Show in Frame No Frame
Up Previous Next Title Page Index Contents Search

10.1 Command line parameters

The following table summarizes the available command line parameters and their usage (with an asterisk in the API column indicating whether the command requires the API version):
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
*
setUser:password:sysadmin:meta:
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.
*
startAPI
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.
*
Please see also textForMERL: in Section 10.2 for running generators as scripts, even before logging in.

Show in Frame No Frame
Up Previous Next Title Page Index Contents Search