Basic System FMS PROC › SELECT Command › SELECT Command SYNTAX

SELECT Command SYNTAX

The syntax of the SELECT command is as follows:

SELECT DSNAMES=,TABLE=,VOLUMES=,TDSN=,CATALOGS=,VTOCS,CRITERIA=

DSNAMES=

You can specify up to 30 fully qualified names, 30 CA Disk pattern names, or a combination of both. If specified, only those data sets matching any of the names or patterns will be candidates for recovery. This parameter has two default values.

If parameter CATALOGS= is not present on the SELECT command, the default is 'DSNAMES=/', meaning all data sets.

If parameter CATALOGS= is present on the SELECT command, the default of the DSNAMES= parameter is null, meaning no data sets.

Note: Both DSNAMES= and CATALOGS= parameters can be specified on the same SELECT command.

CATALOGS=

You can specify a list of up to 30 catalog names, 30 CA Disk pattern names, or a combination of both. If specified, only those catalogs matching any of these names or patterns will be candidates for recovery. If CATALOGS= is not specified, the default value is null, meaning no catalogs will be recovered. For more information, see previous DSNAMES= parameter.

TABLE=

You can specify a name of a member in PARMLIB containing the list (table) of fully qualified data set names or patterns. If specified, only those data sets matching any of the names or patterns in the table will be candidates for recovery. The format of the table is described in the section Selection Lists—Generalized in the chapter CA Disk Libraries in the Systems Guide.

Note: By default, these tables are stored in PARMLIB. However, you can store them in an alternative data set if you desire. For details, see Alternate DDname for User Tables in the Systems Guide.

VOLUMES=

You can specify a list of up to 50 volume serial numbers, 50 CA Disk pattern names or a combination of both where the backed up and archived data sets resided. If specified, only data sets that were backed up or archived from the specified list will be candidates for recovery. The default value is '/', meaning all volumes.

TDSN=

You can specify a list of up to 30 archive volume data set names, 30 CA Disk pattern names, or a combination of both. If specified, only those data sets that were backed up or archived onto an ARCHVOL matching this naming convention will be candidates for recovery.

VTOCS

Causes CA Disk to recover data sets based on a VTOC image created during BACKUP. The zero version backup copy of the VTOC is read for all volumes specified on the VOLUME= parameter; and a list is built of candidate data sets.

Note: If you are familiar with the RECOVER PROC, you will notice a significant difference in the way FMS processes this VTOC image. With the RECOVER PROC, all data sets backed up from the volume are recovered, as long as they have corresponding DSNINDEX records. The FMS PROC simply uses the VTOC image as another table of data set names to do selection (or exclusion) upon. It is for this reason that SET VTOCMSGS= defaults to NO.

If VSAM datasets are to be recovered using this process then Sysparm VBRIVSAM must be specified with a value of Y at the time that the backup which includes the VTOC is taken.

CRITERIA=

You can specify a series of criteria tests to limit the selection of data sets or catalogs to be considered as candidates for recovery. The criteria parameter is specified by a minimum of three subparameters as follows:

(operand1,operator,operand2)

The operands can consist of any combination of the criteria subparameters described in FMS Selection Criteria Field Names. The maximum number of subparameters allowed on a single SELECT or EXCLUDE command is 256. Because the CRITERIA= parameter is already very restrictive, you cannot specify the VTOCS parameter on the same SELECT command. You can, however, add the DSNAMES=, TABLE=, VOLUMES=, or TDSN= parameters. For logical operators, you can specify any of the values listed in the section Criteria Operators and their Meanings in the chapter "Basic System – DMS PROC."