








	*SMF Tools*

SMF Type 120 Record - Subtype 7

This table shows the record layout for type 120 SMF records
(WebContainer Activity 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.

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

Subtype 7: the WebContainer Activity record

The purpose of the WebContainer activity SMF record is to record activity within a WebContainer running inside a WebSphere Application Server for z/OS transaction server (Version 6.0.x).

The Web container is deployed within an EJB and runs within the EJB container. The WebContainer acts as a Web server handling HTTP sessions and servlets. The EJB container is not aware of the work the WebContainer does. Instead, the EJB container only records that the EJB has been dispatched. Meanwhile, the WebContainer gathers the detailed information, such as HTTP sessions, servlets, and their respective performance data. A single WebContainer Activity record is created for each activity that is run within a Web container.

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

The WebContainer Activity record contains:

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.

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

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.

SMF Type 120 Record -- WebContainer Activity Record, Version 2)
Offset (Dec.)	Offset (Hex)	Name	Length	Format	Description
0	0	SMF120LEN	2	binary	Record length. This field and the next field (total of four bytes) form the RDW (record descriptor word).
2	2	SMF120SEG	2	binary	Segment descriptor (see record length field)
4	4	SMF120FLG	1	binary	Bit meaning when set 0: New SMF record format 1: Subtypes used 2: Reserved 3-6: Version indicators* 7: Reserved
5	5	SMF120RTY	1	binary	Record type 120(X'78')
6	6	SMF120TME	4	binary	Time since midnight, in hundredths of a second, that the record was moved into the SMF buffer.
10	A	SMF120DTE	4	packed	Date when the record was moved into the SMF buffer, in the form 0 cyydddF.
14	E	SMF120SID	4	EBCDIC	System identification (from the SMFPRMxx SID parameter)
18	12	SMF120SSI	4	EBCDIC	Subsystem identification from SUBSYS parameter
22	16	SMF120RST	2	binary	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
24	18	SMF120TRN	4	binary	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.
28	1C	SMF120PRS	4	binary	Offset to product section from RDW.
32	20	SMF120PRL	4	binary	Length of product section.
36	24	SMF120PRN	4	binary	Number of product sections.
Individual header extension for subtype 7
40	28	SMF120WA1	4	binary	Offset to WebContainer activity section from RDW.
44	2C	SMF120WA2	4	binary	Length of WebContainer activity section.
48	30	SMF120WA3	4	binary	Number of WebContainer activity sections.
52	34	SMF120WA4	4	binary	Offset to HttpSessionManager activity section from RDW.
56	38	SMF120WA5	4	binary	Length of HttpSessionManager activity section.
60	3C	SMF120WA6	4	binary	Number of HttpSessionManager activity sections.
The following triplet appears once for each WebApplication section.
64	40	SMF120WA7	4	binary	Offset to WebApplication section from RDW.
68	44	SMF120WA8	4	binary	Length of WebApplication section.
72	48	SMF120WA9	4	binary	Number of WebApplication sections.
Product Section(Offset from beginning of record: SMF120PRS)
0	0	SMF120MFV	4	binary	CB SMF version
4	4	SMF120COD	8	EBCDIC	Character codeset in which strings in the SMF record are encoded
12	C	SMF120END	4	binary	Encode of numbers in the SMF record
16	10	SMF120TSF	4	binary	Encoding of timestamps: 1: S390STCK 64: The time values are encoded in 64-bit S/390 Store Clock format.
Reassembly information.
20	14	SMF120IXR	4	binary	Index of this record
24	18	SMF120NRC	4	binary	Total number of records
28	1C	SMF120NTR	4	binary	Total number of triplets
Subtype 7 - 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: SMF120WA1)
0	0	SMF120WAA	64	EBCDIC	The WebSphere transaction server host name.
64	40	SMF120WAB	8	EBCDIC	The WebSphere transaction server name.
72	48	SMF120WAC	8	EBCDIC	The WebSphere transaction server instance name.
80	50	SMF120WAD	8	HEX	The WLM enclave token.
88	58	SMF120WAE	20	HEX	The identity of the activity.
108	6C	SMF120WAF	8	S390STCK	The time the activity began in the server.
116	74	--	8	BINARY	RESERVED
124	7C	SMF120WAG	8	S390STCK	The time the activity ended.
132	84	--	8	BINARY	RESERVED
140	8C	SMF120CL4	8	EBCDIC	Cell
148	94	SMF120ND4	8	EBCDIC	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: SMF120WA4)
0	0	SMF120WAH	4	binary	"created Sessions": Number of http sessions that were created.
4	4	SMF120WAI	4	binary	"invalidatedSessions": Number of http session that were invalidated.
8	8	SMF120WAJ	4	binary	"activeSessions": Number of http sessions that were referenced during this activity.
12	C	SMF120WAK	4	binary	"sessionLifeTime": lifetime of the session in milliseconds. If "invalidatedSessions" > 0, this is the average lifetime (in milliseconds) of the invalidated http session.
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: SMF120WA7)
0	0	SMF120WAL	256	Unicode	The name of the WebApplication.
256	100	SMF120WAM	4	binary	Number of servlet triplets in this web application section.
Servlet Triplets The following triplet appears 0-n times, once for each servlet section (Offset from beginning of record: SMF120WA7 + 260)
0	0	SMF120WAN	4	binary	Offset to servlet section from the beginning of this WebApplication section.
4	4	SMF120WAO	4	binary	Length of servlet section.
8	8	SMF120WAP	4	binary	Number of servlet sections.
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: SMF120WA7 + SMF120WAN)
0	0	SMF120WAQ	256	Unicode	The name of the servlet.
256	100	SMF120WAR	4	binary	"responseTime": Response time in milliseconds.
260	104	SMF120WAS	4	binary	"numErrors": The number of errors that were encountered during the servlet execution.
264	108	SMF120WAT	4	binary	"loaded": 0: The servlet did not have to be loaded as a result of this request. 1: The servlet had to be loaded as the result of this request.
268	10C	SMF120WAU	16	EBCDIC	"loadedSince": Timestamp from System.currentTimeMillis() when the servlet was loaded, in HEX format. Sample: The data as it appears in the record has the format: e7ef7c577c which needs to be converted to a Java long: 996155348860 The Java long digits can be converted to java.util.Date: Thu Jul 26 15:49:08 GMT+02:00 2001
284	11C	SMF120CPU	8	binary	Cpu time in microseconds.

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

Spectrum SMF Writer - the 4GL SMF Report Writer.

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.