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:
When you enable CICS ONC RPC, options to control its operation come into play, and 4-tuples can be registered.
The changes you make during an operator-assisted enable can be temporary, lasting only until the next time you disable CICS ONC RPC, or you can store them into the CICS ONC RPC data set, and use them the next time you enable CICS ONC RPC.
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.
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.)
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.
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.
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).
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, 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.