ctmimptb

The ctmimptb utility imports folders (including SMART Folders and Rule-Based Calendars) containing job definitions that were exported from Control-M/EM by the exportdeffolder utility. To run the ctmimptb utility, see Importing folders using the ctmimptb utility.

The ctmimptb utility gets the exported XML file that was created by exportdeffolder in Control‑M/EM, and imports the folders into the Control-M/Server database. This utility can overwrite existing folders when overwrite mode is specified.

The ctmimptb utility works at the folder level only and cannot import a specific job or jobs from a folder. The utility can import Sub Folder entities and Sub Folders jobs, but cannot import Sub Folders individually. The Sub Folders must be imported as part of SMART folders.

The Control-M/EM exportdeffolder utility cannot define an empty folder. Therefore, the ctmimptb utility cannot perform an action that will cause folders to become empty. If you duplicate SMART Folders in the XML input file, when overwrite mode is specified, the last SMART Folder is considered and overwrite mode is not specified and the SMART Folder does not exist in the database, the first defined SMART Folder is considered.

When a job definition folder in the input XML file is large, importing this folder is performed by a few transactions. The number of jobs within each transaction is specified by the CTMIMPTB_ENT_IN_TRANS parameter that is defined in the
~controlm/ctm_server/data/config.dat file. If the CTMIMPTB_ENT_IN_TRANS parameter is not specified in the config.dat file. The value range is 5–10,000 jobs and the default value 1,000 jobs.

The following describes the results of the import procedure:

• In the event of a successful import, the utility exits with a success return value. If the utility was invoked without overwrite mode and the utility encounters rejected folders during the import process, an appropriate message is issued for the partial import.
• In the event of a failure, the utility exits with an error return value and a partial import might occur. If a commit was already made, an appropriate message is issued for the partial import.

The ctmimptb utility is run by using the Control-M/Server security authorization of the invoking user.

The permissions that are required to run the ctmimptb utility on Control-M/Server SMART Folders are Read, Write, and Delete.

If permission is denied for a specific SMART Folder, the ctmimptb utility ignores the folder, continues processing the input XML file, and (if no other errors are encountered) exits with a success return value.

BMC recommends that you avoid updating job definition folders while the ctmimptb utility is running.