CONTROL BLOCK NAME = DFHPGACC
DESCRIPTIVE NAME = CICS/ESA (PG) Program Manager Autoinstall
exit program parameter list
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1993, 2012
FUNCTION = Defines the commarea passed by the Program Manager
autoinstall function to the autoinstall exit program.
The PGAC control block belongs to the Program Manager (PG)
domain. The control block is used to pass the name of the
program and the module type to the exit program and enables
the user to return information for the program to be
autoinstalled. Storage for the control block is obtained
by the autoinstall function (DFHPGAI).
LIFETIME =
The control block is created when the autoinstall function
(DFHPGAI) is called. The storage is released on return
from the autoinstall function.
STORAGE CLASS =
The control block uses the automatic storage for DFHPGAI.
This storage is above the line.
LOCATION =
In the automatic storage for DFHPGAI at the label PGAC.
The address and length of the control block are passed
to the program autoinstall exit program via the commarea.
NOTES :
This control block is provided as a sample and is not to be
used as a general programming interface. Refer to the
CICS/ESA Customisation Guide to determine its intended
usage.
Matching assembler control block is DFHPGACD
Matching PL/I control block is DFHPGACL
Matching COBOL control block is DFHPGACO
Matching C control block is DFHPGACH
The control block includes the following fields:
Input fields:
PGAC_PROGRAM - name of program to be autoinstalled
PGAC_MODULE_TYPE - program, mapset or partitionset
Output fields:
PGAC_MODEL_NAME - autoinstall model program name
PGAC_LANGUAGE - assembler, cobol, C370, LE370, PL/I
PGAC_CEDF_STATUS - cedf status, yes or no
PGAC_DATA_LOCATION - data location, below or any
PGAC_EXECUTION_KEY - execution key, CICS or user
PGAC_LOAD_ATTRIBUTE - reload, transient, resident, reusable
PGAC_USE_LPA_COPY - use LPA copy, yes or no
PGAC_EXECUTION_SET - use DPL subset or full API
PGAC_REMOTE_SYSID - remote system ID
PGAC_REMOTE_PROGID - remote program name
PGAC_REMOTE_TRANSID - remote transaction ID
PGAC_DYNAMIC_STATUS - DPL dynamic or not dynamic
PGAC_CONCURRENCY - QUASIRENT or THREADSAFE or REQUIRED
PGAC_API - CICSAPI or OPENAPI
PGAC_JVM - the program is to be run under the JVM
PGAC_JVM_CLASS_LENGTH - length of JVM class name data
PGAC_JVM_CLASS_DATA - allows you to specify, as a 256-byte
field, the name of the OSGi service
or Java class to be invoked @R36025C
PGAC_JVM_JVMSERV - the JVMSERVER resource @R36025C
PGAC_RETURN_CODE - OK, or don't define the program
The return fields are initialized to blank on entry to the
autoinstall exit program.
DEPENDENCIES = S/390
RESTRICTIONS = None
MODULE TYPE = Control block definition
------------------------------------------------------------------
EXTERNAL REFERENCES = None
DATA AREAS = No fields in the operating system data areas
are referenced.
CONTROL BLOCKS = No reference to other control blocks.
------------------------------------------------------------------
Table 1.
| Offset Hex |
Type |
Len |
Name (Dim) |
Description |
| (0) |
STRUCTURE |
312 |
PGAC |
| (0) |
CHARACTER |
8 |
PGAC_PROGRAM |
| (8) |
CHARACTER |
1 |
PGAC_MODULE_TYPE |
| (9) |
CHARACTER |
34 |
PGAC_RETURN_ INFORMATION |
| (9) |
CHARACTER |
8 |
PGAC_MODEL_NAME |
| (11) |
CHARACTER |
1 |
PGAC_LANGUAGE |
| (12) |
CHARACTER |
1 |
PGAC_CEDF_STATUS |
| (13) |
CHARACTER |
1 |
PGAC_DATA_LOCATION |
| (14) |
CHARACTER |
1 |
PGAC_EXECUTION_KEY |
| (15) |
CHARACTER |
1 |
PGAC_LOAD_ATTRIBUTE |
| (16) |
CHARACTER |
1 |
PGAC_USE_LPA_COPY |
| (17) |
CHARACTER |
1 |
PGAC_EXECUTION_SET |
| (18) |
CHARACTER |
4 |
PGAC_REMOTE_SYSID |
| (1C) |
CHARACTER |
8 |
PGAC_REMOTE_PROGID |
| (24) |
CHARACTER |
4 |
PGAC_REMOTE_TRANSID |
| (28) |
CHARACTER |
1 |
PGAC_RETURN_CODE |
| (29) |
CHARACTER |
1 |
PGAC_DYNAMIC_STATUS |
| (2A) |
CHARACTER |
1 |
PGAC_CONCURRENCY |
Java return information
|
| (2B) |
CHARACTER |
1 |
PGAC_JVM |
| (2C) |
HALFWORD |
2 |
PGAC_JVM_CLASS_LEN |
| (2E) |
CHARACTER |
256 |
PGAC_JVM_CLASS_DATA |
| (12E) |
CHARACTER |
1 |
* |
reserved |
| (12F) |
CHARACTER |
8 |
PGAC_JVM_JVMSERV |
| (137) |
CHARACTER |
1 |
PGAC_RETURN_ INFORMATION2 |
| (137) |
CHARACTER |
1 |
PGAC_API |
Table 2.
| Len |
Type |
Value |
Name |
Description |
Constants for module type.
|
| 1 |
CHARACTER |
1 |
PGAC_TYPE_PROGRAM |
| 1 |
CHARACTER |
2 |
PGAC_TYPE_MAPSET |
| 1 |
CHARACTER |
3 |
PGAC_TYPE_PARTITIONSET |
Constants for language.
|
| 1 |
CHARACTER |
1 |
PGAC_ASSEMBLER |
| 1 |
CHARACTER |
2 |
PGAC_COBOL |
| 1 |
CHARACTER |
3 |
PGAC_PLI |
| 1 |
CHARACTER |
4 |
PGAC_C370 |
| 1 |
CHARACTER |
5 |
PGAC_LE370 |
Constants for CEDF status.
|
| 1 |
CHARACTER |
1 |
PGAC_CEDF_YES |
| 1 |
CHARACTER |
2 |
PGAC_CEDF_NO |
Constants for data location.
|
| 1 |
CHARACTER |
1 |
PGAC_LOCATION_BELOW |
| 1 |
CHARACTER |
2 |
PGAC_LOCATION_ANY |
Constants for execution key.
|
| 1 |
CHARACTER |
1 |
PGAC_CICS_KEY |
| 1 |
CHARACTER |
2 |
PGAC_USER_KEY |
Constants for load attribute.
|
| 1 |
CHARACTER |
1 |
PGAC_RELOAD |
| 1 |
CHARACTER |
2 |
PGAC_RESIDENT |
| 1 |
CHARACTER |
3 |
PGAC_TRANSIENT |
| 1 |
CHARACTER |
4 |
PGAC_REUSABLE |
Constants for LPA status.
|
| 1 |
CHARACTER |
1 |
PGAC_LPA_YES |
| 1 |
CHARACTER |
2 |
PGAC_LPA_NO |
Constants for execution set.
|
| 1 |
CHARACTER |
1 |
PGAC_DPLSUBSET |
| 1 |
CHARACTER |
2 |
PGAC_FULLAPI |
Constants for DYNAMIC status.
|
| 1 |
CHARACTER |
1 |
PGAC_DYNAMIC_YES |
| 1 |
CHARACTER |
2 |
PGAC_DYNAMIC_NO |
Constants for CONCURRENCY
|
| 1 |
CHARACTER |
1 |
PGAC_QUASIRENT |
| 1 |
CHARACTER |
2 |
PGAC_THREADSAFE |
| 1 |
CHARACTER |
3 |
PGAC_REQUIRED |
Constants for API
|
| 1 |
CHARACTER |
1 |
PGAC_CICSAPI |
| 1 |
CHARACTER |
2 |
PGAC_OPENAPI |
Constants for JVM
|
| 1 |
CHARACTER |
1 |
PGAC_JVM_YES |
| 1 |
CHARACTER |
2 |
PGAC_JVM_NO |
Constants for the return code.
|
| 1 |
CHARACTER |
1 |
PGAC_RETURN_OK |
| 1 |
CHARACTER |
2 |
PGAC_RETURN_DONT_ DEFINE_PROGRAM |