Use the SMF Browser to view the output data set from the WebSphere® Application Server for z/OS® UNIX environment.
Before you begin
The data set should be viewed using a program that can display
record type 120.
About this task
The SMF Browser is provided in the form of a JAR file named
bbomsmfv.jar. The
bbomsmfv.jar file
is not supported by IBM®. To use it from the WebSphere Application Server for z/OS UNIX environment:
Procedure
- Verify that the JAVA_HOME environment
variable refers to the current Java™ installation: JAVA_HOME=../usr/bin/java/J1.3. This must be at least Java 1.3 since this release is the first to implicitly contain the necessary
record support needed by the SMF Browser.
- Download the SMF Browser from the WebSphere Application Server for z/OS website at: https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=zosos390.
The website
also provides a separate batchsmf.jar file to
format batch data.
- Copy the bbomsmfv.jar file to your
tools directory. Be sure that any edits made to the file
in the future are made to both copies of the file, or run from the
installation directory in the first place.
- To interpret SMF data from a cataloged WebSphere Application Server for z/OS sequential file named "USER.SMFDATA"
(which was previously created using the IFASMFDP utility as described
previously), run: java -cp bbomsmfv.jar com.ibm.ws390.sm.smfview.SMF
"INFILE(USER.SMFDATA)". It is implicit in
the Java command parameterization that your current working directory
is the tools directory. If this is not the case, you receive a NoClassDefFoundError
on com.ibm.ws390.sm.smfview.SMF message. Java does not generate a
diagnostic when it does not find the bbomsmfv.jar file in the current directory.
A sample
report is provided in Collecting job-related information with the
System Management Facility (SMF).
You can create
a summary report with the
PLUGIN parameter. For example,
for a batch summary report:
java -cp bbomsmfv.jar:batchsmf.jar com.ibm.ws390.sm.smfview.SMF 'INFILE(USER.SMFDATA)' 'PLUGIN(PERFSUM,STDOUT)'
The
PLUGIN keyword requires a class (
DEFAULT or
PERFSUM) and parameter string (
STDOUT or file name, such as
/tmp/SmfOutput.txt) separated
by a comma.
Results
The SMF Browser is successfully installed and invoked when
you do not receive any Java error messages after the invocation and
the Browser output is shown on the screen.