Disabling CICS ONC RPC

Stabilized feature: CICS® support for Open Network Computing Remote Procedure Call (ONC RPC) is stabilized. Consider exposing and orchestrating applications as API services by using z/OS Connect Enterprise Edition or CICS web services, or by writing web applications in Java or Node.js. See also Stabilization notices and discontinued functions.

There are two ways of disabling CICS ONC RPC: normal, and immediate.

From panel DFHRP04, select option 1; panel DFHRP06 is shown.

Figure 1. Panel DFHRP06
CRPC                    CICS ONC RPC for MVS/ESA Disable                DFHRP06
 
Select the type of disable required. Then press Enter.
 
 
   Type of Disable  ===>  _________    Normal | Immediate
 
 
 
 
 
 
 
 
 
 
 
 
 
Current Status: Enabled
 
 
                                                  SYSID= CI41  APPLID=  IYK1ZFL1
PF1=Help   PF3=Exit   PF9=Messages   PF12=Return
In this panel there is only one field to enter.
Type of Disable
NORMAL (N)
Normal disable processing is started.
  • All program-version pairs are unregistered from z/OS® Communications Server.
  • All work that has already entered CICS ONC RPC is allowed to run to completion, and replies are sent to the relevant client.
IMMEDIATE (I)
Immediate disable processing is started.
  • Aliases not yet started do not start at all.
  • CICS programs running under aliases are allowed to end, and then the alias abends. If the CICS program ends normally, and was called using DPL, the changes it makes to recoverable resources are committed. If the CICS program is a local program, the changes it makes to recoverable resources are backed out unless the CICS program takes a sync point with EXEC CICS SYNCPOINT.
  • All the program-version pairs are unregistered from z/OS Communications Server.
  • No replies are sent to clients, so they do not know whether the CICS program has run or not.

Pressing Enter causes the entry you have made to be validated. Pressing Enter a second time begins disable processing. The Current Status is changed to Disabling or Disabled, depending on the progress of disable processing. When disable processing is complete, pressing Enter changes the Current Status to Disabled.

The panel is displayed until you use PF3 or PF12.

What happens on CICS normal shutdown

CICS normal shutdown starts normal disable processing for CICS ONC RPC.

What happens on CICS immediate shutdown

On CICS immediate shutdown, all transactions are terminated. Clients are not informed of the shutdown or its effects. The program-version-protocol 3-tuples that are registered with z/OS Communications Server might remain registered.