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. The data stored in the WebSphere® Application Server log stream must be formatted using the BBORBLOG Rexx Exec routine. By default, BBORBLOG formats the error records to fit a 3270 display.
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.

reclen This optional keyword parameter specifies the formatted record length for the output data set. When you use this parameter, it must follow the log stream name and format option parameters in order. However, if you specify this parameter, the format option is an optional positional parameter. If you specify NOFORMAT for the format option parameter, the default value is 4096. If the format option parameter value is 80, this parameter value defaults to 80. The value range for this parameter is 80 to 32752.
outdsn This optional keyword parameter is the non-fully qualified data set name for the output data set. When you use this parameter, it must follow the log stream name and format option parameters in order. The default value for this parameter is the name of the log stream.

Procedure

  1. Edit BBO.SBBOEXEC(BBORBLOG) and set the bborblogpath variable to the HFS path where the bborblog dll exists or copy the bborblog dll from the HFS into a dataset that is in linklist. For example, copy the cp -X bborblog "//'xxx.LOAD(bborblog)''' command.
  2. 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 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'
ex 'BBO.SBBOEXEC(BBORBLOG)' 'bbo.bossxxxx NOFORMAT reclen=5200 outdsn=bbos001.stc00123.bborblog'
ex 'BBO.SBBOEXEC(BBORBLOG)' 'bbo.bossxxxx NOFORMAT outdsn=bbos001.stc00456.bborblog'
ex 'BBO.SBBOEXEC(BBORBLOG)' 'bbo.bossxxxx 80 reclen=200'

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 Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 3:08:41 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-zos&topic=ttrbusebrw
File name: ttrb_usebrw.html