INQUIRE IRC
Show the IRC status.
Conditions: NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
Description
The INQUIRE IRC command indicates whether interregion communication (IRC) is open, closed, or in a transitional state in your CICS® system. IRC must be open for your CICS region to communicate with another CICS region using any of the multiregion operation (MRO) facilities (IRC, XM, or XCF).
Options
- OPENSTATUS(cvda)
- returns
a CVDA value identifying the status of IRC in the system. CVDA values
are:
- CLOSED
- IRC is closed for this system, or is not present in the system.
- CLOSING
- A SET IRC CLOSED request to quiesce MRO has been received; tasks that were already using an MRO link are being allowed to complete, but new tasks cannot use an MRO link.
- IMMCLOSING
- A SET IRC IMMCLOSE request to shut down MRO immediately has been received. Tasks that were using an MRO link are being terminated abnormally.
- OPEN
- IRC is open for this system.
- XCFGROUP(data-area)
- returns the
8-character name of the cross-system coupling facility (XCF) group of which this region is a member.
If this region is not a member of an XCF group (because it has not signed on to IRC), XCFGROUP contains the XCF group the region would be in if XCF were opened.
Conditions
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.