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:
- Any specified status types take precedence over the ALL subparameter and the wildcard (*) subparameter.
- The ALL subparameter (purge types HE, HO, HP, HS, RA, and RH) takes precedence over the wildcard (*) subparameter.
- The wildcard (*) subparameter (purge all valid status types) takes the last precedence.
An example of the MAX.AGE parameter follows.
|
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:
|
Modifiable through MODIFY INITPARMS command: YES