HP 3000 Manuals

HP System Dictionary XL Intrinsics

SDCreateSynonym 

Creates a synonym for an entity.

Syntax 

     SDCreateSynonym (Dcb,EntityType,Entity,NewSynonym,Status)

Parameters 

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

EntityType          Required input; type = NameOrNumberType 
                    This parameter specifies the entity type of the
                    entity.

Entity              Required input; type = NameOrNumberType 
                    This parameter specifies the entity for which a new
                    synonym will be created.

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

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.

Discussion 

A synonym will always refer to the same attribute list as the entity it
refers to.  It will also have the same owner scope as the entity, and
will apply to all its versions.

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 the entity's owner scope.

MPE/iX 5.0 Documentation