IBM SC33-1683-02 Server User Manual


 
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
about how to do this, refer to the
CICS System Definition Guide
.
v Make the change online using the EXEC CICS SET SYSTEM DTRPROGRAM
command. For programming information about this command, refer to the
CICS
System Programming Reference
manual.
Note: A sample definition is provided for DFHDYP, but you must install a new
resource definition for a customized dynamic routing program.
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 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
notification (DYRFUNC=0 or DYRFUNC=3)
v The invocation of the dynamic routing programm if an error occurs in route
selection (DYRFUNC=1)
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
transaction or link request (DYRFUNC=2), if you have specified DYROPTER=Y
v The invocation of the dynamic routing program if the routed transaction abends
(DYRFUNC=4), if you have specified DYROPTER=Y.
If you want EDF to display the execution of your dynamic routing program only,
either choose dual-terminal mode, or use one of the other methods described in the
CICS Application Programming Guide
.
naming your dynamic routing program
Chapter 16. Writing a dynamic routing program 573
|
|
|
|