Use the TCPIP FTP attributes to create situations that monitor performance data for FTP data transfers between a z/OS FTP client and a remote FTP server and between a remote FTP client and a z/OS FTP server. A local IP address and port number and a remote IP address and port number uniquely define the FTP data connection for this FTP transfer.
Bytes Transmitted The number of bytes that was transmitted. When the value in the Bytes Transmitted field exceeds 1,073,741,823, the number is divided by 1,073,741,824. The quotient is stored in the Bytes Transmitted (in GB) field and the remainder is stored in the Bytes Transmitted field. The format is an integer.
Bytes Transmitted (in GB) The number of bytes that was transmitted, divided by 1,073,741,824. When the value in the Bytes Transmitted field exceeds 1,073,741,823, the number is divided by 1,073,741,824. The quotient is stored in the Bytes Transmitted (in GB) field and the remainder is stored in the Bytes Transmitted field. The format is an integer.
Client User ID The local user name (login name) of the client. This column applies to client transfers only. The format is an alphanumeric string no longer than 8 characters.
Collection Time The time and date of the data sampling. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
Where:
The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:
Command The FTP command that initiated the transfer. The command can be one of the following:
Data Set Type The type of data set for the file that is being transferred. The following values are valid:
Data Structure The data structure of the file that is being transferred. The following values are valid:
Data Type The data type of the file that is being transferred. The following values are valid:
Dataset Name The name of the data set that is being transferred. The format is an alphanumeric string with a maximum of 1024 characters.
File Type The type of file that is being transferred. The following three-character values are valid:
FTP Session ID The unique identifier for the FTP session associated with this transfer. The format is a string up to 16 characters.
Last Reply to Client The most recent reply that was sent from the server to the client. This value is stored and displayed as a string. Valid values for this integer are:
Last Reply to Client Description Description of the most recent reply that was sent from the server to the client. This value is stored as a string and displayed as a number. Valid values are:
Local IP Address The local IP address for this FTP data connection. The format is a string up to 45 characters in length.
Local IP Port The local port number for this FTP data connection. The format is an integer.
Local IP Port String The local port for this FTP data connection as a string. The format is a string up to five characters in length.
New Data Set Name The name of the second data set involved in the transfer. This column is completed for records associated with an FTP Rename function only. The format is an alphanumeric string no longer than 1024 characters.
New PDS Member Name The name of the member of the second data set involved in the transfer. This column is completed only for records associated with an FTP Rename function. The format is an alphanumeric string no longer than 8 characters.
NMI FTP Enhancements An indicator of whether certain attributes are available to be monitored.
Origin Node The unique identifier of the monitored TCP/IP stack. The format is an alphanumeric string no longer than 32 characters.
PDS Member Name The name of the member of the partitioned data set (PDS) that is being transferred. The format is an alphanumeric string no longer than 8 characters.
Remote IP Address The remote IP address for this FTP data connection. This is the IP address associated with the FTP connection partner session of the TCP/IP stack. The format is an alphanumeric string no longer than 45 characters.
Remote IP Port The remote IP port for this FTP data connection. This is the remote port number, that is the port number associated with the FTP connection partner session of the TCP/IP stack. The format is an integer.
Remote IP Port String The remote port for this FTP data connection as a string. The format is a string up to five characters in length.
Role The role of the z/OS server that indicates whether the TCP/IP stack is acting as the Client or as the Server in this FTP connection. The following are valid values for this switch:
Server Logging Session ID The ID that uniquely identifies sessions between z/OS FTP servers and FTP clients. The format is a 15-character string. The identifier is generated from FTP daemon job name, followed by a 5-digit number in range 00000-99999. The value is displayed in the SYSLOGD file log entries when FTP activity logging is enabled.
State The status of this FTP transfer. This value is stored as an integer and displayed as a number. The following are valid values:
System ID The SMF system ID (the name of the z/OS environment). The format is an alphanumeric string no longer than 4 characters.
TCP Control Connection ID The TCP connection ID of the connection being used for the FTP data connection. This value is displayed as a 8-digit hexadecimal number.
This value is displayed as a hexadecimal number that uniquely identifies the TCP connection being used for the FTP control connection. The TCP connection ID (or resource ID) is displayed under the Local Socket column to the left of the IP address in the output of a NETSTAT command.
TCP Data Connection ID The TCP connection ID for the connection being used for the FTP data connection. This value is displayed as a 8-digit hexadecimal number.
This value is displayed as a hexadecimal number that uniquely identifies the TCP connection being used for the FTP data connection. The TCP connection ID, sometimes referred to as the resource ID, is displayed under the Local Socket column to the left of the IP address in the output of a NETSTAT command.
TCPIP STC Name The name of the TCP/IP job. The format is an alphanumeric string no longer than 8 characters.
Transmission Duration The amount of time, in milliseconds, in which the transfer or command completed. The format is an integer.
Transmission End The date and time the transmission ended. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
Where:
The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:
When no connections have been rejected, this value is stored as a character string of zeros and displayed as blank.
Transmission Mode The transmission mode that is used for this transmission. The following alphabetic characters are valid:
Transmission Start The date and time the transmission started. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
Where:
The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:
User ID on Server The user name that was used to log in to the server. The format is an alphanumeric string no longer than 8 characters. When the actual user ID is longer then 8 characters, it is truncated. See User ID on Server Extended for longer user IDs.
User ID on Server Extended The user name that was used to log in to the server. The format is an alphanumeric string no longer than 63 characters. This attribute is available only on LPARs running on z/OS v1.8 or higher.