IBM Transaction Server OS User Manual
Page 27
Commands detected by the Transaction Affinities Utility
You can use the Transaction Affinities Utility to detect instances of the EXEC CICS
commands listed in Table 1.
Table 1. Commands detected by the Transaction Affinities Utility
Inter-transaction affinity commands
Transaction-system affinity commands
ENQ
DEQ
READQ TS
WRITEQ TS
DELETEQ TS
ADDRESS CWA
LOAD
RELEASE
GETMAIN SHARED
FREEMAIN
RETRIEVE WAIT
DELAY
POST
START
CANCEL
COLLECT STATISTICS
ENABLE PROGRAM
DISABLE PROGRAM
EXTRACT EXIT
INQUIRE
SET
PERFORM
RESYNC
DISCARD
CREATE
WAIT EXTERNAL
WAIT EVENT
WAITCICS
CBTS STARTBROWSE
CBTS GETNEXT
CBTS ENDBROWSE
Notes:
1. The Scanner may detect some instances of these commands that do not cause
an affinity. For example, all FREEMAIN commands are detected but only those
used to free GETMAIN SHARED storage may cause affinity.
2. The Scanner also detects MVS POST SVC calls and MVS POST
LINKAGE=SYSTEM non-SVC calls, because of their tie-up with the various
EXEC CICS WAIT commands.
3. The Transaction Affinities Utility does not search for transient data and file
control EXEC CICS commands. They are assumed not to cause affinity
because you can define transient data and file control resources as remote (in
which case the request is function-shipped, causing no affinity problem).
4. The Detector ignores commands that target remote resources and are function
shipped, because by function shipping the command there is no affinity problem.
5. The Scanner and Detector do not search for commands issued by any program
named CAUxxxxx or DFHxxxxx, because CICS programs are not considered
part of the workload. Also, the Detector does not search for commands issued
from:
v
DB2® and DBCTL task-related user exits
v
User-replaceable modules
6. There are other ways in which transactions can cause affinity with each other,
but they are not readily detectable by the affinity utility program because they do
not take place via the EXEC CICS API.
7. The Detector lists WAIT commands as transaction-system affinities because
only half of the affinity can be detected. (The Detector does not detect MVS
POST calls or the hand posting of ECBs.)
8. The Detector and the Report ignore ENQ and DEQ commands that specify an
ENQSCOPE name.
Chapter 2. Introducing the Transaction Affinities Utility
11
|
|