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.
Application Name The name of the FTP application. The format is a string of up to 8 characters.
Bytes Transferred The number of bytes that was transferred for this file. The format is a long long integer.
Bytes Transmitted (deprecated) 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) (deprecated) 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.
Cipher Specification The current cipher specification for this connection when the security mechanism is TLS or AT-TLS. This value is used for the data encryption or decryption. See the description of the TTLSCipherParms statement in the "Policy Agent and Policy Applications" chapter of the IBM z/OS Communications Server: IP Configuration Reference book for a list of possible cipher values. This value is stored as a long integer and displayed as a string. Valid values for this integer are:
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 (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)
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:
Data Set 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 (deprecated) The local port number for this FTP data connection. The format is a two-byte 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.
Local Port The local port for the FTP data connection. The format is a four-byte integer.
Login Method The current login method for this connection. This value is stored as a single character and displayed as a string. The following are valid:
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 IBM internal use only.
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 (deprecated) 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 a two-byte 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.
Remote Port The remote port for the FTP data connection. The format is a four-byte integer.
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:
Security Mechanism The current security mechanism for this connection. This value is stored as a single character and displayed as a string. The following are valid:
Security Protocol Level The current security protocol level for this connection when the security mechanism is TLS or AT-TLS. The format is a character string.
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 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 control 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 adjacent to 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 adjacent to 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.
Transfer Protection Level The current transfer protection level for this connection. This value is stored as a single character and displayed as a string. The following are valid:
Transmission Duration The amount of time required for the transfer or command to be completed. This value is stored in milliseconds and displayed as a time value (for example, 4.17300s or 4m 20s).
Transmission End The date and time the transmission ended. This time is displayed in the following format:
mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)
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 the transmission has not ended, 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 (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)
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 the User ID on Server Extended attribute 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.