Screen logging

The OMEGAMON® for IMS logging facility supports your printing screen spaces, output appearing on the logical screen, and selected lines from the screen. When the log is on, a copy of every screen display is written to the log. The OUTP major command sets the characteristics of the REPORT file.

OMEGAMON for IMS can log exception analysis screens automatically with the exception logging facility (XLF).

Activating the log

To turn on the log, enter the OPTN immediate command in the input area of the main body of the screen. Two columns of session options appear as shown in the following example.

 OPTN                                                  
:       ASF          = OFF          BELL         = ON  
:       BELLINT      =    60.00     DATEFORMAT   = USA 
:       FIRSTSCREEN  = KOINITZZ     LOG          = OFF 
:       MINORCASE    = LOWER        SCREENCASE   = MIX 
:       SCROLL       = PAGE         TSF          = OFF 
:       XLF          = OFF          ZEROS        = OFF

The status of the log (ON or OFF) displays after the LOG= entry. To initiate logging, type ON over the OFF entry. The word LOG appears on the INFO-line when the log is activated. As an alternative, you can use the .LOG immediate command to turn the log on and off (.LOGON and .LOGOFF).

When the log is on, OMEGAMON for IMS logs the screen output on each cycle. If you freeze the screen with the hold feature during automatic updating OMEGAMON for IMS logs only one time until you move the cursor from row 1, column 1, to resume automatic updating.

To force printing of the log, enter the /LOGOUT INFO-line command or the .LOGOUT immediate command. These commands close the current log file and dynamically reallocate it so that it is immediately reopened. If you set new parameters for the log file, you must issue a LOGOUT command for the new parameters to take effect.

To turn off the log, reenter the OPTN command and type OFF as the value for the LOG= entry. Or enter the .LOGOFF immediate command. The word LOG no longer displays on the INFO-line.

Checking the page limit

The OMEGAMON for IMS profile in effect at your site contains a default limit on the number of pages that are printed before the log stops. The PAGELIMIT= keyword of the .SET immediate command controls the page limit. You can also adjust the limit for your session by using the .PLM immediate command.

Before the log begins to print, .SET displays the current default page limit. To change the limit for your session enter .SET and type a new value over the current value for the PAGELIMIT= keyword, or enter .PLMnnnnn to set the limit.

During printing, the number that is displayed by .SET or .PLM decreases to reflect the number of pages that can be printed before the limit is reached. You can check the progress of the log by entering .SET or .PLM while logging. When the page limit display reaches zero, the screen space clears and a message appears to inform you that the page limit was reached. Press Enter to restore the screen display.

Logging a single display

To print a single screen image without turning on the log, use the /PRINT (or /P) INFO-line command.

The page limit does not affect the /PRINT command. /PRINT continues to work even when the counter is at zero.

Logging part of a display

To print selected lines from a screen space, use the .PRT command. The lines that precede the .PRT command are printed to the log.

 DISK    CPM023   DBRCPROD  DLSPROD IRLMPROD  MPP01   MPP02
 dadr       4F3        4F4      4F5      4F6    4F7     4F8
 >.PRT   >> Screen Printed up to this line << 
 dalc         8       16         6      12        24      16      32       8

In this example, OMEGAMON for IMS logs a copy of the lines that precede the .PRT command, and then changes the command to a comment (>.PRT). To log the lines continually, add the H (Hold) argument to .PRT (.PRTH), which prevents OMEGAMON for IMS from changing the command to a comment.