Enabling CICS ONC RPC

When CICS® ONC RPC is disabled, the connection manager allows you to:

You can use the connection manager to enable CICS ONC RPC in two ways:

The CICS ONC RPC data set is a store of operating environment information. It contains two kinds of records: the CICS ONC RPC definition record contains the operating options, and 4-tuple records contain the 4-tuple information.

Setting and modifying options

If you start the connection manager when CICS ONC RPC is disabled, and select option 1 on panel DFHRP01, panel DFHRP02 is shown. (See Figure 44.)

Figure 44. Panel DFHRP02
CRPC                     CICS ONC RPC for MVS/ESA Enable               DFHRP02
 
Overtype to Modify
                                  Choice       Possible Options
 
Trace                       ===>   STARTED     STArted | STOpped
 
Trace Level                 ===>   1           1 | 2
 
Resource Checker            ===>   NO          Yes | No
 
CRPM Userid                 ===>   CICSUSER
 
Automatic Enable            ===>   NO          Yes | No
 
 
 
 
 
Current Status: Disabled
 
 
                                                  SYSID= CI41  APPLID= IYK1ZFL1
PF1=Help   PF3=Exit   PF4=Save   PF9=Messages   PF12=Return
 

The values displayed in the Choice column are those stored in the CICS ONC RPC data set. The data set is initialized with the values shown in Figure 44, except that the value displayed for CRPM Userid is the default CICS user ID for the CICS system in which CICS ONC RPC is operating.

You can make entries in the fields listed below. Entries may be in lowercase or uppercase. Where entries to a field are restricted (for example, YES or NO) you can enter the whole option (YES) or the minimum (Y). In the panels, the minimum entry is shown in uppercase in the Possible Options column. In the reference material in this manual, the minimum entry is given in parentheses after the full entry.

Trace
Specifies whether CICS ONC RPC tracing is active. STARTED (STA) means it is active, STOPPED (STO) means it is not. The default value is STARTED.

CICS ONC RPC exception trace entries are always written to CICS internal trace whatever the setting of this option. To get non-exception trace entries written, CICS trace must be started, and this option must be set to STARTED.

Trace Level
Specifies the trace level for CICS ONC RPC. The value 1 means that level 1 trace points are traced, and 2 means that both level 1 and 2 are traced. The default value is 1.
Resource Checker
YES (Y) means that CICS ONC RPC is to call the user-written resource-checking module on receipt of every incoming RPC request. NO (N) means the resource checker is not to be called. The default is NO.
CRPM Userid
Specifies the CICS user ID under which the server controller is to run. The default is the default user ID for the CICS system in which CICS ONC RPC is operating.
Automatic Enable
Enter YES (Y) or NO (N). If YES is stored in the CICS ONC RPC data set, you can enable CICS ONC RPC by just typing CRPC; all values are defaulted from the CICS ONC RPC data set, CICS ONC RPC becomes enabled without further user input, and all the 4-tuples with YES for their Register from Data Set option are registered. The default value is NO.

Setting this field has an effect only when you enable CICS ONC RPC. If you use PF4 to save the values to the CICS ONC RPC data set, this value will be effective the next time you enable, unless you override it. A YES in this field in the CICS ONC RPC data set may be overridden by the fast path command CRPC E A(N).

Validating, saving, and activating options

After you have made your changes on panel DFHRP02, press Enter to get them validated by the connection manager.

If you wish to save the new values in the CICS ONC RPC data set, press PF4.

If you press Enter a second time, CICS ONC RPC becomes enabled, and panel DFHRP03 is shown, as described in Defining, saving, modifying, and deleting 4-tuples.

When CICS ONC RPC is enabled

When CICS ONC RPC is enabled, the connection manager allows you to:

There are two ways of disabling CICS ONC RPC: normal, and immediate. The effects of disable processing are described in Disabling CICS ONC RPC.

Related concepts
ONC RPC concepts
Related tasks
Starting the connection manager
Updating CICS ONC RPC status
Defining, saving, modifying, and deleting 4-tuples
Registering the 4-tuples
Unregistering 4-tuples
Disabling CICS ONC RPC
Updating the CICS ONC RPC data set
Processing the alias list
[[ Contents Previous Page | Next Page Index ]]