Do you manage your 390 Logrec error log using a System Logger stream (LOGR)? Do you have a desire to view your Logrec through an ISPF application? If so, this download should be of interest to you.

The Logrec Viewer is an ISPF application that obtains an EREP report for the Logrec stream (for a Logger-resident stream, or SYS1.LOGREC). From the panel, you can navigate to view a summary of the LOGREC data, or display detailed software records. The logrec source is based on the EREP JCL (SERLOG DD statement). From the ISPF panel, you can enter one of the following options:

	S = Summarize LOGR LOGREC data
	D = Detailed LOGR Software Records
	I = LOGR Logrec Inventory
	O = User EREP Input from dataset

Just below the start and end time criteria in the initial panel, the following is shown:

       Select LOGREC archive data sets. . . N  (N/Y)

Specifying 'N' (the default) results in displaying the currently active Logrec data (obtained from your LOGR stream or Logrec data set). Specifying 'Y' allows you to display data from a Logrec archive data set. Also specify 'S' next to "Option===>". The next panel allows you to specify the dataset name prefix for your archive files (for example, ABRAMS.EREP). After pressing enter, the individual archive files will be displayed (for example, ABRAMS.EREP.A1, .A2, etc.). Select the desired file to be formatted and press enter.

Downloading the tool

You can download this tool (transmit.logr.viewer) and its associated load module (transmit.logr.viewer.load) either by using your browser or anonymous ftp.

To download using your browser, shift-click on the following download link using Netscape Navigator® or right-click on the following download link using Microsoft™ Internet Explorer.

Download Logrec Viewer

Download Logrec Viewer load module

To download using anonymous ftp, ftp to public.dhe.ibm.com. Then, cd to s390/zos/ispf/logrec_viewer/. The files tersed.logr.viewer and tersed.logr.viewer.load can be found in the directory /u/ftp/s390/zos/ispf/logrec_viewer/.

Upload the tersed files as binary.

The files that you download are packed in TRANSMIT format. To unpack the file, specify RECEIVE INDSNAME(transmit.logr.viewer), and when prompted, specify the target dataset name (e.g., DS(LOGR.VIEWER) ). Follow the same steps for transmit.logr.viewer.load. (This eliminates the need to use TRSMAIN, as in the last version of this tool.)

Additional usage instructions

In addition to downloading and unpacking the file, you will need to do the following:

  1. Add LOGR.VIEWER to your SYSLIST so that the REXX execs work. To make the file available on a user basis, use the TSO ALTLIB command. For example:
    TSO ALTLIB ACT APPL(CLIST) DS('ABRAMS.LOGR.VIEWER')
    
  2. Include IXCMIAPU in the AUTHPGM list in SYS1.PARMLIB(IJKTSOxx) (whichever xx you are using on your system, 00 is default). This authorizes the exec to use this logger CDS maintenance program to lookup the names of the logger streams.

  3. Ensure that SYS1.MIGLIB is APF-authorized (this is most likely the case already)

  4. In data set LOGR.VIEWER(LRSTRT), replace LOGR.VIEWER and LOGR.VIEWER.LOAD with the names of the data sets that you downloaded.

  5. You may need to customize the VIO unit name assignment statement contained in LOGR.VIEWER(LOGRPRT).

  6. Enter LRSTRT to start the application.

  7. In the initial panel, titled LOGREC Utility - Data Set, enter the location of your EREP input data. A sample is provided in LOGR.VIEWER(LOGRPRTI). In addition, when viewing the content of the LOGR stream, enter the start and end dates to be used.

Additional information about the Logrec Viewer

The ISPF SYSPLEX.LOGREC.ALLRECS log stream viewer is made up of the following parts (members of LOGR.VIEWER):

 

LOGR.VIEWER members
Name Type Description
LOGINFO REXX EXEC Extract log stream information
LOGPRIM ISPF Panel Used by the LOGRPRT REXX EXEC
LOGRAL ASM Source TSO command processor for allocating a subsystem data set (e.g. a log stream)
LOGRALUL Load Module LOGRAL load module in ITD XMIT to OUTDS format. Use RECEIVE INDS to restore the load module.
LOGRPDSN REXX EXEC ISPF Panel for specifying an archive data set.
LOGRPRT REXX EXEC The main line REXX program. To invoke LOGREC viewer enter TSO LOGRPRT on the ISPF primary command line. LOGRPRT invokes the LOGINFO REXX, LOGRPRTM REXX, and the LOGRAL load module. All these three parts must be available for the LOGRPRT dialog. Note: You need to customize the VIO unit name assignment statement before using the LOGRPRT REXX.
LOGRPRTI Sample input Sample input data set for EREP (not required).
LOGRPRTM REXX Edit Macro Used by the LOGRPRT when EREP output viewing is invoked.
LRSTRT REXX EXEC Starting exec for running the Logrec Viewer.

In addition, the data set LOGREC.VIEWER.LOAD contains an object for the LOGRAL program.

Logrec Viewer questions or suggestions?

For questions on this exec, or suggestions for improvement, contact:

Bob Abrams
abrams@us.ibm.com
845-435-6832

Contact IBM

Browse z/OS