FCDS gate, EXTRACT_CFDT_STATS function
This function causes statistics relating to coupling facility data table usage to be extracted from the coupling facility data tables server.
Input Parameters
- FCTE_POINTER
- The address of the FCTE entry of the file for which CFDT statistics are to be extracted.
- RESET_STATISTICS
- Indicates whether the statistics fields are to be reset to zero
or not. Values for the parameter are:
- YES
- NO
- TRANSACTION_NUMBER
- Optional Parameter
- 4-digit transaction number, which is passed to the CFDT server for inclusion in trace messages.
Output Parameters
- CONTENTION_COUNT
- Optional Parameter
- This fullword parameter returns the number of contentions that have been detected, for a coupling facility data table that uses the contention update model.
- CURRENT_RECORDS
- Optional Parameter
- This fullword parameter returns the current number of records in the coupling facility data table.
- CURRENT_USERS
- Optional Parameter
- This fullword parameter returns the current number of users of the coupling facility data table; that is, the number of opens issued against it.
- HIGHEST_RECORDS
- Optional Parameter
- This fullword parameter returns the highest number of records that have been in this coupling facility data table since it was last created.
- MAXIMUM_RECORDS
- Optional Parameter
- This fullword parameter returns the current value of the MAXNUMRECS limit for the data table.
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- CFDT_CONNECT_ERROR
- CFDT_DISCONNECT_ERROR
- CFDT_REOPEN_ERROR
- CFDT_SERVER_NOT_AVAILABLE
- CFDT_SERVER_NOT_FOUND
- CFDT_STATS_ERROR
- CFDT_SYSIDERR
- CFDT_TABLE_GONE
- The following values are returned when RESPONSE is
INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- The following values are returned when RESPONSE is DISASTER:
- POOL_ELEMENT_NOT_FOUND
- ABEND
- DISASTER_PERCOLATION
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- Values for the parameter are:
- OK
- DISASTER
- EXCEPTION
- INVALID
- KERNERROR
- PURGED