SET IRC
Open or close interregion communication.
Conditions: INVREQ, IOERR, NOSTG, NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
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.