Creating a resource prefix list

A resource prefix list is a load module that contains a simple list of TSQueue and ENQ/DEQ resource name prefixes that helps to avoid collecting unnecessary information. You can use the provided sample batch job to create the edit the sample resource prefix list.

About this task

Each list item consists of a 1-byte length field, followed by the characters of the resource name prefix. The length is the number of characters in the prefix, which must be in the range 1 - 32. A length of zero indicates the end of the list. Figure 1 is an example of a resource name prefix list.
Figure 1. Example resource name prefix list
CIUPFXTB CSECT              
CIUPFXTB AMODE 31           
CIUPFXTB RMODE ANY          
         DS 0F                       
 Add user prefixes here    
         DC AL1(4),C'TEST'         Example 
 Predefined prefixes       
         DC AL1(3),C'DFH' CICS 
         DC AL1(0)                 End of list 
         END CIUPFXTB 

Procedure

  1. A sample batch job, CIUJCLPL, is provided to assemble and link-edit the sample resource prefix list, CIUPFXTB. Before running the CIUJCLPL 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 resource prefix 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 resource prefix list.

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

  2. To make your customized resource prefix 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 CIUPFXTB in the CIUDEFT sample JCL in the CICS IA load library. In particular, specify RELOAD(NO) on the PROGRAM definition.

Task Task

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ciuug99.html