SDGetRelScope [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation
HP System Dictionary XL Intrinsics
SDGetRelScope
Retrieves the access a scope has to a relationship.
Syntax
SDGetRelScope (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.
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 whose
scope access will be retrieved.
Scope Required input; type = NameOrNumberType
This parameter specifies the scope that is
associated with the relationship.
ScopeAccess Output; type = ScopeAccessType
This parameter returns the access the scope has
to the relationship as follows:
1 = Read access.
2 = Read and Modify access.
3 = Create, Delete, Read, and Modify access
(owner scope or DA 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.
Description
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--This intrinsic will succeed with any current scope.
MPE/iX 5.0 Documentation