HP 3000 Manuals HP 3000 Manuals
SDGetRelTypeAttrList
Retrieves a relationship type's attribute list.
Syntax
SDGetRelTypeAttrList (Dcb,RelationshipType,RelationshipClass,
RetrievalID,Attribute,OwnerScope,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
whose attribute list 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.
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 attributes
associated with this relationship type.
To find the first attribute, initialize the
first four bytes of this parameter to a binary
zero. To find additional attributes call this
intrinsic once for each attribute to be
returned.
Attribute Output; type = NameType
This parameter returns the name of an attribute
associated with the relationship type for each
successful call of the intrinsic.
OwnerScope Output; type = NameType
If the current scope either has Secure
capability or owns the relationship
type/attribute pair, this parameter returns the
name of the scope that owns the relationship
type/attribute pair. 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 attribute 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.