DMIQ gate, INQ_DOMAIN_BY_NAME function
The INQ_DOMAIN_BY_NAME function of the DMIQ gate is used to get the domain's token, ID, status, and phase for the specified domain name.
Input Parameters
- DOMAIN_NAME
- is a unique string, 1 through 8 characters, which is the name of the domain.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is INVALID:
- DOMAIN_NAME_NOT_FOUND
- DOMAIN_ID
- is the unique character pair, usually an abbreviated form of the domain name.
- DOMAIN_PHASE
- is the current phase level for that domain.
- DOMAIN_STATUS
- is ACTIVE or INACTIVE.
- DOMAIN_TOKEN
- is the unique index that corresponds to the new table entry for the domain.
- RESPONSE
- is DFHDMEN's response to the call.
- Values for the parameter are:
- OK
- EXCEPTION
- DISASTER
- INVALID
- KERNERROR