util

util is a multi-purpose utility that can perform the following functions from the command line:

• Import and export data to and from the Control‑M/EM database
• Delete, clear, and build the Control‑M/EM database
• Import and export a specified definition folder
• Import, export, and remove (to save disk space) Control-M/Forecast data

When version management mode is selected (default), the following additional functions are available from the command line:

• Export or import of scheduling definitions, either with or without the history of changes made
• Export or import of a specified definition folder, either with or without the history of changes made

All the functions use DB_ARGS in the following format:

[-D <database>][{-U <user> -P <password>} |-pf <fileName>]
[-S <server>][-T <level>] [-dbms <system>][-dbtimeout <sec>]
[-dbfile <path>]

For more information about DB_ARGS database arguments, see DB_ARGS database arguments fields.

For Functions and syntax of the util utility (UNIX), add em and a space before specifying util. For example: em util <DB_ARGS> <buildSchema> [-cdbg {1 - 5}][-T 3]

The following topics describe how to run the utility, functions, configuration and parameters:

• Running the util utility.
• util utility functions
• util utility function parameters
• To configure the util utility to recognize different delimiters, see Configure the util utility to recognize different delimiters

NOTE: The util utility is automatically installed on Windows computers with the Control-M/EM Gateway component. For more information about version management, see Using Control-M.