Using the log browse utility (BBORBLOG)

Why and when to perform this task

The browser takes two 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 will be formatted on a lrecl length of 80 characters. Additional lines will be wrapped.

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



Steps for this task

  1. 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 browse data set named "userid.stream_name ", which contains the contents of the log stream. 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

Example

There are three valid ways (three separate commands to use) to invoke the browser. We will illustrate each of these using the following example:

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.




Searchable topic ID:   ttrbusebrw
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/ttrb_usebrw.html

Library | Support | Terms of Use | Feedback