SET IRC

Description

The SET IRC command allows you to start (open) or stop (close) interregion communication (IRC) in your CICS region. IRC must be open for your region to communicate with another CICS region using a multiregion operation (MRO) connection, or for a non-CICS client region to use your CICS over an external CICS interface (EXCI) connection.

Support for this type of communication must be specified at CICS startup (in the ISC initialization option), and at least one CONNECTION resource must be defined with an ACCESSMETHOD value indicating MRO; otherwise exception conditions occur when you attempt to open IRC. The CICS Intercommunication Guide describes the various requirements.

Options

OPENSTATUS(cvda)

specifies whether IRC communications should be started (open) or stopped (closed), and if CICS needs to stop IRC, whether tasks using MRO should be allowed to complete first. CVDA values are:

CLOSED

IRC is to be stopped. If it is currently open, CICS is to quiesce all MRO activity and then close IRC. Tasks using CICS-to-CICS MRO sessions and EXCI sessions are allowed to complete before closure, but new tasks requiring IRC are not begun.

IMMCLOSE

IRC is to be stopped. If currently open, CICS is to terminate abnormally any tasks using IRC immediately and then close IRC.

OPEN

IRC is to be started. If currently closed, CICS is to open it.

Conditions

INVREQ

RESP2 values:

1

A program required for IRC, DFHCRSP, is unavailable.

2

OPENSTATUS has an invalid CVDA value.

4

CICS was initialized without IRC support (ISC=NO).

5

No connection has been defined.

6

The z/OS® Communications Server APPLID for this CICS is blanks; IRC requires a non-blank APPLID.

7

Another CICS using IRC has the same z/OS Communications Server APPLID as this one; unique names are required.

8

IRC rejected the open of this CICS because it had already reached the maximum number of logons.

18

IRC support (the DFHIRP module) is below the level required by this CICS system.

IOERR

RESP2 values:

12

IRC initialization failed.

13

The log on to IRC failed.

14

An attempt to attach the node error transaction, CSNC, failed.

15

An error occurred closing IRC.

NOSTG

RESP2 values:

9

CICS storage is insufficient for the request.

10

MVS™ storage is insufficient (SVC block request rejected).

11

MVS storage is insufficient (SUBSYS block request rejected).

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.