HP 3000 Manuals

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