Checking the log streams

To check, or browse, the contents of a log stream, you use the panel shown in Figure 1. In the panel, you identify the log you want to view, whether you want a summary report or a detailed report, and supply any optional filters that you need to limit the information returned.

If you want to determine on which system a resource manager can restart, select log option 4, the RRS Resource Manager Data Log, and specify the resource manager name. For a description of the output, see Resource manager entry.

On the panel, you can specify only log streams that are currently defined to system logger. You cannot browse a log stream that has been copied and is no longer defined to system logger.

The system displays the sysplex name in the log group name field. The Default Group Name field will be set to the RRS logging group name being used on the system; or, the sysplex name, if RRS is not active on the system. If you want to browse the contents of logs with a different name, type the log group name in the field.

You can also identify the output data set (the data set the system is to use to hold the information you request). If you do not provide a name, the system uses userid.ATR.REPORT.

Figure 1. Log Stream Selection (ATRFPLBS)

                           RRS Log Stream Browse Selection    
 Command ===>                                             
                                                             
 Provide selection criteria and press Enter:                 
                                                              
                                                                
 Select a log stream to view:                 Level of report detail:
 _   1.  RRS Archive log                      _   1.  Summary    
     2.  RRS Unit of Recovery State logs          2.  Detailed  
     3.  RRS Restart log                                      
     4.  RRS Resource Manager Data log    
     5.  RRS RM Metadata log                                    
                                                                 
 RRS Group Name . . . ________  Default Group Name: : ________
 Output data set  . . ATR.REPORT                                  
                                                                  
 Optional filtering:                                           
   Entries from . . . .             LOCAL date in yyyy/mm/dd format
                                  LOCAL time in hh:mm:ss format
   through  . . . . . .             LOCAL date in yyyy/mm/dd format
                                  LOCAL time in hh:mm:ss format
   UR identifier  . . .                                   (Options 1,2,3)
   RM name  . . . . . .                                   (Options 4,5)
   SURID                                                  (Options 1,2,3)

Use filters as much as possible; a request without filters might return a huge number of entries. Using filters is especially important if you are running RRS in a Parallel Sysplex®. When you select any of the first three logs, you can specify a UR identifier (URID), which limits the search to entries for that UR. When you select option 4 or 5, you can identify a resource manager, which limits the search to entries associated with that resource manager.

With any log, you can use the date and time filters to limit the search to log entries after a certain date or time, log entries before a certain date or time, or log entries that fall within a range of dates and/or times. The following example shows how to define a range of hours within the same day:

  Entries from.  . . . 1997/03/15  (yyyy/mm/dd)
                       02:00:00 (hh:mm:ss)
  through. . . . . . . 1997/03/15  (yyyy/mm/dd)
                       10:00:00 (hh:mm:ss)

IBM® Recommends that you specify date and time filters to limit the amount of data searched when browsing the RRS Archive log using a URID filter. The URID filter causes the log browser to search the entire section of the RRS Archive log that might contain the URID. Because of the potentially large amount of data in the RRS Archive log, the absence of the date and time filters may result in noticeable delays.

After you have defined your selection and pressed Enter, the system browses the logs for the log group you name and returns the log entries that match the criteria you specified. Each entry block has a header line that includes the name of the system from which the block was written, the date and time when the block was written, and the system logger identifier of the block. The header line has the following format:

     system  mm/dd/yyyy hh:mm:ss.ssssss  LOCAL         BLOCKID=xxxxxxxxxxxxxxxx   
     BLOCK=xxxx OF yyyy NEXT BLOCKID=xxxxxxxxxxxxxxxx

You can obtain the following types of report entries:

UR entry, either summary or detail
Available from the RRS archive log stream, the RRS unit of recovery (UR) state log stream, and the RRS restart log stream. See UR entry.
Archive entry, either summary or detail
Available from the RRS archive log stream. See Archive entry.
Resource manager entry
Available from the RRS resource manager log stream. See Resource manager entry
Resource manager meta data entry.
Available from the Resource manager meta data log stream. See Resource manager meta data entry.

Each UR has a unique UR identifier. When you browse the UR state log stream, you will find multiple entries for a particular UR. Multiple resource managers might have expressed an interest in the UR, and the entries are logged over time. Only the entry with the latest timestamp contains current information.

Each resource manager also has a unique name. When you browse the resource manager data log stream, you might find multiple entries for a particular resource manager. Only the entry with the latest timestamp contains current information.

You can also filter by sysplex unit of recovery identifier (SURID). No wildcards are supported for SURID on this panel. SURID filtering is only valid for UR related log streams (archive, unit of recovery, and restart log streams).