INQUIRE IPFACILITY
Retrieve information about an IP facility.
Conditions:ILLOGIC, NOTAUTH, NOTFIND
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
This command is threadsafe
Description
The INQUIRE IPFACILITY command returns information about a particular IPFACILITY installed in your CICS system.
Options
- IPFACILITY (data-value)
- Specifies the 4-byte binary token identifying the IP facility to be queried. This should be one of the tokens returned in the IPFACILITIES list from an INQUIRE TASK command.
- IPCONN (data-area)
- Returns the 8-character value of the IPCONN with which this IP facility is associated.
- IPFACILTYPE (cvda)
- Returns a cvda value where:
- PRINCIPAL
- This is the task's principal facility.
- ALTERNATE
- This is the task's alternate facility.
Conditions
- ILLOGIC
- RESP2 values:
- 1
- A START command has been issued when a browse of IPFACILITY resources is already in progress, or a NEXT or an END command has been issued when a browse of IPFACILITY resources is not in progress.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
- NOTFIND
- RESP2 values:
- 1
- The named IPFACILITY cannot be found.