Usage notes
- LINES and DATERNG are mutually exclusive.
- The date format displayed in VIEWLOG will be based on the
CP DATEFORMAT
setting of the user issuing VIEWLOG. IfMODE RDR
orDATE
is specified, the date format will be provided inyyyy/mm/dd
format. - You can use the following default PF KEY assignments to move through the log
display:
- PF01 — Show the help screen.
- PF02 — Pass the current
VIEWLOG
session contents to XEDIT. - PF03 — End the VIEWLOG session.
- PF05 — Toggle the acknowledgment for a line in the log.
- PF07 — Scroll up.
- PF08 — Scroll down.
- PF10 — Scroll left.
- PF11 — Scroll right.
- PF12 — Retrieve previous command.
- PF19 — Scroll to the top.
- PF20 — Scroll to the bottom.
- PF21 — Process CMS command.
- PF22 — Display the users viewing the log.
- PF23 — Toggle auto scrolling.
- PF24 — Display the PF key assignments.
- PA02 — Toggle auto scrolling.
- ENTER — Process the command on the command line.
Note: For the scrolling PF keys, you can enter a scrolling amount on the command line. If no amount is specified, the scroll amount is equal to the size of the viewing area.A command may be typed on the command line for the process CMS command action.
- To invoke XEDIT to review the current content, you must have sufficient disk
space to save the current content. The filename and filetype of the file created by Operations Manager will be
_GOMALOG systemname
. If a file already exists, it will be overwritten.The default filemode of the file created by Operations Manager is A1. The XEDIT rules for filemode processing remain in effect. Thus, using the default filemode A1 will result in the file remaining on the A-disk upon exit.
You may control the file mode used to save the current content by using the
XEDITFM=fm
setting in VIEWLOG PROFILE. For example, by usingXEDITFM=A3
, if you do not save any changes to the file during the XEDIT session, it will be erased upon exit.Any changes made while using XEDIT are not reflected in the live view upon returning from XEDIT.
- Issue the following command in the VIEWLOG PROFILE file to control the
location, sharing, and disposition of the contents passed to
XEDIT:
XEDITFM=m[n]
where m is the file mode letter and n is the file mode number.
- The minidisk/SFS accessed as m, must be R/W (read/write).
- The file mode number may be any valid CMS file number. You can specify a file mode number of 3 and the file passed to XEDIT will be erased by XEDIT after reading the file. If you specify a file mode number of 3, you must use the SAVE/FILE XEDIT command to retain the file.
The default is
XEDITFM=A1
. - The amount of data displayed or sent to your virtual reader from the log is limited to the size
of the logging data space. The logsize parameter on
GOMMAIN
determines this limit. If you want to view the entire log, use theDATE
operand to obtain a log of the entire day. - To search through the display, use the forward slash (/) to search forward and the back slash (\) to search backward. Use the equal sign (=) to repeat the previous command. See DEFOPTN for information on how to change these characters.
- The actions for PF01 - PF24 and initial value for the PF key display are configurable through
the
VIEWLOG PROFILE
file.- Issue the following command in the
VIEWLOG PROFILE
file to set the PF key assignments:PFnn=action
Where nn is 01 through 24 and action is a valid PF key action.
The valid PF key actions are:- HELP — Show the help screen.
- XEDIT — Pass the current
VIEWLOG
session contents to XEDIT. - END — End the VIEWLOG session.
- HOLD — Toggle the acknowledgment for a line in the log.
- UP — Scroll up.
- DOWN — Scroll down.
- LEFT — Scroll left.
- RIGHT — Scroll right.
- RECALL — Retrieve previous command.
- TOP — Scroll to top.
- BOT — Scroll to bottom.
- EXCMD — Process a CMS command (the command to process may be
included).
Refer to Usage Note 9 for more information.
- USERS — Display the users viewing the log.
- SCROLL — Toggle auto scrolling.
- VIEWPF — Display the PF key assignments.
- Issue the following command in the
VIEWLOG PROFILE
file to control the display of the PF key information lines:SHOWPF=c[,h,xat,clr]
Wherec
is one of the following options:N
— Do not display the PF key assignments on the screen.Y
— Display PF01–PF12 assignments on the screen.A
— Display PF01–PF24 assignments on the screen.
The values for h,xat,clr are optional. If one of the values is specified, they must all be specified.h
— Specifies if the line is highlighted. Values areY
orN
.xat
— Specifies the extended attributes applied to the line. Values are:AAI
— Leave as isABL
— BlinkingARV
— Reverse videoAUL
— Underline
clr
— Specifies the color applied to the line. Values are:CAI
— Leave as isCBL
— BlueCRE
— RedCPI
— PinkCGR
— GreenCCY
— CyanCYE
— YellowCWH
— White
The following shows an example of what might be in a
VIEWLOG PROFILE
file after customizing a PF key assignment and the display of the PF keys:PF13=HELP SHOWPF=Y,Y,AAI,CAI
- Issue the following command in the
- While using
VIEWLOG
, you can also execute a z/VM® or Operations Manager command by usingEXCMD
. Execute theEXCMD
command with one of the following methods:- Press a function key that is assigned to
EXCMD
without any command on the command line. This invokes CMS SUBSET. To return toVIEWLOG
, use the CMS commandreturn
. - Press a function key that is assigned to
EXCMD
with a CMS command on the command line.When the command completes, if the command on the command line is not an Operations Manager command, you return to the originating
VIEWLOG
command.When the command completes, if the command on the command line is an Operations Manager command, you return to the point that originated the
VIEWLOG
command. - Assign
EXCMD
with a z/VM or Operations Manager command to a PF key inVIEWLOG PROFILE
. For example,PF19=EXCMD LISTFILE * * A
orPF20=EXCMD GOMCMD OPMGRM1 VIEWSPL
.When the command completes, if the command assigned to the PF key is not an Operations Manager command, you return to the originating
VIEWLOG
command.When the command completes, if the command assigned to the PF key is an Operations Manager command, you return to the point that originated the
VIEWLOG
command.
- Press a function key that is assigned to