This topic applies only on the z/OS operating system.

Using the log browse utility (BBORBLOG)

Use the log browse utility (BBORLOG) to view log stream files.

About this task

The browser takes the following parameters.
Table 1. Log browse utility parameters
Parameter Description
log stream name The name of the log stream. See the job messages for the name of the log stream.
format option

80 The default. The log stream record is formatted on a lrecl length of 80 characters. Additional lines are wrapped.

NOFORMAT Turns off formatting. The error log message displays as one log message string in the browse file.

Procedure

View the error log stream output using the BBORBLOG browser. To invoke the browser, go to ISPF option 6 and enter:
'BBO.SBBOEXEC(BBORBLOG)' 'BBO.BOSSXXXX format option'
Note: In this example, BBORBLOG resides in BBO.SBBOEXEC.

Results

The browser creates a browser data set named userid.stream_name , which contains the contents of the log stream.
Important: The browser data set is named userid.stream_name if the invoking TSO environment includes a TSO PROFILE PREFIX value. If the user ID does not have a TSO PROFILE PREFIX value, then the default output data set name is stream_name.
When the browser is executed, it:
  1. Allocates a data set called userid.stream_name, which overwrites any duplicate data sets.
  2. Populates the data set with the contents of the log stream.
  3. Puts the user in "browse" mode on the data set.

Important: Each time BBORBLOG is invoked a static file is created which overwrites the existing file. In order to refresh the file, it is necessary to re-issue BBORBLOG

If the BBORBLOG utility (or SBBOLOAD) is not in the linklist or in link pack area (LPA), the utility fails with the following error:
 COMMAND BBORBLOG NOT FOUND 57 *-* ADDRESS TSO "BBORBLOG "strm" "format"" +++ RC(-3) +++

Example

There are several valid methods with separate commands to invoke the browser. The following example shows these different methods:

Example: If the BBORBLOG member was in a data set named BBO.SBBOEXEC, then you would issue one of the following depending on your chosen format option:
ex 'BBO.SBBOEXEC(BBORBLOG)' 'BBO.BOSSXXXX' 
ex 'BBO.SBBOEXEC(BBORBLOG)' 'BBO.BOSSXXXX  80'
ex 'BBO.SBBOEXEC(BBORBLOG)' 'BBO.BOSSXXXX  NOFORMAT'

Tip:: It is easier to invoke the browser if you add the target library (in our example, BBO.SBBOEXEC) to the SYSEXEC concatenation of the user logon procedure during the WebSphere Application Server for z/OS installation. If you concatenate the library during installation, you do not have to specify the library containing the browser REXX exec- you only need to specify BBORBLOG.

Task topic    

Terms of Use | Feedback

Last updated: Sep 20, 2010 11:08:29 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-mp&topic=ttrbusebrw
File name: ttrb_usebrw.html