CEMT INQUIRE IRC

Show the status of the interregion communication (IRC) facility.

In the CICS Explorer, the Regions operations 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

Figure 1. CEMT INQUIRE IRC 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.

Figure 2. The expanded display
 IN IRC
 RESULT - OVERTYPE TO MODIFY
   Irc
   Openstatus( Closed )
   Xcfgroup( DFHIR000 )
   Return(00000000)
   Reason(00000000)

CEMT INQUIRE IRC

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE IRCCLOSEDOPENXCFGROUP( 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:
  1. 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.
  2. The values of Return and Reason will be nonzero only after certain SET (or overtype) failures. These are accompanied by a message number, which you can refer to in CICS Messages and Codes Vol 1 .
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.