HP 3000 Manuals HP 3000 Manuals
SDModifyVersion
Modifies a version.
Syntax
SDModifyVersion (Dcb,Version,NewVersionName,NewOwnerScope,
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.
Version Required input; type = NameOrNumberType
This parameter specifies the version to be
modified.
NewVersionName Required input; type = NameType
This parameter specifies the new external name
of the version. A blank string passed for this
parameter indicates no name change.
NewOwnerScope Required input; type = NameOrNumberType
This parameter specifies the new owner scope.
A blank string passed for this parameter
indicates no change in owner scope.
CommonVersion Required input; type = NameOrNumberType
This parameter specifies the common version to
which the local domain version (Version
parameter) is linked. A blank string passed
for this parameter indicates no change.
To explicitly delete a link to a common
version, set this parameter to the null value
(a forward slash '/') left justify, and right
blank fill.
Status Output; type = StatusType
This parameter contains information indicating
the success or failure of the intrinsic call.
This information is detailed in Table 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 version's owner scope.
3. The new owner scope must have at least Version capability.
4. The modified version cannot have any entities or relationships
linked with the common version if the link is deleted.
5. Only the external name will be changed, even if the current name
mode is internal. Internal names are fixed, and used for
reference only.
6. If the link from a local version is changed from one common
version to another, the new common version must have a
corresponding occurrence for each occurrence linked from the local
version.