HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDSwitchVersion 

Switch to another version.

Syntax 

     SDSwitchVersion (Dcb,Version,VersionStatus,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 of the
                          dictionary to be used during the current
                          dictionary session.  When a blank string is
                          used, the version to be used will be determined
                          by the VersionStatus parameter.

VersionStatus             Required input by value; type = 
                          VersionStatusType 
                          This parameter specifies the status of the
                          version to be used.  If zero is passed for this
                          parameter and no version has been specified, it
                          will default to the Production version of
                          definitions.  Numerical values for the version
                          statuses are:
                             1.  = Test status
                             2.  = Production status
                             3.  = Archival 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.

                          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.

   3.  Either Version or VersionStatus may be specified.  Both parameters
       cannot be used at the same time.


MPE/iX 5.0 Documentation