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 indication 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 symbols (including 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.
*
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.
*
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.
*
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 matching the first wildcard argument, run the named generator.
*
forName:type:run:
For all graphs matching the first wildcard argument, and whose types match the second wildcard argument, run the named generator.
*
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.
*
setProject:
Opens the named project and sets it as the default project
*
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