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.