HP 3000 Manuals HP 3000 Manuals
SDAddRelScope
Associates a scope to a relationship, allowing the scope to access that
relationship.
Syntax
SDAddRelScope (Dcb,RelationshipType,RelationshipClass,
EntityList,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.
RelationshipType Required input; type = RelationshipTypeList
This parameter specifies the relationship type of the
relationship to associate with a scope.
RelationshipClass Required input; type = NameOrNumberType
This parameter specifies the class of the
relationship type. Blanks or a 0 may be specified
for this parameter when the entity types specified in
the RelationshipType parameter uniquely identify a
relationship type.
EntityList Required input; type = EntityListType
This parameter specifies the relationship to
associate with a scope.
Scope Required input; type = NameOrNumberType|
This parameter specifies the scope to be allowed
access to the relationship.
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 relationship's owner scope.
3. Relationship Sensitivity--
1. The relationship which is being added to the scope access
list cannot have Public Modify sensitivity.
2. If the relationship'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 a relationship occurrence.