Go to Home Page
Questions?
Call 1-800-572-5517
 
  Go to Home Page  
  See all products
  See price schedules
  See manuals, tutorials, articles
  Download a free 30-day trial
  See user testimonials
  About Pacific Systems Group
 
 
SMF Tools
  See SMF Record Layouts
  See Sample SMF Reports
  Learn How to Export SMF Data
  Download Free SMF Reporting Software (30 days)
 
One of the greatest SMF record parsing programming languages I've ever seen. Chief, Large Systems Services Branch, NIH
  Choose Spectrum Writer to add 4GL to your product
  Free 60-Page Book (PDF) - How to Make an SMF Report
Spectrum DCOLLECT Reporter - the 4GL DCOLLECT Report Writer.

Spectrum SMF Writer - the 4GL SMF Report Writer.

SMF Type 120 Record - Subtype 8

This table shows the record layout for type 120 SMF records
(WebSphere Appl - WebContainer Interval Record - Version 2).

List of other SMF record layouts available.
List of sample SMF reports.

Purpose: WebSphere Application Server writes record type 120 to collect WebSphere Application Server performance statistics.

Record type 120 has the following subtypes:

  • Subtype 1 - the Server Activity record
  • Subtype 6 - the Server Interval record
  • Subtype 5 - the J2EE Container Activity Record
  • Subtype 6 - the J2EE Container Interval Record
  • Subtype 7 - the WebContainer Activity record
  • Subtype 8 - the WebContainer Interval record

Subype 8 - WebContainer Interval Record (Version 2)

The purpose of the WebContainer interval SMF record is to record activity within a WebContainer running inside a WebSphere® Application Server for z/OS® transaction server.

The Web Container acts as a Web Server handling HttpSessions and Servlets. The EJB container is not aware of the purpose of the WebContainer activity record and only records that the EJB has been dispatched, but does not gather any of the detailed information, such as HttpSessions, Servlets, and their respective performance data. A single WebContainer record is created for each Web container.

In addition to data that is associated with an individual activity, there are some cases of Web container work that are performed outside the scope of an individual request. For example, some instances of http session finalization and http session invalidation are performed asynchronously. In such a case a WebContainer interval record would record this data

WebContainer SMF recording is activated and deactivated along with the activation and deactivation of SMF recording for the J2EE container.

The WebContainer Interval record contains:

  • WebContainer inverval section (one section per record):
    Contains information about each activity that occurred within one Web Container in the specified interval.
  • HttpSessionManager activity section (one section per record):
    Contains information about all sessions involved in this activity in the specified interval.
  • WebApplication activity section (multiple (0..n) sections per record):
    Contains information about all WebApplications involved in this activity in the specified interval.
    • Servlet activity section (multiple (0..n) sections per WebApplication section):
      Contains information about all Servlets involved in this activity in the specified interval.

It's easy to report on SMF 120 data! (Jump to sample reports)

SMF Spectrum Writer
We have a low-cost 4GL report writer especially for SMF files. It's called Spectrum SMF Writer.

Spectrum SMF Writer handles the difficult SMF record parsing for you automatically. You just specify which fields you want to see.

Spectrum SMF Writer also converts the arcane date and time fields and reformats them into an attractive report.

Plus, Spectrum SMF Writer can export SMF data as comma delimited files to use on your PC.
 
Try It FREE Now!

SMF Type 120 Record -- WebSphere Appl - WebContainer Interval Record - Version 2
Offset
(Dec.)
Offset
(Hex)
NameLengthFormatDescription
00SMF120LEN2binary
Record length. This field and the next field (total of four bytes) form the RDW (record descriptor word).
22SMF120SEG2binary
Segment descriptor (see record length field)
44SMF120FLG1binary
Bit meaning when set
0: New SMF record format
1: Subtypes used
2: Reserved
3-6: Version indicators*
7: Reserved
55SMF120RTY1binary
Record type 120(X'78')
66SMF120TME4binary
Time since midnight, in hundredths of a second, that the record was moved into the SMF buffer.
10ASMF120DTE4packed
Date when the record was moved into the SMF buffer, in the form 0 cyydddF.
14ESMF120SID4EBCDIC
System identification (from the SMFPRMxx SID parameter)
1812SMF120SSI4EBCDIC
Subsystem identification from SUBSYS parameter
2216SMF120RST2binary
Record subtype:
1: Server activity
2: Container activity
3: Server interval
4: Container interval.
5: J2EE container activity
6: J2EE container interval
7: WebContainer activity
8: WebContainer interval
2418SMF120TRN4binary
Number of triplets in this record. A triplet is a set of three SMF fields (offset/length/number values) that defines a section of the record. The offset is the offset from the RDW.
Subtypes:
1: Value is equal to the number of sessions +2
2 and 4: Value is equal to the number of classes +2.
281CSMF120PRS4binary
Offset to product section from RDW.
3220SMF120PRL4binary
Length of product section.
3624SMF120PRN4binary
Number of product sections.
Individual header extension for subtype 8
4028SMF120WI14binary
Offset to WebContainer interval section from RDW.
442CSMF120WI24binary
Length of WebContainer interval section.
4830SMF120WI34binary
Number of WebContainer interval sections.
5234SMF120WI44binary
Offset to HttpSessionManager interval section from RDW.
5638SMF120WI54binary
Length of HttpSessionManager interval section.
603CSMF120WI64binary
Number of HttpSessionManager interval sections.
The following triplet appears once for each WebApplication section.
6440SMF120WI74binary
Offset to WebApplication section from RDW.
6844SMF120WI84binary
Length of WebApplication section.
7248SMF120WI94binary
Number of WebApplication sections.
Product Section
(Offset from beginning of record: SMF120PRS)
00SMF120MFV4binary
CB SMF version
44SMF120COD8EBCDIC
Character codeset in which strings in the SMF record are encoded
12CSMF120END4binary
Encode of numbers in the SMF record
1610SMF120TSF4binary
Encoding of timestamps:
1: S390STCK64: The time values are encoded in 64-bit S/390 Store Clock format.
Reassembly information.
2014SMF120IXR4binary
Index of this record
2418SMF120NRC4binary
Total number of records
281CSMF120NTR4binary
Total number of triplets
Subtype 8 - WebContainer Activity Section

There is one section per record. The WebContainer activity section contains information about each activity that occurred within one web container.

(Offset from beginning of record: SMF120WI1)
00SMF120WIA64EBCDIC
The WebSphere transaction server host name.
6440SMF120WIB8EBCDIC
The WebSphere transaction server name.
7248SMF120WIC8EBCDIC
The WebSphere transaction server instance name.
8050SMF120WID16S390STCK
The time the sample began.
9660SMF120WIE16S390STCK
The time the sample ended.
11270SMF120CL58EBCDIC
Cell
12078SMF120ND58EBCDIC
Node
HttpSessionManager Section

There is one section per record. The HttpSessionManager section contains information about all (there may be zero or one) http sessions associated to one single activity.

(Offset from beginning of record: SMF120WI4)
00SMF120WIF4binary
'createdSessions': Number of http sessions that were created.
44SMF120WIG4binary
'invalidatedSessions': Number of http sessions that were invalidated.
88SMF120WIH4binary
'activeSessions': Current® number of http sessions that are actively referenced in the server at the end of the interval.
12CSMF120WII4binary
'minActiveSessions': Minimum number of active http sessions during the interval..
1610SMF120WIJ4binary
'maxActiveSessions': Maximum number of active http sessions during the interval.
2014SMF120WIK4binary
'sessionLifeTime': Average lifetime (in milliseconds) of invalidated http sessions.
2418SMF120WIL4binary
'sessionInvalidateTime': Average time (in milliseconds) that was required to process the invalidation of http sessions.
281CSMF120WIM4binary
'finalizedSessions': Number of sessions that were finalized.
3220SMF120WIN4binary
'liveSessions': Total number of http sessions being tracked by the server at the end of the interval. This includes both active and inactive sessions.
3624SMF120WIO4binary
'minLiveSessions': Minimum number of live http sessions during the interval.
4028SMF120WIP4binary
'maxLiveSessions': Maximum number of live http sessions during the interval.
WebApplication Section

There are multiple (0-n) sections per record. The WebApplication section contains information about all WebApplications involved in this activity.

(Offset from beginning of record: SMF120WI7)
00SMF120WIQ256Unicode
The WebApplication name.
256100SMF120WIR4binary
'numLoadedServlets': Number of servlets that were loaded.
260104SMF120WIS4binary
Number of servlet triplets in this web application section. Note: This value might differ from the number of servlet sections in this record since servlets might exist that have been inactive during the interval.
Servlet Triplets

The following triplet appears 0-n times, once for each servlet section

(Offset from beginning of record: SMF120WI7 + 264)
00SMF120WIT4binary
Offset to servlet section from the beginning of this WebApplication section.
44SMF120WIU4binary
Length of the servlet section.
88SMF120WIV4binary
Number of servlet section.
Servlet Activity Section

There are multiple (0-n) sections per WebApplication section. The Servlet activity section contains information about each servlet associated with WebApplications involved in this activity.

(Offset from beginning of record: SMF120WI7 + SMF120WIT)
00SMF120WIW256Unicode
The servlet name.
256100SMF120WIX4binary
'totalRequests': Number of times the servlet service was requested during the interval.
260104SMF120WIY4binary
'responseTime': Average response time in milliseconds.
264108SMF120WIZ4binary
'minResponseTime': Minimum response time in milliseconds.
26810CSMF120WJ14binary
'maxResponseTime': Maximum response time in milliseconds.
272110SMF120WJ24binary
'numErrors': The number of errors that were encountered during servlet execution.
276114SMF120WJ316EBCDIC
'loadedSince': Timestamp when the servlet was loaded.
Example:
Fri May 25 08:42:25 EDT 2001
292124SMF120WJ48binary
Average cpu time in microseconds.
30012CSMF120WJ58binary
Minimum cpu time in microseconds.
308134SMF120WJ68binary
Maximum cpu time in microseconds.

The table above is based on the description provided by IBM in its "MVS Systems Management Facilities (SMF)" manual.

Sample Report from SMF 120
WebSphere Application Java CPU Times


The sample SMF report below was created with Spectrum SMF Writer, the low-cost 4GL SMF report writer. It reads as input the SMF file and selects just the type 120 WebSphere Application records for Jave 2 Enterprise Edition containers. (See SMF 120-5 record layout.) It then prints a report line for each Java bean method accounting section found. The report shows CPU time information about those Java bean methods. Note that a single SMF 120 record can contain information about multiple beans and multiple methods per bean.

All of this with just a few of code!
Why not install a Spectrum SMF Writer trial right now and start making your own SMF reports!

These Spectrum SMF Writer Statements:


INPUT:  SMF12005

INCLUDEIF: SMF120RTY=120   AND SMF120RST=5

TITLE: 'Z/OS WEBSPHERE APPLICATION SMF 120 DATA'
TITLE: 'SUBTYPE 5 -- J2EE CONTAINER ACTIVITY'

COL: SMF120RST(3 'SUB/TYP')
     SMF120JA4(5 'TRANS/SERVER/HOST')
     SMF120JA5(6 'TRANS/SERVER/NAME')
     SMF120JA8_EBC(8 'CONTAINER/NAME')
     SMF120CL2('CELL')
     SMF120ND2('NODE')
     SMF120JB1_EBC(10 'BEAN/NAME')
     SMF120JM1_EBC(25 'BEAN/METHOD')
     SMF120JM2(5 'TIMES/INVOK')
     SMF120JM3('AVG/RSP/TIME' TPIC'9.999' )
     SMF120JM4('MAX/RSP/TIME' TPIC'9.999'  )
     SMF120JMQ('AVG/CPU/TIME' TPIC'9.999999' )
     SMF120JMR('MIN/CPU/TIME' TPIC'9.999999')
     SMF120JMS('MAX/CPU/TIME' TPIC'9.999999')

 

Produce This SMF Report:


                                            Z/OS WEBSPHERE APPLICATION SMF 120 DATA
                                             SUBTYPE 5 -- J2EE CONTAINER ACTIVITY

     TRANS TRANS                                                                         AVG   MAX    AVG      MIN      MAX
 SUB SERVE SERVER CONTAINE                      BEAN              BEAN            TIMES  RSP   RSP    CPU      CPU      CPU
 TYP HOST   NAME    NAME     CELL     NODE      NAME             METHOD           INVOK TIME  TIME    TIME     TIME     TIME
 ___ _____ ______ ________ ________ ________ __________ _________________________ _____ _____ _____ ________ ________ ________

   5 AWT4  AXZ4S1 Default  AXZ4     AXZ44    Tonam::Inf invoke:java.lang.String,j     1 0.014 0.014 0.013665 0.013665 0.013665
   5 AWT4  AXZ4S1 Default  AXZ4     AXZ44    Tonam::Inf invoke:java.lang.String,j     1 0.020 0.020 0.006287 0.006287 0.006287
   5 AWT4  AXZ4S1 Default  AXZ4     AXZ44    Tonam::Inf login:java.lang.String,ja     1 0.006 0.006 0.004206 0.004206 0.004206
   5 AWT4  AXZ4S1 Default  AXZ4     AXZ44    Tonam::Inf invoke:java.lang.String,j     1 0.004 0.004 0.003605 0.003605 0.003605
   5 AWT4  AXZ4S1 Default  AXZ4     AXZ44    Tonam::Inf invoke:java.lang.String,j     1 0.007 0.007 0.004831 0.004831 0.004831
   5 AWT4  AXZ4S1 Default  AXZ4     AXZ44    Tonam::Inf invoke:java.lang.String,j     2 0.005 0.010 0.005650 0.001264 0.010036

 *** GRAND TOTAL (     6 ITEMS)

See other sample SMF reports.

Copyright 2017.
Pacific Systems Group.
All rights reserved.


Spectrum Writer 4GL - the economical alternative to SAS, Easytrieve, DYL-280...

Home | Products | Prices | Documentation | 30-Day Trials | Customer Reviews | Company | FAQ | Sample Reports | SMF Records
Send Your Comments or Questions