Customizing the sample program – IBM SC33-1683-02 User Manual

Page 578

Advertising
background image

named explicitly on the SYSID option of the EXEC CICS LINK
command, the routing program can route the request to the region on
which the program is to execute.

The sample autoinstall control program for programs, DFHPGADX

The CICS-supplied default autoinstall program is an assembler-language
command-level program, named DFHPGADX. The source of the default program is
provided in COBOL, PL/I, and C, as well as in assembler language. The names of
the supplied programs and their associated copy books, and the CICSTS13.CICS
libraries in which they can be found, are summarized in Table 27.

Table 27. Sample programs and copy books for program autoinstall

Language

Member name

Library

Executable file:

Assembler only

DFHPGADX

SDFHLOAD

Program source:

Assembler
COBOL
PL/I
C/370

DFHPGADX
DFHPGAOX
DFHPGALX
DFHPGAHX

SDFHSAMP
SDFHSAMP
SDFHSAMP
SDFHSAMP

Copy books:

Assembler
COBOL
PL/I
C/370

DFHPGACD
DFHPGACO
DFHPGACL
DFHPGACH

SDFHMAC
SDFHCOB
SDFHPL1
SDFHC370

Customizing the sample program

You can write your autoinstall control program in any of the languages supported by
CICS, with full access to the CICS application and system programming interfaces.

If you customize the supplied control program, or write your own version, you
should note the following:

v

Input:The first two fields of the parameter list are input-only fields and should not
be altered by your program.

v

Output:The remaining fields on the parameter list are input/output or output only
fields, which you can use to specify attributes that override those of the model
definition.

v

Some of the output fields in the parameter list are not applicable to mapsets or
partitionsets. CICS ignores any parameters you specify that are not applicable to
the type of object being installed.

v

Any attributes you return to CICS in the parameter list are used to modify the
model definition, and CICS installs the modified definition. Once installed, the
definition can be modified normally using the EXEC CICS SET PROGRAM or
CEMT SET PROGRAM commands.

v

If you modify your control program, you can make the new version available by
using the EXEC CICS SET PROGRAM NEWCOPY or CEMT SET PROGRAM
NEWCOPY command.

the autoinstall control program for programs

546

CICS TS for OS/390: CICS Customization Guide

|
|
|

|

Advertising