HP 3000 Manuals HP 3000 Manuals
SDGetRel
Retrieves a relationship's attributes.
Syntax
SDGetRel (Dcb,RelationshipType,RelationshipClass,EntityList,
AttributeList,AttributeValues,CommonEntityList,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
of the relationship whose attributes are 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.
EntityList Required input; type = EntityListType This
parameter specifies the relationship whose
information is to be retrieved.
AttributeList Required input; type = AttributeListType This
parameter specifies the attributes whose values
are to be retrieved. This list will be
considered empty if the first character is the
List terminator ( ; ) or if the number of
internal numbers in the parameter is zero.
AttributeValues Output; type = AttributeValuesType
This parameter contains the values of the
attributes that are retrieved.
CommonEntityList Output; type = EntityListOutType
This parameter returns a list of entities for
any relationship in to which this local domain
relationship is linked. If this relationship
is not linked to a common relationship, then
this parameter will return a list terminator (
; ) as the first character.
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 number |
| | |
-------------------------------------------------
Discussion
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary must be opened in Shared Read mode,
Shared Read-Only mode, Shared Update mode, or Exclusive Update
mode.
2. Security--The current scope must be either the Dictionary
Administrator scope or a scope with Read access to the
relationship.