COMCHECK subcommand — analyze communications task data

Use the COMCHECK subcommand to generate reports about the attributes and status of the communications task (COMMTASK) at the time of a dump. You can request information for the following:

MCS consoles
Extended MCS consoles
System console
Subsystem console
SMCS console
Device independent display operator console support (DIDOCS) resident display control modules (RDCM)
DIDOCS pageable display control modules (TDCM)
Message queues and console management

You can select information for one or all MCS consoles and RDCM, TDCM, and UCME control blocks. You can request the addresses of control blocks or formatting of the blocks.

See z/OS MVS Diagnosis: Reference for examples of COMCHECK reports and more information about diagnosing problems with communications task.

Syntax

  { COMCHECK | COMK }

-------- Report Type Parameters ----------------------------

             [ MCSINFO                              ]
             [ DATABLKS[( LIST | address )]         ]
             [ LISTNAMES(keyname)                   ]
             [ NAME(nnnnnnnn) | ID(iiiiiiii)        ]
             [ NAMELIST                             ]
             [ RDCM[( ALL | LIST | address )]       ]
             [ SBC                                  ]
             [ SYSCONS                              ]
             [ SYSPLEX[( CNTRLMEM | SYSMEM )]       ]
             [ TDCM[( ALL | LIST | address )]       ]
             [ UCM                                  ]
             [ UCME[( ALL | LIST | address )]       ]
             [ UPDATES[( ALL | LIST | address )]    ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

             [ ACTIVE | MAIN | STORAGE          ]
             [ DSNAME(dsname) | DATASET(dsname) ]
             [ FILE(ddname) | DDNAME(ddname)    ]
             [ PATH(path-name)     ]
             [ FLAG(severity) ]
             [ PRINT | NOPRINT ]
             [ TERMINAL | NOTERMINAL ]
             [ TEST | NOTEST ]

Report type parameters
Use these parameters to select the type of report. Specify only one. If you omit a report type parameter, the default is MCSINFO.
MCSINFO
Requests summary communications task information for console activity. MCSINFO analyzes the control blocks used to queue messages and manage consoles. MCSINFO produces the following statistics:
- The number of queued messages in the system at the time of the dump.
- The WTO limit (MLIM) in the dumped system.
- The number of messages that are queued to each console.
- Pending WTOR messages.
MCSINFO is the default when COMCHECK is specified without any other parameters.
DATABLKS[(LIST | address)]

Requests summary information that the IBM® Support Center might request for problem determination.

ID(iiiiiiii)

Requests summary information for a console. Specify the console's 4-byte ID assigned by the system.

LISTNAMES(keyname)

Requests a list of extended MCS console names defined to a 1- to 8-character keyname.

NAME(nnnnnnnn)

Requests summary information for a console. Specify the console's 2- to 8-character symbolic name.

NAMELIST

Requests a list of all console names defined in a sysplex.

RDCM[(ALL | LIST | address)]

Requests summary control block information for RDCMs.
ALL

Gives the status of all active and defined RDCMs.

LIST

Lists the address of each RDCM in the dump.

address

Gives the status of one RDCM at the specified address.

SBC

Requests information about the delayed issue queue and additional information that the IBM Support Center might request for problem determination. It formats the supplemental branch entry console control block (SBC).

SYSCONS
Requests information about the status of the system console, including:
- The console name and ID
- The console's attributes
- The console's availability
- Message suppression for the console
SYSPLEX[(CNTRLMEM | SYSMEM)]

Requests summary information for the members of the sysplex. SYSPLEX with no delimiter prints the current number of sysplex members, the maximum number of members allowed in this sysplex, and additional information the IBM Support Center might request for problem determination.
CNTRLMEM

Requests information for each sysplex control member that the IBM Support Center might request for problem determination.

SYSMEM

Requests the names of the systems defined to the sysplex and additional information the IBM Support Center might request for problem determination.

TDCM[(ALL | LIST | address)]

Requests summary control block information for TDCMs.
ALL

Gives the status of all active and defined TDCMs.

LIST

Lists the status of each TDCM in the dump.

address

Gives the status of one TDCM at the specified address.

UCM

Requests summary control block information for the unit control module (UCM) base, prefix, and extension.

UCME[(ALL | LIST | address)]

Requests the status of an MCS, SMCS, or subsystem console at the time of the dump. It formats the unit control module individual device entries (UCMEs).
ALL

Gives the status of all active and defined MCS, SMCS, and subsystem consoles. It formats all console information.

LIST

Lists the address of each UCME in the dump.

address

Gives the status of one MCS, SMCS, or subsystem console. It formats the UCME at the specified address.

UPDATES[(ALL | LIST | address)]

Requests summary information that IBM might request for problem determination.
Return codes
See Standard subcommand return codes for a description of the return codes produced by the COMCHECK subcommand.
Example: Find the status of an MCS console at the time of a dump.
- First Action
  Obtain a list of UCME addresses by entering on the command line:
```
COMMAND ===>  COMCHECK UCME
```
- Result
  COMCHECK produces a list of UCME addresses, similar to the example in Figure 1.
  Figure 1. Example COMCHECK command output (obtain UCME addresses)
```
                    COMMUNICATION TASK ANALYSIS

               ADDRESS OF ALL ACTIVE UCMES ON SY1

CONSOLE NAME   ADDRESS   TYPE
------------   -------   ----
MCSY13E0       00FD64C0  MCS
MCSY13D1       00FD6510  MCS
MCSY13D2       00FD6560  MCS
SUBSYS2        00FDFBEC  SUBSYSTEM
```
- Second Action
  To look at the UCME at address 00FD64C0, enter on the command line:
```
COMMAND ===>  COMCHECK UCME(00FD64C0)
```
- Result
  COMCHECK produces a report for the MCS console represented by that UCME. z/OS MVS Diagnosis: Reference shows a sample UCME report and explains the contents of the fields.