HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDCreateVersion 

Creates a version.

Syntax 

     SDCreateVersion (Dcb,NewVersion,CommonVersion,Status)

Parameters 

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

NewVersion          Required input; type = NewNameType 
                    This parameter specifies the name of the version to
                    be created.

CommonVersion       Required input; type = NameOrNumberType 
                    This parameter specifies the common domain version to
                    which this local domain version is linked.  To
                    specify that there is no link to the common domain,
                    or if currently in the common domain, use 0 or a
                    blank string for this parameter.

Status              Output; type = StatusType 
                    This parameter contains information indicating the
                    success or failure of the intrinsic call.  This
                    information is detailed in Table 3-1.

                    If this intrinsic is successful, the Status parameter
                    contains the following information, in addition to
                    the description contained in 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 either Shared Update 
       mode or Exclusive Update mode.

   2.  Security--The current scope must be either the Dictionary
       Administrator scope or a scope with Version Control 

   3.  Maximum Quantities--the maximum number of versions allowed in a
       domain is 128.

   4.  The following character cannot be used by itself as a version
       name, though it may be included in one:  "/"

       _________________________________________________________________ 

       NOTE  In the future, Hewlett Packard will prefix all names of
             objects it adds to the core set with "HP".  To avoid
             potential name conflicts, do not create any entity types,
             relationship classes, attributes, scopes, domains, or
             versions prefixed with "HP".

       _________________________________________________________________ 



MPE/iX 5.0 Documentation