HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDGetRelType 

Retrieves information about a relationship type.

Syntax 

     SDGetRelType (Dcb,RelationshipType,RelationshipClass,OwnerScope,Status)

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
                          whose information is to be retrieved.

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.

OwnerScope                Output; type = NameType 
                          If the current scope either has Secure 
                          capability or owns the relationship type, this
                          parameter returns the name of the scope that
                          owns the relationship type.  Otherwise, this
                          parameter will return only ASCII blanks.

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

                          If this intrinsic is successful, the Status 
                          parameter contains the following information,
                          in addition to the description contained in
                          Table Table 3-1.

-------------------------------------------------
|          |                                    |
|  Bytes   |              Contain               |
|          |                                    |
-------------------------------------------------
|          |                                    |
| 17 - 20  | Internal relationship type number  |
|          |                                    |
-------------------------------------------------

Discussion 

The following restrictions apply when using this intrinsic:

   1.  Open mode--The dictionary can be opened in any mode.

   2.  Security--This intrinsic will succeed with any current scope.


MPE/iX 5.0 Documentation