# Log Stream Viewer

Log and trace data can optionally be written to the IBM z/OS System Logger.

To view these logs, go to the CLIST library, execute the SXGSSPNL CLIST, and select option 3, labeled System Logger Search and Display Facility. The following TIBCO Log Stream Viewer panel appears.

Alternatively, go to the CLIST library, execute the SXLRVIEW clist, to display the following TIBCO Log Stream Viewer panel.

      Select option   ==>
             1   Configuration
             2   LTA Search and Display Facility
             3   System Logger Search and Display Facility

      ENTER = PROCEED   END PFKey = RETURN

    ________________________________________________________________________________

    ---------------------------- TIBCO Log Stream Viewer ----------------------------
     Command ===>

        STREAM  __________________________        HUBNAME ____

        JOBNAME ________

        JOBID   ________

        UOW. .  ________________________________

        CORRID  ________________________________________________________________

                          YYYY MM DD  HH MM SS
        START DATE/TIME . 2019 12 06  23 47 45
        END   DATE/TIME . 2019 12 07  23 59 59

     Press PF3 to terminate or ENTER to continue

    ________________________________________________________________________________

In the TIBCO Log Stream Viewer panel, fill in the STREAM name used in your HUB setup for the log, trace or statistical file.

Alternatively, fill in the following fields to reduce the amount of output displayed.

Fields | Description
--- | ---
HUBNAME | By default, the TIBCO Log Stream Viewer will use the system default HUB. The default value is the SMF ID of the LPAR. If you want to use a different HUB, specify the HUB name in this field.
JOBNAME | Full or partial jobname, for example, MYJOBNM or MYJOB* to select output from a single or multiple jobs.
JOBID | Full JOBID in the format STCnnnnn, JOBnnnnn, or TSUnnnnn.
U0W | Full or partial Unit of work ID, for example,1234 to show all UOWs containing the string 1234.
CORRID | Full or partial correlation ID, for example, 1234 to show all correlation IDs containing the string 1234.
START DATE/TIME | Start date & time of events. It defaults to 24 hours ago.
END DATE/TIME | End date & time of events. It defaults to the end of the current day.

Press Enter to display the selected data in a normal browse interface, where all the usual browse commands work. Press F1 to display the Commands available under Tibco Log Stream Viewer panel. This panel lists all the supported logger specific commands.

Note: When you are working with very large logger streams, setting START DATE/TIME and END DATE/TIME relatively accurately are helpful in reducing search time and resources consumed.

Logger specific commands and their detailed information are provided below:

Commands | Description
--- | ---
#C | Displays the jobname, Unit Of Work, and Correlation ID for the current line, or the line where the cursor is located, if inside the data. This allows you to pick a specific job, Unit Of Work, or Correlation ID. Click PF7 to move to previous line and PF8 to move to next line. Click PF3 to go to the Selection menu and refine the amount of data to be displayed.
#I | Displays a popup window containing the selection criteria from the previous menu.
#R | Refreshes the log stream browse display by reading any events that were added to the log stream since browse was invoked and adding these events to the current display.
#S | Displays a popup menu of the Correlation ID, Unit of Work and various Statistics from the record pointed to by the cursor. Click PF7 to move to previous line and PF8 to move to next line.

Procedure to use the command to display detailed information about a message.

1. In command line, type the command you want to use.
2. Point the cursor to the message that is to be queried, then press Enter.

   A pop-up panel displays the related detail information.

3. Use the PF7 or PF8 keys to navigate to previous or next line respectively.

Note: If the cursor is on the command line and you press Enter, details of the first message on the screen are displayed.

For each command, fields and their detailed information are provided below:

Fields | Description
--- | ---
JOBNAME | The corresponding job name for the message.
JOB-ID | The corresponding job ID for the message.
UOW | The corresponding UOW number for the message.
CORRID | The corresponding correlation ID for the message.
ENVIRON | The corresponding environment of the application that issues the message. The list of environment are BATCH, EMS Interface, RV Interface, KAFKA, EXCI Interface, CICS RED, IMS, RED, and Unknown.
REGION | The corresponding region that produces the message.
NODENAME | The corresponding node-name for the message. The nodename is typically an Interface Id, a CICS, or IMS transaction or a batch stepname; any resource name that enabled the program to execute.
RESOURCE | The corresponding resource related to the message. It is a program or queue name, a container or channel name, an IMS PSB or some resource name to identify what the event is using.
MARKER | The corresponding execution cycle marker for the message. This field is shown on the log viewer in #S mode. The valid values are as follows: 0 - Not set 1 - Start 5 - Body 9 - End The default value is 5.

Copyright © TIBCO Software Inc. All rights reserved.