TN3270E Telnet server SNA session termination record (subtype 21)

The Type 119 TN3270E Telnet server (Telnet) SNA session termination record is collected when the z/OS® TN3270E Telnet server terminates a SNA session with a Telnet client. The information in this record is associated with a given LU-LU session, and not to the TCP/IP Telnet connection; for example, if multiple LU-LU sessions use the same Telnet connection, separate SNA session termination records are reported for each LU-LU session.

The Type 119 Telnet SNA Session termination record is collected at the same point in session processing as the equivalent Type 118 TN3270E Telnet server "LOGF" SMF record.

Guideline: Because the Telnet SNA session termination record contains a superset of the information that the Telnet SNA session initiation record contains, you should collect only the Telnet SNA session termination records.

See Table 1 for the contents of the TCP/IP stack identification section. For the Telnet SNA session termination record, the TCP/IP stack identification section indicates TN3270S as the subcomponent and X'08' (event record) as the record reason.

Table 1 shows the Telnet SNA session termination record self-defining section:
Table 1. TN3270E Telnet server SNA session termination record self-defining section
Offset Name Length Format Description
0(X'0') Standard SMF Header 24   Standard SMF header; subtype is 21(X'15')
Self-defining section
24(X'18') SMF119SD_TRN 2 Binary Number of triplets in this record (5)
26(X'1A')   2 Binary Reserved
28(X'1C') SMF119IDOff 4 Binary Offset to TCP/IP identification section
32(X'20') SMF119IDLen 2 Binary Length of TCP/IP identification section
34(X'22') SMF119IDNum 2 Binary Number of TCP/IP identification sections
36(X'24') SMF119S1Off 4 Binary Offset to Telnet SNA session termination section
40(X'28') SMF119S1Len 2 Binary Length of Telnet SNA session termination section
42(X'2A') SMF119S1Num 2 Binary Number of Telnet SNA session termination sections
44(X'2C') SMF119S2Off 4 Binary Offset to TN3270 server host name section
48(X'30') SMF119S2Len 2 Binary Length of TN3270 server host name section
50(X'32') SMF119S2Num 2 Binary Number of TN3270 server host name sections
52(X'34') SMF119S3Off 4 Binary Offset to TN3270 server session performance data section
56(X'38') SMF119S3Len 2 Binary Length of TN3270 server session performance data section
58(X'3A') SMF119S3Num 2 Binary Number of TN3270 server session performance data sections
60(X'3C') SMF119S4Off 4 Binary Offset to TN3270 server session time bucket performance data section
64(X'40') SMF119S4Len 2 Binary Length of TN3270 server session time bucket performance data section
66(X'42') SMF119S4Num 2 Binary Number of TN3270 server session time bucket performance data sections

Table 2 shows the Telnet SNA session termination section of this SMF record.

Table 2. TN3270E Telnet server SNA session termination section
Offset Name Length Format Description
0(X'0') SMF119TN_NTLU 8 EBCDIC Telnet LU name
8(X'8') SMF119TN_NTAppl 8 EBCDIC Host application name
16(X'10') SMF119TN_NTLdev 4 Binary Telnet internal logical device number
20(X'14') SMF119TN_NTRIP 16 Binary Remote (client) IP address
36(X'24') SMF119TN_NTLIP 16 Binary Local (Telnet) IP address
52(X'34') SMF119TN_NTRPort 2 Binary Remote (client) port number
54(X'36') SMF119TN_NTLPort 2 Binary Local (Telnet) port number
56(X'38') SMF119TN_NTHostNm 8 EBCDIC TCP/IP Host name
64(X'40') SMF119TN_NTInByte 8 Binary Inbound byte count
72(X'48') SMF119TN_NTOutByte 8 Binary Outbound byte count
80(X'50') SMF119TN_NTiTime 4 Binary Time of session initiation
84(X'54') SMF119TN_NTiDate 4 Packed Date of session initiation
88(X'58') SMF119TN_NTtTime 4 Binary Time of session termination
92(X'5C') SMF119TN_NTtDate 4 Packed Date of session termination
96(X'60') SMF119TN_NTDur 4 Binary Session duration in units of 1/100 seconds
100(X'64') SMF119TN_NTSType 1 Binary Telnet session type:
  • 0: UNKNOWN
  • 1: TN3270
  • 2: TN3270E
  • 3: LINEMODE
  • 4: DBCSTRANSFORM
  • 5: BINARY
101(X'65') SMF119TN_NTLUSel 1 Binary Telnet LU selection method:
  • 0: LU chosen by server
  • 1: LU chosen by client
102(X'66') SMF119TN_NTSSL 1 Binary SSL status:
  • 0: No SSL session
  • 1: Server authentication only
  • 2: Server and client authentication (REQUIRED/SSLCERT):
    • If AT-TLS policy (REQUIRED), then check SAF, and user ID is not required to be returned.
    • If TN profile control (SSLCERT), then no SAF.
  • 3: Server and client authentication (SAFCHECK/SAFCERT):
    • If AT-TLS policy (SAFCHECK), then SAF check requires user ID returned.
    • If TN profile control (SAFCERT), then SAF check requires user ID returned.
  • 4: Server and client authentication (FULL):
    • AT-TLS policy only. Optional client certificate. SSL cert if provided. SAF check, user ID is not required.
  • 5: Server and client authentication (PASSTHRU)
    • AT-TLS policy only. Optional client certificate. No SSL cert if provided. SAF check, user ID is not required.
103(X'67')   1 Binary Reserved
104(X'68') SMF119TN_NTCopt 1 Binary Telnet connection options negotiated for this connection:
  • 1000 0000: TN3270E
  • 0100 0000: Terminal type
  • 0010 0000: End of Record
  • 0001 0000: Transmit binary
  • 0000 1000: Echos
  • 0000 0100: Suppress go ahead
  • 0000 0010: Timemark
  • 0000 0001: New Environment

TN3270E connection options negotiated for this connection. More than one of these options can be set.
105(X'69')   1 Binary Reserved
106(X'6A') SMF119TN_NT32opt 2 Binary TN3270E connection options negotiated for this connection.

First Byte:

  • 1000 0000: Bind image
  • 0100 0000: SysRequest
  • 0010 0000: Responses
  • 0001 0000: SCS control codes
  • 0000 1000: DCS control codes
  • 0000 0100: Contention Resolution
  • 0000 0010: FMH Support
  • 0000 0001: SNA Sense Support
Second Byte:
  • 1000 0000: Suppress Header Byte Doubling
  • 0xxx xxxx: Reserved

TN3270E connection options negotiated for this connection. More than one of these options can be set.
108(X'6C') SMF119TN_NTRCode 8 EBCDIC Session termination reason code. The values in this field are the same as those displayed in message EZZ6034I as value for the object variable.
116(X'74') SMF119TN_NTLMode 8 EBCDIC SNA logmode
124(X'7C') SMF119TN_NTDevt 20 EBCDIC Telnet device type
Note: SMF119TN_NTiTime and SMF119TN_NTiDate are only relevant if SMF119TN_NTDur is non-zero.
Table 3 shows the Telnet server host name section. This section is optional and is present if HNGROUP was applicable for this connection.
Table 3. TN3270E Telnet server host name section
Offset Name Length Format Description
0(X'0') SMF119TN_NTHostname n EBCDIC Host name associated with this session
Table 4 shows the TN3270E Telnet server round trip performance section. This section is optional and is present when performance data is being collected for this connection as a result of a MONITORGROUP being mapped to this connection.
Table 4. TN3270E Telnet server Round Trip Performance section
Offset Name Length Format Description
0(X'0') SMF119TN_NTRRts 4 Binary Sum of round trip times for this session in milliseconds
4(X'4') SMF119TN_NTRIPRts 4 Binary Sum of IP portion of round trip times for this session in milliseconds
8(X'8') SMF119TN_NTRCountTrans 4 Binary Count of transactions used to measure round trip times for this session
12(X'C') SMF119TN_NTRCountIP 4 Binary Count of IP transactions used to measure the IP portion of the round trip time
16(X'10') SMF119TN_NTRElapsRndTrpSq 8 Binary The sum of the square of each round trip time
24(X'18') SMF119TN_NTRElapsIpRtSq 8 Binary The sum of the square of each IP portion of round trip time
32(X'20') SMF119TN_NTRElapsSnaRtSq 8 Binary The sum of the square of each SNA portion of round trip time
40(X'28') SMF119TN_NTRGrpIndex 4 Binary The index into the master MonitorGroup table this connection is using
44(X'2C') SMF119TN_NTRDR 1 Binary Indicator how IP trip time is measured:
  • '80'x: Definite Response used
  • '40'x: Timemark used
45(X'2D')   3 Binary Reserved
Table 5 shows the Telnet SNA session termination time bucket performance data section. This section is optional and is present if performance data is being collected for this connection as a result of a MONITORGROUP being mapped to this connection and time bucket data has been requested. The upper boundary of one bucket is the lower boundary of the next bucket. A transaction is added to a bucket when its round trip time falls within the bounds of that bucket.
Table 5. TN3270E Telnet server time bucket performance section
Offset Name Length Format Description
0(X'0') SMF119TN_NTBucketBndry1 4 Binary Upper boundary for bucket 1 in milliseconds
4(X'4') SMF119TN_NTBucketBndry2 4 Binary Upper boundary for bucket 2 in milliseconds
8(X'8') SMF119TN_NTBucketBndry3 4 Binary Upper boundary for bucket 3 in milliseconds
12(X'C') SMF119TN_NTBucketBndry4 4 Binary Upper boundary for bucket 4 in milliseconds
16(X'10') SMF119TN_NTBucket1Rts 4 Binary Number of transactions with a round trip time meeting bucket 1 criteria
20(X'14') SMF119TN_NTBucket2Rts 4 Binary Number of transactions with a round trip time meeting bucket 2 criteria
24(X'18') SMF119TN_NTBucket3Rts 4 Binary Number of transactions with round trip time meeting bucket 3 criteria
28(X'1C') SMF119TN_NTBucket4Rts 4 Binary Number of transactions with a round trip time meeting bucket 4 criteria
32(X'20') SMF119TN_NTBucket5Rts 4 Binary Number of transactions with a round trip time that exceeds bucket 4 time