ctmwhy

The ctmwhy utility displays a report showing why a SMART folder, Sub Folder, or job waiting in Active Jobs is not being submitted for execution. This utility is equivalent to the Why option available when right-clicking a SMART folder, Sub Folder, or job in the Tree View pane of the Control‑M/EM window. To run the ctmwhy utility, see Running the ctmwhy utility.

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

ctmwhy -input_file <fullPathFileName>

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

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.

Begin

Open a command prompt and type the following command:

ctmwhy <orderID>

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).

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".

Specify the following command to determine why the job with Order ID A4X is not being submitted for execution:

ctmwhy A4X

A typical response might be QR: ‘TAPE4’ : needed 2. None reserved. This response indicates that the job is not being submitted because it requires two of the Quantitative resource TAPE4 and none is available.

Specify the following command to determine why the job with Order ID 11 is not being submitted for execution. The Order ID in this example is expressed as a base 10 number:

ctmwhy "*37"