HP 3000 Manuals HP 3000 Manuals
SDCreateRel
Creates a relationship occurrence.
Syntax
SDCreateRel (Dcb,RelationshipType,RelationshipClass,NewEntityList,
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.
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.
NewEntityList Required input; type = NewEntityListType
This parameter specifies the list of entities that
will be used to establish a relationship.
AttributeList Required input; type = AttributeListType
This parameter specifies the new relationship's list
of attributes to be initial
AttributeValues Required input; type = AttributeValuesType
This parameter specifies the respective values which
will be assigned to the attributes in the attribute
list.
CommonEntityList Required input; type = EntityListType
This parameter specifies the common domain
relationship whose attributes are to be shared by the
local domain relationship to be created. If this
parameter is used, the AttributeList parameter can
contain only the following attributes:
(1) Sensitivity
(2) Relationship-position
If any attributes other than these are specified in
the AttributeList parameter, the CommonEntityList
parameter must be either 0 or an empty list ( ; )
Status Output; type = StatusType
This parameter contains information indicating the
success or failure of the intrinsic call. This
information is detailed in Table 3-1.
If this intrinsic is successful, the Status parameter
contains the following information, in addition to
the description contained in Table 3-1.
-------------------------------------------------
| | |
| Bytes | Contain |
| | |
-------------------------------------------------
| | |
| 17 - 20 | Internal relationship number |
| | |
-------------------------------------------------
Discussion
The following attributes are automatically assigned values as the
relationship is created, and therefore cannot be specified in the
AttributeList parameter.
scope-owner
scope-changed
date-created
date-changed
The attribute Sensitivity should only be specified for the first version
of the relationship being created. If it is not specified for the first
version of a relationship, it will default to PRIVATE, provided an
attribute edit does not exist. Further, if it is specified for
subsequent versions of a relationship, it will be ignored.
Attributes which are without edits and are not specified in the
AttributeList parameter, but are associated with the relationship type
will be defaulted as follows:
Boolean = false
Character = blank characters
Floating Point = floating point zero
Integer = binary zero
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary must be opened in either Shared Update
mode or Exclusive Update mode.
2. Security--The current scope must be either the Dictionary
Administrator scope or the owner of existing versions of the
relationship within the current domain. The scope must also have
Create capability. If no other versions of the relationship
exist, the current scope must have at least Read access to each of
the entities in the relationship.
3. Sensitivity--If the relationship is to be linked to a common
relationship, its sensitivity cannot be greater than the
sensitivity of the common relationship.
4. The current version must be in TEST status.
5. The relationship-position attribute must either be set to zero or
not specified if default numbering is desired.