Displaying extended MCS information

Use the DISPLAY EMCS command (instead of the DISPLAY CONSOLES command) to display information about extended MCS (EMCS) consoles.

When the system searches for any consoles you specify, it allows wildcard matching. CN, SYS, and KEY can include wildcard characters (* and ?) that allow a single parameter to match many different actual conditions. For example, CN=AD? matches console names like AD1 or AD2 but not ADD1. CN=A* matches A1 or AD1 or ADD1.

The syntax for the DISPLAY EMCS command is:

D EMCS 
 D EMCS,{SUMMARY|S                 }[,L={a|name|name-a}]
       {INFO|I                    }
       {FULL|F                    }
       
       {STATUS=A|N|L|B[{nn}]|ERR  }
       {ST                        }
                                    
       {CN=consname|*             }
                                    
       {SYS=sysname|*             }
                                    
       {KEY=keyname|*             }
                                    
       {AUTH={ANY}                }
             {MASTER}                
             {SYS}                   
             {IO}                    
             {CONS}                  
             {ALL}                   
             {INFO}                  
             {SYSONLY}               
             {IOONLY}                
             {CONSONLY}              
             {ALLONLY}               
             {INFOONLY}              
                                    
       {ATTR={ANY}                }
             {YES}                   
             {ROUT}                  
             {HC}                    
             {AUTO(YES|NO)}          
             {MN}                    
             {NONE}                  
             {INTIDS}                
             {UNKNIDS}               
                                     
       {DOM={ANY}                 }
            {NORMAL}                 
            {ALL}                    
            {NONE}                   
            {YES}

The parameters are:

EMCS
The system is to display console information about extended MCS (EMCS) consoles.
SUMMARY or S
The system is to display only the numbers and names for the consoles that meet the criteria.
INFO or I
The system is to display all console information, except statistics on the console's message data space, for the consoles that meet the criteria.
FULL or F
The system is to display all available information about the consoles that meet the criteria. Message data space statistics can only be displayed for consoles that are active on the system where the command is processed.

The following keyword parameters define the criteria used to limit the number of consoles displayed.

STATUS|ST=A|N|L|B[(nn)]|ERR
The system is to display information about extended MCS consoles according to console status:
A
All extended MCS consoles that are active.
N
All extended MCS consoles that are not active.
L
Both active and inactive extended MCS consoles.
B[(nn)]
All consoles with a backlog of more than nn unretrieved delivered messages, where nn is a number from 1 to 999999. If you omit nn, the default is 10 unretrieved messages. Backlog information can only be displayed for consoles attached to the system that processes the command.
ERR
All consoles in an error state, such as consoles with queueing suspended. Error state information can only be displayed for consoles attached to the system that processes the command.
Note: Specifying B or ERR on STATUS forces the amount of information to be FULL.
CN=consname
The system is to display information according to console name. A console name can be from 1 to 8 characters. You can specify wildcard characters (* and ?) in the console name.

CN=* is a special case because * is not a wildcard character. CN=* means that the system is to display information about this console, the console you are using to enter the command.

Note: Specifying CN=*, or a console name with no wildcard characters, automatically forces STATUS=L.
SYS=sysname
The system is to display information about any consoles that are active or eligible to be activated on the system you specify, and that match the other specified parameters. A system name can be from 1 to 8 characters. You can specify wildcard characters (* and ?). The default is SYS=*, which matches all system names.
KEY=keyname
The system is to display information according to console key name, where keyname is the name your installation has assigned to a console group. (See z/OS MVS Planning: Operations for more information.) The name can be from 1 to 8 characters. You can specify wildcard characters (* and ?). The default is KEY=*, which matches all console class names.
AUTH=
The system is to display information about consoles with a specific console command authority, which may be one of the following:
ANY
Consoles with any authority.
MASTER
Consoles with MASTER authority.
SYS
Consoles with at least SYS authority (meaning MASTER authority, SYS authority alone, or SYS combined with IO or CONS or both).
IO
Consoles with at least IO authority.
CONS
Consoles with at least CONS authority.
ALL
Consoles with at least ALL authority (SYS, IO, and CONS).
INFO
Consoles with at least INFO authority.
SYSONLY
Consoles with SYS authority only (not MASTER, CONS, or IO).
IOONLY
Consoles with IO authority only.
CONSONLY
Consoles with CONS authority only.
ALLONLY
Consoles with ALL authority only (meaning consoles with SYS, IO, and CONS authority, but not MASTER authority).
INFOONLY
Consoles with INFO authority only.
ATTR=
The system is to display information about extended MCS consoles that receive messages with a specific routing attribute, which may be one of the following:
ANY
Any consoles, regardless of routing attributes.
YES
Consoles that receive some type of unsolicited messages (either routing codes, hardcopy messages, AUTO(YES) messages, or MONITOR messages.)
ROUT
Consoles that receive any routing codes.
HC
Consoles receiving the hardcopy message set.
AUTO[(YES|NO)]
Consoles that are or are not receiving AUTO(YES) messages. The default is YES.
MN
Consoles receiving any type of MONITOR messages.
NONE
Consoles with no routing attributes.
INTIDS
Consoles receiving messages directed to console ID zero. If you do not specify, the system displays consoles with either Y or N value of INTIDS.
UNKNIDS
Consoles receiving messages directed to the old 1-byte format of console IDs. If you do not specify, the system displays consoles with either Y or N value of UNKNIDS.
DOM=
The system is to display information about extended MCS consoles according to specific DOM attributes.
ANY
Any consoles, regardless of DOM attributes.
NORMAL
Only consoles defined with DOM(NORMAL).
ALL
Only consoles defined with DOM(ALL).
NONE
Only consoles defined with DOM(NONE).
YES
Consoles defined with either DOM(ALL) or DOM(NORMAL).
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:

Assume a single system where the system console is named SYS01, and there are two two additional extended MCS consoles, named EMCS1 and EMCS2. If you issue the following command: 
DISPLAY EMCS
The display includes only the console names (because SUMMARY is the default) of active extended MCS consoles (because STATUS=A is the default). The output of the command appears as follows: 
IEE129I 13.35.15 
DISPLAY EMCS DISPLAY EMCS 
NUMBER OF CONSOLES MATCHING CRITERIA: 6 
*DICNSY3 EMCS1 SY3 *ROUTEY3 EMCS2 *SYSLGY3
DISPLAY EMCS,INFO
The display includes all information except dataspace information (because you specified INFO) but will only include active consoles (because STATUS=A is the default). The output of the command looks like: 
CNZ4101I 13.31.07 DISPLAY EMCS 
DISPLAY EMCS,INFO 
NUMBER OF CONSOLES MATCHING CRITERIA: 6 
CN=*DICNSY3 STATUS=A CNID=01000001 KEY=NONE 
SYS=SY3 ASID=0009 JOBNAME=-------- JOBID=--------
HC=N AUTO=N DOM=ALL TERMNAME=*DICNSY3 
MONITOR=-------- 
CMDSYS=SY3 
LEVEL=ALL AUTH= INFO 
MSCOPE=*ALL 
ROUTCDE=ALL 
INTIDS=N UNKNIDS=N 
CN=EMCS1 STATUS=A CNID=01000002 KEY=EXAMPLE 
SYS=SY3 ASID=0018 JOBNAME=EXTMCS JOBID=STC00029
HC=N AUTO=N DOM=NORMAL TERMNAME=EMCS1 
MONITOR=-------- 
CMDSYS=SY3 
LEVEL=ALL AUTH= MASTER 
MSCOPE=*ALL 
ROUTCDE=ALL 
INTIDS=N UNKNIDS=N 
CN=SY3 STATUS=A CNID=02000001 KEY=SYSCONS 
SYS=SY3 ASID=0009 JOBNAME=-------- JOBID=--------
HC=N AUTO=N DOM=NORMAL TERMNAME=SY3 
MONITOR=-------- 
CMDSYS=SY3 
LEVEL=ALL,NB AUTH= MASTER 
MSCOPE=*ALL 
ROUTCDE=NONE 
AUTOACT=-------- 
INTIDS=N UNKNIDS=N 
CN=*ROUTEY3 STATUS=A CNID=02000002 KEY=MVSROUTE 
SYS=SY3 ASID=0009 JOBNAME=-------- JOBID=--------
HC=N AUTO=N DOM=NONE TERMNAME=ROUTEALL 
MONITOR=-------- 
CMDSYS=SY3 
LEVEL=R,NB AUTH= CONS 
MSCOPE=*ALL 
ROUTCDE=NONE 
INTIDS=N UNKNIDS=N 
CN=EMCS2 STATUS=A CNID=02000003 KEY=EXAMPLE 
SYS=SY3 ASID=0029 JOBNAME=EXTMCS JOBID=STC00030
HC=N AUTO=N DOM=NORMAL TERMNAME=EMCS2 
MONITOR=-------- 
CMDSYS=SY3 
LEVEL=ALL AUTH= MASTER 
MSCOPE=*ALL 
ROUTCDE=ALL 
INTIDS=N UNKNIDS=N 
CN=*SYSLGY3 STATUS=A CNID=03000001 KEY=SYSLOG 
SYS=SY3 ASID=0009 JOBNAME=-------- JOBID=--------
HC=N AUTO=N DOM=NONE TERMNAME=*SYSLGY3 
MONITOR=-------- 
CMDSYS=SY3 
LEVEL=ALL AUTH= MASTER 
MSCOPE=SY3 
ROUTCDE=NONE 
INTIDS=N UNKNIDS=N
Parent topic: DISPLAY command