CNZ4100Itimehmsp CONSOLE DISPLAY CONSOLES MATCHING COMMAND: command text
Explanation
[MSG:CURR=mcur LIM=mlim RPLY:CURR=rcur LIM=rlim SYS=sysname PFK=pfk]
[HARDCOPY LOG=(log) CMDLEVEL=clevel ROUT=hcrout]
[HARDCOPY SUSPENDED ON THIS SYSTEM|HARDCOPY NOT ACTIVE ON THIS SYSTEM]
[LOG BUFFERS IN USE: loguse LOG BUFFER LIMIT: loglim]
[consname TYPE=constype STATUS=status [COMPID=compid ASID=asid]]
[DEFINED=(definedlist)]
[MATCHED=(matchedlist)]
[ATTRIBUTES ON attributesonsys]
[AUTH=(auth) [CMDSYS=cmdsys NBUF=nbuf SUPSBY=stdby]]
[DEV=dev LOGON=logon USERID=userid TIMEOUT=timeo]
[LU=luname LOGON=logon USERID=userid TIMEOUT=timeo]
[KEY=keyname [PDMODE=pd AUTOACT=autoact]]
[MFORM=(mform) [AREA=(area) PFKTAB=pfktable]]
[USE=use [DEL=mode RTME=rtme RNUM=rnum SEG=seg CON=con]]
[LEVEL=(level)]
[MONITOR=(monitor) INTIDS=intids UNKNIDS=unknids]
[ROUT=(rout)]
[MSCOPE=(mscope)]
[NAME TYPE STATUS DEFINED MATCHED]
[consname constype status definedlist matchedlist]
[DISPLAY TRUNCATED - INSUFFICIENT STORAGE]
[THE FOLLOWING DEVICES ARE NOT CONSOLES ON THIS SYSTEM: devspec]
[NO CONSOLES MEET SPECIFIED CRITERIA]
[ADDRESS SPACE WTO BUFFER USAGE]
[ASID=bklgasid JOBNAME=bklgjob NBUF=blkgnbuf]
[NO ADDRESS SPACES ARE USING MORE THAN nbuf33tot WTO BUFFERS]
[MESSAGES COMING FROM OTHER SYSTEMS - WTO BUFFER USAGE]
[SYSTEM=syswithnbuf NBUF=nbuffromsys]
[NO WTO BUFFERS ARE IN USE FOR MESSAGES FROM OTHER SYSTEMS]
A DISPLAY CONSOLES command was entered explicitly or by the system (for example, as a result of a VARY HARDCPY or VARY CONSOLE command). The system issues this message in response to that command.
For active consoles that meet the specified criteria, the system displays the console attributes. Otherwise, the system displays only the name, type and status of the consoles that meet the specified criteria. In addition, the name of each system where the consoles are defined, and where they match the specified criteria is displayed.
- timehmsp
- The time that the message was issued.
- command
- The DISPLAY CONSOLES command issued. Note: If the command is longer than 40 characters, only the first 40 characters are displayed.
- mcur
- The number of write to operator (WTO) message buffers in use by the system at this time. If the number is greater than 9999, asterisks will appear.
- mlim
- The limit of the number of WTO message buffers allowed outstanding. The maximum value is specified by the MLIM parameter in the CONSOLxx parmlib member. The CONTROL M command can be issued to change the limit.
- rcur
- The number of write to operator with reply (WTOR) message buffers in use by the system at this time.
- rlim
- The limit of the number of WTOR message buffers allowed outstanding. The maximum value is specified by the RLIM parameter in the CONSOLxx parmlib member. The CONTROL M command can be issued to change the limit.
- sysname
- The name of the system where this command is processed. Note that this system might be different from the system where this output is displayed.
- pfk
- The suffix of the PFKTABxx parmlib member which contains the current program function key (PFK) table definitions. If no member was specified in the CONSOLxx parmlib member, NONE will be displayed.
- log
- One or more of the following:
- SYSLOG
- The system log is active.
- OPERLOG
- The operations log is active.
- clevel
- One of the following:
- CMDS
- Operator and system commands, responses, and status displays are to be written to the hardcopy message set.
- INCMDS
- Operator and system commands and responses (but not status displays) are to be written to the hardcopy message set.
- NOCMDS
- Operator and system commands and responses are not to be written to the hardcopy message set.
- STCMDS
- Same as CMDS
- hcrout
- One of the following:
- nnn,nnn,...
- The hardcopy message set receives messages for these routing codes.
- lowrc-highrc
- The hardcopy message set receives messages for the routing codes in the range of lowrc to highrc.
- ALL
- The hardcopy message set receives messages for all routing codes.
- HARDCOPY SUSPENDED ON THIS SYSTEM
- Hardcopy is not sent to the system log or to the operations log and the hardcopy support is required.
- HARDCOPY NOT ACTIVE ON THIS SYSTEM
- Hardcopy is not sent to the system log or to the operations log and the hardcopy support is not required.
- loguse
- The number of SYSLOG message buffers in use by the system at this time.
- loglim
- The limit of the number of SYSLOG message buffers that the system sends to the system log. The maximum value is specified by the LOGLIM parameter in the CONSOLxx parmlib member. The CONTROL M command can be issued to change the limit.
- consname
- The name of the console.
- constype
- One of the following:
- MCS
- Multiple console support console.
- SMCS
- SNA MCS console.
- EMCS
- Extended MCS console.
- SYSCONS
- System console.
- HMCS
- Hardware Management Console MCS console.
- status
- One of the following:
- ACT-actsys
- The status of the console is active. actsys is the name of the system where the console is active.
- INACT
- The status of the console is not active.
- STANDBY
- The status of the console is in standby.
- compid
- Specifies the component identifier for the system component to which this subsystem console is allocated. If the subsystem console is not allocated on this system, N/A is displayed.
- asid
- Specifies the address space identifier (ASID) of the system component to which this subsystem console is allocated. If the subsystem console is not allocated on this system, N/A is displayed.
- definedlist
- The names of the systems where the console is defined. If the console is defined on all systems, *ALL is displayed. *ALL will normally be displayed for SMCS consoles unless there are systems that cannot activate an SMCS console (for example, the system did not define an APPLID in CONSOLxx). In this case the names of systems which can activate an SMCS console will be displayed. If no system in the sysplex has a definition of this console (for example, the system that had the definition of this console was removed from the sysplex and its console definition has not been removed using the IEARELCN service or the SETCON DELETE command), *NONE is displayed.
- matchedlist
- The names of the systems where the console matches the specified criteria. If the console matches on all systems in the sysplex, *ALL is displayed. If no system in the sysplex has a definition of this console that matches the specified criteria, *NONE is displayed. For commands that only produce local consoles (example, D C,BACKLOG), N/A is displayed.
- attributesonsys
- The name of the system where the following attributes apply. If the attributes for this console are applicable to all systems in DEFINED=(definedlist), *DEFINED is displayed. If no system in the sysplex has a definition of this console (for example, the system that had the definition of this console was removed from the sysplex and its console definition has not been removed using the IEARELCN service or the SETCON DELETE command), *NONE is displayed. Any attributes displayed are collected from the system that processed the command.
- auth
- One of the following:
- (ALL)
- Any INFO, SYS, IO, or CONS command can be entered from this console.
- (CONS)
- INFO commands as well as any command from the console control command group can be entered from this console.
- (INFO)
- Any command from the Informational command group can be entered from this console.
- (IO)
- INFO commands as well as any command from the I/O Control command group can be entered from this console.
- (MASTER)
- The specified console is authorized to enter any command.
- (SYS)
- INFO commands as well as any command from the system control command group can be entered from this console.
- (SYS,IO)
- INFO commands as well as any command from the system control command group and I/O Control command group can be entered from this console.
- (SYS,CONS)
- INFO commands as well as any command from the system control command group and console control command group can be entered from this console.
- (IO,CONS)
- INFO commands as well as any command from the I/O Control command group and console control command group can be entered from this console.
- cmdsys
- Specifies the name of the system where commands from this console will be processed. An asterisk (*) indicates the name of the system where this console is active.
- nbuf
- The number of WTO message buffers currently queued to this console. If the number is greater than 9999, asterisks will appear. No value will be shown for consoles not active on the system where the DISPLAY CONSOLES is processed.
- dev
- The device number of the MCS console.
- supsby
- One of the following:
- Y
- Specifies this console supports standby mode.
- N
- Specifies this console does not support standby mode.
- N/A
- Specifies this console is not eligible for standby mode.
- logon
- One of the following:
- AUTO
- Specifies this console is automatically logged on when the console is activated.
- DEFAULT
- Specifies this console will use the LOGON specification on the DEFAULT statement in the CONSOLxx parmlib member.
- OPTIONAL
- Specifies that the operators can optionally log on to the console.
- REQUIRED
- Specifies that an operator must log on to the console before issuing commands from this console.
- N/A
- logon is only applicable to display consoles.
- userid
- The userid of the logged-on user of the console.
- timeo
- The number of minutes of inactivity that is allowed before the operator is logged off. If the console does not support the timeout function, N/A is displayed.
- luname
- The LU name of the SMCS console. If there is no LU name defined for the SMCS console, *NONE* will be displayed.
- keyname
- Represents a collection of extended MCS consoles logically grouped by name.
- pd
- One of the following:
- N
- Indicates this system console is NOT in problem determination mode.
- Y
- Indicates this system console is in problem determination mode.
- autoact
- One of the following:
- grpname
- The name of the AUTOACT group for this system console.
- --------
- There is no AUTOACT group for this system console.
- N/A
- This system console is not active on this system. The name of
the AUTOACT group is not available.
AUTOACT specifies the
automatic activate group
for the system console. While the AUTOACT group is defined and not suspended, the system console will automatically be placed into problem determination (PD) mode when all of the consoles in AUTOACT are inactive.
- mform
- Specifies the format in which messages are displayed. One or more
of the following values may appear:
- J
- The system will display each message with the job identifier or name.
- M
- The system will display only the text of each message (without a time stamp, job identifier or name, and system name).
- S
- The system will display each message with the name of the system on which the message originated.
- T
- The system will display each message with a time stamp.
- X
- Whenever possible, the system will attempt to suppress the job name and system name, if they are not be meaningful.
- area
- One of the following:
- Z,a-b
- The range of area designators defined for this console.
- Z
- is the identifier of the in-line message area.
- a
- is the bottom out-of-line area. Values can be letters between the values of A and K.
- b
- is the top out-of-line area. Values can be letters between the values of A and K.
The presence of some or all of these designators depends on the area definitions currently in effect at this console.
- NONE
- If the console has no defined areas, NONE appears.
- pfktable
- The name of the PFK table that is being used on this console. If the IBM® default PFK definitions are being used for the console, *DEFAULT is to be displayed.
- use
- One of the following:
- FC
- Indicates full-capability use of a display console.
- MS
- Indicates message stream use of a display console.
- SD
- Indicates status display use of a display console.
- mode
- Specifies the message deletion mode of the console. mode is one
of the following:
- N
- Indicates that manual message deletion is required.
- R
- Indicates roll mode. The system deletes a specified number of messages from the screen when a time interval elapses. Deletion occurs only if the screen is full and messages are waiting to be displayed.
- RD
- Indicates roll mode with the following exception: messages awaiting action will not roll off, they are gathered at the top of the screen.
- W
- Wrap mode. The system overlays the newest message over the oldest message on the screen.
- Y
- Indicates automatic mode of message deletion. All messages marked for deletion are deleted whenever the screen becomes full.
- N/A
- mode is only applicable to display consoles that are full-capability or message stream use.
- rtme
- Specifies the number of seconds between message rolls. This is
a decimal value from 1 to 999, or a value of 1/4 or 1/2. rtme is only
applicable to display consoles. Note: If an asterisk (*) appears as the RTME value, the console is not fully initialized. The actual RTME value cannot be determined until the console is fully initialized.
- rnum
- Specifies the maximum number of messages lines included in one
message roll mode. This is a decimal value from 1 to the number of
lines in the message area. rnum is only applicable to display consoles. Note: Note: If an asterisk (*) appears as the RNUM value, the console is not fully initialized. The actual RNUM value cannot be determined until the console is fully initialized.
- seg
- Specifies the number of lines in the message area that can be
deleted with a CONTROL E,SEG command. This is a decimal value from
1 to the number of lines in the message area. seg is only applicable
to display consoles. Note: If an asterisk (*) appears as the SEG value, the console is not fully initialized. The actual SEG value cannot be determined until the console is fully initialized.
- con
- Specifies the conversation mode for message deletion. con is one
of the following:
- N
- Indicates non-conversational mode for message deletion.
- Y
- Indicates conversational mode for message deletion.
- N/A
- con is only applicable to display consoles that are full-capability or message stream use.
- level
- Specifies the message level(s) to be received by the console.
level can be one or more of the following:
- ALL
- Indicates that all messages are to be received by the console.
- CE
- Indicates that critical eventual action messages are to be received by the console.
- E
- Indicates that eventual action messages are to be received by the console.
- I
- Indicates that immediate action messages are to be received by the console.
- IN
- Indicates that informational messages are to be received by the console.
- NB
- Indicates that broadcast messages are not to be received by the console.
- R
- Indicates that messages requiring a reply (WTORs) are to be received by the console.
- monitor
- The monitor status of a console might be one or more of the following:
- JOBNAMES
- The console is monitoring job names.
- SESS
- The console is monitoring sessions.
- STATUS
- The console is monitoring status.
- NONE
- No monitoring is being performed by this console.
- intids
- One of the following:
- N
- Indicates this console is NOT to receive messages that are directed to console id zero.
- Y
- Indicates this console is to receive messages that are directed to console id zero.
- unknids
- One of the following:
- N
- Indicates this console is NOT to receive messages that are directed to unknown console ids.
- Y
- Indicates this console is to receive messages that are directed to unknown console ids.
- rout
- One of the following:
- nnn,nnn,...
- The routing codes assigned to the console.
- lowrc-highrc
- The routing codes in the range of lowrc to highrc.
- ALL
- All of the routing codes, 1 through 128.
- NONE
- None of the routing codes.
- mscope
- The name of the system or systems from which this console is receiving
unsolicited messages. Note that these systems might be different from
the system where this console is physically attached. mscope can
be one of the following:
- sysname,sysname,...
- The system names. An asterisk (*) indicates the name of the system where this console is active.
- *ALL
- Message scope is for all systems currently defined in the sysplex.
- DISPLAY TRUNCATED - INSUFFICIENT STORAGE
- All consoles matching the specified criteria could not be displayed due to insufficient storage. Reissue the DISPLAY CONSOLES command with more specific search criteria.
- devspec
- One of the following:
- dev dev dev ...
- A list of device numbers that are not consoles on this system.
- lowdev-highdev
- A range of device numbers that are not consoles on this system.
- NO CONSOLES MEET SPECIFIED CRITERIA
- A valid keyword was specified, but no consoles were found that match the search criteria.
- bklgasid
- The address space identifier (ASID) of the address space that is using more than 33% of the available WTO buffers.
- bklgjob
- The name of the job running in the address space that is using more than 33% of the available WTO buffers.
- blkgnbuf
- The number of WTO buffers in use by the specified ASID and job.
- nbuf33tot
- No address space is using more than 33% of the available WTO buffers, where nbuf33tot is 33% of the total number of WTO buffers.
- syswithnbuf
- The name of the system that has incoming messages in WTO buffers.
- nbuffromsys
- The number of buffers being used for messages from a specific system.
- NO WTO BUFFERS ARE IN USE FOR MESSAGES FROM OTHER SYSTEMS
- There are no WTO buffers in use for messages from other systems in the sysplex. This line is not displayed when there is only one system in the sysplex.
System action
The command is processed.
Operator response
If the current WTO or WTOR message buffer count is close to the limit, check the message buffer counts for each console. A console with a high count may not be functioning properly. See the operator response to message IEA405E.
- Not match the number of outstanding message buffers. If a message buffer is queued to two consoles, it would be counted twice, once for each console.
- Not match the number of messages to be displayed at that console. For multiple line messages, each message buffer can hold two message lines.
The message buffer limit is not the actual limit at IPL time. The IPL limit is very high, and the limit displayed is correct once IPL is finished.
System programmer response
None.
Module
CNZK1DCM
Source
Consoles (SC1CK)
Routing Code
* The message will be routed back to the console that initiated the associated request.
Descriptor Code
5,8,9