HP 3000 Manuals HP 3000 Manuals
SDGetScope
Returns information about a scope.
Syntax
SDGetScope (Dcb,Scope,Password,ScopeRights,OwnerScope,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
Scope Required input; type = NameOrNumberType
This parameter specifies the scope whose
information is to be retrieved.
Password Output; type = ScopePasswordType
This parameter returns the scope's password.
ScopeRights Output; type = ScopeRightsType
This parameter returns the list of capabilities
associated with the scope. ScopeRights are
assigned by number, as follows:
1. = Secure capability
2. = Extend capability
3. = Create capability
4. = Read capability
5. = Domain capability
6. = Version Control capability
More information about ScopeRights is located
in Chapter 5 of Volume 1 of the General
Reference Manual.
OwnerScope Output; type = NameType
This parameter returns the name of the scope
that owns the scope.
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 scope number |
| | |
-------------------------------------------------
Discussion
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary can be opened in any mode.
2. Security--The current scope must be either the Dictionary
Administrator scope, or the scope's owner scope, or the specified
scope.