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.
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:
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 an 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 LPAR being monitored is running z/OS V1.8 , this column applies to both the client and the server. When the LPAR being monitored is running an earlier version of z/OS, this column applies to the server only.
When the FTP Type is Server, the following reason codes are possible:
When the FTP Type is Client, the following reason codes are possible. These client values are documented in the z/OS Communications Server IP User's Guide. Additional information about the failure might be available in that manual.
Login Failure Reason Description The reason that the login failed. This value is stored and displayed as a string.
When the LPAR being monitored is running z/OS V1.8 , this column applies to both the client and the server. When the LPAR being monitored is running an earlier version of z/OS, this column applies to the server only.
When the FTP Type is Server, the following values are possible:
When the FTP Type is Client, the following values are possible. These FTP client error codes are documented in the z/OS Communications Server IP User's Guide. Additional information about the failure might be available in that manual.
NMI FTP Enhancements An indicator of whether certain attributes are available to be monitored.
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 an 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.
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 in seconds. The format is an integer.
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
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.
Session End Reason Code A code indicating the reason that the control connection ended. This value is stored and displayed as a number.
When FTP Type is Server, the following values are possible:
When FTP Type is Client, the following values are possible. The FTP client error codes are documented in the z/OS Communications Server IP User's Guide. Additional information about the failure might be available in that manual.
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 LPAR being monitored is running z/OS V1.8 , this column applies to both the client and the server. When the LPAR being monitored is running an earlier version of z/OS, this column applies to the server only.
When the FTP Type is Server, the following values are possible:
When the FTP Type is Client, the following values are possible. These FTP client error codes are documented in the z/OS Communications Server IP User's Guide. 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
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 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 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 to the left of 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.
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 z/OS V1.8 or higher.