There are changes affecting the following user-replaceable programs:
A new abend code, AIID, may be returned in the DYRABCDE field of the communications area passed to the distributed routing program, DFHDSRP, if the routing program is invoked for transaction abend. (Note that this invocation occurs on the target region, and then only if the routing program has specified, on a previous call on the routing region, that it should be re-invoked, on the target region, for transaction initiation, termination, and abend.)
AIID indicates to the distributed routing program that a routed method request for an enterprise bean or CORBA stateless object has failed, on the target region, because the target CorbaServer on the target region is disabled.
After a routing error, the routing program has better information on which to base a decision whether or not to remove an AOR from its routing set. For example:
For detailed information about how to code a distributed routing program to deal with a disabled CorbaServer, see the CICS® Customization Guide.
The sample IIOP security program, DFHXOPUS, has been changed to handle GIOP 1.2 request headers. The actions taken by the sample program have not changed. However, versions of GIOP from 1.2 onwards do not support the IIOP Principal field in request headers. In some circumstances (where SSL(YES) or SSL(NO) is specified on the TCPIPSERVICE definition and there is no RACF® user ID associated with the SSL client certificate), DFHXOPUS uses the first eight characters of the IIOP Principal, if there is one, to derive the user ID that it returns. For GIOP 1.2 requests, the IIOP Principal is not present and so DFHXOPUS will never return it as the user ID.
There is a new DFHCNV macro parameter operand.
The new operand SYSDEF has been added to the TYPE=INITIAL and TYPE=ENTRY macro parameters CLINTCP and SRVERCP. These macros define the user-replaceable data conversion table DFHCNV. The DFHCNV TYPE=INITIAL macro defines the beginning of the conversion table. It gives a list of valid code pages. The DFHCNV TYPE=ENTRY macro specifies a name and type to uniquely identify a data resource. There must be one for each resource for which conversion is required.
For information about the format of the changed parameters, see the CICS Family: Communicating from CICS on System/390® Guide.
[[ Contents Previous Page | Next Page Index ]]