TCP/IP Report Field Definitions (MF User)
During playback, you can set Performance Test for Mainframe Servers to collect information on many separate fields. These fields are collected in five separate tables. The information in the final reports then comes from this data. The fields are listed in the following table.
Field names and descriptions
Field Name | Description |
|---|---|
AF_family (AFIN) | The IP address format for the client and server. It can be either IPV4 or IPV6 format. |
BytesReceivedRate (BYRR) | Number of bytes received per unit time. |
BytesSentRate (BYSR) | Number of bytes sent per unit time. |
ClientAddress (CLAD) | The IP address of the client. |
ClientAddress6 (CLA6) | The IP address of the client in IPV6 format. |
ClientPort (CLPT) | The port number of the client. |
ConnectionCount (CNCT) | Number of CONNECTION instances, whether successful or only attempted, within a SCRIPT instance. This is not the number of attempts, but rather the number of <CONNECT> tags executed. For example, five attempts with the last attempt being successful counts as one CONNECTION. Five attempts with no success is also one CONNECTION. |
ConnectionDuration (CNDR) | Length in time of a CONNECTION instance (ConnectionFinishTime-ConnectionStartTime). If a connection is never established, equals 0. |
ConnectionFinishTime (CNFT) | Date and time when a CONNECTION instance finished, whether normally or not. This is when we issue the CLOSE verb during the playback or when we are notified that the partner has closed the connection. |
ConnectionID (CNID) | From the ID keyword on the <CONNECT> tag within a script. |
ConnectionNumber (CNNU) | Generated by Performance Test for Mainframe Servers during playback, this uniquely identifies a CONNECTION instance within the scope of a SCRIPT instance. This value is NOT unique within the scope of the entire playback. Range: 4 byte unsigned integer. |
ConnectionRate (CNRT) | The number of CONNECTION instances created per unit time. |
ConnectionsAttempted (CNAT) | Number of times we tried to connect to a partner for a single <CONNECT> tag execution. If the user has a <CONNECT> and other tags within a REXX loop, each time the <CONNECT> tag is encountered is a new CONNECTION instance. |
ConnectionsRefused (CNRF) | Number of times a CONNECTION instance was refused by the partner. |
ConnectionStartTime (CNST) | If the connection is established, the TOD when we issued the successful CONNECT verb. If a connection is never established, the TOD when we issued the last attempted CONNECT verb. |
ConnectionStatus (CNSC) | The final status of the connection: Normal: You established a connection, were able to send data on the connection, and received complete HTTP responses to all of the HTTP requests you transmitted. TimedOut: You established a connection, have sent one or more HTTP requests on the connection, and might have received one or more HTTP responses on the connection, but did not receive a complete HTTP response for one of your HTTP requests (within the STDWAIT amount of time). PrematureClose: You established a connection, might have sent one or more HTTP requests on the connection, might have received one or more HTTP responses on the connection, and then either ran out of CLIENT data in the script before you had a complete HTTP request to send or the partner (the server) closed the connection before it sent back a complete HTTP response. It is also a PrematureClose if the partner closes the connection at any point “in-flight”, e.g., while you are in the process of sending a request. Reset: You established a connection, might have sent one or more HTTP requests on the connection, might have received one or more HTTP responses on the connection, and then received a TCP 'RESET' indicator. CouldNotConnect: You could not establish a TCP connection with the partner, either because you timed out (STDWAIT) or because the partner refused the connection. |
ConnectionsTimedOut (CNTO) | Number of times a CONNECTION instance timed out rather than being established. |
DB2SqlCode (SQCD) | The numeric SQL code returned by the SQL statement, executed during the playback. |
DB2SqlState (SQST) | The numeric SQL state returned by the SQL statement, executed during the playback. |
DB2SqlStatement (SQSM) | The SQL statement executed. |
DB2SqlAnswerSet (SQAS) | The resultant data when executing a Db2 SQL statement from the database when it was recorded during the playback. |
DB2RDBNAM (RDBN) | Name of the target relational database. |
DB2Userid (SQUS) | The userid logged into the database. |
ExpDB2SqlCode (EXSQCD) | The numeric SQL code returned by the SQL statement, executed when it was recorded. |
ExpDB2SqlState (EXSQST) | The numeric SQL state returned by the SQL statement, executed when it was recorded. |
ExpDB2SqlAnswerSet (EXSQAS) | The resultant data when executing a Db2 SQL statement from the database when it was recorded. |
ExpResponseBody (EXBD) | The (EXPECTED) entire response body. For ECI and CTG playback, this field reports ECI COMMAREA data. |
ExpResponseBodyByteCount (EXBB) | (EXPECTED) Number of bytes in the response body. |
ExpResponseBodyLineCount (EXBL) | (EXPECTED) Number of LINEFEED characters (x'0A') in the response body. |
ExpResponseByteCount (EXCT) | The (EXPECTED) number of bytes in a complete HTTP response. |
ExpResponseHeadernnnn (EXHDnnnn) | The (EXPECTED) value of a particular HTTP response header, one of the values in Valid Values for RequestHeadernnnn, ResponseHeadernnnn, ExpResponseHeadernnnn. |
ExpResponseHeaderCount (EXHC) | The (EXPECTED) number of headers present in the HTTP response. |
ExpResponseHeaders (EXHS) | The (EXPECTED) value of all of the HTTP response headers present in the HTTP response. |
ExpResponseReasonPhrase (EXRP) | The (EXPECTED) reason phrase present in the HTTP response. |
ExpResponseStatusCode (EXSC) | The (EXPECTED) status code present in the HTTP response. |
ExpResponseVersionNumber (EXVN) | The (EXPECTED) version number of the HTTP response, one of the following: HTTP/1.0, HTTP/1.1, or other version number. |
FinalResponseTime (RTFN) | The time elapsed from when the last byte of the HTTP request was sent until we see the last byte of the HTTP response. |
InitialResponseTime (RTIN) | The time elapsed from when the last byte of the HTTP request was sent until we see the first byte of the HTTP response. |
JobName (JBNA) | The MVS job name. |
JobNumber (JBNU) | The JES job number. |
MessageCount (MSCT) | Number of messages within a CONNECTION instance. This could be zero if the CONNECTION was never successful. |
MessageDuration (MSDR) | Length in time of a MESSAGE instance. |
MessageFinishTime (MSFT) | Date and time when a MESSAGE instance finished. This is when we received the last byte of data that makes up a complete HTTP response. |
MessageID (MSID) | The sequence number that is part of the <CLIENT> tag within a script for the first byte of the HTTP request. |
MessageNumber (MSNU) | Generated by Performance Test for Mainframe Servers during playback, this uniquely identifies a MESSAGE instance within the scope of a CONNECTION instance. This value is NOT unique within the scope of the entire playback. |
MessageRate (MSRT) | The number of messages created per unit time. |
MessageStartTime (MSST) | Date and time when a MESSAGE instance started. This is when we first issue the SEND verb for the beginning of an HTTP request. |
OwnerName (OWNA) | Entered by the user on the CONTROL statement to provide the user with some indication of who did this playback (or other notes). |
PlaybackDuration (PLDR) | Length in time of the entire playback. |
PlaybackFinishTime (PLFT) | Date and time when the playback program finished. |
PlaybackName (PLNA) | Entered by the user on the CONTROL statement to provide the user with some indication of what this playback is about (or other notes). |
PlaybackNumber (PLNU) | Always set to 1 in this release of the product. |
PlaybackReturnCode (PLRC) | The return code of the entire playback jobstep. This will be the maximum of the internal return code (set by Performance Test for Mainframe Servers when errors are detected) and the maximum script return code set by REXX code added by a user with a REXX EXIT or RETURNstatement. |
PlaybackStartTime (PLST) | Date and time when the playback program started. |
Protocol (PROT) | The application or network protocol used for a connection - either HTTP, HTTPS, or TCP. |
RequestBody (RQBD) | The entire request body, if present. For ECI and CTG playback, this field reports ECI COMMAREA data. |
RequestBodyByteCount (RQBB) | Number of bytes in the request body. |
RequestBodyLineCount (RQBL) | Number of LINEFEED characters (x'0A') in the request body. |
RequestByteCount (RQCT) | The number of bytes in a complete HTTP request. |
RequestHeadernnnn (RQHDnnnn) | The value of a particular HTTP request header, where nnnn is one of the values in Valid Values for RequestHeadernnnn, ResponseHeadernnnn, ExpResponseHeadernnnn. |
RequestHeaderCount (RQHC) | The number of headers present in the HTTP request. |
RequestHeaders (RQHS) | The value of all of the HTTP headers present in the HTTP request. |
RequestMethod (RQME) | The method sent in the HTTP request, one of the following: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT, or other. |
RequestURI (RQUR) | The URI contained in the HTTP request. |
RequestVersionNumber (RQVN) | The version number of the HTTP request, one of the following: HTTP/1.0, HTTP/1.1, or -other-. |
ResponseBody (RSBD) | The (ACTUAL) entire response body. For ECI and CTG playback, this field reports ECI COMMAREA data. |
ResponseBodyByteCount (RSBB) | (ACTUAL) Number of bytes in the response body. |
ResponseBodyLineCount (RSBL) | (ACTUAL) Number of LINEFEED characters (x'0A') in the response body. |
ResponseByteCount (RSCT) | The (ACTUAL) number of bytes in a complete HTTP response. |
ResponseHeadernnnn (RSHDnnnn) | The (ACTUAL) value of a particular HTTP response header, one of the values in Valid Values for RequestHeadernnnn, ResponseHeadernnnn, ExpResponseHeadernnnn. |
ResponseHeaderCount (RSHC) | The (ACTUAL) number of headers present in the HTTP response. |
ResponseHeaders (RSHS) | The (ACTUAL) value of all of the HTTP response headers present in the HTTP response. |
ResponseReasonPhrase (RSRP) | The (ACTUAL) reason phrase present in the HTTP response. |
ResponseStatusCode (RSSC) | The (ACTUAL) status code present in the HTTP response. |
ResponseVersionNumber (RSVN) | The (ACTUAL) version number of the HTTP response, one of the following: HTTP/1.0, HTTP/1.1, -other-. |
ScriptDuration (SCDR) | Length in time of a SCRIPT instance. |
ScriptFinishTime (SCFT) | Date and time when a SCRIPT instance finished. |
ScriptName (SCNA) | From the SCRIPT statement. |
ScriptNumber (SCNU) | Generated by Performance Test for Mainframe Servers during playback, this uniquely identifies a SCRIPT instance within the scope of a SOCKETS instance. This value is NOT unique within the scope of the entire playback. |
ScriptReturnCode (SCRC) | The return code of a SCRIPT instance. This will be the maximum of the internal return code (set by Performance Test for Mainframe Servers when errors are detected) and the maximum script return code set by REXX code added by a user with a REXX EXIT or RETURN statement. |
ScriptStartTime (SCST) | Date and time when a SCRIPT instance started. |
ScriptStatementCount (SCSC) | Number of SCRIPT instances under a specific SOCKETS instance. |
ServerAddress (SVAD) | The IP address of the server. |
ServerAddress6 (SVA6) | The IP address of the server in IPV6 format. |
ServerPort (SVPT) | The port number of the server. |
SocketsDuration (SODR) | Length in time of a SOCKETS instance. |
SocketsFinishTime (SOFT) | Date and time when a SOCKETS instance finished. |
SocketsID (SOID) | From the ID keyword on a SOCKETS statement. |
SocketsNumber (SONU) | Generated by Performance Test for Mainframe Servers during playback, this uniquely identifies a SOCKETS instance within the scope of the playback. Analogous to PORT number in the VTAM version of Performance Test for Mainframe Servers. |
SocketsReturnCode (SORC) | The return code of a SOCKETS instance. This will be the maximum of the internal return code (set by Performance Test for Mainframe Servers when errors are detected) and the maximum script return code set by REXX code added by a user with a REXX EXIT or RETURN statement. |
SocketsStartTime (SOST) | Date and time when a SOCKETS instance started. |
SocketsStatementCount (SOSC) | Number of SOCKETS instances in the playback. |
SystemName (SYNA) | The MVS system ID, for example, AC01. |
TimeForConnectionRefusal (TMCR) | The amount of time between issuing the CONNECT verb and when the connection was refused by the partner. |
TimeForConnectionTimedOut (TMCT) | The amount of time between issuing the CONNECT verb and when the connection request timed out. |
TimeToConnect (TMTC) | The amount of time between issuing the CONNECT verb and when the connection was actually established. |
The values in the following table are valid values for the variable nnnn listed on several of the field names shown in the above table. Each of these valid values can be used on any field name that shows the variable nnnn.
Valid Values for RequestHeadernnnn, ResponseHeadernnnn, ExpResponseHeadernnnn
Value |
|---|
(ACPT) Accept |
(ACCH) Accept-Charset |
(ACEN) Accept-Encoding |
(ACLA) Accept-Language |
(ACRA) Accept-Ranges |
(AGE) Age |
(ALOW) Allow |
(AUTH) Authorization |
(CACO) Cache-Control |
(CONN) Connection |
(COEN) Content-Encoding |
(COLA) Content-Language |
(COLN) Content-Length |
(COLO) Content-Location |
(COMD) Content-MD5 |
(COOK) Cookie |
(CORA) Content-Range |
(COTY) Content-Type |
(DATE) Date |
(EXPC) Expect |
(EXPR) Expires |
(ETAG) ETag |
(FROM) From |
(HOST) Host |
(IFMA) If-Match |
(IFMS) If-Modified-Since |
(IFNM) If-None-Match |
(IFRA) If-Range |
(IFUS) If-Unmodified-Since |
(LAMD) Last-Modified |
(LOCA) Location |
(MXFW) Max-Forwards |
(PRAG) Pragma |
(PAUC) Proxy-Authenticate |
(PAUZ) Proxy-Authorization |
(RANG) Range |
(REFR) Referer |
(RTAF) Retry-After |
(SRVR) Server |
(TRLR) Trailer |
(TREN) Transfer-Encoding |
(TE) TE |
(UPGD) Upgrade |
(USAG) User-Agent |
(VARY) Vary |
(VIA) Via |
(WARN) Warning |
(WWWA) WWW-Authenticate |
(OTHR) -concatenation of all others we see- |