Start of change

Creating a command exclude list

A command exclude list is a load module that contains a simple list of command codes and group command codes.

About this task

Each list item consists of a 1-byte length field that contains the length of the command code or the group command code. A CICS® command code or group command code follows the length field. Both codes are in hexadecimal form. The length field is always equal to 2. The Group command code has a zero in the second byte. A length of zero indicates the end of the list.

Figure 1 is an example of a command exclude list.
Figure 1. Example command exclude list
MYXCOMM  CSECT                                                          
MYXCOMM  AMODE 31                                                       
MYXCOMM  RMODE ANY                                                      
         DS    0F                                                       
         DC    AL1(2),X'0802'         Excludes WRITEQ TDQUEUE command    
         DC    AL1(2),X'0804'         Excludes READQ TDQUEUE command 
         DC    AL1(2),X'0C00'         Excludes all commands from group 0C   
         DC    AL1(0)                 End of list                       
         END   MYXCOMM                                                  

A sample batch job, CIUJCLXC, is provided to assemble and link-edit the sample command exclude list, CIUXCOMM.

Before running the CIUJCLXS job, change the following:
  1. The JOB accounting parameters
    Modify the JOB card statement to meet your site standards.
    The PGM keyword of the EXEC statement of the ASM step
    Insert the name of the assembler to use.
    The SYSIN DD statement
    Specify the name of the assembler language source library where your exclude list is to be found. The default is hlq.SCIUSRCE, where "hlq" is the data set qualifier assigned during installation.

    Change the member name to the name of your own command exclude list.

    The SYSLMOD DD statement
    Specify the name of the CICS IA load library where the exclude list is to be placed. The default is hlq.SCIULOAD, where "hlq" is the data set qualifier assigned during installation.

    Change the member name to the name of your own command exclude list.

  2. To make your customized command exclude list available to the Collector:
    1. Place the generated load module in a load library concatenated with DDNAME DFHRPL.
    2. Define the generated load module to CICS, by using the same attributes as those used for CIUXCOMM in the CIUJnnCR sample JCL in the CICS IA load library. In particular, specify RELOAD(NO) on the PROGRAM definition).
End of change