SDGetVersion [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation
HP System Dictionary XL Intrinsics
SDGetVersion
Returns information about a version.
Syntax
SDGetVersion (Dcb,Version,VersionStatus,VersionDate,
CommonVersion,Ownerscope,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 about
which information will be returned.
VersionStatus Output; type = VersionStatusType
This parameter returns the current status of
the specified version. numerical values for
the version statuses are:
1. = Test status
2. = Production status
3. = Archival status
VersionDate Output; type = DateType
This parameter returns the date and time the
specified version was created.
CommonVersion Output; type = NameType
This parameter returns the name of the common
version which is linked to the version. If the
current domain is the common domain, or the
version is not linked to a common version, this
parameter will return only ASCII blanks.
OwnerScope Output; type = NameType
If the current scope either has Secure
capability or owns the version, this parameter
returns the name of the scope that owns the
version. Otherwise, this parameter will return
only ASCII blanks.
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.
If this intrinsic is successful, the Status
parameter contains the following information,
in addition to the description contained in
Table 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 Shared Read mode,
Shared Read-Only mode, Shared Update mode, or Exclusive Update
mode.
2. Security--This intrinsic will succeed with any current scope.
MPE/iX 5.0 Documentation