CEMT INQUIRE IRC
In the CICS Explorer, the Regions view provides a functional equivalent to this command.
Description
The INQUIRE IRC command shows whether the interregion communication (IRC) facility is open or closed.
Input
Press the Clear key and type CEMT INQUIRE IRC (or suitable abbreviations for the keywords).
The resulting display is similar to the following example.
Sample screen
IN IRC
STATUS: RESULTS - OVERTYPE TO MODIFY
Irc Clo DFHIR000
If you place the cursor against the result and press ENTER, CICS® displays an expanded format, as shown in Figure 2.
IN IRC
RESULT - OVERTYPE TO MODIFY
Irc
Openstatus( Closed )
Xcfgroup( DFHIR000 )
Return(00000000)
Reason(00000000)
CEMT INQUIRE IRC >>-CEMT INQUIRE IRC--+-CLOSED-+--+-----------------+----------->< '-OPEN---' '-XCFGROUP(value)-'
Displayed fields
- IRC
- Indicates that this panel relates to an IRC inquiry.
- OPENSTATUS (value)
- Displays
whether the IRC facility is open or closed. The values are:
- CLOSED
- Interregion communication for this CICS system is terminated after tasks using the session have terminated normally.
- OPEN
- Interregion
communication for this CICS system
is initialized. This allows connections to be established between
this system and other systems. You can control the availability of
individual connections with the INSERVICE or OUTSERVICE settings on
the connection names, using CEMT INQUIRE CONNECTION or CEMT SET CONNECTION.
The DFHIR3780 message is issued to the console log if the region made an unsuccessful attempt to start IRC.
Note:- You can reset this value by overtyping it with a different value,
or with:
- IMMCLOSE
- All tasks using IRC sessions are to be abended when they next try to use the session. Interregion communication is terminated when all tasks that were using IRC have been abended or have terminated normally.
- The values of Return and Reason will be nonzero only after certain SET (or overtype) failures. These are accompanied by a message number.
- XCFGROUP
- Displays
the 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 displays the XCF group the region would be in if XCF were opened.
For introductory information about XCF/MRO, see Cross-system multiregion operation (XCF/MRO) .
