HP 3000 Manuals HP 3000 Manuals
SDModifyRel
Modifies a relationship.
Syntax
SDModifyRel (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 to be modified.
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 to be
modified.
AttributeList Required input; type = AttributeListType This
parameter specifies the attributes to be
modified. 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 Required input; type = AttributeValuesType
This parameter specifies the new values of the
attributes being modified.
CommonEntityList Required input; type = NameOrNumberType
This parameter specifies the common
relationship whose attributes are to be shared
by the local domain relationship being
modified. If this parameter is used, the
AttributeList parameter can contain only the
following attributes:
(1) scope-owner
(2) sensitivity
(3) relationship-position
If attributes other than these are specified
in the AttributeList parameter, the
CommonEntityList parameter must be either an
empty list (';'), or a null value (a forward
slash '/') terminated with the list terminator
(';').
To explicitly delete a link to a common
relationship, set this parameter to the null
value (a forward slash '/') and terminate with
the list terminator.
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.
Discussion
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 DA scope or a scope
with at least Modify access to the relationship. It must also be
either the DA scope or the relationship's owner scope to change
the scope-owner or sensitivity attributes, or the common domain
relationship link.
3. The current version must be in TEST status.
4. If the relationship being modified is linked to a common
relationship, the sensitivity for this relationship cannot be
greater than the sensitivity for the common relationship.
5. The following attributes are either assigned by this intrinsic or
cannot be modified, and cannot be specified in the AttributeList
of this intrinsic.
date-created
date-changed
scope-changed