SELECT/IGNORE Statements for CTMHCLN

The utility receives parameters in the form of SELECT/IGNORE statements that designate the required function, using DD statement DAFRMIN (or SYSIN). They identify jobs that are deleted or not deleted, as follows:

Table 118 CTMHCLN SELECT/IGNORE Statements

Statement	Description
IGNORE statements	Identify jobs that are not deleted.
SELECT statements	Identify jobs that are deleted.

Note: The default action of the CTMHCLN utility is to delete jobs in the History Jobs file based on their retention criteria. To override this default use the SELECT/IGNORE statements.

Up to 500 SELECT/IGNORE statements can be specified. Jobs are handled according to the first statement for which the criteria are met.

One or more of the parameters described in Table 119 can be specified in any SELECT/IGNORE statement (in any order).

Table 119 CTMHCLN SELECT/IGNORE Parameters

Parameter	Description
FROM date	Starting ODATE in yymmdd format
GROUP groupname	Name of the group appearing in the job scheduling definition
JOBNAME jname or MEMBER memname	jname—Name of the job appearing in both the JOB statement and the JOBNAME field of the Status screen memname—Name of the JCL member (specified in the MEMNAME field in the job scheduling definition) jname or memname (but not both) can be specified in one statement.
STATUS status	Valid values are: ACTIVE
	Note: ACTIVE status includes all statuses except WAITSCHED, ENDOK and ENDNOTOK. This status enables the user to select or ignore jobs that are in ACTIVE status.
	ENDOK ENDNOTOK HELD WAITSCHED DELETED TBL-ACTIVE
TO date	Ending ODATE in yymmdd format.
SIMULATION	Activate Simulation mode, for simulation of the maintenance functions, without performing any changes in the History Jobs file.

Note: A prefix can be specified instead of a full table name, job name or member name by placing an asterisk (*) at the end of the string (for example, PROD*).

Parent Topic

CTMHCLN – Maintain the History Jobs File