Console-related commands

The commands discussed in this section relate to console operations.

OCMD

Issues z/OS® and JES2 operator commands from an OMEGAMON terminal.

Type:

Immediate

Format:

-OCMDnn [CONS={conid|conname}] ccccc or

-OCMDnn
         [CONX=xconid] ccccc

-: Required action character. This changes to a comment character (>) after the command executes.
nn: For commands that accept a return destination, the variable nn indicates which operator’s console will receive the response. If you omit nn, the response goes to the main console.
conid: Specifies which operator's console issued the command. Overrides the nn operand.
conname: Specifies the console name from which the command originated.
xconid: Specifies which operator's console issued the command in 1-8 hexadecimal digit format. Overrides the nn operand.
ccccc: Indicates an or JES command.

OMEGAMON issues the command (ccccc) that you supply via SVC 34.


-OCMD01  SEND ’PLEASE RELEASE ALL HELD DATA SETS’,USER=TSO001
-OCMD01  $HJ123
-OCMD01  C JOB123,DUMP

OMEGAMON has the same z/OS console authority as the console you indicate. Therefore, if you want to issue a command that requires main console authority (such as VARY CHANNEL) you must specify the z/OS console ID of your current main console. If you do not specify a console ID, the main console ID is used.

In TSO mode, you can request OMEGAMON to return the output of a command back to your terminal. To do this, issue OCMD with a console ID of 99. For example:


-OCMD99 D T

displays the date and time on your TSO terminal.

Some z/OS commands do not send output to TSO users, even though you use OCMD99. This is because OCMD can only request the z/OS command scheduler to send the output back to the OMEGAMON TSO session; some z/OS components do not honor this request. The JES2 $ commands are an example of this restriction. For example, the output of


-OCMD99 $DA

appears on the main console, not your TSO session.

Important: OCMD99 does not work for any OMEGAMON session type except TSO. In particular, it does not work for dedicated or VTAM® sessions.

RCMD

Routes z/OS and JES2 commands to a desired system in a sysplex.

Type:: Major
Format:: -RCMDnn sysname [CONS={conid|conname}] ccccc -RCMDnn sysname [CONX=xconid] ccccc

OMEGAMON issues the command (ccccc) that you supply via SVC 34.

RCMD requires the action character (-) in column 1. The action character changes to a comment character after execution.

The variable nn indicates which operator’s console will receive the response. If you omit nn, the response goes to the main console.

sysname specifies the system name where the command executes.

The variable ccccc is a z/OS or JES2 command.

conid specifies which operator’s console issued the command. This operand overrides the nn operand.

xconid specifies which operator's console issued the command in 1-8 hexadecimal digit format. This operand overrides the nn operand.

conname specifies the console name from which the command originated.

CONS

Displays the console image for the specified console.

Type:: Major
Format:: CONSnn[CONS={conid|conname}] CONSnn [CONX=xconid]

The variable nn is a z/OS console number. This number ranges from 01 to the maximum number of consoles generated for your installation. If nn is omitted, OMEGAMON selects the main console.

conid selects the z/OS operator’s console by ID number. This operand overrides the nn operand.

conname selects the z/OS operator’s console by name.

xconid selects the z/OS operator's console by hexadecimal number. ID may be 1 through 8 hexadecimal digits. This operand overrides the nn operand.

CONS displays three types of information on the command line: the type of console (CONSOLE or main CONSOLE), the console’s device number, and the console’s ID number (as in ID=3).

To see each z/OS console’s number (also known as the UCMID), issue the D CONSOLES command at a real z/OS console.

The CONS minor commands enable you to display selected types of messages from the console.

The CONS command also displays the output that z/OS or JES commands generate when the OCMD authorized command issues them. (See Figure 1 for an example.)

Note that OMEGAMON accesses the CONSOLE address space using cross memory services each time you ask for a display. It uses a small amount of memory in the z/OS common area (approximately 2K) for the period that the CONS command is on the screen.

Figure 1 is an example of an OMEGAMON screen that uses the z/OS console support.

Figure 1. OCMD and CONS Output


>OCMD R 83,ABEND                                                        RC =  0
================================================================================
 CONS01  main CONSOLE 01F
 line99   *STC  721 *82 DFS996I *IMS READY*  IPO1
+        - STC 1113  $HASP395 IMSRDR   ENDED
+          STC 1113  $HASP250 IMSRDR   IS PURGED
+        - JOB 1114  $HASP373 BMP01    STARTED - INIT  4 - CLASS I - SYS A430
+        - JOB 1111  $HASP395 TSO003G  ENDED
+                    $HASP309    INIT  3 INACTIVE ******** C=I
+          JOB 1111  $HASP250 TSO003G  IS PURGED
+        - STC  721  DFS2500I *MDA00   IPO1
+        - DATABASE BE3PARTS SUCCESSFULLY ALLOCATED
+        - STC  721  DFS2500I *MDA00   IPO1
+        - DATABASE BE3PSID1 SUCCESSFULLY ALLOCATED
+        | JOB 1114 @83 DFS3125A PRIMER SAMPLE TEST, REPLY CONT, LOOP, ABEND, O
+        |  CANCEL JOB
+          TSU 1115  $HASP100 TSO045   ON TSOMEGAMON/IMSNRDR
+        - TSU 1115  $HASP373 TSO045   STARTED
+      00            IEE600I REPLY TO 83 IS;ABEND
================================================================================

CONU

Locates the output buffer for a z/OS operator console by device address.

Type:: Major
Format:: CONU xxx

CONU functions like CONS, except that you supply the three-byte hex device address as an operand instead of the console ID. If you omit xxx, OMEGAMON automatically locates the output buffer for the main console. CONU displays the address and the console ID:


 CONU  6A0   Master Console 6A0 ( ID=3 )

The following minor commands display information about the selected console.

ACTN

Displays only those lines from the screen that require some action.

Type:: Minor of CONS and CONU

ACTN displays any line that begins with an asterisk (*). You can use this command to display any outstanding Mount or Reply messages that need attention. ACTN has no arguments.

For example, to display commands that require operator action for console 3, enter:


CONS03   Console 6A0 (ID=3)
ACTN

LINE

Displays the last nn lines from the console you select.

Type:: Minor of CONS and CONU
Format:: LINEnn

To display the last 12 lines of the screen of console 11, enter this command:


CONS11   Master Console (ID=11)
line12

The LINE minor command displays only in-line messages, such as the display produced by the following command.


D A,L,L=Z

LINE does not display out-of-line messages, such as those produced by the following command.


D A,L,L=A

To avoid this situation, either use the L=Z operand where appropriate, or issue the following console control command to remove the out-of-line display areas:


K A,NONE

For JES2, OMEGAMON requires the $TM command to change the status information routing.

MNT

Displays mount messages that require operator action.

Type:: Minor of CONS and CONU

MNT has no arguments.

For example, to display mount messages for console 4, enter the following command:


 CONS04   Console 660 (ID=4)
 mnt
+ 2000 09.07.47 JOB 2225 *13 IEC701D M 370,VOLUME TO BE LABELED CA1759