HP 3000 Manuals HP 3000 Manuals
SDAddEntScope
Associates a scope to an entity, allowing the scope to access that
entity.
Syntax
SDAddEntScope (Dcb,EntityType,Entity,Scope,ScopeAccess,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is initialized by
the SDOpen intrinsic.
EntityType Required input; type = NameOrNumberType
This parameter specifies the entity type of the
entity to associate with a scope
Entity Required input; type = NameOrNumberType
This parameter specifies the entity to associate with
a scope.
Scope Required input; type = NameOrNumberType
This parameter specifies the scope to be allowed
access to the entity.
ScopeAccess Required input by value; type = ScopeAccessType
This parameter specifies the access that the scope is
allowed, as follows:
1. = Read access
2. = Read and modify access
Status Output; type = StatusType
This parameter contains information indicating the
success or failure of the intrinsic call. This
information is detailed in Table 3-1, located in
Chapter 3 of this manual.
Discussion
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary must be opened in either Shared Update
mode or Exclusive Update mode.
2. Security--The current scope must be either the Dictionary
Administrator scope or the entity's owner scope.
3. Entity Sensitivity--
1. The entity which is being added to the scope access list
cannot have Public Modify sensitivity.
2. If the entity's sensitivity is Public Read, ScopeAccess
must = 2.
4. Scope Capabilities--
1. If ScopeAccess = 1, the scope must have at least Read
capability.
2. If ScopeAccess = 2, the scope must have Create capability.
5. A scope may be associated only once to an entity occurrence.