HP 3000 Manuals HP 3000 Manuals
SDGetVersionHistory
Returns status information about a specified version.
Syntax
SDGetVersionHistory (Dcb,Version,RetrievalID,VersionStatus
VersionDate,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 whose
information is to be returned.
RetrievalID Required input; Output; type = RetrievalIDType
This parameter is used internally to pass
information between multiple calls of this
intrinsic, to retrieve all the status changes
of the specified version. To find the latest
status change, initialize the first four bytes
of this parameter to a binary zero. To find
additional status changes call this intrinsic
once for each status change to be returned.
VersionStatus Output; type = VersionStatusType
This parameter returns a status of the
specified version for each successful call of
this intrinsic. 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 that
the version was set to the respective status.
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
All information about the version will be reported in reverse
chronological order.
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.