Use the FTP Sessions attributes to create situations that monitor the sessions from either a remote client to a z/OS FTP server or from a z/OS client to a remote FTP server.
Application Name The name of the FTP application. The format is an alphanumeric string no longer than 8 characters.
ASID The z/OS address space ID of the address space that opened the socket. This value is displayed as a 4-digit hexadecimal number.
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 v1.12 or later book for a list of possible cipher values. This value is stored as an 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:
FTP Session ID The unique identifier for this FTP session. The format is an alphanumeric string no longer than 16 characters.
FTP Type Identifies whether this FTP session is using the FTP client or the FTP server on the local system. This value is stored as an integer and displayed as a string. This field displays the string. Valid values are:
FTP Type Int Identifies whether this FTP session is using the FTP client or the FTP server on the local system. This value is stored as an integer. This field displays the integer. Valid values are:
Local IP Address The local IP address for this FTP control connection. The format is an alphanumeric string no longer than 45 characters.
Local Port The local port for the FTP control connection. The format is a four-byte integer.
Local Port (deprecated) The local port for the FTP control connection, as a two-byte integer.
Local Port String The local port for the FTP control connection as a string. The format is a string up to five characters in length.
Login Failure Reason Code The reason returned when a login fails. This value is stored and displayed as a number.
When the FTP Type value is Server, the following reason codes are possible:
When the FTP Type value is Client, the following reason codes are possible. These client values are documented in the z/OS Communications Server: IP User's Guide and Commands. Additional information about the failure might be available in that book.
Login Failure Reason Description The reason that the login failed. This value is stored as a number and displayed as a string.
When the FTP Type value is Server, the following reason codes are possible:
When the FTP Type value is Client, the following reason codes are possible. The FTP client error codes, found in parentheses below, are documented in the z/OS Communications Server: IP User's Guide and Commands. Additional information about the failure might be available in that book.
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:
NMI FTP Enhancements IBM internal use only.
Origin Node The unique identifier for the TCP/IP stack being displayed. The format is an alphanumeric string no longer than 32 characters.
Remote IP Address The remote IP address for the FTP control connection. The format is an alphanumeric string no longer than 45 characters.
Remote Port The remote port for the FTP control connection. The format is a four-byte integer.
Remote Port (Deprecated) The remote port for the FTP control connection, as a two-byte integer.
Remote Port String The remote port for the FTP control connection as a string. The format is a string up to five characters in length.
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.
Session Duration The duration of the session. This value is stored in seconds and displayed as a time value (for example, 4.00000s or 4m 20s).
Session End The date and time when the control session 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 session has not ended, this value is stored as a character string of zeros and displayed as blank.
Session End Reason Code A code indicating the reason that the control connection ended. This value is stored and displayed as a number.
When the FTP Type value is Server, the following reason codes are possible:
When the FTP Type value is Client, the following reason codes are possible. The FTP client error codes are documented in the z/OS Communications Server: IP User's Guide and Commands. Additional information about the failure might be available in that book.
Session End Reason Description The description of the session end reason code. This value is stored as an integer and displayed as a string.
When the FTP Type value is Server and Client, the following reason codes are possible:
When the FTP Type value is Server, the following reason codes are possible:
When the FTP Type value is Client, the following reason codes are possible. These FTP client error codes are documented in the z/OS Communications Server: IP User's Guide and Commands Additional information about the failure might be available in that manual.
Session Start The date and time at which the control session was established. 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:
State The status of this FTP session. 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 for the connection being used for the control connection. This value is displayed as an 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.
TCPIP STC Name The TCP/IP job name. The format is an alphanumeric string no longer than 8 characters.
Total Bytes Transferred The number of bytes in all files sent and received since the FTP connection started. The format is a long long integer.
Total Files Transferred The number of files sent and received since the FTP connection started. The format is an integer.
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:
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.