MAX.AGE = (nnn , * | *(nnn) | ALL | ALL(nnn) | status_type | status_type (nnn) , list)

This parameter specifies how many calendar days to wait before purging a Process. You can also use this parameter to purge only Processes with a specific status or define a different time to wait for each status type.

Note: IBM® Connect:Direct® software does not automatically delete Processes when you specify 0.

The following table explains the values.

Value Description
nnn The number of days to wait before purging a Process. The maximum value is 32767. After the specified number of days as passed, the Process is deleted. If nnn=0, no MAX.AGE processing is performed.
* (asterisk) Purge all Processes.
ALL Purge all Processes with Hold queue error status types (HE, HO, HP, HS, RA, and RH).
status_type Purge only specified status types (HE, HO, HP, HS, PR, RA, RH, HC, HI, HR, WC, WP, WT, or WX).
list Specify a list by separating entries with a comma.

Following are the queue status values you can select for automatic removal from the TCQ.

Parameter Description
ALL This value indicates a request for all of the queue types for the MAX.AGE parameter. If you specify ALL and another queue type, ALL is ignored.
HE This value indicates to automatically remove held for error (HE) status values. This parameter is the default.
HO This value indicates to automatically remove held for operator (HO) status values.
HP This value indicates to automatically remove held due to Process error (HP) status values.
HS This value indicates to automatically remove held for suspension (HS) status values.
RA This value indicates to automatically remove held for restart due to allocation error (RA) status values.
RH This value indicates to automatically remove restart held (RH) status values.

The order of precedence for MAX.AGE subparameters is:

  1. Any specified status types take precedence over the ALL subparameter and the wildcard (*) subparameter.
  2. The ALL subparameter (purge types HE, HO, HP, HS, RA, and RH) takes precedence over the wildcard (*) subparameter.
  3. The wildcard (*) subparameter (purge all valid status types) takes the last precedence.

An example of the MAX.AGE parameter follows.

MAX.AGE=(10,*,ALL(4),HO(20),HI(0))

The following table explains the values in the example.

Value Description
10 The default number of days before a Process is removed from the Process queue.
* All Process types are removed. Because no waiting period is specified for *, the default of 10 days is used.
ALL(4) Processes with Hold queue error status types (HE, HO, HP, HS, RA, and RH) are removed after 4 days in the Hold queue. Note that the 4-day waiting period for Processes with these status types overrides the 10-day default waiting period.
HO(20) Processes with an HO status type are purged after 20 days. As a result, they are not purged when ALL or wildcard (*) Processes are purged.
HI(0) Processes with an HI status type are not eligible for purge because zero is specified as the waiting period. They are never automatically purged from the Hold queue.

In the following example, Processes in the PR queue are aged after one day. Processes in any other queue or status are not aged:

MAX.AGE = (0,PR(1),*(0))

Modifiable through MODIFY INITPARMS command: YES