Program manager domain's generic gates
Table 1 summarizes
the domain's generic gates. It shows the level-1 trace point IDs of
the modules providing the functions for the gates, the functions provided
by the gates, and the generic formats for calls to the gates.
| Gate | Trace | Functions | Format |
|---|---|---|---|
| PGDM | PG 0101 |
INITIALISE_DOMAIN |
DMDM |
| PGRL | PG 1401 |
CREATE |
RLCB |
| PGST | PG 0F01 |
COLLECT_STATISTICS |
STST |
| PGUE | PG 1001 |
SET_EXIT_STATUS |
APUE |
INITIALISE_DOMAIN
There are two phases to initialization of the program manager
domain:
- The DFHPGDM module creates the PG domain anchor block, the table of installed program resource definitions, and the PG Lock. It also adds subpools and gates, determines whether a cold, warm, or emergency start is needed, and waits for the global catalog to be available.
- For a warm or emergency start, the DFHPGDM module rebuilds the
table of installed program resource definitions, and restores the
program autoinstall system initialization parameters from the global
catalog entries. (It calls the parameter manager to obtain other system
initialization parameter values.)
For a cold start, the DFHPGDM module purges all the information about installed program resource definitions from the global catalog.
QUIESCE_DOMAIN
In quiesce processing, the program manager domain:
- Sets the PG state to quiescing.
- Ensures that the statistics domain has gathered the PG statistics by issuing a WAIT_PHASE for STATISTICS_UNAVAILABLE. This also ensures synchronization with the AP domain quiesce activity.
- Sets the PG state to quiesced.
- Delete the PG gates. PG functions remain available, but the use of programs after this point does not appear in statistics (DFHSTP issues a PC LINK/ PGLK LINK to DFHWKP after AP domain waits for STATISTICS_UNAVAILABLE).
- Store information about program resource definitions in the global catalog. Information about program resource definitions is written to the catalog only when they are installed or changed.
TERMINATE_DOMAIN
In terminate processing, the program manager domain sets
the PG state to terminated, and makes the program manager domain unavailable
to EXEC CICS commands.