FCCT gate, EXTRACT_STATISTICS function
This function returns information about a table that is currently open, with the option to reset the statistics.
Input Parameters
- RESET_STATISTICS
- Optional Parameter
- Specifies whether to reset the statistics. Values for the parameter
are:
- YES
- NO
- TABLE_NAME
- 16-character table name. This name is typically the CICS® file name padded with trailing blanks.
- TABLE_TOKEN
- The token returned by the OPEN function, which must be passed on all subsequent requests against that table.
- TRANSACTION_NUMBER
- Optional Parameter
- This 4-character string identifies the requesting task in the debug trace if used.
Output Parameters
- CONTENTION_COUNT
- Optional Parameter
- This fullword binary field indicates the number of times a rewrite or delete failed because of a mismatched version (for the contention model) or the number of times that a lock was found to be unavailable (for the locking or recoverable models) since the last statistics reset.
- CURRENT_RECORDS
- This fullword binary field indicates the number of records in the table the last time that the current server accessed the table.
- CURRENT_USERS
- This fullword binary field indicates the number of explicit opens that are currently active against the table, not including internal recoverable opens issued by the server.
- HIGHEST_RECORDS
- Optional Parameter
- This fullword binary field indicates the highest number of records in the table as seen by the current server at any time since the last statistics reset.
- MAXIMUM_RECORDS
- Optional Parameter
- This fullword binary field specifies the maximum number of records that can be stored in the table. If no maximum limit is required, the maximum positive number (hex 7FFFFFFF) can be specified.
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- SERVER_CONNECTION_FAILED
- TABLE_TOKEN_INVALID
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- Values for the parameter are:
- OK
- EXCEPTION
- DISASTER
- INVALID
- KERNERROR
- PURGED