HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDAddAttrRelType 

Adds an attribute to a relationship type's attribute list in the
dictionary structure.

Syntax 

     SDAddAttrRelType (Dcb,RelationshipType,RelationshipClass,
                           Attribute,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 to
                    which an attribute will be added.

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.

Attribute           Required input; type = NameOrNumberType 
                    This parameter specifies the attribute to be added.

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, located in
                    Chapter 3 of this manual.

Discussion 

The following restrictions apply when using this intrinsic:

   1.  Open mode--The dictionary must be opened in Exclusive 
       Customization mode.

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

   3.  Maximum Quantities--the maximum number of attributes that can be
       associated with a relationship type is 128, not including the six
       special attributes.

   4.  An attribute may be assigned only once to a relationship type's
       attribute list.

   5.  The maximum total size of all the attribute list's data values
       (not including special attributes) is 2048 bytes.  This value is
       checked whenever the dictionary is restructured.  A description of
       special attributes is located in Chapter 3 of the General
       Reference Manual (Vol 1).

   6.  Alias or variable length attributes may not be specified.

   7.  When the dictionary is restructured, the specified attribute will
       be added to every relationship occurrence of the particular
       relationship type specified in the intrinsic call.  Attribute
       value defaults, listed below, depend on the attribute type being
       used.

       NOTE : These values will be used when no edit exists for the
       attribute.

       Boolean          =  false
       character        =  blank characters
       floating point   =  floating point zero

       integer          =  binary zero



MPE/iX 5.0 Documentation