TCPIP FTP Attributes
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
v1.12 or later 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:
- blank = 0X00000000
- SSL_RC4_US = 0X0000F0F1
- SSL_RC4_EXPORT = 0X0000F0F2
- SSL_RC2_US = 0X0000F0F3
- SSL_RC2_EXPORT = 0X0000F0F4
- SSL_DES_US = 0X0000F0F6
- SSL_3DES_US = 0X0000F0F7
- SSL_NULL_MD5 = 0X0001F0F1
- SSL_NULL_SHA = 0X0001F0F2
- SSL_RC4_MD5_EX = 0X0001F0F3
- SSL_RC4_MD5 = 0X0001F0F4
- SSL_RC4_SHA = 0X0001F0F5
- SSL_RC2_MD5_EX = 0X0001F0F6
- SSL_DES_SHA = 0X0001F0F9
- SSL_3DES_SHA = 0X0001F0FA
- SSL_AES_128_SHA = 0X0001F2C6
- SSL_AES_256_SHA = 0X0001F3F5
- TLS_RC4_128_WITH_MD5 = 0X0002F0F1
- TLS_RC4_128_EXPORT40_WITH_MD5 = 0X0002F0F2
- TLS_RC2_CBC_128_CBC_WITH_MD5 = 0X0002F0F3
- TLS_RC2_CBC_128_CBC_EXPORT40_WITH_MD5 = 0X0002F0F4
- TLS_DES_64_CBC_WITH_MD5 = 0X0002F0F6
- TLS_DES_192_EDE3_CBC_WITH_MD5 = 0X0002F0F7
- TLS_NULL_WITH_NULL_NULL = 0X0003F0F0
- TLS_RSA_WITH_NULL_MD5 = 0X0003F0F1
- TLS_RSA_WITH_NULL_SHA = 0X0003F0F2
- TLS_RSA_EXPORT_WITH_RC4_40_MD5 = 0X0003F0F3
- TLS_RSA_WITH_RC4_128_MD5 = 0X0003F0F4
- TLS_RSA_WITH_RC4_128_SHA = 0X0003F0F5
- TLS_RSA_EXPORT_WITH_RC2_CBC_40_MD5 = 0X0003F0F6
- TLS_RSA_WITH_DES_CBC_SHA = 0X0003F0F9
- TLS_RSA_WITH_3DES_EDE_CBC_SHA = 0X0003F0C1
- TLS_DH_DSS_WITH_DES_CBC_SHA = 0X0003F0C3
- TLS_DH_DSS_WITH_3DES_EDE_CBC_SHA = 0X0003F0C4
- TLS_DH_RSA_WITH_DES_CBC_SHA = 0X0003F0C6
- TLS_DH_RSA_WITH_3DES_EDE_CBC_SHA = 0X0003F1F0
- TLS_DHE_DSS_WITH_DES_CBC_SHA = 0X0003F1F2
- TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA = 0X0003F1F3
- TLS_DHE_RSA_WITH_DES_CBC_SHA = 0X0003F1F5
- TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA = 0X0003F1F6
- TLS_RSA_WITH_AES_128_CBC_SHA = 0X0003F2C6
- TLS_DH_DSS_WITH_AES_128_CBC_SHA = 0X0003F3F0
- TLS_DH_RSA_WITH_AES_128_CBC_SHA = 0X0003F3F1
- TLS_DHE_DSS_WITH_AES_128_CBC_SHA = 0X0003F3F2
- TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0X0003F3F3
- TLS_RSA_WITH_AES_256_CBC_SHA = 0X0003F3F5
- TLS_DH_DSS_WITH_AES_256_CBC_SHA = 0X0003F3F6
- TLS_DH_RSA_WITH_AES_256_CBC_SHA = 0X0003F3F7
- TLS_DHE_DSS_WITH_AES_256_CBC_SHA = 0X0003F3F8
- TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0X0003F3F9
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:
- mm = Month
- dd = Day of the month
- yy = Year
- hh = Hour
- mm = Minute
- ss = Seconds
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:
- C = Century (0 for 20th, 1 for 21st)
- Y = Year
- M = Month
- D = Day
- H = Hour
- M = Minute
- S = Second
- m = Millisecond
Command The FTP command that initiated the transfer. The command can be one of the following:
- 1 = Append
- 2 = Delete
- 3 = Rename (only possible when Role is server)
- 4 = Retrieve
- 5 = Store
- 6 = Store Unique
Data Set Type The type of data set for the file that is being transferred. The following values are valid:
- S = Sequential
- P = Partitioned data set
- H = Hierarchical file system
Data Structure The data structure of the file that is being transferred. The following values are valid:
- F = File
- R = Record
Data Type The data type of the file that is being transferred. The following values are valid:
- A = ASCII
- B = Double byte
- E = EBCDIC
- I = Image
- U = UCS-2
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:
- SEQ = Sequential
- JES = Job Entry System
- SQL = Structured Query Language
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:
- 200: Command OK
- 202: Command not implemented
- 211: System status
- 212: Directory status
- 213: File status
- 214: Help message
- 215: System type
- 220: Service ready for new user
- 221: Service closing control connection
- 225: Data connection open -- no transfer in progress
- 226: Closing data connection -- requested file action successful
- 227: Entering passive mode
- 230: User logged in -- proceed
- 250: Requested file action OK -- completed
- 257: Path created
- 331: User name OK -- need password
- 332: Need account for login
- 350: Requested file action pending further information
- 421: Service not available -- closing control connection
- 425: Cannot open data connection
- 426: Connection closed -- transfer aborted
- 450: Requested file action not taken -- file unavailable
- 451: Requested action aborted -- local error in processing
- 452: Requested action not taken -- insufficient system storage
- 500: Syntax error -- command unrecognized
- 501: Syntax error in parameters or arguments
- 502: Command not implemented
- 503: Bad sequence of commands
- 504: Command not implemented for that parameter
- 530: Not logged in
- 532: Need account for storing files
- 550: Requested action not taken -- file unavailable
- 551: Requested action aborted -- page type unknown
- 552: Requested file action aborted -- exceeded storage allocation
- 553: Requested action not taken -- file name not allowed
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:
- Command OK = 200
- Command not implemented = 202
- System status = 211
- Directory status = 212
- File status = 213
- Help message = 214
- System type = 215
- Service ready for new user = 220
- Service closing control connection = 221
- Data connection open -- no transfer in progress = 225
- Closing data connection -- requested file action successful = 226
- Entering passive mode = 227
- User logged in -- proceed = 230
- Requested file action OK -- completed = 250
- Path created = 257
- User name OK -- need password = 331
- Need account for login = 332
- Requested file action pending further information = 350
- Service not available -- closing control connection = 421
- Cannot open data connection = 425
- Connection closed -- transfer aborted = 426
- Requested file action not taken -- file unavailable = 450
- Requested action aborted -- local error in processing = 451
- Requested action not taken -- insufficient system storage = 452
- Syntax error -- command unrecognized = 500
- Syntax error in parameters or arguments = 501
- Command not implemented = 502
- Bad sequence of commands = 503
- Command not implemented for that parameter = 504
- Not logged in = 530
- Need account for storing files = 532
- Requested action not taken -- file unavailable = 550
- Requested action aborted -- page type unknown = 551
- Requested file action aborted -- exceeded storage allocation = 552
- Requested action not taken -- file name not allowed = 553
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:
- C= Certificate
- P = Password
- T= Kerberos_Ticket
- U= Undefined
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:
- 0 = Client
- 1 = Server
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:
- A = AT_TLS
- G = GSSAPI
- N = None
- T = TLS
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.
- C = Clear
- N = None
- P = Private
- S = Safe
- U = Unknown
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:
- 0 Unknown - In the history file, the value was Active during historical collection.
- 1 Inactive - A close record was received for this open record.
- 2 Active - No close record was received.
- 4 Complete - The record was closed.
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:
- C = Clear
- N = None
- P = Private
- S = Safe
- U = Unknown
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:
- mm = Month
- dd = Day of the month
- yy = Year
- hh = Hour
- mm = Minute
- ss = Seconds
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:
- C = Century (0 for 20th, 1 for 21st)
- Y = Year
- M = Month
- D = Day
- H = Hour
- M = Minute
- S = Second
- m = Millisecond
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:
- B = Block
- C = Compressed
- S = Stream
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:
- mm = Month
- dd = Day of the month
- yy = Year
- hh = Hour
- mm = Minute
- ss = Seconds
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:
- C = Century (0 for 20th, 1 for 21st)
- Y = Year
- M = Month
- D = Day
- H = Hour
- M = Minute
- S = Second
- m = Millisecond
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.