Creating a program exclude list

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

About this task

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

Running the sample batch job CIUJCLXP

Procedure

  1. A sample batch job, CIUJCLXP, is provided to assemble and link-edit the sample program exclude list, CIUXPROG. Before running the CIUJCLXP job, change the following:
    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 program 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 program exclude list.

  2. To make the exclude list from your customized program 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 CIUXPROG in the CIUJnnCR sample JCL in the CICS IA load library. In particular, specify RELOAD(NO) on the PROGRAM definition.