








	*SMF Tools*

SMF Type 120 Record - Subtype 6

This table shows the record layout for type 120 SMF records
(WebSphere Appl - J2EE container 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 6 - J2EE Container Interval Record (Version 2)

The purpose of the J2EE container interval SMF record is to record activity within a J2EE container that is located inside the WebSphere® Application Server transaction server.

This record is produced at regular intervals and is an aggregate of the activities running inside a J2EE container during the interval. This record can be used to perform application profiling, problem determination, and capacity planning.

A single record is created for each active J2EE container located in a WebSphere Application Server transaction server within the interval being recorded. If there is more than one server instance associated with a server, a record for the container will exist for each server instance. To get a common view of the work running in the J2EE container during the interval, you must merge the records after processing.

You can specify an interval through the WebSphere Application Server administrative console by setting server_SMF_interval_length=n, where n is the desired number of seconds.

You can activate this record by setting server_SMF_container_interval_enabled=1 (or server_SMF_container_interval_enabled=true) on the administrative console.

The J2EE Container Interval record contains:

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.

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 -- WebSphere Appl - J2EE container interval 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 6
40	28	SMF120JI1	4	binary	Offset to J2EE container interval section from RDW
44	2C	SMF120JI2	4	binary	Length of J2EE container interval section
48	30	SMF120JI3	4	binary	Number of J2EE container interval sections
The following triplet appears once for each bean section.
52	34	SMF120JIS	4	binary	Offset to bean section from RDW
56	38	SMF120JIL	4	binary	Length of bean section
60	3C	SMF120JIN	4	binary	Number of bean 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: S390STCK64: 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
J2EE container interval section. The J2EE container interval section contains information about each activity that occurred within one J2EE container in the specified interval. There is one section per record. (Offset from beginning of record: SMF120JI1)
0	0	SMF120JI4	64	EBCDIC	The WebSphere Application Server for z/OS® transaction server host name.
64	40	SMF120JI5	8	EBCDIC	The WebSphere Application Server for z/OS transaction server name.
72	48	SMF120JI6	8	EBCDIC	The WebSphere Application Server for z/OS transaction server instance name.
80	50	SMF120JI7	512	Unicode	The WebSphere Application Server for z/OS container name. Note: This is hardcoded to 'Default' for the 4.0.1 time frame.
592	250	SMF120JI8	16	S390STCK	The time that the sample began in the server.
608	260	SMF120JI9	16	S390STCK	The time that the sample ended.
624	270	SMF120CL3	8	EBCDIC	Cell
632	278	SMF120ND3	8	EBCDIC	Node
Bean Section There are multiple sections per record. (Offset from beginning of record: SMF120JIS)
0	0	SMF120JB1	512	Unicode	AMCName of the bean activated by the container. Note: If the length of the AMCName exceeds 256 DBCS characters (512 bytes), the rightmost 256 characters are recorded.
512	200	SMF120JB2	60	binary	UUID based AMC name
572	23C	SMF120JB3	4	binary	The bean's type. 2: Stateless session bean. 3: Stateful session bean. 4: BMP entity bean. 5: CMP entity bean. 6. Message-driven bean.
576	240	SMF120JB4	4	binary	RESERVED
580	244	SMF120JB5	4	binary	RESERVED
584	248	SMF120JB6	4	binary	RESERVED
588	24C	SMF120JB7	4	binary	The bean's reentrance policy. 0: Not reentrant within transaction. 1: Reentrant within transaction.
592	250	SMF120JB8	4	binary	RESERVED
596	254	SMF120JMC	4	binary	RESERVED
600	258	SMF120JM6	4	binary	RESERVED
604	25C	SMF120JB9	4	binary	Number of method triplets in this bean section
Bean Method Triplets The following triplet appears 0-n times; once for each bean method section. (Offset from beginning of record: SMF120JIS + 608)
0	0	SMF120JBS	4	binary	Offset to bean method section from the beginning of this bean section
4	4	SMF120JBL	4	binary	Length of bean method section
8	8	SMF120JBN	4	binary	Number of bean method sections
Bean Method Section There are multiple sections per bean section. The bean method section contains information about all methods of beans involved in this activity. (Offset from beginning of record: SMF120JBS)
0	0	SMF120JM1	1024	Unicode	The name of the method including its signature in its externalized, human-readable form. If the length of the method exceeds 512 DBCS characters (1024 bytes), the leftmost 512 characters are recorded.
1024	400	SMF120JM2	4	binary	The number of times the method was invoked during the activity.
1028	404	SMF120JM3	4	binary	Average response time. The response time is measured in milliseconds (the granularity provided by the JVM - hopefully, it will be equal to 0 in most cases).
1032	408	SMF120JM4	4	binary	Maximum response time. The response time is measured in milliseconds.
1036	40C	SMF120JM5	4	binary	The bean method's transaction policy. Values from com.ibm.websphere.csi. TransactionAttribute.java: 0: "TX_NOT_SUPPORTED" 1: "TX_BEAN_MANAGED" 2: "TX_REQUIRED" 3: "TX_SUPPORTS" 4: "TX_REQUIRES_NEW" 5: "TX_MANDATORY" 6: "TX_NEVER"
1040	410	SMF120JM8	4	binary	RESERVED.
1044	414	SMF120JM9	4	binary	RESERVED.
1048	418	SMF120JMA	512	Unicode	List of ejbRoles associated with the method. Separator character: ";" (semicolon). If the length of the concatenated string exceeds 256 characters (512 bytes), only its leftmost 256 characters are recorded.
1560	618	SMF120JMB	4	binary	RESERVED.
1564	61C	SMF120JMD	4	binary	RESERVED.
1568	620	SMF120JME	4	binary	ejbLoad: # of invocations
1572	624	SMF120JMF	4	binary	ejbLoad: avg execution time
1576	628	SMF120JMG	4	binary	ejbLoad: max execution time
1580	62C	SMF120JMH	4	binary	ejbStore: # of invocations
1584	630	SMF120JMI	4	binary	ejbStore: avg execution time
1588	634	SMF120JMJ	4	binary	ejbStore: max execution time
1592	638	SMF120JMK	4	binary	ejbActivate: # of invocations
1596	63C	SMF120JML	4	binary	ejbActivate: avg execution time
1600	640	SMF120JMM	4	binary	ejbActivate: max execution time
1604	644	SMF120JMN	4	binary	ejbPassivate: # of invocations
1608	648	SMF120JMO	4	binary	ejbPassivate: avg execution time
1612	64C	SMF120JMP	4	binary	ejbPassivate: max execution time
1616	650	SMF120JMQ	8	binary	Average cpu time in microseconds.
1624	658	SMF120JMR	8	binary	Minimum cpu time in microseconds.
1632	660	SMF120JMS	8	binary	Maximum 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.