Displaying console status information

Use the DISPLAY CONSOLES command to display the status of all consoles or specified consoles in the sysplex, including HMCS and SMCS. If you need information about extended MCS (EMCS) consoles, use the DISPLAY EMCS command to display information for extended MCS consoles.

See Figure 1 and Figure 1 for examples of the resulting display of the DISPLAY CONSOLES and DISPLAY CONSOLES,BACKLOG commands. The syntax of the command is:

 
D {CONSOLES|C},{ACTIVE|A}[,CA[={name            }][,SYS=system-name]]
               {NACTIVE|N}     {(name[,name]...)}

                         [,CN={name            }[,ROUT={NONE|ALL|rr }][,SYS=system-name][,{SUMMARY|S}] ]
                              {(name[,name]...)}       {(rr-ss)     }                     {FULL|F   }
                                                       {(rr[,ss]...)}

                         [,MSTR[,ROUT={NONE|ALL|rr }][,SYS=system-name][,{SUMMARY|S}] ]
                                      {(rr-ss)     }                     {FULL|F   }
                                      {(rr[,ss]...)}

                         [,U={[/]dev              }[,ROUT={NONE|ALL|rr}][,{SUMMARY|S}] ]
                             {([/]dev1[,[/]dev2]…)}       {(rr[,ss]…) }   {FULL,F   }
                             {([/]dev1[-[/]dev2]…)}       {(rr-ss)    }                         
   

              {SS       }[,CN={name            }[,ROUT={NONE|ALL|rr }][,SYS=system-name][,{SUMMARY|S}]]
                              {(name[,name]...)}       {(rr-ss)     }                     {FULL|F   }
                                                       {(rr[,ss]...)}                                
                           
                         [,MSTR[,ROUT={NONE|ALL|rr }][,SYS=system-name][,{SUMMARY|S}] ]
                                      {(rr-ss)     }                     {FULL|F   }
                                      {(rr[,ss]...)}

              {BACKLOG|B  }

              {HARDCOPY|HC}

              {KEY        }[=key[,SYS=system-name]] 

              {LIST|L     }[,SYS=system-name][,{SUMMARY|S}]
                                               {FULL|F   }

              {MASTER|M   }[,SYS=system-name][,{SUMMARY|S}]
                                               {FULL|F   }
              
              {SHAREDMODE  }[,{SUMMARY|S}]
                              {FULL|F   }

              {SMCS       }
             
              {*          }
        [,L={a|name|name-a}]

The parameters are:

CONSOLES or C

Displays console information in message CNZ4100I.

ACTIVE or A

Displays the status of all active MCS, HMCS, SMCS and subsystem consoles. Consoles in standby mode are also displayed.

Note: The ACTIVE parameter only works for extended MCS or system consoles when issued with the CN or MSTR parameter. Use the D EMCS command for these consoles.

NACTIVE or N

Displays the status of all MCS, HMCS, SMCS and subsystem consoles that are not active or in STANDBY mode..

Note: The NACTIVE parameter only works for extended MCS and system consoles when issued with the CN or MSTR parameter; use the D EMCS command for these consoles.

SS

Displays the status of all allocatable subsystem consoles.

CA

Displays, for a sysplex, the console/system association list to match the specified keyword, ACTIVE or NACTIVE.

CA=[name]

Displays the specified console name(s) in the sysplex to match the specified keyword, ACTIVE or NACTIVE. A console name can be 2 to 8 characters in length. You can specify wildcard characters (* and ?) in the console name.

CN=name

Displays the status of a console or consoles identified by console name. A console name can be 2 to 8 characters in length. You can specify wildcard characters (* and ?) in the console name.

MSTR

The system displays the status of the operators with master authority that match the specified keyword of ACTIVE, NACTIVE, or SS. MSTR is mutually exclusive with CA and U. MSTR can be issued with ROUT.

U=

Displays the status of one or more consoles, identified by device numbers. A device number consists of 3 or 4 hexadecimal digits, optionally preceded by a slash (/).

[/]devnum: Displays the status of the console identified by device number devnum.
([/]devnum1[,[/]devnum2]…): Displays the status of consoles identified by device numbers devnum1, devnum2, and so on.
[/]lowdevnum-[/]highdevnum): Displays the status of the consoles identified by device numbers in the range of lowdevnum-highdevnum.

SYS=system-name

Displays the status of consoles that are active or eligible to be activated on the system you specify, and that match the other specified parameters.

SYS is mutually exclusive with BACKLOG (B), HARDCOPY (HC), KEY, *, and U=.

ROUT

Displays the status of consoles that receive messages identified by the routing code you specify.

NONE: Displays the status of consoles to which no messages are routed by routing code.
rr: Displays the status of consoles that accept messages with a routing code of rr.
(rr[,ss]…): Displays the status of consoles that accept messages with routing codes listed as rr,ss, and so forth.
(rr-ss): Displays the status of consoles that accept messages with routing codes in the range of rr to ss.
ALL: Displays the status of consoles that accept messages by routing codes.

FULL or F

Displays the console attributes as they are defined on each system that matches the specified parameters.

If neither FULL (F) nor SUMMARY (S) is specified, the output depends on the status of the console that matches the specified parameters:

If the console is active, Displays the console attributes as it is defined on the system where it is active.
If the console is active and does not match the specified parameters on the system where it is active (but it does match the specified parameters on one or more systems where it is not active), Displays only the name, type, and status of the consoles that match the specified parameters. In addition, the name of each system where the consoles are defined and where they match the specified parameters are displayed.
If the console is not active, Displays only the name, type, and status of the consoles that match the specified parameters. In addition, the name of each system where the consoles are defined and where they match the specified parameters are displayed.

SUMMARY or S

Displays only the name, type, and status of the consoles that match the specified parameters. In addition, the name of each system where the consoles is defined and where they match the specified parameters are displayed.

BACKLOG or B

Displays the status of all local consoles with a message backlog. It will list the information in descending order by quantity of backlogged messages.

HARDCOPY or HC

Displays the following information about the hardcopy message set or the hardcopy medium:

Whether the hardcopy medium is SYSLOG or OPERLOG
Whether the hardcopy message set is to include operator commands, responses, and status displays
The routing codes for messages the system is to include in the hardcopy message set
The number of messages waiting to be sent to the hardcopy medium.

The DISPLAY CONSOLES command response (CNZ4100I) will display SYSLOG and OPERLOG status.

KEY

Displays a list of available class names of extended MCS consoles.

KEY[=key]

Displays the list of active operators in the specified console class, where ‘key’ is a specific class name. See z/OS MVS Planning: Operations for more information.

LIST or L

Displays the status of consoles defined to the sysplex in CONSOLxx but not for extended MCS consoles.

MASTER or M

Displays the status of all consoles with master authority.

SHAREDMODE

Displays the status of all MCS, HMCS, SMCS and subsystem consoles that are available in console services shared mode. Use SHAREDMODE to display which consoles will continue to exist in console services shared mode.

Note: EMCS consoles are unaffected by a fallback from console services distributed mode to shared mode.

SMCS

Displays the status of the SMCS applications in the sysplex. The SMCS keyword is mutually exclusive with all other DISPLAY CONSOLES keywords.

*

Displays the status of the console that issues the DISPLAY command.

L=a, name, or name-a

Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.

If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.

Example 1:

To display information about consoles named CON24 and TAPE, enter:

D C,CN=(CON24,TAPE)

Example 2:

To display information about all active consoles that receive messages with routing code 3, enter:

D C,A,ROUT=3

Example 3:

To display information about all subsystem consoles that receive routing code 15, enter:

D C,SS,ROUT=15

Example 4:

To display information about the console device number 81B, enter:

D C,U=81B

Example 5:

To display information about the console device number 3480, enter:

D C,U=/3480

Example 6:

To display the list of available class names (keys), enter:

D C,KEY

Example 7:

To display information about all consoles that are inactive or in STANDBY mode and have the output go to area A on the console named CON5, enter:

D C,N,L=CON5-A

Example 8:

To display information about hardcopy processing on console CON13, area B, enter:

D C,HC,L=CON13-B

Example 9:

To display only the names of all consoles that begin with the letters, SYS1, enter:

D C,CN=(SYS1*),S

Example 10:

To display information about the console named DAVE for every system where DAVE is defined, enter:

D C,CN=DAVE,F