HP 3000 Manuals HP 3000 Manuals
SDModifyEnt
Modifies an entity.
Syntax
SDModifyEnt (Dcb,EntityType,Entity,NewEntityName,
AttributeList,AttributeValues,CommonEntity,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
EntityType Required input; type = NameOrNumberType
This parameter specifies the entity type of the
entity to be modified.
Entity Required input; type = NameOrNumberType
This parameter specifies the entity to be
modified.
NewEntityName Required input; type = NameType
This parameter specifies the new external name
of the entity. A blank string passed for this
parameter indicates no name change.
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.
CommonEntity Required input; type = NameOrNumberType
This parameter specifies the common entity
whose attributes are to be shared by the local
domain entity being modified. If this
parameter is used, the AttributeList parameter
can contain only the following attributes:
(1) scope-owner
(2) sensitivity
(3) ID-number
If attributes other than these are specified in
the AttributeList parameter, the CommonEntity
parameter must be blank or specified as the
null value (a forward slash '/' ) left
justified and right blank filled.
To explicitly delete a link to a common entity,
set this parameter to the null value (a forward
slash '/'), left justify, and right blank fill.
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 Dictionary
Administrator scope or a scope with at least Modify access to the
entity. It must also be either the DA scope or the entity's owner
scope to change the scope-owner or sensitivity attributes, or the
common domain entity link.
3. The current version must be in TEST status.
4. If the entity being modified is linked to a common entity, the
sensitivity for this entity cannot be greater than the sensitivity
for the common entity.
5. The following attributes are either assigned by this intrinsic or
cannot be modified, and cannot be specified in the AttributeList
for this intrinsic.
date-created
date-changed
scope-changed
6. Only the external name will be changed, even if the current name
mode is internal. Internal names are fixed, and used for
reference only.