Controlling Collector performance

Global user exits are used by CICS® IA to collect resource dependencies.

Table 1 shows the global user exits used by CICS IA to collect resource dependencies.
Table 1. Global user exits used by CICS IA to collect resource dependencies
CICS commands
Type of command Exit point
File Control. See Note. XFCREQC
File Data. See Note. XFCSREQC
Program Data. See Note. XPCFTCH
Transaction Data. See Note. XPCFTCH
Interval Control. See Note. XICEREQC
EXEC CICS LINK. XPCREQC
Transient Data. See Note. XTDEREQC
Temporary Storage Data. See Note. XTSEREQC
All other EXEC CICS commands listed in Details of dependencies and affinities collected that are not in one of the above categories. XEIIN and XEIOUT
Note: For a list of the EXEC CICS commands that can be monitored by the Collector, categorized by CICS domain, that is, File Control, Interval Control, Transient Data, Temporary Storage, and others, see Details of dependencies and affinities collected.
NON-CICS commands
Type of command Exit point
DB2®: EXEC SQL XRMIOUT
IMS™: EXEC DLI XRMIOUT
IMS: CBLTDLI, ASMTDLI and PLITDLI XDLIPOST
MQ: MQM XRMIIN and XRMIOUT
Natural: ADABAS CALLS and NATURAL PROGRAM CALLS XRMIOUT and task-related user exit program
Note: If you specify that any subset of Natural commands are to be monitored, both the CICS IA XRMIOUT exit program and task-related user exit program are called for each monitored Natural command.
Table 2 shows the global and task-related user exits used by CICS IA to collect transaction affinities.
Table 2. Global and task-related user exits used by CICS IA to collect transaction affinities
CICS commands
Type of affinity information collected Exit point
Updates affinity lifetime information with Business Transaction Services (BTS) activity and process information. XBADEACT
Intercepts the intertransaction and transaction-system commands that might cause affinities. XEIOUT
From CICS TS for z/OS® V2.2 onwards, updates affinity lifetime information with LINK3270 information. XFAINTU
Intercepts the expiration of interval control elements (ICEs) and thus deduces which affinity table elements can be deleted because they are no longer of interest. XICEXP
Intercepts certain CICS "DFH" messages to detect terminal logoff and user signoff and thus deduce whether affinity lifetimes are of type LOGON or SIGNON. XMEOUT
Runs at the start and end of the user task. Its purpose is to intercept the end of pseudoconversations and thus deduce whether affinity lifetimes are of type PCONV. Task-related user exit program
Start of changeTable 3 shows the global and task-related user exits used by CICS IA to collect Command Flow data.
Table 3. Global and task-related user exits used by CICS IA to collect Command Flow data
CICS commands
Type of command Exit name Exit program
EXEC CICS LINK XEIIN CIUXACO3
EXEC CICS command XEIOUT CIUXACO2
DB2, IMS, MQ calls XRMIIN CIUXACR3
XRMIOUT CIUXACR2
START of task TRUE CIUXACT1
End of change
Notes:

The invocation of a global user exit program imposes an overhead on each affected command. Applications that issue many affected commands with little other processing will notice the greatest percentage increase in pathlength. Clearly, the Collector will impact the performance of the region on which it is running.

To optimize the performance of the Collector:

For information about how to control these options, see Changing the Collector options.