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


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