Description of the import procedure

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.