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