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.
Table 1. Program manager domain's generic gates
Gate Trace Functions Format
PGDM

PG 0101
PG 0102

INITIALISE_DOMAIN
QUIESCE_DOMAIN
TERMINATE_DOMAIN

DMDM
PGRL

PG 1401
PG 1402

CREATE
DISCARD
INQUIRE
INQUIRE_BY_NAME
SET

RLCB
PGST

PG 0F01
PG 0F02

COLLECT_STATISTICS
COLLECT_RESOURCE_STATS

STST
PGUE

PG 1001
PG 1002

SET_EXIT_STATUS

APUE

INITIALISE_DOMAIN

There are two phases to initialization of the program manager domain:
  1. 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.
  2. 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:
  1. Sets the PG state to quiescing.
  2. 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.
  3. Sets the PG state to quiesced.
During quiesce processing, the program manager does not:
  • 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.


dfhs3_PGgenericGates.html | Timestamp icon Last updated: Monday, 5 June 2017