Creating a transaction exclude list

A transaction exclude list is a load module that contains a simple list of transaction name prefixes.

About this task

Each list item consists of a 1-byte length field, followed by the characters of the transaction name prefix. The length is the number of characters in the prefix, which must be in the range 1 through 4. A length of zero indicates the end of the list. Figure 1 is an example of a transaction exclude list.
Figure 1. Example transaction exclude list
MYXTRAN  CSECT                                                          
MYXTRAN  AMODE 31                                                       
MYXTRAN  RMODE ANY                                                      
         DS    0F                                                       
         DC    AL1(1),C'C'            Excludes names starting with C    
         DC    AL1(3),C'UCC'          Excludes names starting with UCC  
         DC    AL1(0)                 End of list                       
         END   MYXTRAN                                                  

A sample batch job, CIUJCLXT, is provided to assemble and link-edit the sample transaction exclude list, CIUXTRAN.

Before running the CIUJCLXT 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 transaction 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 transaction exclude list.

  2. To make your customized transaction 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, using the same attributes as those used for CIUXTRAN in the CIUJnnCR sample JCL in the CICS IA load library. In particular, specify RELOAD(NO) on the PROGRAM definition).