The COLU transaction

To run the CICSPlex® SM online utility, log onto a CICS® system that is either a CMAS or a local MAS and enter the following transaction:

COLU  compid  keyword

where:

compid
Is one of the following 3-character component identifiers:
CHE
Data Cache Manager
COM
Communications
KNL
Kernel Linkage
QUE
Queue Manager
SRV
Common Services
TOP
Topology Services
keyword
Is a valid keyword for the specified component. Valid component and keyword combinations are described in the remainder of this chapter.

Valid keywords for component CHE

CACHE
Summarizes the data space usage of each CMAS component. This keyword can be issued only from a CMAS.
LIST
Summarizes the data cache list usage of each CMAS component. This keyword can be issued only from a CMAS.

Figure 18 is an example of the report produced by the CACHE keyword.

Figure 18. Sample CACHE report from COLU
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
                      CPSM 210  DATA CACHE Dataspace Element Summary
  CMAS Name:  CMAS1JB     Date/Time:   2/09/98 06:28:26.40770
    Name       ALET      Start       End       Used
  DMDSJWB1   01FF0013   00000000   00801000   00406E80
  WLM1JWB1   01FF0017   00000000   00400000   000CA000
  RTA1JWB1   01010042   00000000   00400000   00080000
  MON1JWB1   01010041   00000000   00400000   00080000
  TOP1JWB1   01FF0016   00000000   00400000   000A0000
  COM1JWB1   01010040   00000000   00400000   000A0000
  MAS1JWB1   01FF0015   00000000   00400000   000E4000
  DAT1JWB1   0101003F   00000000   00400000   00175000
  QUE1JWB1   01FF0014   00000000   00400000   00108000
 

The CACHE report produced by COLU names the data space for each component of the CMAS and shows its ALET, its location, and the amount of storage used.

Valid keywords for component COM

MALRL
Lists all outstanding message argument lists (MALs) for the CMAS. This keyword can be issued only from a CMAS.
MASRL
Lists all outstanding message argument lists (MALs) for all MASs attached to the CMAS. This keyword can be issued only from a CMAS.
NETOP
Lists the communication network topology as it is known to the CMAS. This keyword can be issued only from a CMAS.

Valid keywords for component KNL

ESSSINFO
Summarizes the resources in use by the Environment Services System Services (ESSS) address space. This keyword can be issued only from a CMAS.

Figure 19 is an example of the report produced by the ESSSINFO keyword.

Figure 19. Sample ESSSINFO report from COLU
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
          CPSM 210  Kernel Linkage CICSPlex SM ESSS Connection Information
  CMAS Name   Job Name   CICS SYSID   MAS Name   Job Name   CICSPlex Name
   CMAS1JB     CVMCJBC    JWB1
   CMAS1C3     CVMTCC3    HTC3         CVMTCT2    CVMTCT2    PLEX1C1
   CMAS1PP     CVMCPPC    PATC         CSYS1PP    CVMCPPM    PLEX1PP
   CMAS1JF     CVMCJFC    CMJF
 
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
          CPSM 210  Kernel Linkage CICSPlex SM ESSS Program Information
  Program Name   Version   Load Point     Date     Time
   EYU9XESS       110       05A00E78    01/28/98   18.01
   EYUTXEPC       110       852A73E0    01/28/98   18.02
   EYU9XEEM       110       855C1D38    02/02/98   03.06
   EYU9XEET       110       8559C958    12/21/97   08.48
 
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
          CPSM 210  Kernel Linkage CICSPlex SM ESSS Resource Usage Information
  Resource Name                         Origin    Length    Number    In Use
  Connected ASID Table Elements        00006D98  0000D214  000001A4  00000006
  Dynamic Work Area Elements           00013FAC  00010014  00000040  00000000
  Lock Manager Resource Queues         0006BFD4  000A0014  00004000  0000031F
  Lock Manager Holder/Waiter Elements  00023FC0  00048014  00002000  00000000
  CICSPlex Name Blocks                 0010BFE8  00003014  00000400  00000004
  Signal Blocks                        0010EFFC  00006014  00000200  00000000
 

The ESSSINFO report produced by COLU provides information about active CMASs and the MASs that are connected to them, the ESSS system programs, and the ESSS resource tables.

Valid keywords for component QUE

ALL
Indicates that all allocated queues should be listed. When ALL is specified, no other keyword is permitted. This keyword can be issued from any CMAS or MAS.
COMPID(xxx)
Is a 3-character CICSPlex SM component ID. This keyword can be issued from any CMAS or MAS.
METH(xxxx)
Is a 4-character CICSPlex SM method name. This keyword can be issued from any CMAS or MAS.
SUM
Causes a summarization report to be generated. In the detailed report, each line describes an allocated queue. This keyword can be issued from any CMAS or MAS.

Figure 20 is an example of the report produced by the ALL keyword.

Figure 20. Sample QUE ALL report from COLU
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
                      CPSM 210  Allocated Queue Resources
    Queue Token     AllcStg  TotRec   Meth MaxRecln Mode Type DbugText
  801B0001 00001060 00008000 00000000 XLNX 00000000 Del  Wait NTFYQUE
  801B0001 00001080 00008000 00000000 XDIN 00000000 Rept Work
  801B0002 000010A0 00008000 00000004 CIIN 00000078 Rept Work EYU0CIIN
  801B0002 000010C0 00008000 00000001 CIIN 00000052 Rept Work EYU0CIIN
  801B0003 000010E0 00008000 00000001 CSSR 00000052 Rept Work COMMDEFS
  801B0002 00001100 00008000 00000000 CWIN 00000000 Del  Wait CWINXQCQ
  801B0001 00001120 00008000 00000000 CPLT 00000000 Del  Wait EYU0CPLT
 

The QUE ALL report produced by COLU provides information about queue resources allocated by the CMAS or MAS, including their location, allocated storage, total number of records, method, maximum record length, mode, type, and text used in debugging.

Valid keywords for component SRV

LOCKS
Dumps the contents of all lock manager control blocks that are local to the CMAS or MAS. This keyword can be issued from any CMAS or MAS.
LOCKSUM
Summarizes the lock manager usage of all locks that are local to the CMAS or MAS. This keyword can be issued from any CMAS or MAS.

Figure 21 is an example of the report produced by the LOCKSUM keyword.

Figure 21. Sample LOCKSUM report from COLU
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
          CPSM 210  Common Services Lock Management Summary
  Resource Queue pool address                        05F55014
  Resource Queue pool size                           00002800  (   10K)
  Total number of Resource Queues                         256
  Number of Resource Queues in use                          5  (  1.9%)
  Resource Holder/Waiter Element pool address        05F57828
  Resource Holder/Waiter Element pool size           00002400  (    9K)
  Total number of Resource Holder/Waiter Elements         256
  Number of Resource Holder/Waiter Elements in use          0  (  0.0%)
 
  CICSPLEX SM 210 CICS/ESA SNAP Utility For JOB CVMCJBC     02/02/01
          CPSM 210  Common Services Lock Management Summary
  Lock 05F59F18  Owner CVMCJBC
  Lock 05E18EA8  Owner CVMCJBC
  Lock 00063228  Owner CVMCJBC
  Lock 00062D28  Owner CVMCJBC
  Lock 05DEA220  Owner CVMCJBC
 

The LOCKSUM report produced by COLU provides information about local locks in use by the CMAS or MAS, including their location, size, and number.

Valid keywords for component TOP

PLEX(plexname [,scope])
Lists the topology of the specified CICSplex as it is known to the CMAS. The optional scope value limits the report to a named CICS system or CICS system group within the CICSplex. This keyword can be issued only from a CMAS.
[[ Contents Previous Page | Next Page Index ]]