Dynamic transaction routing sample programs – IBM SC33-1683-02 User Manual

Page 606

Advertising
background image

Dynamic transaction routing sample programs

The CICS-supplied sample dynamic routing program is named DFHDYP. 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 CICSTS13.CICS
libraries in which they can be found, are summarized in Table 28.

Table 28. Dynamic transaction routing programs and copy books

Language

Member name

Library

Programs:

Assembler
COBOL
PL/I
C/370

DFHDYP
DFHDYP
DFHDYP
DFHDYP

SDFHSAMP
SDFHCOB
SDFHPL1
SDFHC370

Copy books:

Assembler
COBOL
PL/I
C/370

DFHDYPDS
DFHDYPDS
DFHDYPDS
DFHDYPDS

SDFHMAC
SDFHCOB
SDFHPL1
SDFHC370

You can write your own dynamic routing program in VS COBOL II, 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 and
remote transaction name that are passed in fields DYRSYSID and DYRTRAN of the
communications area, and set DYRRETC to ‘0’ before returning to CICS. When
invoked with DYRFUNC set to ‘2’ or ‘3’, 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 transactions or DPL requests dynamically, you must customize
DFHDYP, replace it completely with your own routing program, or use
CICSPlex SM.

sample transaction routing programs

574

CICS TS for OS/390: CICS Customization Guide

|
|
|
|

|
|
|
|
|
|

|
|
|
|
|
|

|
|
|

Advertising