Naming Your Dynamic Routing Program; Testing Your Dynamic Routing Program - IBM SC34-6814-04 Customization Manual

DYRUSERN
DYRVER

Naming your dynamic routing program

The supplied, user-replaceable dynamic routing program is named DFHDYP. If you
write your own version, you can name it differently.
After the system has been loaded, to find the name of the dynamic routing program
currently identified to CICS, use the EXEC CICS INQUIRE SYSTEM command.
Field DTRPROGRAM contains the name of the current program.
The default is DFHDYP.
To change the current program:
v Use the DTRPGM system initialization parameter. For more guidance information
v Make the change online using the EXEC CICS SET SYSTEM DTRPROGRAM
Note: A sample definition is provided for DFHDYP, but you must install a new

Testing your dynamic routing program

You can use the CICS execution diagnostic facility (EDF) to test your dynamic
routing program. To do so, you must name your program something other than
DFHDYP, because you cannot use EDF for programs that begin with "DFH". For
details of how to use EDF, see Execution diagnostic facility (EDF), in the CICS
Application Programming Guide.
You can use EDF in either single- or dual-terminal mode. If you choose
single-terminal mode, EDF displays screens for both the dynamic routing program
and the application program that is invoked by the routed transaction. The screens
relate to:
v The initial invocation of the dynamic routing program for route selection or
v The invocation of the dynamic routing programm if an error occurs in route
v The invocation of the application program
v The termination of the task
v The invocation of the dynamic routing program at termination of the routed
is a 1024-byte user area.
CICS initializes this user area to zeroes before invoking the dynamic routing
program for a given task. This user area can be modified by the dynamic
routing program; the modified area is passed to subsequent invocations of the
dynamic routing program for the same request.
is the version number of the dynamic routing program interface. For CICS
Transaction Server for z/OS, Version 3 Release 2, the number is "10".
about how to do this, refer to the CICS System Definition Guide.
command. For programming information about this command, refer to the CICS
System Programming Reference.
resource definition for a customized dynamic routing program.
notification (DYRFUNC=0 or DYRFUNC=3)
selection (DYRFUNC=1)
transaction or link request (DYRFUNC=2), if you have specified DYROPTER=Y
Chapter 17. Writing a dynamic routing program
621