Updating the CICS ONC RPC data set

If you select option 2 on panel DFHRP01, or option 2 on panel DFHRP04, panel DFHRP20 is shown. (See Figure 51.)

Figure 51. Panel DFHRP20
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:

Program Number
The program number of the 4-tuple whose definition is to be retrieved.
Version Number
The version number of the 4-tuple whose definition is to be retrieved.
Procedure Number
The procedure number of the 4-tuple whose definition is to be retrieved.
Protocol
The protocol of the 4-tuple whose definition is to be retrieved.

Select an option, then press Enter.

Option
For more information see:
1
Updating the CICS ONC RPC definition record
2
Working with a list of 4-tuples
3
Changing the attributes of a 4-tuple
4
Changing the attributes of a 4-tuple

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.

Updating the CICS ONC RPC definition record

If you select option 1 on panel DFHRP20, panel DFHRP22 is shown. (See Figure 52.)

Figure 52. Panel DFHRP22
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

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, 2 means that both level 1 and level 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 operate. 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 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).

Working with a list of 4-tuples

If you select option 2 on panel DFHRP03, or option 2 on panel DFHRP20, panel DFHRP14 is shown. (See Figure 53.)

Figure 53. Panel DFHRP14
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:

D
Deletes the definition from the data set.
R
If CICS ONC RPC is enabled, registers the 4-tuple with CICS ONC RPC. If CICS ONC RPC is disabled, this command produces an error message.
M
Shows panel DFHRP21. See Changing the attributes of a 4-tuple for details.
?
Shows panel DFHRP15, which displays the attributes of a 4-tuple, but does not allow changes.
Figure 54. Panel DFHRP15
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
 

Changing the attributes of a 4-tuple

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:

Figure 55. Panels DFHRP21 and DFHRP2B
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.

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