Defining, saving, modifying, and deleting 4-tuples

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.

The first panel for defining, saving, modifying, and deleting 4-tuples is DFHRP03. This panel is shown as soon as you have enabled CICS ONC RPC, or if you choose option 2 on panel DFHRP10.

Figure 1. Panel DFHRP03
CRPC                        CICS ONC RPC for MVS/ESA                   DFHRP03
                          Remote Procedure Registration
 
Select one of the following. Then press Enter.
 
_  1. Register procedures from the data set
   2. List procedures sequentially
   3. Register a new procedure
   4. Retrieve a specified procedure from the data set (Enter required data)
           Program Number      ===> ________   0-FFFFFFFF
           Version Number      ===> ________   0-FFFFFFFF
           Procedure Number    ===> ________   1-FFFFFFFF
           Protocol            ===> UDP        Udp | Tcp
 
 
 
 
 
 
Current Status: Enabled
 
 
                                                  SYSID= CI41  APPLID= IYK1ZFL1
PF1=Help   PF3=Exit   PF9=Messages   PF12=Return
 
Table 1. Options in Panel DFHRP03
Option Description
1 If you select option 1, the 4-tuples in the CICS ONC RPC data set that have YES for their Register from Data Set attribute are all registered.

If you specify a 4-tuple for which there is no definition in the CICS ONC RPC data set, a message is issued when you press Enter, and panel DFHRP03 remains on the screen.

2 See Defining the attributes of a 4-tuple.
3 See Unregistering 4-tuples.
4 Use this option to modify existing 4-tuple definitions.

Modifying existing 4-tuple definitions

To change some of the attributes of a 4-tuple that already has a definition in the CICS ONC RPC data set, select option 4 on panel DFHRP03 or panel DFHRP20.

Deleting existing 4-tuple definitions

You can delete existing 4-tuple definitions from the CICS ONC RPC data set in two ways:
  • On panel DFHRP03, select option 2. Then on panel DFHRP14 you can enter D against 4-tuples in the list, and they are deleted from the data set when you press Enter.
  • On panel DFHRP21, by using key PF2, as described in Changing the attributes of a 4-tuple.