HP 3000 Manuals

SDGetEntScope [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation


HP System Dictionary XL Intrinsics

SDGetEntScope 

Retrieves the access a scope has to an entity.

Syntax 

     SDGetEntScope (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 that is associated with the scope to be
                          checked.

Entity                    Required input; type = NameOrNumberType 
                          This parameter specifies the entity that is
                          associated with the scope whose access rights
                          are to be returned.

Scope                     Required input; type = NameOrNumberType 
                          This parameter specifies the scope that is
                          associated with the entity.

ScopeAccess               Output; type = ScopeAccessType 
                          This parameter returns the access the scope has
                          to the entity as follows:
                             1.  = Read Only 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.

Discussion 

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