NEWS SMF Record Formats

Implementing the NEWS User Exit › NEWS SMF Record Formats

NEWS SMF Record Formats

The NEWS SMF exit program (NEWSXSMF) is provided as a sample user exit that receives a copy of every NEWS CNM record and writes each record to the SMF log file.

NEWSXSMF writes data to the SMF log file in the following formats:

CNM records have a header followed by the CNM record section.
4700 Support Facility (TARA) data have a header followed by one or more sections containing statistical information. Such data is sent from 36xx/47xx Finance Communications Systems (FCS) devices and contained in RECFMS type X‘04’ records.

You must configure NEWSXSMF to indicate which format is to be used, depending on the type of data you want to collect. You can indicate one of the following options:

Write all CNM records out in the CNM record format.
Write only TARA data in TARA data format, and ignore all other records.
Write TARA data in TARA data format, and write all other records in the CNM record format.

For more information about how to configure the NEWSXSMF program, see the comments provided in the program.

The macro $NMSMF defines a DSECT describing the contents of the SMF records.

In the following pages, all field names are those defined in that DSECT. The following pages also describe the various sections that may be present in the NEWS SMF record.

All records contain the header section. The header is followed by one section, or more, depending on whether the data is CNM record data or TARA statistical data.

SMF Header Section

Offset Dec.	Offset Hex.	Length Bytes	Field Name	Description	Type
+0	+0	2	SMFNMLEN	SMF record length	Binary
+2	+2	2	SMFNMSEG	Segment descriptor	Binary
+4	+4	1	SMFNMFLG	System indicator X‘3E’ for z/OS	Binary
+5	+5	1	SMFNMRTY	SMP record type, set by SYSPARMS SMFID=	Binary
+6	+6	4	SMFNMTME	Time stamp set by SMF in hundredths of a second	EBCDIC
+10	+A	4	SMFNMDTE	Record was moved to the external log buffer on this date. The format is 00YYDDDF where F is the sign	EBCDIC
+14	+E	4	SMFNMSID	System identifier	EBCDIC
+18	+12	1	SMFNMCAT	Record subcategory X‘03’ for CNM Deliver RU record X‘04’ for CNM record, not embedded	Binary
+19	+13	1	(Reserved)	X‘00’	Binary
+20	+14	12	SMFNMID	NMID value, set by SYSPARMS ID=	EBCDIC
+32	+20	40	(Reserved)	X‘00’	Binary
+72	+48	8	SMFNWNCP	Name of the NCP through which the device is connected. Blank, if the name is unknown.	EBCDIC
+80	+50	8	SMFNWLNK	Name of the link through which the device is connected. Blank, if the name is unknown.	EBCDIC
+88	+58	8	SMFNWPU	Name of the PU device. Blank, if the name is unknown.	EBCDIC
+96	+60	8	SMFNWLU	LU name, if applicable. Blank, if name is unknown.	EBCDIC

CNM Record Section

Offset Dec.	Offset Hex.	Length Bytes	Field Name	Description	Type
+104	+68	Variable	SMFNWRU	The CNM record as it was received by your region	Binary

TARA Header Section

The header section for TARA data contains the following fields, in addition to those in the common SMF Header Section in this appendix.

Offset Dec.	Offset Hex.	Length Bytes	Field Name	Description	Type
+104	+68	8	SMFWKSTA	Installation-defined string	EBCDIC
+112	+70	4	SMFWKSID	Workstation ID, WKnn, where nn is the workstation number	EBCDIC
+116	+74	Variable	SMFSTATS	Start of statistical information section	-

TARA Data Section

There can be one or more data sections for each SMF record in TARA data format. Each section has the following fields.

Offset Dec. *	Offset Hex. *	Length Bytes	Field Name	Description	Type
n+0	n+0	8	SMFTNAME	Installation-defined name to represent the type of information contained in this section	EBCDIC
n+8	n+8	3	SMFMIN	Minimum response time value	Binary
n+11	n+B	3	SMFMAX	Maximum response time value	Binary
n+14	n+E	4	SMFCUM	Total cumulative response time value	Binary
n+18	n+12	2	SMFINTV	Number of response time measurements	Binary
n+20	n+14	4	SMFRAVG	Average response time (that is, SMFCUM divided by SMFINTV)	Binary

* n is the start of the section.