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


dfhs3_FCCTextract_statistics.html | Timestamp icon Last updated: Monday, 5 June 2017