|
Command
|
Usage
|
API
|
|
abandon
|
Abandons the current transaction
|
*
|
|
backupToDB:dir:
|
Creates a copy of the repository (not including uncommitted
transactions) while being logged in. Useful when automating a version management
scheme. The first argument is the new repository name, and the second argument
is the relative or absolute directory of the copied repository. If the
repository name is an empty string, "", the copied repository maintains its old
name in manager.ab and is not added to artbase.roo.
|
*
|
|
commit
|
Commits the current transaction
|
*
|
|
condenseDatabase
|
Compacts the repository by removing old versions of objects
(cf. maintainDatabase).
|
*
|
|
condenseVersions
|
Condenses duplicate graph snapshots in version history.
Requires that this is the only user logged in.
|
*
|
|
createProject:
|
Creates a new project in the repository, or does nothing if it
exists already. To be able to use the new project, you must first commit, and
then set it as the default project with setProject:
|
*
|
|
currentDir:
|
Sets the MetaEdit+ working directory to be the directory in
the argument. Argument is a string representing a directory name, or a file name
within a directory. The file or directory must exist. Cannot be used when logged
in. When reading metaedit.ini from this new directory, only those settings
explicitly mentioned in the ini file will be changed.
|
|
|
document:into:
|
Documents Graph types in a human-readable and diffable textual
format. For each Graph type matching the first wildcard argument, creates a
subdirectory of the same name below the base directory specified in the second
argument. Into each directory it outputs metamodel.txt, a comprehensive yet
readable textual representation of the Graph type, the Graph types’
generators as *.rep files and library symbols as *.mxs files.
|
*
|
|
documentGraphsInto:
|
For each Graph in a project open in this transaction, runs its
_vcsGraphSnapshot generator to output a text snapshot to the directory named in
the argument. The directory is created if necessary, and the file encoding is
UTF-8. Filenames are .txt, formed from the graph name, oid and type name
separated with underscores.
|
*
|
|
evalCode:
|
Supplies the evaluation code for MetaEdit+ on startup. The
evaluation code is remembered so it can be used automatically as needed, rather
than prompting the user for it with a dialog. Note that this command should
precede the login command on the command line. The code is requested during
first login; supplying the code in other situations will have no effect and is
harmless.
|
*
|
|
exportName:type:file:
|
Exports a set of graphs into a file. The first argument is a
wildcard to match graph names, the second argument is a wildcard to match graph
type names, and the third is a filename with extension .mxm or .mec. The graphs
matching will be exported as from Graph Manager.
|
*
|
|
fileInPatch:
|
Imports the named program, type or model patch (.mep, met,
.mec, .mxt, .mxs, .mxm). Note you must be logged in for all but .mep
patches.
|
|
|
fileInPatches
|
Imports .mep program patches. Patches are named in a
patches.txt file in the current directory or patches subdirectory. If there is
no patches.txt file, all .mep patches from the patches subdirectory are taken in
alphabetical order.
|
|
|
forAll:run:
|
For all graphs which are in open projects, and whose type
matches the wildcard first argument, run the named generator.
|
*
|
|
forName:type:run:
|
For all graphs which are in open projects, and whose name
(identifier) matches the first wildcard argument, and whose types match the
second wildcard argument, run the named generator.
|
*
|
|
ip:
|
Specify how to select among possibly several IPs that may
exist in a multihomed machine. The argument is either a preferred IP address
e.g. 192.168.0.10 or a CIDR pattern e.g. 192.168.0.0/24. The supplied IP or CIDR
must be a match for an actual IP of the current hostname. The preferred IP info
can be unset by supplying a CIDR string with a legal IP but a prefix length of
0. Any failures in getting this host’s IPs or setting the desired IP are
logged to log.txt.
|
|
|
login
|
Logs in to repository ‘db’ (or ‘demo’,
if that exists and ‘db’ does not) as user ‘user’ with
password ‘user’
|
*
|
|
loginDB:user:password:
|
Logs in to the given repository, as the given user with the
given password. Note that the first parameter is the repository name rather than
the repository directory name. If the password is * the user will be prompted
with a dialog (even for ‘user’ and ‘sysadmin’ where the
password is the same as the user name).
|
*
|
|
loginNewDB:dir:user:password:
|
Creates and logs in to a new database with the given name and
directory, as the named sysadmin user with the given password.
|
*
|
|
logoutAndExit
|
Logs out and exits: use abandon or commit first to avoid
dialogs
|
*
|
|
maintainDatabase
|
condenseDatabase + condenseVersions + repository garbage
collect. This also converts a multi-user repository ready for single user
use.
|
*
|
|
minimalUI
|
Suppress certain MetaEdit+ windows and menu elements to
minimize the user-visible UI elements. The windows to be hidden are the
MetaEdit+ main window, the Generator Output Browser and the API Tool (the API
tool itself still exists, it just not shown). When minimalUI is set, closing the
last MetaEdit+ window will not automatically log out or exit
MetaEdit+.
|
*
|
|
obsolete:
|
Mark all types created by the given user name as removed:
useful mostly with types imported from a generated MXT file. Object types' icons
will be replaced by a red X, and their identifier will be prefixed with bold
XXX. The prefix and icon to be used can be customized by saving them as the
content and icon of a Graph generator __obsolete().
|
*
|
|
openAllProjects
|
Opens all the projects in the repository.
|
*
|
|
quit
|
Quits MetaEdit+ abruptly: no logout is performed. Use with
care.
|
*
|
|
resetVersionHistory
|
Removes the entire version history of all users. The removal
will become permanent on commit. Requires that this is the only user logged
in.
|
*
|
|
saveWSDL:
|
Save the WSDL to the file specified as argument. The settings
for hostname and port will be taken from the API Tool most recently started via
the API, or the defaults if none.
|
*
|
|
setMemoryLimit:
|
Sets the memory upper bound for the MetaEdit+ process. Value
is in bytes (no thousand separators), optionally multiplied by suffix K, M, G
etc. (binary-based, so 1024 etc.), e.g. 1.5G or 200M. Default value is 512M
(rarely reached in practice, even in large repositories). Specified values are
forced to be between a minimum of 64M and a maximum of 4G.
|
|
|
setProject:
|
Opens the named project and sets it as the default
project
|
*
|
|
Creates or changes the user named in the first argument.
Boolean arguments sysadmin (for sysadmin rights) and meta (for metamodeling
rights) are case-insensitive and recognize as true anything with first character
T, Y or 1; other values are treated as false. Arguments other than the user can
be supplied as empty strings (explicit "" on Windows command line) to leave the
current value unchanged when updating, or to take the default value when
creating. The default value for password is the user name, and the default value
for the Booleans is false.
|
*
|
|
|
Starts the API with default settings (hostname as localhost,
port 6390 and event logging turned off).
|
*
|
|
|
startAPIHostname:port:logEvents:
|
Starts the API with the given parameters.
|
*
|
|
stopAPI
|
Stops and closes all API Tools that have been started through
the command-line mechanism (i.e. command-line, internal...execute, or API call).
Will not affect manually started API Tools.
|
*
|