Previous Topic

Next Topic

Book Contents

Book Index

Retention Days

Determines the number of days to retain the job in the History Jobs file. For z/OS jobs only.

Additional information

Description

Usage

Optional

Format

001 - 999 days.

NOTE: When the Retention Days field is left blank, History Jobs file information is kept as specified by the Retention Generation parameter. For more information, see Retention Generations.

Variable Support

None

Alternate names

  • Control‑M/EM Utilities: RETEN_DAYS
  • Control-M Report: RETEN DAYS
  • Control‑M/Server Utilities: (none)
  • Control‑M for z/OS: RETENTION: # OF DAYS TO KEEP
  • Control‑M/EM API: reten_days

Jobs in the History Jobs file are easier to restore to the Active Jobs database (for example, for restart) than jobs archived to CDAM. Therefore, it may be desirable to retain a job in the History Jobs file for a period of time.

Using Retention Days you can specify a fixed number of days to keep the job in the History Jobs file. Once the specified number of days is reached, the job is automatically deleted from the History Jobs file during the next New Day processing.

Retention Days and Retention Generations are mutually exclusive. A value can be specified for either, but not both.

When changing job criteria from Retention Days to Retention Generations (or the reverse), previous job criteria are lost and are not acted upon.

For retention criteria to hold across job executions, the jobs must be identical in all respects. (For example, if a job is transferred to a different folder, it is treated as a different job for purposes of retention. In this case, retention values are reset, and retention is calculated from the moment of transfer.)

NOTE: At sites that do not use the History Jobs file, this parameter is not relevant and is not displayed.

Parent Topic

Actions parameters