HP 3000 Manuals HP 3000 Manuals
SDGetDomain
Retrieves information about a domain.
Syntax
SDGetDomain (Dcb,Domain,OwnerScope,Sensitivity,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
Domain Required input; type = NameOrNumberType
This parameter specifies the domain whose
information is to be retrieved.
OwnerScope Output; type = NameType
If the current scope either has Secure
capability or owns the domain, this parameter
returns the name of the scope that owns the
domain. Otherwise, this parameter will return
only ASCII blanks.
Sensitivity Output; type = 4 byte Integer
This parameter returns the sensitivity of the
domain, as follows:
1 = Private. Only the DA scope,
the domain's owner
scope, or an
associated scope has
access to the domain.
2 = Public. Any scope can access
the domain.
Status Output; type = StatusType
This parameter contains information indicating
the success or failure of the intrinsic call.
This information is detailed in Table Table
3-1, located in Chapter 3 of this manual.
If this intrinsic is successful, the Status
parameter contains the following information,
in addition to the description contained in
Table Table 3-1.
----------------------------------------------------------------------
| | |
| Bytes | Contain |
| | |
----------------------------------------------------------------------
| | |
| 17 - 20 | Internal domain number |
| | |
----------------------------------------------------------------------
Discussion
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary must be opened in Shared Read mode,
Shared Read-Only mode, Shared Update mode, or Exclusive Update
mode.
2. Security--The current scope must be either the Dictionary
Administrator scope or a scope with Domain capability.