ctmorder

The ctmorder utility orders or forces one or more jobs from a SMART Folder in the Control‑M/Server database.

NOTE: Ordered jobs are placed in the Active Jobs database if their scheduling criteria are met. Forced jobs are placed in the Active Jobs database regardless of their scheduling criteria.

To run the ctmorder utility, see Ordering or forcing a job using the ctmorder utility.

If two jobs with the same name exist in a SMART Folder and you use the ctmorder utility to order or force a job with that name, only the first job is added to the Active Jobs database.

NOTE: If the ctmorder utility is running when the New Day procedure begins, it is automatically suspended until New Day procedure is ended.

When ordering a SMART Folder, folder-level Rule-Based Calendars are calculated and joined so that if the scheduling criteria are met, the folder will be ordered. As a result of ordering the folder:

• A row in the Active Jobs database is added for this folder.
• All folder contents must pass the order procedure. Each field in the folder is inspected as follows:
  • For regular jobs, the job scheduling criteria is calculated and either Or (default) or And with folder or Sub Folder-level Rule-Based Calendars associated to it, according to the relationship parameter in the job definition. If the scheduling criteria are satisfied the job is inserted into the Active Jobs database. If the scheduling criteria are not satisfied, the job is ignored.
  • For Sub Folders, Rule-Based Calendars of the Sub Folder are calculated and joined. When * is defined, Rule-Based Calendars of the parent folder are fetched. If the result of the Rule-Based Calendars calculation is satisfied, a row for the Sub Folder is added in the Active Jobs database and the Sub Folder content will be ordered. If the result of the Rule-Based Calendars calculation is not satisfied, the Sub Folder is ignored.
• Ordered SMART Folder, jobs and Sub Folders status are set to WAIT_SCHEDULING.
• INTO_FOLDER_ORDERID will be used to force (Ordering Sub Folders will not be valid) a job or Sub Folder into already ordered folder or Sub Folder. The ordered job or Sub Folder should belong to the same folder or Sub Folder of the job or Sub Folder we are ordering into. Force a Sub Folder ALONE will not be applicable, for jobs it will be applicable.

The ctmorder utility can be invoked using the -input_file parameter:

ctmorder -input_file <fullPathFileName>

The referenced file contains all the required parameters. Most of the parameters are described in Control-M Parameters and ctmorder parameters.

For examples, see ctmorder examples.