Subtask commands to TEP Data Collection

You can issue specific subtask commands to the TEP Data Collection. The subtask commands must be preceded by the MODIFY command.

Specific subtask commands are:

MODIFY command

Issues a subcommand to the COMMCOLL subtask.

F cccccccc,F COMMCOLL,option

where:

cccccccc is the started task name that you specify for the OMEGAMON® Collector during the configuration within the Configuration Tool
option is the task that the COMMCOLL subtask should perform

option can be one of the following:

CONNECTIONS: Displays the active Agent connections to Db2 subsystems that are created by the D5API collector on behalf of the Agent.
STIMER: Changes the D5API collect interval value.
REGISTRY: Displays the internal contents of the D5API registration table.
TRACE=NO: Removes additional D5API collector write-to-operator (WTO) messages in the joblog of the server address space.
TRACE=YES: Displays additional D5API collector write-to-operator (WTO) messages in the joblog of the server address space.
TRACEALL: Displays the internal contents of the D5API trace table.
STATUS: Displays the status of the D5API.

This example shows how the D5API collect interval is changed.

F D2DBnnn,F COMMCOLL,STIMER=hhmmssth

F D2DB046,F COMMCOLL,STIMER=00001000
CI0760: PROCESSING COMMAND 
CI0720: PROCESS MESSAGES FOLLOW 
D53101I COMMCOLL MODIFY PROCESSING IN PROGRESS 
CI0551: MODIFY MESSAGE SENT TO TASK 
D53113I STIMER WAIT VALUE SUCCESSFULLY CHANGED 
CI0700: IBM COMMON INTERFACE READY FOR COMMANDS

This example shows how the contents of the D5API registration table are displayed.

The registration table (REGISTRY) contains registration entries (RTBEs) for every OMEGAMON Collector instance running on an MVS image.

F D2DBnnn,F COMMCOLL,REGISTRY

D53101I COMMCOLL MODIFY PROCESSING IN PROGRESS 
D53106I COMMON COLLECTOR REGISTRATION DATA DISPLAY 
REGISTRY: ACTIVE=00000002 CONNECTED=00000002 MAX=00000040 
RTBE=0F203070 D2=D2DB058 D5APIUSE=10BC82C8 STATUS=ACTIVE 
RTBE DATA: FLGS=80000000 ATTACH=0001 DETACH=0001 STIMER=00001500 
RTBE=0F203090 D2=D2DB046 D5APIUSE=10BC8220 STATUS=ACTIVE 
RTBE DATA: FLGS=80000000 ATTACH=0000 DETACH=0000 STIMER=00001500

If the module KO2AINIB is attached to any Db2 address space, the KO2AINIB registration routine adds an RTBE entry to the registration table. The RTBE contains the JOB/STC name of the Db2 address space and the address of the D5API communication control table and other information.

This list describes the RTB fields:

ACTIVE: The active number of number of connections
CONNECTED: The number of connected D2 address spaces
MAX: The maximum number of D2 address spaces supported

This list describes the RTBE fields:

RTBE: The registration table entry address within the RTB
D2: The registration entry owning D2 address space
D5APIUSE: The D5API common control table address
STATUS: The status of the D5API in the D2 address space
FLAGS: The status of the RTBE entry x'80' in use, x'00' available' Other flags currently 000000
ATTACH: The number of times the D5API has attached KO2ACONB
DETACH: The number of times the D5API has detached KO2ACONB
STIMER: The elapsed interval value in the format of hhmmssth that a collect call can consume

This example shows how the internal contents of the D5API trace table are changed.

F D2DBnnn,F COMMCOLL,TRACEALL

D53101I COMMCOLL MODIFY PROCESSING IN PROGRESS 
D53107I COMMON COLLECTOR TRACE TABLE DISPLAY 
MOD=AINI TID=BLDCCPC CID=0000 PCTB=0F9573C0 PCN=00008E00 
MOD=AINI TID=WAITD2 CID=0000 SUSE=10BC8220 
MOD=AINI TID=WAITD120 CID=0000 CECB=48000000 
MOD=AINI TID=WAITD2 CID=0000 SUSE=10BC8220 
MOD=AINI TID=CONNECT CID=0000 COMM=8ED364D8 SUSE=10BC8220 
MOD=AINI TID=ACON200 CID=0000 SASN=000000CD KEY=00000070 DB2=D71D MROW=000000FA 
MOD=AINI TID=POSTD2I CID=0000 COMM=8ED364D8 SUSE=10BC8220 
MOD=AINI TID=APIPOST CID=0000 ECB =40000000 
MOD=AINI TID=POSTIND2 CID=0000 POST=00000001 COMM=8ED364D8 
MOD=AINI TID=ATCHD2 CID=0000 COMM=8ED364D8 DB2=D71D 
MOD=AINI TID=WAITD2 CID=0000 SUSE=10BC8220 
MOD=ACON TID=ATCHACON CID=0001 COMM=8ED364D8 TCB=007DF810 
MOD=ACON TID=INITD2 CID=0000 COMM=8ED364D8 DB2=D71D 
MOD=ACON TID=INITD2C CID=0000 COMM=8ED364D8 RC=00000000 
MOD=ACON TID=WAITD2 CID=0001 COMM=8ED364D8 TCB=007DF810 
MOD=AINI TID=COLLECT CID=0000 COMM=8ED364D8 SUSE=10BC8220 
MOD=AINI TID=POSTD2C CID=0000 COMM=8ED364D8 SUSE=10BC8220 
MOD=ACON TID=POSTACON CID=0000 COMM=8ED364D8 POST=00000003 
MOD=ACON TID=CALLD2 CID=0001 TABL=REALTHDA THDA=00000000
MOD=ACON TID=CALLD2C CID=0001 RC=00000000 ADDR=00000080 
MOD=ACON TID=WAITD2 CID=0001 COMM=8ED364D8 TCB=007DF810 
MOD=AINI TID=WAITD120 CID=0000 CECB=48000000 
MOD=AINI TID=WAITD2 CID=0000 SUSE=10BC8220 
MOD=AINI TID=WAITD120 CID=0000 CECB=48000000

This example shows how the status of the D5API is displayed.

F D2DBnnn,F COMMCOLL,STATUS

D53101I COMMCOLL MODIFY PROCESSING IN PROGRESS 
D53105I COMMON COLLECTOR STATUS DISPLAY 
RTBE=0F203090 D5APIUSE=10BC8220 STATUS=ACTIVE TRACE=YES STIMER=00001500
COLLECT COUNT= 000001 
AGENT SUMMARY: 
DAPICOMM JOBNAME TCBADDR COMPCODE API ECB TERMECB CALL RC POST ID DB2 
8ED364D8 _D2DB000 007DF810 00000000 406DE5F3 F1F0FB08 2DB 00 F1 40 CALL 
RTBE DATA: FLGS=80000000 ATTACH=0001 DETACH=0001 STIMER=00001500