File Maintenance › Create Sequential File from the History File › Input

Input

Keywords can be entered in one or more APTSYSIN records. If more than one keyword appears on a single record, the keywords must be separated by a comma. The keyword name and value must fit in its entirety on a single record.

The keyword ACTION is required. The values that can be specified for ACTION are PURGEHIST, DUMPHIST, PRINTHIST, DUMPPEND, and PRINTPEND.

ACTION="PURGEHIST"

Selected Move Requests are deleted from the History file and written to the sequential file.

ACTION="DUMPHIST"

Selected Move Requests on the History file are written to the sequential file, but are not deleted.

ACTION="PRINTHIST"

Selected Move Requests on the History file are simply reported. They are not deleted or written to a sequential file.

ACTION="DUMPPEND"

Selected Move Requests on the database are written to the sequential file, but are not deleted.

ACTION="PRINTPEND"

Selected Move Requests on the database are simply reported. They are not deleted or written to a sequential file.

Move Requests can be selected or bypassed by status. Specify selection by the STATUS= keyword, 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"

Move Requests can be selected or bypassed by Move Request Number. Specify selection by the MR= keyword, 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. An example follows:

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, 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 sample selection criteria.

For a Move Request to be processed, it must satisfy ALL selection criteria. For example, if the following selection criteria are entered in the APTSYSIN file:

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

Only Move Requests on the History file that are in Deleted status in the Move Request Number range 10 through 99 with a Service Request of PR000025 are purged to the sequential file.