SDCreateVersion [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation
HP System Dictionary XL Intrinsics
SDCreateVersion
Creates a version.
Syntax
SDCreateVersion (Dcb,NewVersion,CommonVersion,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is initialized by
the SDOpen intrinsic.
NewVersion Required input; type = NewNameType
This parameter specifies the name of the version to
be created.
CommonVersion Required input; type = NameOrNumberType
This parameter specifies the common domain version to
which this local domain version is linked. To
specify that there is no link to the common domain,
or if currently in the common domain, use 0 or a
blank string for this parameter.
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 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 Version Control
3. Maximum Quantities--the maximum number of versions allowed in a
domain is 128.
4. The following character cannot be used by itself as a version
name, 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