Utilities › CTSPMTST Utility—Validate Pattern Definitions › Report Description › Job Control Statements

Job Control Statements

//CTSPMTST EXEC PGM=CTSPMTST,PARM='verb,class'
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//SYSPRINT DD  SYSOUT=A
//SYSPATT  DD  *
(control statements here)
/*
//SYSOBJ   DD  *                                                *NOTE
(control statements here)
/*

Note: The SYSOBJ DD statement is not required if the verb specified is VALIDATE.

Parameter Definitions

verb

Possible values for verb are:

COMPARE

Compares two patterns and indicates whether the first pattern (SYSPATT DD) is the same, more specific, or less specific than the second pattern (SYSOBJ DD).

VALIDATE

Tests structure and syntax and reports on the validity of the patterns pointed to by the SYSPATT DD. This parameter does not use the SYSOBJ DD.

MATCH

Matches patterns from the SYSPATT DD against objects from the SYSOBJ DD and reports the results.

class

Indicates the object class of the patterns and objects to be processed. These classes define the characteristics of the objects to be matched. Possible values for class are:

MVSFILE

MVS 44-character data set name. This class is nodal and uses the period as a node separator.

MVSJOB

Any standard 8-byte name that can be found in the JCL. This applies to step name, program name, unit name, ddname, and job name. This class is nodeless.

JCL Considerations

SYSPATT DD

Points to one or more patterns used in processing the action requested with the verb parameter. Comment can be used in either the SYSPATT or SYSOBJ file by placing "**" in columns 1 and 2.

SYSOBJ DD

When the COMPARE verb is specified, this DD defines one or more patterns which are compared to the patterns defined in SYSPATT to determine which patterns are more specific.

When the MATCH verb is specified, this DD specifies a list of objects to be matched to the patterns specified in the SYSPATT DD. Each object specified in the SYSOBJ DD is compared to each pattern specified in the SYSPATT DD.

This DD is not used when the VALIDATE verb is specified. It is ignored if provided.

Examples:

Example 1 program names or data set names to identify which EDM is to be assigned. If you plan to use job names to assign the EDM and would like to test the match processing before implementing the rules, execute CTSPMTST with the MATCH,MVSJOB parameter as in the following example. Note that if program name or DD statement were to be tested that the MATCH,MVSJOB parameter would also be used.

//STEP1    EXEC PGM=CTSPMTST,PARM='MATCH,MVSJOB'
//STEPLIB  DD DSN=CAI.CTAPLINK,DISP=SHR
//SYSPRINT DD SYSOUT=A
//SYSPATT  DD *
MFG!!###
/*
//SYSOBJ   DD *
MFGAA000
MFGA000
MFGAA00
MFGZZ000
MFGZZ999
MFGZZ00A
/*
//

Each test job name specified in the SYSOBJ DD is compared to the pattern specified in the SYSPATT DD and the results of the match are reported. The results of executing this job are displayed in Sample Output - Example 1 below.