View the output data set
Use the SMF Browser to view the output data set from the WAS for z/OS UNIX environment.
The data set should be viewed using a program that can display record type 120.
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 WAS for z/OS UNIX environment:
- 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 WAS 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 the 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).
We 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 we do not receive any Java error messages after the invocation and the Browser output is shown on the screen.
Related tasks
Formatting the output data set
Collecting job-related information with the System Management Facility (SMF)
Related information:
Understand SMF Record Type 120, Subtype 9