HP 3000 Manuals

SDGetVersionList [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation


HP System Dictionary XL Intrinsics

SDGetVersionList 

Returns a list of versions within the current domain.

Syntax 

     SDGetVersionList (Dcb,RetrievalID,Version,Status)

Parameters 

Dcb                       Required input; type = DcbType 
                          This parameter passes information about the
                          dictionary to this intrinsic.  It is
                          initialized by the SDOpen intrinsic.

RetrievalID               Required input; Output; type = RetrievalIDType 
                          This parameter is used internally to pass
                          information between multiple calls of this
                          intrinsic, to retrieve all of the version names
                          in the current domain.

                          To find the first version, initialize the first
                          four bytes of this parameter to a binary zero.
                          To find additional versions call this intrinsic
                          once for each version to be returned.

Version                   Output; type = NameType 
                          This parameter returns one version name for
                          each successful call of this intrinsic.

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