COMCHECK SYSCONS subcommand output

The COMCHECK SYSCONS subcommand gives information on the status of the system console.

The following is an example of a report generated when the COMCHECK SYSCONS subcommand is entered:

                   COMMUNICATION TASK ANALYSIS
       SYSTEM CONSOLE INFORMATION

OPERATOR DATA
NAME:                        SYSCONS1
CONSOLE ID:                  01000001
TERMINAL:                    SY1
KEY:                         SYSCONS
SYSTEM NAME:                 SY1
NUMBER OF MESSAGES QUEUED:   0
OPERATOR ATTRIBUTES
STATUS:                      ACTIVE
AUTHORITY:                   MASTER
MESSAGE FORMAT:              MESSAGE
MESSAGE TYPE:                NONE
MESSAGE LEVEL:               WTOR
IMMEDIATE ACTION
CRITICAL EVENTUAL ACTION
EVENTUAL ACTION
INFORMATIONAL
QUEUING FLAG:                FIFO
DOM FLAG:                    NORMAL
CMDSYS:                      SY1
PROBLEM DETERMINATION MODE:  YES
RECEIVES AUTO MESSAGES:      NO
RECEIVES HARDCOPY MESSAGES:  NO
RECEIVES INTIDS MESSAGES:    NO
RECEIVES UNKNIDS MESSAGES:   NO
ALERT PERCENTAGE:            80
RESUME PERCENTAGE:           30
CONSOLE STATUS AREA ALET:    01FF0009
CONSOLE STATUS AREA ADDRESS: 00002000
ROUTING CODES:               NONE
MSCOPE LIST:                 *ALL

CONSOLE NAME:                                         SYSCONS1
CONSOLE ID:                                           01000001
SYSTEM CONSOLE ACTIVE:                                YES
PROBLEM DETERMINATION MODE:                           YES
PROBLEM DETERMINATION MODE CHANGE IN PROGRESS:        NO
SYSTEM CONSOLE RECEIVING ONLY SYNCHRONOUS MESSAGES:   YES
ABEND OCCURRED IN SYSTEM CONSOLE DOM LIST:            NO
SYSTEM CONSOLE DOM LIST VALID:                        YES
NUMBER OF MESSAGES HELD ON SYSTEM CONSOLE DOM LIST:   0
     OPERATOR INPUT LISTENER EXIT TOKEN:                02FF0888
     PRIORITY OPERATOR INPUT LISTENER EXIT TOKEN:       02FF0850
MACHINE CHECK LISTENER EXIT TOKEN:                    02FF06D8
STATE CHANGE OUTPUT LISTENER EXIT TOKEN:              02FF06A0
OUTPUT TASK ECB:                                      809FF910
OPERATOR INPUT TASK ECB:                              809FF910
     PRIORITY OPERATOR INPUT TASK ECB:                  809FF910
ALERT ECB:                                            809FA510
MESSAGE ECB:                                          809FA510
20 MINUTE ECB:                                        809FA510
2 MINUTE ECB:                                         809FA510
STATE CHANGE ECB:                                     809FA510

The following fields appear in the report:

NAME

The System console name defined in the CONSOLxx parmlib member at system initialization.

CONSOLE ID

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

TERMINAL

The terminal name associated with this console.

KEY

The 1- to 8-character keyname that identifies the message that the system requests.

SYSTEM NAME

The name of the system to which this console is defined.

NUMBER OF MESSAGES QUEUED

The number of messages retained for later viewing.

STATUS

One of the following:

ACTIVE: The console is currently active.
DEFINED: The device is currently inactive.

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.
MASTER: Master authority commands.
ALL: All commands.

MESSAGE FORMAT

The format of the 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 ID 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 the 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.

QUEUING FLAG

The type of message delivery specified at console initialization, which is one of the following:

FIFO: Messages are delivered from the message data space on a first in, first out basis.
SEARCH: Messages are delivered from the message data space based on search criteria specified in the MCSOPER macro.
NONE: No messages are placed into, or delivered from, the message data space.

DOM FLAG

The delete operator message (DOM) disposition of this console, which is one of the following:

NORMAL: The console receives DOMs only for messages that have been received and placed in its message data space.
ALL: The console receives all DOMs in the system.
NONE: The console receives no DOMs.

CMDSYS

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

PROBLEM DETERMINATION MODE

One of the following values:

YES: The system console is in problem determination mode and can issue MVS™ system commands and receive messages to assist with diagnostics and problem determination. The operator can issue VARY CN,DEACTIVATE to end problem determination mode for the system console.
NO: The system console is not in problem determination mode. The operator can issue VARY CN,ACTIVATE to activate problem determination mode for the system console.

RECEIVES AUTO MESSAGES

Indicates whether this console receives automatable messages. The response is either YES or NO.

RECEIVES HARDCOPY MESSAGES

Indicates whether this console receives hardcopy messages. The response is either YES or NO.

RECEIVES INTIDS MESSAGES

Indicates whether this console receives INTIDS messages. The response is either YES or NO.

RECEIVES UNKNIDS MESSAGES

Indicate whether this console receives UNKNIDS messages. The response is either YES or NO.

ALERT PERCENTAGE

The percentage of the message buffer that, when full, indicates a buffer shortage.

RESUME PERCENTAGE

The percentage of the message buffer that, when full, allows message processing to resume after a buffer shortage.

CONSOLE STATUS AREA ALET

The console status area access list entry table. It is used with the console status area address to look at the data structure of the console status area.

CONSOLE STATUS AREA ADDRESS

The address of the console status area for this console.

ROUTING CODES

The set of routing codes for messages displayed at this console.

MSCOPE LIST

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

CONSOLE NAME

A 2- to 8- character name for the system console defined in the CONSOLxx parmlib member during system initialization.

If no name was specified at initialization, this field contains the name of the system on which the console is located. If the specified name was a duplicate of an existing console name, this field contains SYSCNxxx, where xxx is a unique identifier assigned by the system.

CONSOLE ID

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

SYSTEM CONSOLE ACTIVE

One of the following values:

YES: The system console is active and can be used as an extended MCS console.
NO: The system console is not active. This condition is normal if the communications task is not yet initialized. If the communications task is initialized, a problem occurred while activating the system console. In this case, the system issues message IEA128I and the system console cannot be used as an extended MCS console.

PROBLEM DETERMINATION MODE

One of the following values:

YES: The system console is in problem determination mode and can issue MVS system commands and receive messages to assist with diagnostics and problem determination. The operator can issue VARY CN,DEACTIVATE to end problem determination mode for the system console.
NO: The system console is not in problem determination mode. The operator can issue VARY CN,ACTIVATE to activate problem determination mode for the system console.

PROBLEM DETERMINATION MODE CHANGE IN PROGRESS

One of the following:

YES: The system detected that a VARY CN,ACTIVATE command to activate problem determination mode or a VARY CN,DEACTIVATE command to end problem determination mode has been issued for the system console, but the system is already processing a previous VARY CN,ACTIVATE or VARY CN,DEACTIVATE command. The system ignores the command.
NO: The system is not currently processing a VARY CN,ACTIVATE or VARY CN,DEACTIVATE command for the system console.

SYSTEM CONSOLE RECEIVING ONLY SYNCHRONOUS MESSAGES

This field indicates whether the system console is receiving only synchronous messages or both synchronous and non-synchronous messages.

YES: The system console is receiving only synchronous messages because the system console non-synchronous message processing function is not available.
NO: The system console is receiving both synchronous and non-synchronous messages.

SYSTEM CONSOLE DOM LIST PROCESSING ABENDED

This field indicates whether delete operator message (DOM) list processing for the system console has abended. The DOM list contains elements representing messages held on the system console.

YES: DOM requests are not being processed for the system console because the DOM list for the console is not valid. The system tried to repair the list. The next field in this report, SYSTEM CONSOLE DOM LIST VALID, contains NO if the repair worked (and therefore the list is valid) and YES if it did not work.
NO: DOM requests are being processed for the system console.

SYSTEM CONSOLE DOM LIST VALID

This field indicates whether the DOM list for the system console is valid. The DOM list contains elements representing messages held on the system console.

YES: The system console DOM list is not valid. The system tried once to repair the list, but was not successful. No more DOM requests will be added to the list until the system can delete the existing list and create a new one.
NO: The system console DOM list is valid.

NUMBER OF MESSAGES HELD ON THE SYSTEM CONSOLE DOM LIST

The number of delete requests currently on the DOM list for the system console.

MACHINE CHECK LISTENER EXIT TOKEN

This field displays the address of the token for the machine check listener exit routine. This exit routine initiates processing if a machine check occurs on the system console. The token contains the address of the event notification listener element (ENFLS) that contains information about this listener exit routine.

If the address is zero, the system cannot process machine checks for the system console.

STATE CHANGE LISTENER EXIT TOKEN

This field displays the address of the token for the state change listener exit routine. This exit routine initiates processing if the state of the system console changes from available to unavailable or vice versa. The token contains the address of the event notification listener element (ENFLS) that contains information about this listener exit routine.

If the address is zero, the system cannot process state changes for the system console.

OUTPUT TASK ECB

The system posts the output task event control block (ECB) when a non-synchronous message is ready to be displayed on the system console.

INPUT TASK ECB

The system posts the input task ECB to retry processing if the unsolicited input listener exit routine fails.

ALERT ECB

The system posts the alert ECB if an error occurs in the system console queue. The system also issues message IEA125I describing the error.

MESSAGE ECB

The system posts the message ECB when a message is ready to be displayed on the system console.

20 MINUTE ECB

The system sets a 20 minute timer if the system console becomes unavailable due to a state change or machine check. If the system console becomes available within 20 minutes, the system cancels the timer. Otherwise, the system posts the 20 minute ECB so that all messages can be deleted from the system console queue.

2 MINUTE

The system sets a two minute timer if a message cannot be sent to the system console because the processor controller element (PCE) hardware buffer is full. After two minutes, the system posts the two minute ECB so that the message can be sent again.

STATE CHANGE ECB

The system posts the state change ECB if the state of the system console changes from available to unavailable or vice versa or if a machine check occurs.

This report goes on to display information that is normally displayed for an extended MCS console. COMCHECK NAME or ID subcommand output describes these fields.