Running the ctmwhy utility

This procedure describes how to run the ctmwhy utility, which displays a report stating why a SMART Folder, Sub Folder, or job waiting in the Active Jobs database is not being submitted for execution.

To run the utility:

• Open a command prompt and type the following command:

  ctmwhy <orderID>

For more details on the ctmsweep parameters, see ctmwhy example.

If the host is upgrading, and the job is in state wait host, the following message will appear:

No agent hosts available for job's host-group.

The variable <orderID> is the Order ID of a job waiting in the Active Jobs database (as displayed in the Job Details window of Control‑M/EM).

NOTE: The Order ID as displayed in the Job Details window is a base 36 number. If you wish to specify the Order ID here as a base 10 number, prefix the number with an asterisk, and enclose the result in quotation marks (for example, " *1234").