
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:
-
- 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.
- To make your customized command exclude list available to the Collector:
- Place the generated load module in a load library concatenated with DDNAME DFHRPL.
- 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).
