|
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 ftp.software.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:
- 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')
- 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.
- Ensure that SYS1.MIGLIB is APF-authorized (this is most likely the
case already)
- In data set LOGR.VIEWER(LRSTRT), replace LOGR.VIEWER and
LOGR.VIEWER.LOAD with the names of the data sets that you downloaded.
- You may need to customize the VIO unit name assignment statement contained
in LOGR.VIEWER(LOGRPRT).
- Enter LRSTRT to start the application.
- 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 z/OS.
Send us your questions and comments.
Netscape and Netscape Navigator are registered trademarks of Netscape
Communications Corporation.
Microsoft is a trademark of the Microsoft Corporation.
|
