HP 3000 Manuals HP 3000 Manuals
SDGetScopeList
Returns a list of scopes in the dictionary.
Syntax
SDGetScopeList (Dcb,RetrievalID,Scope,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
RetrievalID Required input; Output; type = RetrievalIDType
This parameter is used internally to pass
information between multiple calls of this
intrinsic, to retrieve all of the scopes in the
dictionary.
To find the first scope, initialize the first
four bytes of this parameter to a binary zero.
To find additional scopes call this intrinsic
once for each scope to be returned.
Scope Output ; type = NameType
This parameter returns the name of one scope
for each successful call of this intrinsic.
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 a scope with Secure capability.
If the current scope is not the DA scope, only the current scope
and those scopes owned by the current scope, will be returned.