Screen control

OMEGAMON® for IMS provides commands and other features that you use for screen control. For example, commands such as /UP and /DOWN scroll the screen, and the .D command deletes lines from the screen.

Scrolling

In the menu interface, the default scrolling keys are PF7/PF19 and PF8/PF20 (on terminals with 24 programmed function keys). In the command interface, OMEGAMON for IMS assigns PF7 and PF8 to analysis screens, so PF19 and PF20 are the default scrolling keys. The scrolling keys are set to /U and /D (which as aliases for /UP and /DOWN), and they scroll one physical screen at a time. You can change the default scroll amount with the OPTN command.

You can also scroll by using the /UP and /DOWN INFO-line commands. /UP and /DOWN (or /U and /D) accept the following arguments:

nnn: Scrolls nnn lines (nnn can be a number 1 - 999).

PAGE: Scrolls a physical screen at a time.

MAX: Scrolls up or down the number of LROWS defined for your terminal. The short form of MAX is M.
CSR: Scrolls according to the current location of the cursor. If the cursor is on the INFO-line, the scroll amount is one page.

As an alternative to /UP and /DOWN, you can use the INFO-line command /TOP to scroll to the top of the logical screen and /BOTTOM to scroll to the bottom of the logical screen.

You can also type any of the /UP and /DOWN arguments (such as nnn, MAX, or CSR) on the INFO-line, then press the scroll PF key to scroll up or down that amount. For example, if you type MAX on the INFO-line, then press PF20, OMEGAMON for IMS scrolls down the maximum number of lines.

Clearing the screen

If a menu, screen space, or any commands display on your screen, and you want to clear the screen, use the clear screen immediate command. The clear screen command consists of two periods followed by two blanks. Enter ..bb, where b is a blank, in the input area of any line below the INFO-line to clear the screen below it.

Deleting comment lines

If your screen is cluttered with lines of comment text (lines with > in column 1), and you want to clear the comments but retain other command text, you can use the /DCL INFO-line command or the .DCL immediate command. The /DCL command clears all comment lines on the logical screen, while the .DCL immediate command clears all comment lines after its entry line.

Inserting and deleting lines

To insert blank lines into a screen, use the following immediate command:

.I nn

The variable nn indicates the number of lines to insert. The default setting is 1. Note that the nn argument must begin in column 6.

OMEGAMON for IMS inserts the new lines above the line where you type the insert command. Therefore, all other lines currently on the screen below the inserted line shift downward. When the command executes, the line you typed over with the insert command restores to its original data.

For example, assume that your screen includes the following lines.

 DISK    VMXA04   VMXA05    VMSP50  VMHP02    OMONVM  DOSTST  DP215R  DOSRES +
 dadr       1A0      1A1       1B0     1B1       2A7     2B0     4F1     4F2
 dalc         8       16         6      12        24      16      32       8

You then type .I on the second line.

 DISK    VMXA04   VMXA05    VMSP50  VMHP02    OMONVM  DOSTST  DP215R  DOSRES +
 .I         1A0      1A1       1B0     1B1       2A7     2B0     4F1     4F2
 dalc         8       16         6      12        24      16      32       8

When you press Enter, a new line is inserted above the line where you typed .I and the original lines shift down.

 DISK    VMXA04   VMXA05    VMSP50  VMHP02    OMONVM  DOSTST  DP215R  DOSRES +
 
 dadr       1A0      1A1       1B0     1B1       2A7     2B0     4F1     4F2
 dalc         8       16         6      12        24      16      32       8

To delete lines from a screen space, use the .D nn immediate command, which works the same way as .I nn. When you do not specify the nn variable, it defaults to one deletion line.

You can also delete a block of data from the physical screen. To delete a block of lines, enter .DD on the first and last lines of the block, then press Enter.

Displaying continuation lines of command output

Some major commands select a series of items. Often, the display output does not fit onto one line. In this case, the major command displays only the first line of output, and a plus sign appears at the end of the line to indicate that more data is available.

To see a count of the number of items that are selected by a major command, enter a number sign (#) in column 1 before the command. The following example shows that there are 20 online disks for the DISK command to display:

#DISK      20

Continuing major command output

You can use a number of different continuation characters and commands to control the output display.

Enter a less-than sign (<) in column 1 in front of a major command to generate all of the output at once when the command executes.
After you issue a major command for the first time, you can put a number in column 1 to specify how many lines of the display to skip.
You can repeat a major command to display only the next line of output.

Continuing major and minor command output

When a major command lists a series of items that continues for more than one line, any minor command that you enter after the major command applies only to the last line of output. Therefore, if you enter a minor command after the third line of major command output, that minor command generates information only about the third line of items that are listed by the major. Normally, the major and minor commands must be repeated for each line of available output.

The .RC command is a shortcut to this process. The .RC command automatically repeats the major and the minor until all available lines of data are displayed. Enter the major command one time, followed by the minor commands, and then the .RC command after the minors. The set of major and minor commands are automatically repeated for every line of major command output.

For example, you enter the DISK major command followed by the DADR and DIO minor commands, then type the .RC command as shown in the following example.

 DISK    VMXA04   VMXA05    VMSP50  VMHP02    OMONVM  DOSTST  DP215R  DOSRES +
 dadr       1A0      1A1       1B0     1B1       2A7     2B0     4F1     4F2
 dio       4157     4240      3975    4010      4422     272    1638    1147
 .RC

When you press Enter, the set of commands repeats for each line of DISK output.

 DISK    VMXA04   VMXA05    VMSP50  VMHP02    OMONVM  DOSTST  DP215R  DOSRES +
 dadr       1A0      1A1       1B0     1B1       2A7     2B0     4F1     4F2
 dio       4157     4240      3975    4010      4422     272    1638    1147
 DISK    PPSMPE   TSO024    QM0001  OMON25    MTBLI3  DB2002  PPSMPE  TSO042 +
 dadr       148      149       14A     14B       14C     14D     14E     14F
 dio       6157    40885      3325    4115       277    1122   44322   48995
 DISK    CPM023   DBRCPROD  DLSPROD IRLMPROD  MPP01   MPP02
 dadr       4F3      4F4       4F5     4F6       4F7     4F8
 dio       3284     2140      3287    3967       298     275
.RC

Setting Program Function (PF) keys

When you use the command interface, the default PF key definitions differ from those key definitions that are used in the menu system. In the command interface, some PF keys are preset to control commands such as scrolling and printing, and a number of keys are set to IBM®-defined screen spaces for various types of analysis. Use the .PFK immediate command to list the PF key settings.

The following figure shows the default PF key definitions for the command interface.

Figure 1. Default PF keys for the command interface

 .PFK                                                       
+    01=KOI#01           /* EXCEPTION ANALYSIS, GENERAL INFO
+    02=KOI#02           /* ANALYZE ONE IMS REGION          
+    03=KOI#03           /* ANALYZE ALL DEPENDENT REGIONS   
+    04=KOI#04           /* PROGRAM SPECIFICATION BLOCKS    
+    05=KOI#05           /* DATABASE MANAGEMENT BLOCKS      
+    06=KOI#06           /* TRANSACTIONS                    
+    07=KOI#07           /* LOGICAL TERMINALS               
+    08=KOI#08           /* SCHEDULING CLASSES              
+    09=KOI#09           /* DEVICE STATISTICS (DASD  TAPE)  
+    10=KOINOSHI         /* SELF EDUCATION FACILITY REPLACED
+    11=KOI#11           /* NO ASSIGNMENT YET               
+    12=KOISWCH          /* COMMAND MODE/MENU MODE TOGGLE   
+    13=KOI#13           /* IMS INITIALIZATION PARAMETERS   
+    14=KOI#14           /* IMS DATASETS STATISTICS         
+    15=KOI#15           /* REAL, VIRTUAL MEMORY UTILIZATION
+    16=KOI#16           /* IMS POOL STATISTICS             
+    17=KOI#17           /* DATABASE BUFFER POOL STATISTICS 
+    18=KOI#18           /* DUMPING IMS CONTROL BLOCKS      
+    19=/U               /* SCROLL UP                       
+    20=/D               /* SCROLL DOWN                     
+    21=/PRINT           /* PRINT THE CURRENT SCREEN        
+    22=KOI#22           /* CONTROLLING EXCEPTION ANALYSIS  
+    23=KOI#23           /* CONTROLLING EXCEPTION GROUPS    
+    24=KOISWCH          /* CMD/MENU MODE TOGGLE

You can define new PF key settings for your current session with the .PFK command. For example, rather than typing

/DEF
ON

and /DEF OFF each time you create a screen space, you can assign /DEF ON to PF19 and

/DEF
OFF

to PF20. Then, you can use the PF keys to turn definition mode ON while you create a screen space and OFF when you finish. Define the keys and type comment text after a slash and asterisk (/*) as shown in the following example.

.PFK19=/DEF ON    /* Turns definition mode on
.PFK20=/DEF OFF   /* Turns definition mode off

Note: The PF keys that you define with .PFK are in effect only for the current session.

Your installation can allow you to assign screen spaces or INFO-line commands to up to 99 PF keys with the .PFK immediate command. To invoke the function that is associated with one of the 99 logical keys, you can type the PF key number on the INFO-line, then press Enter.

You can redefine several PF keys at the same time without having to reenter the .PFK command.

Beginning in column 1, type E.PFK, then press Enter. OMEGAMON for IMS gives you an extended display of all current PF key assignments, and inserts .PFK before each key number as shown in the following example.

E.PFK                                                       
+.PFK01=KOI#01           /* EXCEPTION ANALYSIS, GENERAL INFO
+.PFK02=KOI#02           /* ANALYZE ONE IMS REGION          
+.PFK03=KOI#03           /* ANALYZE ALL DEPENDENT REGIONS   
+.PFK04=KOI#04           /* PROGRAM SPECIFICATION BLOCKS    
+.PFK05=KOI#05           /* DATABASE MANAGEMENT BLOCKS      
+.PFK06=KOI#06           /* TRANSACTIONS                    
+.PFK07=KOI#07           /* LOGICAL TERMINALS               
+.PFK08=KOI#08           /* SCHEDULING CLASSES              
+.PFK09=KOI#09           /* DEVICE STATISTICS (DASD  TAPE)  
+.PFK10=KOINOSHI         /* SELF EDUCATION FACILITY REPLACED
+.PFK11=KOI#11           /* NO ASSIGNMENT YET               
+.PFK12=KOISWCH          /* COMMAND MODE/MENU MODE TOGGLE   
+.PFK13=KOI#13           /* IMS INITIALIZATION PARAMETERS   
+.PFK14=KOI#14           /* IMS DATASETS STATISTICS         
+.PFK15=KOI#15           /* REAL, VIRTUAL MEMORY UTILIZATION
+.PFK16=KOI#16           /* IMS POOL STATISTICS             
+.PFK17=KOI#17           /* DATABASE BUFFER POOL STATISTICS 
+.PFK18=KOI#18           /* DUMPING IMS CONTROL BLOCKS      
+.PFK19=/U               /* SCROLL UP                       
+.PFK20=/D               /* SCROLL DOWN                     
+.PFK21=/PRINT           /* PRINT THE CURRENT SCREEN        
+.PFK22=KOI#22           /* CONTROLLING EXCEPTION ANALYSIS  
+.PFK23=KOI#23           /* CONTROLLING EXCEPTION GROUPS    
+.PFK24=KOISWCH          /* CMD/MENU MODE TOGGLE

For each new assignment, blank out the plus sign (+) in front of .PFK for the targeted PF keys and type the new settings after the equal signs. When you press Enter, the PF key assignments take effect for the duration of the session.

Delaying automatic updating

The delay and hold features temporarily defer updating when you are in dedicated or VTAM® mode with automatic updating in effect.

Delay feature: While OMEGAMON for IMS is automatically updating, you can continue to enter commands. If OMEGAMON for IMS detects a cursor movement since the last update, it defers processing to avoid executing half-entered input. The words I/O Delay appear on the INFO-line, and the screen is not updated for the number of cycles that is specified with the IODELAY keyword of the .SET command.
Hold feature: If your screen display contains data that you want to study for longer than the normal automatic update interval, you can use the hold feature to temporarily freeze the screen image. To do so, place the cursor in the Home position, then move it back one space to the blank space in column 1 of the INFO-line. The words Hold Mode appear on the INFO-line, and the information on the screen does not change until you move the cursor away from row 1, column 1.