ctmruninf utility parameters

The following table describes the ctmruninf utility parameters:

Parameter

Description

‑list

Displays data from the Statistical Details table within the dates specified in the From Date and To Date parameters. The data listed can be limited by using the Filter subparameter (described in this table).

‑delete

Deletes data from the Statistical Details table in the range specified in the From Date and To Date parameters.

<From Date>

Start date of statistical data to be displayed or deleted. Format: yyyymmddhhmmss

<To Date>

End date of statistical data to be displayed or deleted. Format: yyyymmddhhmmss

"*"

Asterisk enclosed in quotation marks. Specifies that the utility should list all statistical data currently available, without regard to date.

<Filter

Specify one of the following options and its associated subparameter or leave blank to display the statistics for all jobs in the range.

  • ‑JOBNAME <jobName>

    Identify the job by the first 10 characters in its Job Name parameter.

  • ‑FILE_NAME <file name>

    Identify the job by its file name parameter.

  • ‑FILE_PATH <path>

    Identify jobs by their file path parameter specifications.

  • ‑HOSTID <hostid>

    Identify jobs by their Host ID parameter (agent computer).

  • -ORDERID <orderid>

    Identify jobs by their Order ID parameter.

Each of the sub parameters in the filter can include the following wildcard characters:

* represents any number of characters (including none). Any parameter including * should be enclosed in quotation marks (see the third example below).

? represents any single character

‑total

Displays the total CPU and elapsed times for the jobs selected.

-purge

Purge data from the Statistical Details table based on the number of job executions.

Running the ctmruninf utility with the -PURGE option performs the statistics clean up as if it was done during New Day with the RUNINF_PURGE_MODE set to 0 (default).

The Statistics algorithm (JOBNAME or MEMNAME) and the RUNINF_PURGE_LIMIT parameter are taken from the config.dat table, if configured.

NOTE: You can speed up the New Day procedure by specifying N for the STATISTICS_CLEANUP_IN_NEWDAY parameter and running ctmruninf -PURGE in a job that is run daily. Only the last n run information records of a job are kept, where n is the value of RUNINF_PURGE_LIMIT (default 20).

Parent Topic

ctmruninf