HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDGetRelClassList 

Retrieves all of the relationship classes in the dictionary structure.

Syntax 

     SDGetRelClassList (Dcb,RetrievalID,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.

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 relationships
                          classes in the dictionary.

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

RelationshipClass         Output; type = NameType 
                          This parameter returns the name of one
                          relationship class for each successful call of
                          the 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 class 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