HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDGetRelTypeList 

Retrieves all of the relationship types of a relationship class in the
dictionary structure.

Syntax 

     SDGetRelTypeList (Dcb,RelationshipClass,RetrievalID,
                        RelationshipType,Status)

Parameters 

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

RelationshipClass         Required input; type = NameOrNumberType 
                          This parameter specifies the relationship class
                          from which to retrieve the relationship types.

RetrievalID               Required input; Output; type = RetrievalIDType 
                          This parameter is used internally to pass
                          information between multiple calls of this
                          intrinsic, to retrieve all of the relationship
                          types in the specified relationship class.

                          To find the first relationship type, initialize
                          the first four bytes of this parameter to a
                          binary zero.  To find additional relationship
                          types call this intrinsic once for each
                          relationship type to be returned.

RelationshipType          Output; type = RelationshipTypeOutList 
                          This parameter returns a relationship type for
                          each successful call of this intrinsic.

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