HP 3000 Manuals HP 3000 Manuals
SDCreateDomain
Creates a new domain, and a version for this domain.
Syntax
SDCreateDomain (Dcb,NewDomain,NewVersion,CommonVersion,
Sensitivity,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is initialized by
the SDOpen intrinsic.
NewDomain Required input; type = NewNameType
This parameter specifies the name of the domain to be
created.
NewVersion Required input; type = NewNameType
This parameter specifies the name of the new version
to be created for this domain. The status of this
new version will automatically be set to Test.
CommonVersion Required input; type = NameOrNumberType
This parameter specifies the name of the common
version to which the local domain version is linked.
A blank string or 0 used for this parameter specifies
that there is no link to the common domain.
Sensitivity Required input by value; type = 4 byte Integer
This parameter specifies the sensitivity of the
domain, as follows:
1. = Private. Only the DA scope, the domain's
owner scope, or an associated scope has access
to the domain.
2. = Public. Any scope can access the domain.
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 domain number |
| | |
-------------------------------------------------
| | |
| 21 - 24 | Internal version 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 Domain capability.
3. Sensitivity--the sensitivity of the domain must be public for a
scope other than the DA scope, the domain's owner scope, or an
associated scope, to access the domain.
4. Maximum Quantities--the maximum number of domains allowed in the
dictionary is 128.
_________________________________________________________________
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".
_________________________________________________________________