CTMSLC – Schedule Library Cleanup Utility

The CTMSLC utility enables you to remove old job scheduling definitions from the schedule library.

A job is considered old if the date specified in the DEFINITION ACTIVE UNTIL field of the job scheduling definition and/or all job rule-based calendars have already passed.

If the relationship between the rule-based calendars and the basic scheduling criteria of the job is an AND relationship, the job is considered old when the DEFINITION ACTIVE UNTIL date has passed in at least one set of scheduling parameters (all job rule-based calendars or basic scheduling data). If the relationship between the rule-based calendars and the basic scheduling criteria of the job is an OR relationship, the job is considered old when the DEFINITION ACTIVE UNTIL date has passed in both sets of scheduling parameters.

Note: If the date specified in the DEFINITION ACTIVE UNTIL field has already passed, but the date specified in the DEFINITION ACTIVE FROM field is later than that date, the job is not considered old. Similarly, if the date specified in the SCHEDULE RBC ACTIVE UNTIL field of a schedule RBC has already passed, but the date specified in the SCHEDULE RBC ACTIVE FROM field of that RBC is later than that date, jobs containing that RBC are not considered old. The utility permits all jobs in a SMART Table to be deleted regardless of the setting of the EMPTYTBL parameter in the CTMPARM member of the IOA PARM library or the PTBLEMPT parameter in the $PROFILE member of the IOA IOAENV library.

The CTMSLC utility receives control statements, in DD statement SYSIN, with the following syntax:

where

• data_set_name is the data set name of the library being cleaned.
• ddname is a DD statement pointing to the library being cleaned.

Note: Specify either DSNAME or DDNAME, but do not specify both.

• member_name is the name of the library member containing the job table that is to be cleaned.

  Either the full member name or a prefix followed by an * (asterisk) can be specified. If this parameter is omitted, all the members in the library are eligible for cleanup.

• jobname is the name of each job in the job table that is to be cleaned.

  Either the full job name or a prefix followed by an * (asterisk) can be specified. If this parameter is omitted, all the jobs in the table will be eligible for cleanup.

• date is the date, in the format used at your site, that is used to determine if a job is old.

  The default value of date is the current date.

• MODE is the desired operation mode of the utility.

  There are two options:

  • SIMULATION
    In this mode, when a job is found to be old the utility issues an appropriate message but does not delete the job. This is the default setting.
  • NORMAL
    In this mode, when a job is found to be old, it is deleted.
• SMARTEMP controls whether a SMART Table is to be deleted when the utility deletes all the jobs within it (SMARTEMP=DELETE) or to be kept as an empty SMART Table (SMARTEMP=KEEP, the default).