SYSIN Control Statements - syncsort_allocation_control_center

SELECT Control Statement

The SELECT control statement indicates which control datasets are to be used by ACS/QA, which testcase library is to be used, identifies which test cases are to be run, and specifies other execution options.

Important: Only one SELECT statement should be specified for each execution of ACS/QA.

The format of the SELECT statement is shown below. Default values are underlined. All operands must be enclosed in parentheses.

Tip: Continuation follows TSO conventions. The SELECT statement may be continued to additional lines by placing a dash ('-') as the last character on a line.

The MEMBER parameter must be specified. Either CDS1 or CDS2 (or both) must also be specified. The TESTCASE parameter is required unless a //TESTCASE DD statement is present in the JCL.

SELECT (
  BYPASS_DC ( yes|no )
  BYPASS_SC ( yes|no )
  BYPASS_MC ( yes|no )
  BYPASS_SG ( yes|no )
  CDS1 ( dsn_name )
  CDS2 ( dsn_name )
  DATACLAS ( dc_name )
  DSINFO ( yes|no )
  EXITS1 ( yes|no )
  EXITS2 ( yes|no )
  EXITLIB ( load_library )
  FILTJOB ( jobname_mask )
  FILTDSN ( dsn_mask )
  GROUP ( group_name )
  MEMBER ( test_case_mask )
  MGMTCLAS ( mc_name )
  NULL ( char_string )
  NOTRUN ( char_string )
  PRINTRO ( yes|no )
  STORCLAS ( sc_name )
  SETDCVARS ( yes|no )
  TRACE ( yes|no )
  TESTLIB ( dataset_name )
  USER ( userid )
)

BYPASS_DC ( yes|no )

Function:

Tip: This is an optional parameter.

Indicates whether the data class ACS routine should be executed. This parameter applies to both CDS1 and CDS2.

Default: BYPASS_DC ( NO )

Format: YES or NO

BYPASS_SC ( yes|no)

Function:

Tip: This is an optional parameter.

Indicates whether the storage class ACS routine should be executed. This parameter applies to both CDS1 and CDS2.

Default: BYPASS_SC ( NO )

Format: YES or NO

BYPASS_MC ( yes|no )

Function:

Tip: This is an optional parameter.

Indicates whether the management class ACS routine should be executed. This parameter applies to both CDS1 and CDS2.

Default: BYPASS_MC ( NO )

Format: YES or NO

BYPASS_SG ( yes|no )

Function:

Tip: This is an optional parameter.

Indicates whether the storage group ACS routine should be executed. This parameter applies to both CDS1 and CDS2.

Default: BYPASS_SG ( NO )

Format: YES or NO

CDS1 ( dsn_name )

Function:

Important: CDS1 or CDS2 is a required parameter.

Identifies the SMS Source Control Datasets (SCDS) which contain the translated ACS routines to be executed. Specifying ACTIVE indicates that the currently active ACS routines are to be used.

Default: Either CDS1 or CDS2 must be specified.

Format: Any valid data set name

CDS2 ( dsn_name )

Function:

Important: CDS1 or CDS2 is a required parameter.

Identifies the SMS Source Control Datasets (SCDS) which contain the translated ACS routines to be executed. Specifying ACTIVE indicates that the currently active ACS routines are to be used.

Default: Either CDS1 or CDS2 must be specified.

Format: Any valid data set name

DATACLAS ( dc_name )

Function:

Tip: This is an optional parameter.

Specifies a data class name which will be used instead of the data class (if any) that is present in the test cases. This is the input data class to the ACS routines and is thus equivalent to specifying the DATACLAS parameter in the JCL.

Default: None

Format: Any valid data class name

DSINFO ( yes|no)

Function:

Tip: This is an optional parameter.

Indicates that dataset information should be obtained from the catalog if the dataset exists, and the &ALLVOL, &ANYVOL, &NVOL, &DATACLAS, &STORCLAS, &MGMTCLAS read-only variables updated with these values prior to calling the first ACS routine.

Warning: This option requires a catalog access for each testcase. If the dataset does not exist, the variables are left unchanged.

Default: DSINFO ( NO )

Format: YES or NO

EXITS1 ( yes|no)

Function:

Tip: This is an optional parameter.

Indicates whether the ACS user exits (IGDACSDC, IGDACSSC, and IGDACSMC) are to be called for CDS1. By default, the ACS exits, if any, present in the system are used. If an EXITLIB parameter is present, the exits are loaded from the library specified in the EXITLIB parameter.

Default: EXITS1 ( YES )

Format: YES or NO

EXITS2 ( yes|no)

Function:

Tip: This is an optional parameter.

Indicates whether the ACS user exits (IGDACSDC, IGDACSSC, and IGDACSMC) are to be called for CDS2. By default, the ACS exits, if any, present in the system are used. If an EXITLIB parameter is present, the exits are loaded from the library specified in the EXITLIB parameter.

Default: EXITS2 ( YES )

Format: YES or NO

EXITLIB ( load_library)

Function:

Tip: This is an optional parameter.

Specifies the load library from which the ACS user exits (IGDACSDC, IGDACSSC, and IGDACSMC) are loaded. This parameter is meaningful only if EXITS1(YES) or EXITS2(YES) is specified or defaulted.

Default: If EXITLIB is not specified, the currently active exits, if any, are called.

Format: Any valid dataset name

FILTJOB ( jobname_mask)

Function:

Tip: This is an optional parameter.

Specifies that only those test cases which have a JOBNAME matching the filter should be executed. The default is that all test cases are executed regardless of jobname.

Default: FILTJOB ( * )

Format: Any valid jobname, or jobname mask using an asterisk (e.g., ABC*).

FILTDSN ( dsn_mask)

Function:

Tip: This is an optional parameter.

Specifies that only those test cases which have a dataset name matching the filter should be executed. The default is that all test cases are executed regardless of jobname.

Default: FILTDSN ( * )

Format: Any valid dataset name, or dataset mask using an asterisk (e.g., ABC*).

GROUP ( group_name)

Function:

Tip: This is an optional parameter.

Specifies a RACF group name which is to be passed to the ACS routines in the &GROUP read-only variable. This overrides any group name specified in the testcase.

Default: None

Format: Any valid RACF group name

MEMBER ( test_case_mask )

Function:

Tip: This is an optional parameter.

Specifies which members in the test case library should be executed. The default is to run all of the test cases.

Default: MEMBER ( * )

Format: Any valid member name, or member name mask using an asterisk (e.g., ABC*).

MGMTCLAS ( mc_name )

Function:

Tip: This is an optional parameter.

Specifies a management class name which will be used instead of the management class (if any) that is present in the test cases. This is the input management class to the ACS routines and is thus equivalent to specifying the MGMTCLAS parameter in the JCL.

Default: None

Format: Any valid management class

NULL ( char_string )

Function:

Tip: This is an optional parameter.

The character string (1-8 characters) to be used in the output to indicate that an ACS routine returned a null result for an SMS construct. The default is the character string NULL.

Default: NULL ( NULL )

Format: Any character string up to eight characters long.

NOTRUN ( char_string )

Function:

Tip: This is an optional parameter.

The character string (1-8 characters) to be used in the output to indicate that an ACS routine was not executed (for example, if a prior ACS routine returned a nonzero exit code). The default is the character string NOTRUN.

Default: NOTRUN ( NOTRUN )

Format: Any character string up to eight characters long.

PRINTRO ( yes|no )

Function:

Tip: This is an optional parameter.

Indicates whether all of the ACS read-only variables should be displayed on SYSPRINT prior to the ACS routine results, or just the description, job name, dataset name, program name, and ACS environment.

Default: PRINTRO ( NO )

Format: YES or NO

STORCLAS ( sc_name)

Function:

Tip: This is an optional parameter.

Specifies a storage class name which will be used instead of the storage class (if any) that is present in the test cases. This is the input storage class to the ACS routines and is thus equivalent to specifying the STORCLAS parameter in the JCL.

Default: None

Format: Any valid storage class name

SETDCVARS ( yes|no)

Function:

Tip: This is an optional parameter.

Specifies whether the ACS read-only variables RECORG, DSNTYPE, NVOL, SIZE, and MAXSIZE should be set from the values in the data class that was assigned, if they were not explicitly specified in the testcase. If a data class is assigned at all, and the testcase did not specify a DSORG, then the value of DSORG is set to PS, just as will happen in a normal allocation.

Default: SETDCVARS ( NO )

Format: YES or NO

TRACE ( yes|no)

Function:

Tip: This is an optional parameter.

Indicates whether the ACS routine logic should be traced to the SYSPRINT dataset for each testcase. If TRACE(YES) is specified, it applies to all test cases run, for both CDS1 and CDS2.

Default: TRACE ( NO )

Format: YES or NO

TESTLIB ( dataset_name )

Function:

Important: This is a required parameter unless a //TESTLIB DD statement is present in the JCL.

Indicates the partitioned dataset or PDS containing the test cases.

Default: None

Format: Any valid dataset name

USER ( userid)

Function:

Tip: This is an optional parameter.

Specifies a RACF userid which is to be passed to the ACS routines in the &USER read-only variable. This overrides any userid specified in the testcase.

Default: None

Format: Any valid RACF userid

SYSIN Control Statements - syncsort_allocation_control_center - Latest

Syncsort™ Storage Management Sms/Debug User Guide