DSF SELECT Statement – for DUMP and PRINT
SELECT statement syntax (for DUMP and PRINT)
SELECT|EXCLUDE | |
|---|---|
,DATA=ALL|NONE | |
,DSORG=([DA][,EF][,PO][,PS][,UM][,UN]) | |
,TAPEDD=x | |
SELECT statement (for DUMP and PRINT)
This statement selects the data sets and/or tracks to be dumped or printed.
A SELECT statement identifies an individual data set, group of data sets, or range of tracks to be processed. An EXCLUDE statement identifies data sets from within those selected by SELECT statements that are not to be processed. All data sets in the VTOCs of DASD volumes specified by DISKx DD statements are compared to these statements to identify those to be processed; each data set is compared to each control statement until a match is found. It must match all criteria specified on the statement to qualify, for example, if DSN= and DSORG= are both specified, it must be a data set with the right name, having the indicated organization. A maximum of 250 of these control statements may be used in one execution unless overridden by MAXCARDS=.
The control statements are always scanned in the order in which they were input, so in general, EXCLUDE statements should precede SELECT statements. Since DSF will only dump or print data sets that are selected, EXCLUDE statements are required only to exclude certain data sets from within a larger group on a SELECT statement, and can also be used to EXCLUDE certain tracks.
Example 1. Select all data sets with a first index of “A” except those with a second index of “B”:
EXCLUDE DSN=A.B.**
Example 2. Select all data sets except partitioned (PDSs):
EXCLUDE ALLDSN,DSORG=PO
Dumping VSAM clusters
VSAM clusters can be selected by specifying the fully-qualified base cluster name or matching on the base cluster with generic data set selection. When selected, all components of that cluster that exist on the volumes being processed are dumped or printed, including Alternate Indexes (AIXs) and key range components. DSF does not examine VSAM component names when processing SELECT/EXCLUDE statements; components are selected only if their cluster name is selected. For further information, see VSAM-Special-Considerations.
SELECT statement operands (for DUMP and PRINT)
DSN=
Specifies a fully-qualified data set name or a filter to be used for generic data set selection, as described in Generic-Data-Set-Name-Selection. This name or filter is used when scanning the VTOCs of selected volumes. For VSAM clusters, only the cluster name is compared; you cannot select by component name. For example,
DSN=USER1.JCL.CNTL
DSN=**LIST
DSN=PROD++.**.LIB*
DSN= cannot select GDGs by relative generation number; use DD= for that purpose.
DD=
Specifies that a data set name is to be taken from a DD statement. This operand must point to the ddname of a JCL statement. Using this option lets you specify a non-standard data set name or a Generation Data Group (GDG) relative generation. For example,
SELECT DD=DD1
//DD1 DD DSN=A.B.C(0),DISP=SHR
ALLDSN
Specifies that all the data sets on the DASD volumes specified are to be selected. If the DSORG operand is specified, only those data sets with a matching organization are selected.
FROM
TO
Identifies a range of track addresses for an absolute track dump or print. Absolute track statements can be mixed with SELECT statements for data sets. The FROM and TO operands must appear on the same input record, and cannot be continued. FROM and TO cannot be used on an EXCLUDE statement.
The cylinder (CYL=) and track (TRK=) addresses are in decimal, relative to zero. Leading zeros can be omitted. For example, valid specification on a 3390-3, which has 3339 cylinders and 15 tracks per cylinder, are CYL=0,TRK=0 to CYL=3338,TRK=14. The FROM address must be lower than or equal to the TO address.
If the FROM track (TRK=) is omitted, zero is assumed. If the TO track (TRK=) is omitted, the last track of the cylinder is assumed. So, if you specify only cylinder numbers (for example, FROM(CYL=5),TO(CYL=7)) all tracks in those cylinders are processed.
DATA=
All allocated tracks in the selected data sets are dumped or printed. This can be used to override DATA=USED operand (the default) from the DUMP or PRINT statement for certain data sets.
No data tracks are backed up for any type of data sets selected. The backup data set consists only of the FDR control records necessary to allocate and update the characteristics of the output data sets during a restore. A DATA=NONE backup can be used to allocate all the data sets on the backup on output volumes, as long as the data in those data sets is recovered by other means (such as data base backups). Member DATANONE in the FDR Installation FDRSAMP has more information on the use of DATA=NONE.
Default: Only used tracks are processed for PS and PO data sets unless DATA=ALL was specified on the DUMP or PRINT statement.
DSNENQ=NONE
The data set enqueue will not be done for the selected data sets. This can be used to override the DSNENQ= operand on the DUMP statement for certain data sets that you know will probably be enqueued by another task.
Default: Enqueue option is determined by the DSNENQ= option specified on the DUMP or PRINT statement.
DSORG=
Data sets are not to be selected by this SELECT unless their DSORG matches one of the DSORG= values specified. If more than one DSORG is specified, they must be enclosed in parentheses.
Valid DSORG= values are:
DA-BDAM
EF-VSAM
PO-Partitioned
PS-Sequential
UM-Unmovable
UN-Undefined
TAPEDD=
x-Specifies a single character matching the “x” in a TAPEx DD statement. If this operand is specified, then this SELECT/EXCLUDE will only apply to data sets on the input DASD volume specified by the DISKx DD statement. TAPEDD= might be used when multiple DISKx DD statements point to the same volume to select which data sets are to go to which backups.