Installation Options › CA JCLCheck Macros › The $J6PCB Macro

The $J6PCB Macro

This macro defines a parameter. It provides a name for the parameter (keyword for keyword parameters and eight-character name used in messages for positional parameters). It points either to a $PTB macro describing the subparameters or to a $VTB macro describing the parameter's valid values.

$J6PCB NAME=parameter-name
       -FLAG=name of byte in XJB-         |-XFLAG=name of byte in XJB-
       -BIT=name of bit within flag-byte- |-XBIT=name of bits within xflg-byte-
       -EXCL=(bits1,bits2,bits3,bits4)-   |-XEXCL=(bits,flag-byte)-
       [REQ=NO|YES]
       -PTB=dtb-name-
       -VTB=vtb-name-

NAME

Parameter name to use in all messages about the parameter.

This is a one- to eight-character alphanumeric name.

When using this name in a keyword table, make it identical to the keyword used in the JCL. Specify this parameter as a list of names enclosed in parentheses and use it to define multiple PCBs with identical requirements. This is particularly useful in defining keyword operand values (see the LAST parameter of the $KTB, $PTB, and $VERBTBL macros).

FLAG|XFLAG

Required parameter if you specify BIT and specifies the name of a byte in the XJB containing a bit that is set when CA JCLCheck encounters this parameter.

Specify the name of the bit in the BIT parameter. Use XFLAG if you use the XEXCL parameter.

BIT|XBIT

CA JCLCheck requires this parameter if you use FLAG and specifies the name of a bit that is in the XJB and is set when CA JCLCheck encounters this parameter.

Specify the name of the byte containing the bit in the FLAG parameter. Use XBIT if you use the XEXCL parameter.

EXCL

Specifies the parameters that are mutually exclusive with this one.

Define this specification as four bit masks, which are tested against the fields XJBxFLG1, XJBxFLG2, XJBxFLG3, and XJBxFLG4 (where x signifies the statement type: J=JOB, E=EXEC, D=DD, O=/*OUTPUT, P=/*JOBPARM). Use XEXCL if the bit that needs testing is outside these four bytes.

XEXCL

Specifies parameters that are mutually exclusive with this parameter.

The bit specification is given one or more bits which are tested against a single specified flag byte. The flag byte can exist in an XJB, global, or extended global. You can repeat the bit, byte combination without restriction. If you use XEXCL, you must also use XBIT and XFLAG, instead of BIT and FLAG.

REQ

Specifies whether CA JCLCheck requires the parameter.

If you specify REQ=YES and you omit the parameter, this causes CA JCLCheck to generate the CAY6036E error message. You can only code the required parameter for positional parameters.

Default: NO

PTB

Required parameter if you do not specify VTB and names the $PTB macro describing the subparameters.

PTB is mutually exclusive with the VTB parameter. It allows the parameter's operand to contain subparameters.

VTB

Required only if you do not specify PTB and specifies the parameter's operand as a single value without subparameters.

VTB names the $VTB macro describing the value. It is mutually exclusive with the PTB parameter.

Note: Assemble defaults: Use the $JCLXJB macro to list the names of valid bits and bytes in XJB as follows:

$JCLXJB TYPE=ALL (instruction to map XJB fields)