HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDCreateRelVarAttr 

Assigns text to a variable length attribute of a relationship.

Syntax 

     SDCreateRelVarAttr(Dcb,RelationshipType,RelationshipClass,
                        EntityList,Attribute,Value,ValueLength,Status)

Parameters 

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

RelationshipType    Required input; type = RelationshipTypeList 
                    This parameter specifies the relationship type of the
                    relationship.

RelationshipClass   Required input; type = NameOrNumberType 
                    This parameter specifies the class of the
                    relationship type.  Blanks or a 0 may be specified
                    for this parameter when the entity types specified in
                    the RelationshipType parameter uniquely identify a
                    relationship type.

EntityList          Required input; type = EntityListType 
                    This parameter specifies the entities of the
                    relationship.

Attribute           Required input; type = NameOrNumberType 
                    This parameter specifies the variable length
                    attribute to which the text will be associated.

Value               Required input; type = ValueTextType 
                    This parameter is the attribute text to assign to the
                    attribute.

ValueLength         Required input; type = 4 byte Integer 
                    This parameter specifies the number of bytes of text
                    in the parameter Value.

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 

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 have at least Create capability and Modify 
       access to the relationship.

   3.  The current version must be in TEST status.

   4.  The specified relationship must not be linked with a common
       relationship.


MPE/iX 5.0 Documentation