HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDCreateScope 

Creates a new scope.

Syntax 

     SDCreateScope (Dcb,NewScope,ScopeRights,NewPassword,Status)

Parameters 

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

NewScope            Required input; type = NewNameType 
                    This parameter specifies the name of the new scope to
                    be created.

ScopeRights         Required input; type = ScopeRightsType 
                    This parameter specifies the list of capabilities
                    given to the scope.  ScopeRights are assigned by
                    number, as follows:
                      1 = Secure capability
                      2 = Extend capability
                      3 = Create capability
                      4 = Read capability
                      5 = Domain capability
                      6 = Version Control capability

                    More information about ScopeRights is located in
                    section 6 of the General Reference Manual.

NewPassword         Required input; type = ScopePasswordType 
                    This parameter specifies the password that will allow
                    access to the scope.
                    NOTES: 
                      1) A blank password is allowed.
                      2) The password is case sensitive.

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.

                    If this intrinsic is successful, the Status parameter
                    contains the following information, in addition to
                    the description contained in Table 3-1.

-------------------------------------------------
|          |                                    |
|  Bytes   |              Contain               |
|          |                                    |
-------------------------------------------------
|          |                                    |
| 17 - 20  | Internal scope number              |
|          |                                    |
-------------------------------------------------

Discussion 

The following restrictions apply when using this intrinsic:

   1.  Open mode--The dictionary must be opened in either Shared Update 
       mode or Exclusive Update mode.

   2.  Security--The current scope must be either the Dictionary
       Administrator scope or a scope with Secure capability.

   3.  Maximum Quantities--the maximum number of scope definitions
       allowed in the dictionary is 128.

   4.  The following character cannot be used by itself as a password,
       though it may be included in one:  "/"

       _________________________________________________________________ 

       NOTE  In the future, Hewlett Packard will prefix all names of
             objects it adds to the core set with "HP".  To avoid
             potential name conflicts, do not create any entity types,
             relationship classes, attributes, scopes, domains, or
             versions prefixed with "HP".

       _________________________________________________________________ 


MPE/iX 5.0 Documentation