INQUIRE CFDTPOOL
Retrieve information about a coupling facility data table pool.
Conditions: END, ILLOGIC, NOTAUTH, POOLERR
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
Description
The INQUIRE CFDTPOOL command returns the status of the connection of the local CICS region to a coupling facility data table pool.
Browsing
You can also browse through all the coupling facility data table pool names that a CICS region has installed, using the browse options (START, NEXT, and END) on INQUIRE CFDTPOOL commands. CICS implicitly installs coupling facility data table pool names from file definitions that specify a coupling facility data table pool name, even if the definition specifies TABLE(NO). See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.
Options
- CFDTPOOL(data-value)
- specifies the 8-character name of the coupling facility data table pool about which you are inquiring.
- CONNSTATUS(cvda)
- returns
a CVDA value indicating whether CICS is connected to the specified pool. CVDA values are:
- CONNECTED
- The server for the coupling facility data table pool is available in this MVS image, and this CICS is currently connected to it.
- UNCONNECTED
- The server for the coupling facility data table pool is available in this MVS image, but this CICS is not currently connected to it.
- UNAVAILABLE
- The server for the coupling facility data table pool is currently unavailable in this MVS image.
Conditions
- END
- RESP2 values:
- 2
- There are no more coupling facility data table pools to browse.
- ILLOGIC
- RESP2 values:
- 1
- You have issued a START command when a browse of CFDTPOOLs is already in progress, or you have issued a NEXT or an END command when a browse of CFDTPOOLs is not in progress.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the task issuing the command is not authorized to use this command.
- POOLERR
- RESP2 values:
- 1
- The named CFDT pool was not found. Either CICS has not installed any file definitions that specify the named coupling facility data table pool, or the name is specified incorrectly on the command.
- 2
- An internal control structure that CICS uses to maintain access to CFDT pools has been altered while the set of pools known to CICS was being browsed.