Distributed Transaction Routing Sample Programs - IBM SC34-6814-04 Customization Manual

Note: A sample definition is provided for DFHDSRP, but you must install a new

Distributed transaction routing sample programs

The CICS-supplied sample distributed routing program is named DFHDSRP. The
corresponding copy book that defines the communications area is DFHDYPDS.
There are assembler-language, COBOL, PL/I, and C source-level samples and
copy books. The supplied programs and copy books, and the CICSTS32.CICS
libraries in which they can be found, are summarized in Table 33.
You can write your own distributed routing program in COBOL, PL/I, C, or
assembler language, and you can change the name of the program.
When invoked with DYRFUNC set to '0', the sample programs accept the sysid that
is passed in field DYRSYSID of the communications area, and set DYRRETC to '0'
before returning to CICS. When invoked with DYRFUNC set to '2', '3', '5', or '6',
they set a return code of '0'. When invoked with DYRFUNC set to '1' or '4', they set
a return code of '8'.
If you want to route requests dynamically, you must customize DFHDSRP, or
replace it completely with your own routing program.
resource definition for a customized distributed routing program.
Table 33. Distributed routing programs and copy books
Language
Programs: Assembler
COBOL PL/I C
Copy books: Assembler
COBOL PL/I C
Member name
DFHDSRP DFHDSRP
DFHDSRP DFHDSRP
DFHDYPDS DFHDYPDS
DFHDYPDS DFHDYPDS
Chapter 18. Writing a distributed routing program
Library
SDFHSAMP SDFHCOB
SDFHPL1 SDFHC370
SDFHMAC SDFHCOB
SDFHPL1 SDFHC370
657