The Sample Autoinstall Control Program For Programs, Dfhpgadx; Customizing The Sample Program - IBM SC34-6814-04 Customization Manual

PGAC_JVM
PGAC_JVM_CLASS_LEN
PGAC_JVM_CLASS_DATA
PGAC_JVM_PROFID
PGAC_RETURN_CODE

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 CICSTS32.CICS
libraries in which they can be found, are summarized in Table 31.

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.
586
Customization Guide
shared resources it takes into account the possibility that other
programs may be executing concurrently and attempting to modify the
same resources.
allows you to specify, in a 1-byte field, whether the program is to be run under a
JVM. The equated values are:
PGAC_JVM_YES
The program is a Java bytecode program and must run under the
control of a JVM.
PGAC_JVM_NO
The program does not require a JVM for its execution.
allows you to specify, as a two-byte binary value, the length of the Java class
name supplied in PGAC_JVM_CLASS_DATA.
allows you to specify, as a 256-byte field, the name of the Java class to be
invoked.
allows you to specify, in an 8-byte field, the name of the JVM profile to be used
for the JVM in which the program is to run.
allows you to specify, in a 1-byte field, the autoinstall control program's return
code to CICS. The equated values are:
PGAC_RETURN_OK
Install the program definition using the values returned in the
communications area parameter list.
PGAC_RETURN_DONT_DEFINE_PROGRAM
Do not define the program.
Table 31. Sample programs and copy books for program autoinstall
Language
Executable file: Assembler
only
Program source: Assembler
COBOL PL/I C
Copy books: Assembler
COBOL PL/I C
Member name
DFHPGADX
DFHPGADX DFHPGAOX
DFHPGALX DFHPGAHX
DFHPGACD DFHPGACO
DFHPGACL DFHPGACH
Library
SDFHLOAD
SDFHSAMP SDFHSAMP
SDFHSAMP SDFHSAMP
SDFHMAC SDFHCOB
SDFHPL1 SDFHC370