Usage notes

  1. LINES and DATERNG are mutually exclusive.
  2. The date format displayed in VIEWLOG will be based on the CP DATEFORMAT setting of the user issuing VIEWLOG. If MODE RDR or DATE is specified, the date format will be provided in yyyy/mm/dd format.
  3. 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.

  4. 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 using XEDITFM=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.

  5. 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.

  6. 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 the DATE operand to obtain a log of the entire day.
  7. 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.
  8. The actions for PF01 - PF24 and initial value for the PF key display are configurable through the VIEWLOG PROFILE file.
    1. 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.
    2. Issue the following command in the VIEWLOG PROFILE file to control the display of the PF key information lines:
      SHOWPF=c[,h,xat,clr]
      Where c 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 are Y or N.
      • xat — Specifies the extended attributes applied to the line. Values are:
        • AAI — Leave as is
        • ABL — Blinking
        • ARV — Reverse video
        • AUL — Underline
      • clr — Specifies the color applied to the line. Values are:
        • CAI — Leave as is
        • CBL — Blue
        • CRE — Red
        • CPI — Pink
        • CGR — Green
        • CCY — Cyan
        • CYE — Yellow
        • CWH — 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
  9. While using VIEWLOG, you can also execute a z/VM® or Operations Manager command by using EXCMD. Execute the EXCMD 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 to VIEWLOG, use the CMS command return.
    • 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 in VIEWLOG PROFILE. For example, PF19=EXCMD LISTFILE * * A or PF20=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.