NMI and SMF enhancements for TCP/IP applications

z/OS® V2R1 Communications Server adds two new SMF 119 event records:

The SMF 119, subtype 71 record contains FTP daemon configuration data. This record is created during the FTP daemon initialization when it listens on the listening port successfully for the first time. A new FTP.DATA statement SMFDCFG is added to control whether to write this SMF record to the SMF data set.
The SMF 119, subtype 24 record provides the TN3270 server initial profile configuration information, as well as information about replacement of the profile caused by VARY TCPIP,Telnet,OBEYFILE processing. This record is written to the MVS™ SMF data sets.

In z/OS V2R1 Communications Server, you can obtain FTP daemon configuration data by using the following NMIs:

The TCP/IP callable NMI, EZBNMIFR, by specifying the new request type, GetFTPDaemonConfig.
The real-time TCP/IP network monitoring NMI, SYSTCPSM. The SMF type 119, subtype 71 record for FTP daemon configuration data is available to this NMI.

In addition, TN3270 server profile configuration data can be obtained through the following NMIs:

The TCP/IP callable NMI, EZBNMIFR by specifying the new request type, GetTnProfile.
The real-time TCP/IP network monitoring NMI, SYSTCPSM. The SMF type 119, subytpe 24 record for TN3270 server profile configuration data is available to this NMI.

The new SMF 119 event record is subtype 24 and is written to the MVS SMF data sets. The event record can also be obtained from the real-time TCP/IP network monitoring NMI (SYSTCPSM). The new SMF record provides the initial profile and information about replacement of the profile caused by VARY TCPIP,Telnet,OBEYFILE processing.

The new GetTnProfile request for the TCP/IP Callable NMI, EZBNMIFR, provides complete profile information. Network management applications can use a combination of the GetTnProfile request and the new SMF 119 event records that are created during the VARY TCPIP,Telnet,OBEYFILE command processing to monitor replacements of the Telnet profile settings.

Using NMI and SMF enhancements for TCP/IP applications

To obtain FTP daemon configuration data, perform the appropriate tasks in Table 1.

Table 1. NMI and SMF enhancements for TCP/IP applications about FTP daemon configuration data
Task	Reference
Obtain FTP daemon configuration data from the TCP/IP Callable NMI by developing or enhancing an application to use the new TCP/IP callable NMI request, GetFTPDaemonConfig.	Network management interfaces in z/OS Communications Server: IP Programmer's Guide and Reference
Interpret return values, return codes, and reason codes that result from calling the TCP/IP callable NMI EZBNMIFR.	Network management interfaces in z/OS Communications Server: IP Programmer's Guide and Reference
Configure SMFDCFG statement in server FTP.DATA to write type 119 SMF record for FTP daemon configuration data into SMF data sets. The statement has no effect on whether the new SMF record is available to the real-time SMF data NMI or not.	File Transfer Protocol in z/OS Communications Server: IP Configuration Reference
Optionally, configure the real-time TCP/IP network monitoring NMI (SYSTCPSM) to support the SMF 119 subtype 71 event records by specifying NETMONITOR SMFSERVICE PROFILE in the PROFILE.TCPIP configuration file.	NETMONITOR statement in z/OS Communications Server: IP Configuration Reference
Enable applications to obtain the SMF 119 subtype 71 event records from the real-time TCP/IP network monitoring NMI (SYSTCPSM) by configuring the user IDs that are associated with applications to access the SYSTCPSM NMI interface.	Real-time TCP/IP network monitoring NMI: Configuration and enablement in z/OS Communications Server: IP Programmer's Guide and Reference

To obtain TN3270 server profile configuration data, perform the appropriate tasks in Table 2.

Table 2. NMI and SMF enhancements for TCP/IP applications about TN3270 server profile configuration data
Task	Reference
Configure the creation of the SMF 119 subtype 24 event records that provide TN3270 server profile information by specifying SMFCONFIG in the PROFILE.TELNET configuration file.	SMFCONFIG statement in z/OS Communications Server: IP Configuration Reference
Optionally, configure the real-time TCP/IP network monitoring NMI (SYSTCPSM) to support the SMF 119 subtype 24 event records by specifying NETMONITOR SMFSERVICE PROFILE in the PROFILE.TCPIP configuration file.	NETMONITOR statement in z/OS Communications Server: IP Configuration Reference
Enable applications to obtain the SMF 119 subtype 24 event records from the real-time TCP/IP network monitoring NMI (SYSTCPSM) by configuring the user IDs that are associated with applications to access the SYSTCPSM NMI interface.	Real-time TCP/IP network monitoring NMI: Configuration and enablement in z/OS Communications Server: IP Programmer's Guide and Reference
Obtain TN3270 server profile information from the TCP/IP Callable NMI by developing or enhancing an application to use the new TCP/IP Callable NMI request, GetTnProfile.	TCP/IP callable NMI (EZBNMIFR) in z/OS Communications Server: IP Programmer's Guide and Reference