HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDCreateRelType 

Creates a new relationship type in the dictionary structure.

Syntax 

     SDCreateRelType (Dcb,NewRelationshipType,RelationshipClass,Status)

Parameters 

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

NewRelationshipType       Required input; type = NewRelationshipTypeList 
                          This parameter specifies the new relationship
                          type to be created.

RelationshipClass         Required input; type = NameOrNumberType 
                          This parameter specifies the class of the
                          relationship type.

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 relationship type number  |
|          |                                    |
-------------------------------------------------

Discussion 

Every relationship type has the following attributes associated with it
after it is created:

    scope-owner
    date-created
    date-changed
    scope-changed
    sensitivity
    relationship-position

These attributes, called special attributes, are associated by default
and can never be deleted from the relationship type's attribute list.
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 relationship types
       allowed in the dictionary is 512.


MPE/iX 5.0 Documentation