Changing the program name
When the routing program is invoked for route selection or for notification
of a program-link request, the DYRLPROG field in the communications area contains
the name of the program to be linked, obtained using the following sequence:
- From the REMOTENAME option of the installed program definition
- If REMOTENAME is not specified, or there is no program definition, from the PROGRAM option of the EXEC CICS LINK command.
When it is invoked for routing 1 (not for notification of a statically-routed request), your routing program can, by overwriting the DYRLPROG field, specify that an alternative program is to be linked. You can specify a local or remote program, depending on the region to which the request is to be routed.
1 By “invoked for routing” we
mean both “invoked for route selection” and “invoked because an
error occurred in route selection”.