Previous Topic

Next Topic

Book Contents

Book Index

CTTRPT EXTRACT Parameter

EXTRACT PATH=path[,RCLLOC=ASIS|VAULT]

<INCLUDE/EXCLUDE statements>

In the EXTRACT parameter statement, PATH specifies the type of records to be extracted. Valid values are described in Table 354.

Table 354 CTTRPT Extract Parameter PATH Values

Value

Description

VOLUME

Volume records are extracted.

VOLUME/
FIRSTDATASET

Volume records with only their first data set records are extracted. Abbreviation: VOLUME/FIRSTDS.

VOLUME/
ALLDATASETS

Volume records with all their data set records are extracted. Abbreviation: VOLUME/ALLDS

DATASET

Data set records are extracted.

DATASET/
FIRSTVOLUME

Data set records with only their first volume records are extracted. Abbreviation: DATASET/FIRSTVOL

DATASET/
ALLVOLUMES

Data set records with all their volume records are extracted. Abbreviation: DATASET/ALLVOLS

In the EXTRACT parameter statement, RCLLOC controls the report of the LOCATION field from the volume record for recalled volumes. Valid values are described in Table 355.

Table 355 CTTRPT Extract Parameter RCLLOC Values

Value

Description

VAULT

Report the LOCATION as the vault name where the volume should be returned. If, while recalling the volume, the slot in the vault was freed, the LOCATION field will be reported as MAINLIB. In addition, the VAULTED flag of the volume will be reported as turned on, although it is not in the Media database. Default.

ASIS

Report the LOCATION field as currently saved in the Media database. During recall the LOCATION is always MAINLIB. Be aware that the slot number field, SLOTNUM, will be zero or the vault or MAINLIB slot number, according to the recall parameter (whether the vault slot number was freed or not) and whether there are slots in MAINLIB

Multiple EXTRACT statements can be specified in the SYSIN DD statement, but each additional EXTRACT statement must follow the INCLUDE and EXCLUDE statements (if any), and the Report Parameter statements of the preceding EXTRACT statement. When saving extracted data in a data set, if several EXTRACT statements are specified, only the data extracted by the last EXTRACT statement is stored.

Parent Topic

CTTRPT Parameters