Defining CICS ONC RPC resources to CICS

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.

CICS ONC RPC provides two RDO groups for defining CICS resources used by CICS ONC RPC. The groups are DFHRP and DFHRPF.

Transaction definitions for CICS ONC RPC transactions

These CICS ONC RPC transactions are defined in the locked group DFHRP:
  • CRPA Alias
  • CRPC Connection manager
  • CRPM Server controller

These definitions cannot be changed.

Program definitions for CICS ONC RPC programs

All the CICS ONC RPC programs are defined in the locked group DFHRP.

Mapset definition

Mapset definitions are supplied in the group DFHRP for the connection manager mapsets. The definitions cannot be changed.

Transient data definitions

CICS provides a resource definition for the CICS ONC RPC message transient data queue CRPO. The resource definition is in group DFHDCTG, which is part of DFHLIST.

Group DFHDCTG is not protected by a lock, so the definitions it contains can be modified if required. CRPO is defined as an extrapartition queue, but you can make the destination intrapartition or indirect if you prefer.

If you leave CRPO defined as an extrapartition queue, you must add a suitable DD statement for the extrapartition queue in the CICS JCL. For example:
//CRPO   DD   SYSOUT=A

XLT definitions

The XLT system initialization parameter and its associated transaction list should allow the connection manager, CRPC, to be started during normal CICS shutdown. If CICS ONC RPC is delaying shutdown, the connection manager can be used to force an immediate disable of CICS ONC RPC.