COMCHECK UCME subcommand output

The COMCHECK UCME subcommand gives the status of an MCS, SMCS, or a subsystem console at the time of the dump. It formats the unit control module individual device entries (UCME).

To obtain the status for an MCS or SMCS console, you must first find the address of its associated UCME. Use COMCHECK UCME(LIST) to find the addresses of all UCMEs in the dump. Choose an address from the list and use COMCHECK UCME(address) to format the UCME at that address.

If you want to view the status of all MCS or SMCS consoles in the dump, use COMCHECK UCME(ALL).

The following is an example of a report generated with COMCHECK UCME(address):

                   COMMUNICATION TASK ANALYSIS

                        CONSOLE INFORMATION

CONSOLE DATA
  NAME:                        MCSY13E0
  CONSOLE ID:                  00000001
  CONSOLE TYPE:                MCS
  USERID IF LOGGED ON:         N/A
  CONSOLE LOGON SETTING:       OPTIONAL
  DEVICE NUMBER:               03E0
  UCB ADDRESS:                 00F07968
  UCME ADDRESS:                00FDB084
  CDU ADDRESS:                 00000000
  SYSTEM NAME:                 SY1
  NUMBER OF MESSAGES QUEUED:   0
CONSOLE ATTRIBUTES
  STATUS:                      ACTIVE
  AUTHORITY:                   MASTER
  MESSAGE FORMAT:              SYSNAME
  MESSAGE TYPE:                NONE
  MESSAGE LEVEL:               WTOR
                               IMMEDIATE ACTION
                               CRITICAL EVENTUAL ACTION
                               EVENTUAL ACTION
                               INFORMATIONAL
                               BROADCAST
  CONSOLE USE:                 DISPLAY CONSOLE
                               FULL I/O CAPABILITY
  CONVERSATIONAL MODE:         NO
  ATTRIBUTES ASSIGNED BY SYS:  NO
  MESSAGE DELETION MODE:       ROLL DELETABLE
  MESSAGE ROLL TIME(SECONDS):  1/4
  MESSAGE ROLL NUMBER(LINES):  25
  MESSAGE SEGMENTATION(LINES): 43
  NUMBER OF ROWS ON SCREEN:    90
  NUMBER OF COLUMNS ON SCREEN: 90
  PFK SUFFIX IN PARMLIB:       N/A
  PFK TABLE NAME:              01
  CMDSYS:                      SY1
  SYSTEM FOR ACTIVATION:       SY1
  INACTIVITY TIMEOUT (MINUTES):5
  ROUTING CODES:               1-128
  CONSOLE AREA:                Z,A
  MSCOPE LIST:                *ALL

In this example, X'00FD63D0' is the address of the UCME. COMCHECK UCME(00FD63D0) is the correct syntax used to obtain this report.

The following fields appear in the report:

NAME

The console name defined in the CONSOLxx parmlib member at system initialization. If no name was specified, the console identifier appears in this field.

CONSOLE ID

A 4-byte identifier that the system assigns to the console at system initialization.

CONSOLE TYPE

Indicates the type of console. Possible values include:

MCS: Indicates that this is an MCS console.
SMCS: Indicates that this is an SMCS console.
MCS/PRT: Indicates that this is an MCS printer console.
SUBSYSTEM: Indicates that this is a subsystem console.

USERID IF LOGGED ON

If an operator has logged on to the console with a user ID, the user ID is displayed. If the console was not logged on or does not support the logon function, N/A is displayed. End of change

CONSOLE LOGON SETTING

Indicates the LOGON attribute of the console if one was specified.

DEVICE NUMBER

The device number for the console; it is specified in the CONSOLxx parmlib member.

UCB ADDRESS

The address of the unit control block (UCB), a storage area that describes the characteristics of a device to the operating system. This is only shown for MCS, MCS/PRT, and Subsystem consoles.

UCME ADDRESS

The address of the unit control module entry (UCME), which contains console-related information.

CDU ADDRESS

The address of the console definition UCME, which contains console-related information.

SYSTEM NAME

The name of the system on which the console was active when the dump was written.

NUMBER OF MESSAGES QUEUED

The number of messages waiting to be displayed on the console at the time the dump was written.

STATUS

One of the following:

ACTIVE: The device is currently active on the system.
INACTIVE: The device is currently inactive on the system.

AUTHORITY

The command group assigned to the console, as follows:

INFO: Informational commands.
SYS: System control commands.
I/O: Input/output (I/O) control commands.
CONS: Console control commands.
ALL: All command authority. This includes SYS, I/O, and CONS authority.
MASTER: Master authority commands.

MESSAGE FORMAT

The information that will accompany a message when it is displayed on this console, as follows:

TIMESTAMP: A time stamp, in the format hh.mm.ss
JOBNAME/JOBID: The name or identifier of the job issuing the message.
SYSNAME: The name of the system issuing the message.
NOSYSJB: All information except the system and job names.
MESSAGE: Only the message text is displayed.

MESSAGE TYPE

Indicates the type of information that is continually displayed at this console, as follows:

JOBNAME: The job name or job identifier when the job starts and ends.
STATUS: Displays data set names and volume serial numbers when they are free, with dispositions of keep, catalog, and uncatalog.
SESSION: Displays the user identifier for each time sharing terminal when a Time Sharing Option Extensions (TSO/E) session starts and ends.
TIME: Displays the time along with the job name and session; the time is displayed in hh.mm.ss format.
NONE: Displays none of the above information.

MESSAGE LEVEL

Lists the message level options specified in the CONSOLxx parmlib member or in the CONTROL command, as follows:

WTOR: Console displays write to operator (WTOR) messages
IMMEDIATE ACTION: Console displays immediate action messages
CRITICAL EVENTUAL ACTION: Console displays critical eventual action messages
EVENTUAL ACTION: Console displays eventual action messages
INFORMATIONAL: Console displays informational messages
BROADCAST: Console displays broadcast messages
NONE: Console displays only messages specifically directed to the console and command responses.

CONSOLE USE

The mode in which the multiple console support (MCS) console is operating, which is one of the following:

FULL I/O CAPABILITY: The console can receive input, display output, accept commands, and receive status displays and messages.
STATUS DISPLAY ONLY: The console cannot accept commands; the system uses the screen to receive status displays.
MESSAGE STREAM ONLY: The console cannot accept commands; the system uses the screen to present general messages.

CONVERSATIONAL MODE

One of the following:

YES: Conversational message deletion is in effect. The system allows you to verify a request to delete a message before deleting it from the screen.
NO: Non-conversational message deletion is in effect. The system immediately deletes messages from the screen when you enter a deletion request.

MESSAGE DELETION MODE

One of the following:

AUTOMATIC: The system deletes certain messages from the screen automatically whenever the message area is full and messages are waiting to be displayed.
MANUAL: The system deletes messages from the screen when you issue a deletion request. All messages waiting to be displayed remain in a queue.
ROLL: Roll mode is in effect. A specified number of messages (the value of RNUM in CONSOLxx) roll off the screen at a specified time interval (the value of RTME in CONSOLxx).
ROLL DELETABLE: The same as roll mode, except that action messages accumulate at the top of the screen.
WRAP: The same as roll mode, except that new messages overlay old messages at the top of the screen when the screen is full. An on-screen separator line identifies the oldest and newest messages.

MESSAGE ROLL TIME (SECONDS)

The time interval between message rolls. The value in this field can be 1/4, 1/2, or any decimal number from one to 999.

MESSAGE ROLL NUMBER (LINES)

The maximum number of lines included in one message roll.

MESSAGE SEGMENTATION (LINES)

The number of lines in the message area that will be deleted when the operator enters the CONTROL E, SEG command.

NUMBER OF ROWS ON SCREEN

Indicates the number of rows on the screen. N/A may be displayed for an inactive console.

NUMBER OF COLUMNS ON SCREEN

Indicates the number of columns on the screen. N/A may be displayed for an inactive console.

PFK SUFFIX IN PARMLIB

The parmlib member that contains definitions for one or more program function key (PFK) tables.

PFK TABLE NAME

The name of the program function key (PFK) table that contains the PFK definitions assigned to this console.

CMDSYS

The name of the system that runs the commands entered from this console.

DEV IN MIDDLE OF BRACKETS

For an SMCS console, indicates that the console was in the middle of brackets. This is only displayed for SMCS consoles.

SMCS CONSOLE ALLOCATED

For an SMCS console, this indicates that the UCME was allocated by SMCS on any system in the sysplex. This is only displayed for SMCS consoles.

SMCS CONSOLE ACTIVE ON THIS SYS

For an SMCS console, this indicates that the UCME was allocated by SMCS on this system. This is only displayed for SMCS consoles.

SMCS CONSOLE LU TYPE

This is only displayed for SMCS consoles. For an SMCS console, possible values include:

LU0: Indicates that LU 0 protocol is being used for this console.
LU2: Indicates that LU 2 protocol is being used for this console.
N/A: Indicates that this console is not active.

SMCS CLEAN-UP IN PROGRESS

For an SMCS console, indicates if the SMCS console was being cleaned up at the time of the dump. This is only displayed for SMCS consoles.

SMCS NIB ADDRESS

For an SMCS console, indicates the address of the NIB control block that is used for this console. This is only displayed for SMCS consoles.

SMCS LPAB ADDRESS

For an SMCS console, indicates the address of the LPAB control block for this console. This is only displayed for SMCS consoles.

SMCS SEND RPL ADDRESS

For an SMCS console, indicates the address of the SEND RPL for this console. This is only displayed for SMCS consoles.

SMCS RECEIVE RPL ADDRESS

For an SMCS console, indicates the address of the RECEIVE RPL for this console. This is only displayed for SMCS consoles.

SMCS COMMUNICATION ID

For an SMCS console, indicates the communication ID (CID) that SecureWay Security Server assigned to this console session. This is only displayed for SMCS consoles.

SMCS CLSDST RPL ADDRESS

For an SMCS console, indicates the address of the CLSDST RPL for this console. This is only displayed for SMCS consoles.

SMCS BIND PARMS

For an SMCS console, indicates the BIND data that was provided for this console. This is only displayed for SMCS consoles.

SYSTEM FOR ACTIVATION

The default system on which this console will be activated when the VARY CN,ONLINE command is issued for this console. This field appears only for MCS consoles (not for extended MCS consoles).

MISC ROUTING INFORMATION

One of the following:

NONE: Indicates that this console does not receive INTIDS or UNKNIDS messages.
RECEIVING INTIDS: Indicates that this console receives INTIDS messages.
RECEIVING UNKNIDS: Indicates that this console receives UNKNIDS messages.
RECEIVING INTIDS AND UNKNIDS: Indicates that this console receives INTIDS and UNKNIDS messages.

INACTIVITY TIMEOUT (MINUTES)

The number of minutes of inactivity for this console after which the system logs the user off. If the console does not support TIMEOUT or no timeout value is specified, N/A is displayed. End of change

ROUTING CODES

The set of routing codes for messages displayed at this console. They are specified in parmlib.

CONSOLE AREA

The portion of the console screen reserved for displaying system status messages.

The console area field contains a list of alphabetic identifiers, each representing an in-line area. The list always begins with Z, which represents the out-of-line area that is not assigned to a display area. This area is reserved for general messages. The remainder of the list consists of identifiers that the system assigns to message display areas, starting at the bottom and working in alphabetical order toward the top of the screen. For example Z, A, B, C indicates a screen with one general message (in-line) area and three out-of-line display areas.

MSCOPE LIST

A list of the names of systems from which this console is receiving messages.