HP 3000 Manuals

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