HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDSwitchScope 

Switch to another scope.

Syntax 

     SDSwitchScope (Dcb,Scope,Password,Status)

Parameters 

Dcb                       Required input; type = DcbType 
                          This parameter passes information about the
                          dictionary to this intrinsic.  It is
                          initialized by the SDOpen intrinsic.

Scope                     Required input; type = NameOrNumberType 
                          This parameter specifies the scope which will
                          become the current scope.

Password                  Required input; type = ScopePasswordType 
                          This parameter specifies the password for the
                          user's 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--This intrinsic will succeed in any dictionary open
       mode.

   2.  Security--The new scope must be the Dictionary Administrator scope
       or a scope with access to the current domain.

   3.  The scope password must be the correct password for the scope
       which will become the current scope.


MPE/iX 5.0 Documentation