If you select option 2 on panel DFHRP01, or option 2 on panel DFHRP04, panel DFHRP20 is shown. (See Figure 51.)
CRPC CICS ONC RPC for MVS/ESA DFHRP20 Update CICS ONC RPC Data set Select one of the following. Then press Enter. _ 1. View or modify the CICS ONC RPC definition record 2. Display a list of remote procedure definitions 3. Define 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: SYSID= CI41 APPLID= IYK1ZFL1 PF1=Help PF3=Exit PF9=Messages PF12=Return
The Current Status field in this panel might show Enabled or Disabled, depending on which panel you came from.
Before selecting option 4, you must supply the following information:
Select an option, then press Enter.
If you specify a 4-tuple which is not defined in the CICS® ONC RPC data set, a message is issued when you press Enter, and panel DFHRP20 remains on the screen.
If you select option 1 on panel DFHRP20, panel DFHRP22 is shown. (See Figure 52.)
CRPC CICS ONC RPC for MVS/ESA DFHRP22 Update CICS ONC RPC Definition Record 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: SYSID= CI41 APPLID= IYK1ZFL1 PF1=Help PF3=Exit PF9=Messages PF12=Return
The values displayed in the Choice column are those stored in the CICS ONC RPC data set.
After you have made your changes you should press Enter to get them validated. You can then press Enter again to update the CICS ONC RPC data set with the values you have supplied. The next time you start the connection manager, the saved options are used to set up panel DFHRP02
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 save the values to the CICS ONC RPC data set, this value will be effective the next time you enable, unless you override it. The value of this field in the CICS ONC RPC data set may be overridden by the fast path command CRPC E A(N).
If you select option 2 on panel DFHRP03, or option 2 on panel DFHRP20, panel DFHRP14 is shown. (See Figure 53.)
CRPC CICS ONC RPC for MVS/ESA DFHRP14 Remote Procedure Definition List Enter a command (press PF1 to view the list of valid commands). _ Prog( 20000002 ) Vers( 00000001 ) Proc( 00000006 ) Prot( UDP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 00000007 ) Prot( TCP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 00000007 ) Prot( UDP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 00000008 ) Prot( TCP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 00000009 ) Prot( UDP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 0000000A ) Prot( TCP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 0000000B ) Prot( TCP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 0000000B ) Prot( UDP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 0000000C ) Prot( TCP ) _ Prog( 20000002 ) Vers( 00000001 ) Proc( 0000000C ) Prot( UDP ) _ Prog( ________ ) Vers( ________ ) Proc( ________ ) Prot( ___ ) _ Prog( ________ ) Vers( ________ ) Proc( ________ ) Prot( ___ ) _ Prog( ________ ) Vers( ________ ) Proc( ________ ) Prot( ___ ) _ Prog( ________ ) Vers( ________ ) Proc( ________ ) Prot( ___ ) _ Prog( ________ ) Vers( ________ ) Proc( ________ ) Prot( ___ ) _ Prog( ________ ) Vers( ________ ) Proc( ________ ) Prot( ___ ) Current Status: SYSID= CI41 APPLID= IYK1ZFL1 PF1=Help PF2=Refresh PF3=Exit PF7=Back PF8=Forward PF9=Messages PF12=Return
This panel presents a list of 4-tuples currently defined in the CICS ONC RPC data set. If CICS ONC RPC is enabled, the 4-tuples that are currently registered are shown highlighted. You can put a command against a 4-tuple, and it takes effect when you press Enter. The following commands can be entered against a 4-tuple:
CRPC CICS ONC RPC for MVS/ESA DFHRP15 Display Registered Procedure Program Number( 20000002 ) Version Number( 00000001 ) Procedure Number( 00000006 ) Protocol( UDP ) RPC Call Type( Blocking ) Inbound XDR( XDR_WRAPSTRING ) Outbound XDR( XDR_WRAPSTRING ) Alias Transid( CRPA ) Alias Termid( ) Server Program Name( STRING6 ) Converter Program Name( RINGCVNY ) Getlengths( NO ) Decode( YES ) Encode( NO ) Server Input Length( 00000 ) Server Output Length( 00000 ) Server Data Format( CONTIGUOUS ) Register from Data set( Yes ) Current Status: SYSID= CI41 APPLID= IYK1ZFL1 PF1=Help PF3=Exit PF12=Return
If you select option 3 or 4 on panel DFHRP20, or if you enter the M command on panel DFHRP14, panel DFHRP21 is shown. (See Figure 55.)
The attributes of a 4-tuple are divided into three categories:
CRPC CICS ONC RPC for MVS/ESA Remote Procedure Definition DFHRP21 Overtype to Modify. Then press Enter to Validate ONC RPC ATTRIBUTES ONC RPC Program Number ===> ________ 0-FFFFFFFF ONC RPC Version Number ===> ________ 0-FFFFFFFF ONC RPC Procedure Number ===> ________ 1-FFFFFFFF Protocol ===> UDP Udp | Tcp RPC Call Type ===> BLOCKING Blocking | Nonblocking Inbound XDR Routine ===> ______________ Outbound XDR Routine ===> ______________ CICS ATTRIBUTES ALIAS Transaction ID ===> CRPA EDF Terminal ID ===> ____ + Program Name ===> ________ Current Status: SYSID= CI41 APPLID= IYK1ZFL1 PF1=Help PF2=Delete PF3=Exit PF8=Forward PF9=Messages PF12=Return
CRPC CICS ONC RPC for MVS/ESA Remote Procedure Registration DFHRP2B Overtype to Modify. Then press Enter to Validate + CICS ONC RPC ATTRIBUTES Converter Program Name ===> ________ Encode ===> NO Yes | No Decode ===> YES Yes | No Getlengths ===> YES Yes | No Server Input Length ===> _____ 0 - 32767 Bytes Server Output Length ===> _____ 0 - 32767 Bytes Server Data Format ===> CONTIGUOUS Contiguous | Overlaid Register from Data set ===> YES Yes | No Current Status: SYSID= CI41 APPLID= IYK1ZFL1 PF1=Help PF2=Delete PF3=Exit PF7=Back PF9=Messages PF12=Return
You can use these panels to delete a 4-tuple definition from the CICS ONC RPC data set by pressing PF2.
If you wish to modify the 4-tuple definition, you should first make modifications to panel DFHRP21, and then press PF8 to move to panel DFHRP2B. From panel DFHRP2B you can press PF7 if you wish to go back to panel DFHRP21. After you have made your modifications to the panels, you should press Enter to get all the modifications validated, and then press Enter again to get the definition changed.