Major, minor, and immediate command help

Major, minor, and immediate commands provide one-line help. Many of these commands also provide extended help, which displays more information about the command or the command operands.

A continuation character (+) following the end of the one-line help indicates that more (extended) help is available. To request help for a major, minor, or immediate command, enter one of three symbols (?, /, or ;) followed by the command.

Help symbols

Table 1. Help symbols
Symbol Description
? Displays a one-line help that stays on the screen until you clear it.
/ Displays an extended help that stays on the screen until you clear it. You can clear the help text with the .DCL command.
; Displays an extended help that is cleared from the screen on the next cycle.

Help examples

The following examples show the three symbols being used to obtain help for the .WAT command.

When you enter ?.WAT, one-line help is displayed.

>.WAT
>       Specifies a delay before executing the commands that follow.          +
Note: The continuation character (+) at the end of the one-line help indicates that extended help is available.
When you enter a slash followed by the command, as in /.WAT, an extended help is displayed.
>.WAT                                                                          
>       Specifies a delay before executing the commands that follow.          +
>                                                                              
>       Type of Command:  Immediate                                            
>                                                                              
>       Command Format:  .WATnn                                                
>                                                                              
>        1 | 2    |  Definition of operands                                    
>       -----------------------------------------------------------------------
>          | .WAT |  nn   Specifies the length of the delay (seconds) before   
>          |      |       the command(s) that follow are executed.             
>                                                                              
>       EXAMPLE:                                                               
>                                                                              
>        .WAT02                                                                
>        .FGO MYSCREEN                                                         
>                                                                              
>       The commands shown above cause OMEGAMON to wait 2 seconds before       
>       fetching screen space MYSCREEN.                                        
The entry ;.WAT produces the same output as ?.WAT, however, plus signs (+) display in column 1 of the lines below the one-line help. The plus signs indicate that the extended help text will disappear on the next cycle.
>.WAT                                                                          
>       Specifies a delay before executing the commands that follow.          +
+                                                                              
+       Type of Command:  Immediate                                            
+                                                                              
+       Command Format:  .WATnn                                                
+                                                                              
+        1 | 2    |  Definition of operands                                    
+       -----------------------------------------------------------------------
+          | .WAT |  nn   Specifies the length of the delay (seconds) before   
+          |      |       the command(s) that follow are executed.             
+                                                                              
+       EXAMPLE:                                                               
+                                                                              
+        .WAT02                                                                
+        .FGO MYSCREEN                                                         
+                                                                              
+       The commands shown above cause OMEGAMON to wait 2 seconds before       
+       fetching screen space MYSCREEN.                                        

Minor command help

You can obtain help for a minor command by using the ?, /, and ; symbols, without knowing the associated major command name. In some cases, however, the same minor name is used for multiple majors. If the function of the minor command is the same for all of its associated majors, OMEGAMON® for IMS displays help that lists the associated major commands with the help for the minor command, as shown in the following example, which displays the one-line help for the DIO minor command.
>DIO                                                                           
>  DIO  is a minor command of the following major(s):                          
>       DEV   DEVL  DEVP  DISK  DPAV  DSKB  DSKC  DSKE  DSKG  DSKM  DSKN  DSKP 
>       DSKQ  DSKR  DSKS  DSKU  DSKV  GDEV  TAPE  TPAL  TPBS  TPCU  TPFR  TPMT 
>       TPOF  TP16  TP38  TP62  TP7T  TP80  2305  2314  3330  3340  3350  3375 
>       3380  3390                                                             
>  Help:                                                                       
>       Displays the I/O count since IPL of the device(s).                    +

In cases where OMEGAMON for IMS uses the same minor command name for multiple major commands, but the function and help text differ, OMEGAMON for IMS lists the major command names and instructs you to place your cursor under the desired command. When you press Enter, the appropriate help displays.

If you know that the minor command is shared among several major commands and you know the major command, you can type the major command name on the same line after the help request. For example, entering /DIO DISK produces the help text for the DIO minor specific to the DISK major command.