File Maintenance › Purging to the History File › Input

Input

The ACTION="PURGEPEND" keyword is required in the APTSYSIN file. All other keywords are optional. If the ACTION keyword is not specified or if an error is encountered with any of the keywords, the program ABENDs with a User 1000, and an error is logged on the APCS5950‑00 Execution Log.

Keywords can be entered in one or more SYSIN records. If more than one keyword appears on a single SYSIN record, the keywords must be separated by a comma. The last keyword on a SYSIN record does not have to end with a comma. If there is only one keyword on a SYSIN record, then the commas are not required.

The keyword name must be entered in its entirety on a SYSIN record. For example, you cannot start a keyword name on one SYSIN record and then continue that name onto the next SYSIN record. If this is done, the program ABENDs with a User 1000 and an error is generated on the APCS5950‑00 Execution Log.

Move Requests can be selected or bypassed by status. Specify selection by the STATUS= keyword, and bypass by the STATUS‑OMIT= keyword. Specify multiple statuses either by separating them by commas in the value, as in:

STATUS="MVP,MVP‑B,DEL"

Or specify multiple status keywords, as in:

STATUS="MVP",STATUS="MVP‑B"
STATUS="DEL"

Any statuses specified that are ineligible for being purged or non‑existent, are ignored.

Move Requests can be selected or bypassed by Move Request Number. Specify selection by the MR= keyword and bypass by the MR‑OMIT keyword. Like the STATUS and STATUS‑OMIT keywords, you can specify multiple Move Requests within a keyword value, and you can specify the keyword multiple times. Also, the Move Request value can be a single Move Request number, or a range in the format LOWER:HIGHER as in the following example:

MR="5,10,15:200,300",MR‑OMIT="50:60,45"

Note that in the overlap of MR‑OMIT 50:60 and MR 15:200, the MR‑OMIT takes precedence, selecting 15 through 49 and 61 through 200.

Selection by Move Requests can improve performance of this program if a significant number of Move Requests do not have to be read to determine whether they are eligible to be purged.

Move Requests can be selected or bypassed by Service Request. Specify selection by the SR= keyword, and bypass by the SR‑OMIT keyword. Like the STATUS and STATUS‑OMIT keywords, you can specify the keyword multiple times.

Restrict the selection of Move Requests to those that have certain Move Types by the MPC= (Move Processing Cycle) keyword. Specify all Move Types to be selected in the value, with no separating commas. For example, to select Move Types C, D, and M, specify MPC="CDM". Do not specify multiple MPC keywords, only the last one specified is in effect.

Select Move Requests by age, using the MR‑AGE= keyword. The value of the keyword can be a single number, specifying the exact number of days ago the Move Request was last moved, or a range of ages separated by colons. This is just like the MR selection keyword. You can select those Move Requests moved yesterday and those moved a year ago or more with the following:

MR‑AGE="1,365:99999"

See the topic Input Selection Criteria from DD APTSYSIN presented later in this subject for some sample selection criteria.

A Move Request must satisfy ALL selection criteria to be deleted from the Pending file. For example, if the following selection criteria is entered as two SYSIN records in the APTSYSIN file:

ACTION="PURGEPEND",STATUS="DEL"
MR="10:99",SR="PR000025"

Only a Move Request on the Pending file that is in a Deleted status, has a Move Request number between 10 and 99, and has a Service Request of PR000025 is deleted from the Pending file.