Domain manager domain’s generic formats

Table 43 describes the generic formats owned by the domain manager domain and shows the functions performed on the calls.

Table 43. Generic formats owned by the domain manager domain
Format Calling module Function
DMDM
DFHKETCB
DFHDMDS
DFHDMDS
DFHKETCB
PRE_INITIALIZE
INITIALIZE_DOMAIN
QUIESCE_DOMAIN
TERMINATE_DOMAIN

In the descriptions of the formats that follow, the "input" parameters are input not to the domain manager domain, but to the domain being called by the domain manager. Similarly, the "output" parameters are output by the domain that was called by the domain manager, in response to the call.

DMDM format, PRE_INITIALIZE function

The DFHKETCB module issues a preinitialization call to each of the following domains: LC, PA, TR, ME, DU, LM, SM, DD, DS, XM, LD, and DM.

Apart from the LD, and DM domains, preinitialization takes place under the job-step TCB; for LD, and DM, it takes place under the resource-owning (RO) TCB.

In preinitialization processing, the domain manager domain reads information about domains from the local catalog, and passes it to the kernel. It then attaches the initialization tasks for all the other domains.

Input parameters

None.

Output parameters

RESPONSE
is the domain’s response to the call. It can have any of these values:
OK|INVALID|KERNERROR|DISASTER
[REASON]
is returned when RESPONSE is DISASTER. Possible values are:
RESPONSE Possible REASON values
DISASTER
INSUFFICIENT_STORAGE
ABEND
LOOP

DMDM format, INITIALIZE_DOMAIN function

The domain manager domain issues an INITIALIZE_DOMAIN function call to a domain. In initialization processing, the domain manager domain performs only internal routines.

Input parameters

None.

Output parameters

RESPONSE
is the domain’s response to the call. It can have any of these values:
OK|INVALID|KERNERROR|DISASTER
[REASON]
is returned when RESPONSE is DISASTER or INVALID. Possible values are:
RESPONSE Possible REASON values
DISASTER
INSUFFICIENT_STORAGE
ABEND
LOOP
INVALID ALREADY_INITIALIZED

DMDM format, QUIESCE_DOMAIN function

The domain manager domain issues a QUIESCE_DOMAIN function call to a domain when the system is required to shut down normally. The domain manager domain initiates quiesce processing by attaching the quiesce task for each domain.

Input parameters

None.

Output parameters

RESPONSE
is the domain’s response to the call. It can have any of these values:
OK|INVALID|KERNERROR|DISASTER
[REASON]
is returned when RESPONSE is DISASTER. Possible values are:
RESPONSE Possible REASON values
DISASTER
INSUFFICIENT_STORAGE
ABEND
LOOP

DMDM format, TERMINATE_DOMAIN function

The domain manager domain issues a TERMINATE_DOMAIN function call to a domain when the system is required to shut down quickly. This call is always issued under the job-step TCB.

The domain manager domain does no termination processing.

Input parameters

CLEAN_UP
indicates whether or not the TERMINATE_DOMAIN function request is being issued under a cleanup-only ESTAE exit. It can have either of these values:
YES|NO
YES implies restrictions for termination logic, specifically that an ATTACH request cannot be issued.
CANCEL
indicates whether or not the termination is happening because of an operator CANCEL command. It can have either of these values:
YES|NO
YES means that attached subtasks are no longer dispatchable.
TERMINATION_TYPE
indicates whether the termination is happening because of either a quiesce or an abnormal shutdown. It can have either of these values:
QUIESCE|IMMEDIATE

Output parameters

RESPONSE
is the domain’s response to the call. It can have any of these values:
OK|INVALID|KERNERROR|DISASTER
[REASON]
is returned when RESPONSE is DISASTER. Possible values are:
RESPONSE Possible REASON values
DISASTER
ABEND
LOOP
[[ Contents Previous Page | Next Page Index ]]