Previous Topic: SET CommandNext Topic: PASSWORD Command (For VSAM Only)

Basic System FMS PROC › SET Command › SET Command Syntax

SET Command Syntax

The syntax of the SET command is as follows:

SET MODE=,GEN=,VTOCMSG=,MSGLEVEL=,FROMDATE=,TODATE=,FROMTIME=,TOTIME=
MODE=

Specify SIMULATE or SIM to have CA Disk simulate the execution. In simulate mode, CA Disk produces messages and reports as if the supplied action command had really taken place. Specify LIVE, LIV, or remove the SET command entirely to have CA Disk execute the supplied action command. The default value is LIVE.

GEN=

There are two source locations containing data sets names that are available to the SET command:

Data set names and/or patterns specified by the TABLE= parameter on the SELECT command.

Data set names selected by the VTOCS parameter on the SELECT command.

By specifying GEN=YES, CA Disk will print the combined list of data set names to CMDPRINT. By specifying NO, the list of data set names will not be printed. The default value is YES.

Note: The combined list of data set names is the actual candidate list of data sets, not just the data sets that will be processed. Specifically, those data sets not selected for processing will still be listed.

VTOCMSG=

When the VTOCS parameter is specified on the SELECT command, you can optionally have CA Disk generate a message for data sets that are not processed. By specifying VTOCMSG=YES, message 3822 is issued for each data set not recovered. By specifying NO, this message is not issued. The default value is NO.

MSGLEVEL=

This parameter controls the degree (a range from 0 to 9) of debugging desired, recording the output in MSGPRINT.

For instance, a value of '6' will produce a message showing why each data set was or was not selected. The default value is 0, which disables the feature. Other values available for this option include:

0 or 1

Either one will disable the feature 1.

2, 3, 4, or 5

Provides ARCHVOL information.

6, 7, or 8

Displays SELECT/EXCLUDE information in addition to the ARCHVOL information supplied from value 2.

9

Prints all selection control blocks available.

FROMDATE=date,
TODATE=date

These optional parameters establish a date window in which the creation date of each DSNINDEX record is compared to. FROMDATE= defaults to the beginning of time, while TODATE= defaults to today. If the creation date of the DSNINDEX record does NOT fall within this window, the record is excluded from processing. This includes user exits. It will be as if the data set does not exist in the files data set.

For example, using the following command will exclude from further processing any data set that wasn't created in January:

//SYSIN DD *
SET FROMDATE=01JANyyyy,TODATE=31JANyyyy
SCAN DSNINDEX
RECOVER SCRATCH
/*

Note: For a list of valid dates, see the section Date Formats in the chapter "General Information."

FROMTIME=time,TOTIME=time

These optional parameters establish a time window in which the creation time of each DSNINDEX record is compared to. FROMTIME= defaults to 0000 and TOTIME= defaults to 2359. If the creation time of the DSNINDEX record does NOT fall within this window, the record is excluded from processing. This includes user exits. It will be as if the data set does not exist in the FILES.

For example, using the following command will exclude from further processing any data set that wasn't created between 11PM on March 23 and 2:30PM on March 24.

//SYSIN DD *
SET MODE=SIM,FROMDATE=23MARxxxx,TODATE=24MARxxxx,TOTIME=1430,FROMTIME=2300
SCAN DSNINDEX
RECOVER SCRATCH
/*