Changing the target CICS region
The dynamic routing program can change the target CICS® region by modifying the system identifier (sysid) and netname of the default CICS region to which the transaction is to be routed.
The communications area passed to the dynamic routing program initially contains the system identifier (sysid) and netname of the default CICS region to which the transaction is to be routed. These are derived from the value of the REMOTESYSTEM option of the installed transaction definition. If the transaction definition does not specify a REMOTESYSTEM value, the sysid and netname passed are those of the local CICS region.
- The NETNAME and the SYSID are not changed.
CICS tries to route to the SYSID as originally specified in the communications area.
- The NETNAME is not changed, but the SYSID is changed.
CICS updates the communications area with the NETNAME corresponding to the new SYSID, and tries to route to the new SYSID.
- The NETNAME is changed, but the SYSID is not changed.
CICS updates the communications area with a SYSID corresponding to the new NETNAME, and tries to route to the new SYSID.
- The NETNAME is changed and the SYSID is changed.
CICS overwrites the communications area with a SYSID corresponding to the new NETNAME, and tries to route to that new SYSID.
If the NETNAME specified is invalid, or cannot be found, SYSIDERR is returned to the dynamic routing program, which may deal with the error by returning a different SYSID or NETNAME. See If the system is unavailable or unknown.
If the routing program changes the SYSID or NETNAME when it is invoked for notification, the changes have no effect.