HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDDeleteScope 

Deletes a scope from the dictionary.

Syntax 

     SDDeleteScope (Dcb,Scope,NewOwnerScope,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 to be
                          deleted.

NewOwnerScope             Required input; type = NameOrNumberType 
                          This parameter specifies the new owner of the
                          entities, relationships, attributes, entity
                          types, relationship types, relationship
                          classes, entity type/attribute pairs,
                          relationship type/attribute pairs, scopes,
                          domains, and versions that are owned by the
                          scope to be deleted.

Password                  Required input; type = ScopePasswordType 
                          This parameter specifies the password that will
                          allow access to the new owner scope.

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 Exclusive Update mode.

   2.  Security--The current scope must be either the Dictionary
       Administrator scope or the deleted scope's owner scope.

   3.  If the NewOwnerScope parameter is blank, all items previously
       owned by the deleted scope will now be owned by the current scope,
       and the Password parameter will be ignored.

   4.  The scope rights of the new owner scope must be at least as great
       as the deleted scope.


MPE/iX 5.0 Documentation