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 1

This table shows the record layout for type 120 SMF records
(WebSphere Application Server Performance Statistics).

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.

This information is typically presented with the help of an SMF data viewing tool. [Ed.] Such as Spectrum SMF Writer, the 4GL report writer and export utility for SMF files.]

Two types of SMF records can be produced: activity records and interval records.

  • Activity records are gathered as each activity within a server is completed. An activity is a logical unit of business function. It can be a server or user-initiated transaction.
  • Interval records consist of data gathered at installation-specified intervals and provide capacity planning and reliability information.

Six records can be produced:

  • Subtype 1 - the Server Activity record
  • Subtype 3 - 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

Record type 120 has the following subtypes:

  • Subtype 1: Server activity record
    • Server activity section (one section per record):
      Contains information about each activity that occurred within one server.
    • Communication session section (zero, one, or multiple sections per record):
      Contains information about each communication session.
    • JVM heap section (zero, one, or multiple sections per record):
      Contains information about the heap in a server region.
  • Subtype 3: Server interval record
    • Server interval section (one section per record):
      Contains aggregated information about all activities that occurred within the specified server interval.
    • Server region section (zero, one, or multiple sections per record):
      Contains information about server regions in the specified interval.
  • Subtype 5: J2EE container activity record
    • J2EE container activity section (one section per record):
      Contains information about each activity that occurred within one J2EE container.
    • Bean section (multiple (0..n) sections per record):
      Contains information about all beans involved in this activity.
    • Bean method section (multiple (0..n) sections per bean section):
      Contains information about all methods of this bean involved in this activity.
  • Subtype 6: J2EE container interval record
    • J2EE container interval section (one section per record):
      Contains aggregated information about all activities that occurred within one J2EE container in the specified interval.
    • Bean section (multiple (0..n) sections per record, see subtype 5):
      Contains information about all beans involved in this activity in the specified interval.
    • Bean method section (multiple (0..n) sections per bean section, see subtype 5):
      Contains information about all methods of this class involved in this activity in the specified interval.
  • Subtype 7: WebContainer activity record (Version 2)
    • WebContainer activity section (one section per record):
      Contains information about each activity that occurred within one WebContainer.
    • HttpSessionManager activity section (one section per record):
      Contains information about all sessions involved in this activity.
    • WebApplication activity section (multiple (0..n) sections per record):
      Contains information about all WebApplications involved in this activity.
      • Servlet activity section (multiple (0..n) sections per WebApplication section):
        Contains information about all Servlets involved in this activity.
  • Subtype 8: WebContainer interval record (Version 2)
    • WebContainer interval section (one section per record):
      Contains information about each activity that occurred within one WebContainer in the specified interval.
    • HttpSessionManager interval section (one section per record):
      Contains information about all sessions involved in this activity in the specified interval.
    • WebApplication interval section (multiple (0..n) sections per record):
      Contains information about all WebApplications involved in this activity in the specified interval.
      • Servlet interval 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 Application Server Performance Statistics
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 1
4028SMF120SAS4binary
Offset to server activity section from RDW
442CSMF120SAL4binary
Length of server activity section
4830SMF120SAN4binary
Number of server activity sections
5234SMF120CSS4binary
Offset to communication session section from RDW
5638SMF120CSL4binary
Length of communication session section
603CSMF120CSN4binary
Number of communication session sections
6440SMF120JHS4binary
Offset to JVM heap section from RDW
6844SMF120JHL4binary
Length of JVM heap section
7248SMF120JHN4binary
Number of jvm heap sections
Individual header extension for subtype 3
4028SMF120SIS4binary
Offset to server interval section from RDW
442CSMF120SIL4binary
Length of server interval section
4830SMF120SIN4binary
Number of server interval sections
The following triplet appears 0-n times; once for each server region section.
5234SMF120SRS4binary
Offset to server region section from RDW
5638SMF120SRL4binary
Length of server region section
603CSMF120SRN4binary
Number of server region sections
Individual header extension for subtype 5
4028SMF120JA14binary
Offset to J2EE container activity section from RDW
442CSMF120JA24binary
Length of J2EE container activity section
4830SMF120JA34binary
Number of J2EE container activity sections
The following triplet appears 0-n times; once for each bean section.
5234SMF120JAS4binary
Offset to bean section from RDW
5638SMF120JAL4binary
Length of bean section
603CSMF120JAN4binary
Number of bean sections
Individual header extension for subtype 6
4028SMF120JI14binary
Offset to J2EE container interval section from RDW
442CSMF120JI24binary
Length of J2EE container interval section
4830SMF120JI34binary
Number of J2EE container interval sections
The following triplet appears 0-n times; once for each bean section.
5234SMF120JIS4binary
Offset to bean section from RDW
5638SMF120JIL4binary
Length of bean section
603CSMF120JIN4binary
Number of bean sections
Individual header extension for subtype 7
4028SMF120WA14binary
Offset to WebContainer activity section from RDW.
442CSMF120WA24binary
Length of WebContainer activity section.
4830SMF120WA34binary
Number of WebContainer activity sections.
5234SMF120WA44binary
Offset to HttpSessionManager activity section from RDW.
5638SMF120WA54binary
Length of HttpSessionManager activity section.
603CSMF120WA64binary
Number of HttpSessionManager activity sections.
The following triplet appears 0-n times, once for each WebApplication section.
6440SMF120WA74binary
Offset to WebApplication section from RDW.
6844SMF120WA84binary
Length of WebApplication section.
7248SMF120WA94binary
Number of WebApplication 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 0-n times, 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: S390STCK 64: 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 1 - Server activity record

The server activity SMF record is used to record activity that is running inside a WebSphere Application Server for z/OS. This record can be used to perform basic charge-back accounting and to profile your applications to determine, in detail, what is happening inside the WebSphere Application Server transaction server.

A single record is created for each activity that is run inside a server or server instance. If the activity runs in multiple servers, then a record is written for each server.

(Offset from beginning of record: SMF120SAS)
00SMF120HNM64EBCDIC
WebSphere Application Server for z/OS transaction server host name
6440SMF120SNA8EBCDIC
WebSphere Application Server for z/OS transaction server name
7248SMF120INA8EBCDIC
WebSphere Application Server for z/OS transaction server instance name
8050SMF120SNM4binary
Total number of server servants that were involved to process this activity. If applicable, up to the first five server servant address space IDs are listed within the next five fields.
8454SMF120SR14binary
The specific WebSphere Application Server for z/OS transaction server instance server servant where the request ran
8858SMF120SR24binary
The specific WebSphere Application Server for z/OS transaction server instance server servant where the request ran
925CSMF120SR34binary
The specific WebSphere Application Server for z/OS transaction server instance server servant where the request ran
9660SMF120SR44binary
The specific WebSphere Application Server for z/OS transaction server instance server servant where the request ran
10064SMF120SR54binary
The specific WebSphere Application Server for z/OS transaction server instance server servant where the request ran
10468SMF120CRE8EBCDIC
The user credentials under which the activity began. Due to deferred security authentication, the user credentials assigned to the request when it first reaches the server will often be the unauthenticated guest ID, and not the ID of the authenticated user that submitted the request.
11270SMF120ATY4binary
Type of activity that this record references:
1: Method request: This record refers to a method request that is not part of a global transaction.
2: Transaction: This record refers to a transaction.
11674SMF120AID20HEX
Identity of the activity
13688SMF120WLM8HEX
WLM enclave token
14490SMF120AST8binary
Activity start time
15298--8binary
reserved
160A0SMF120AET8binary
Activity stop time
168A8--8binary
reserved
176B0SMF120NIM4binary
Number of input methods
180B4SMF120NGT4binary
Number of global transactions that were started in the server servant
184B8SMF120NLT4binary
Number of local transactions that were started in the server servant
188BCSMF120J2E4binary
J2EE server
192C0SMF120CEL8EBCDIC
WebSphere Application Server for z/OS cell name
200C8SMF120NOD8EBCDIC
WebSphere Application Server for z/OS node name
208D0SMF120WCP8binary
Total CPU time accumulated by the WLM enclave. TOD clock format (bit 51 = microseconds).
Communications Section

There are zero, one, or multiple sections per record. The Communications session section contains information about each communication session.

(Offset from beginning of record: SMF120CSS)
00SMF120CSH8HEX
Communications session handle
88SMF120CSA64EBCDIC
Communications session address
7248SMF120CSO4binary
Communications session optimization
1: Local communications session: The session is a local OS/390 optimized communications session.
2: Remote communications session: The session is a remote communications session.
3: Remote encrypted (SSL)
4: Remote within sysplex.
5: HTTP session.
6: HTTP encrypted session.
7. Message-driven bean session
764CSMF120SDR4binary
Data received; the number of bytes received by the server. 'FFFFFFFF'X indicates the 4-byte field is too small. Use SMF120CDR, an 8-byte field, instead.
8050SMF120SDT4binary
Data transferred; the number of bytes transferred from the server back to the client. 'FFFFFFFF'X indicates the 4-byte field is too small. Use SMF120CDT, an 8-byte field, instead.
8454SMF120CDR8binary
Data received; the number of bytes received by the server.
925CSMF120CDT8binary
Data transferred; the number of bytes transferred from the server back to the client.
JVM Heap section

There are zero, one, or multiple sections per record. The JVM heap section contains information about the heap in each server servant.

The information in the JVM heap section comes from the QueryGCStatus() JNI function.

(Offset from beginning of record: SMF120JHS)
00SMF120JHA4binary
Servant address space ID
44SMF120JHH4binary
The heap for which the following data applies.
88SMF120JHC4binary
The total number of allocation failures on this heap or, if querying shared storage, the subpool identifier. A negative value indicates the information is for the shared memory page pool.
12CSMF120JHF8binary
The total number of free bytes in the heap/subpool/page pool.
2014SMF120JHT8binary
The total number of bytes in the heap, subpool, or page pool.

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