Start of change

Creating a TRUE include list

A TRUE include list is a load module that contains a simple list of TRUE names and names of the products, which use these TRUEs.

About this task

Each list item consists of a 1-byte length field, followed by the characters of the TRUE name and name of the product, which matches this TRUE. The length consists of the number of characters in the TRUE name, which must be in the range 1 through 8, and the number of characters in the corresponding product information, which is 50 characters or more. A length of zero indicates the end of the list. Figure 1 is an example of a TRUE include list.
Figure 1. Example TRUE include list
MYXITTB  CSECT                                                          
MYXITTB  AMODE 31                                                       
MYXITTB  RMODE ANY                                                      
         DS    0F                                                       
         DC    AL1(8),C'TEST    '     Includes TRUE called TEST   
         DC    AL1(4),C'TEST'         Includes names starting with TEST 
         DC    AL1(3),C'UCC'          Includes names starting with UCC  
         DC    AL1(0)                 End of list                       
         END   MYXITTB                                                 

Running the sample batch job CIUJCLTR

Procedure

  1. A sample batch job, CIUJCLTR, is provided to assemble and link-edit the sample TRUE include list, CIUXITTB. Before running the CIUJCLTR 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 include 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 TRUE include list.

    The SYSLMOD DD statement
    Specify the name of the CICS® IA load library where the include 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 TRUE include list.

  2. To make your customized TRUE include 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 CIUXITTB in Start of changethe CIUDEFTEnd of change sample JCL in the CICS IA load library. In particular, specify RELOAD(NO) on the PROGRAM definition.
End of change