CICS ONC RPC attributes
- Converter Program Name
- Specifies the name of the converter program. This name must be specified.
- Encode
- YES (Y) means that CICS® ONC RPC must call the Encode function of the converter when servicing a client request for this 4-tuple; NO (N) means that it must not. The default is NO.
- Decode
- YES (Y) means that CICS ONC RPC must call the Decode function of the converter when servicing a client request for this 4-tuple; NO (N) means that it must not. The default is YES.
- Getlengths
- YES (Y) means that the connection manager must call the Getlengths function of the converter before registering this 4-tuple. NO (N) means that it must not. If you specify YES here, you should ignore the next two attributes, but you can set Server Data Format. If you specify NO here, you must specify the next three attributes. The default is YES.
- Server Input Length
- For the use of this option, see the description of Server Data Format.
If you specified YES for the Getlengths option, leave this field blank.
- Server Output Length
- For the use of this option, see the description of Server Data Format.
If you specified YES for the Getlengths option, leave this field blank.
- Server Data Format
- A value that controls:
- How the input data pointer for Encode will be set up
- How the communication area length to be checked by the connection manager is calculated
The values you can specify are as follows:- CONTIGUOUS
- The value of the data pointer that will be passed to Encode, or to the outbound XDR routine if Encode is
not used for this 4-tuple, is the address of the CICS program communication area plus the value
of Server Input Length, though Decode can modify this
offset.
The connection manager calculates a communication area length by adding the values of Server Input Length and Server Output Length. If this length exceeds 32␠767 bytes, message DFHRP1965 is issued. If this length is different from the actual length of the communication area passed from Decode to the CICS program, errors might occur in the processing of client requests.
- OVERLAID
- The value of the data pointer that will be passed to Encode, or to the outbound XDR routine if Encode is
not used for this 4-tuple, is the address of the CICS program communication area.
The connection manager calculates a communication area length by taking the larger of the output values of Server Input Length and Server Output Length. If this length is different from the actual length of the communication area passed to the CICS program, errors might occur in the processing of client requests.
If you specified YES for the Getlengths option, the value in this field is used as an input to the Getlengths function of the converter.
- Register from Data Set
- YES (Y) means
that the 4-tuple is to be registered:
- During automatic enable processing
- When option 1 is selected on panel DFHRP03, as described in Registering the 4-tuples