HP 3000 Manuals HP 3000 Manuals
SDCreateEnt
Creates an entity occurrence.
Syntax
SDCreateEnt (Dcb,EntityType,NewEntity,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.
NewEntity Required input; type = NewNameType
This parameter specifies the name of the new entity.
AttributeList Required input; type = AttributeListType
This parameter specifies the new entity's list of
attributes to be initialized.
AttributeValues Required input; type = AttributeValuesType
This parameter specifies the respective values which
will be assigned to the attributes in the attribute
list.
CommonEntity Required input; type = NameOrNumberType
This parameter specifies the common domain entity
whose attributes are to be shared by the local domain
entity being created. If this parameter is used,
then the AttributeList can contain only the following
attributes:
(1) Sensitivity
(2) ID-Number
If any attributes other than these are specified in
the AttributeList parameter, then the CommonEntity
parameter must be a blank string or 0.
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 entity number |
| | |
-------------------------------------------------
Discussion
The following attributes are automatically assigned values as the entity
is created, and therefore cannot be specified in the AttributeList
parameter.
scope-owner
scope-changed
date-created
date-changed
The attributes Sensitivity and ID-Number should only be specified for the
first version of the entity being created. If either of these attributes
are specified for subsequent versions of an entity they will be ignored.
If Sensitivity is not specified for the first version of an entity, it
will default to PRIVATE, provided an attribute edit does not exist.
Attributes which are without edits, and are not specified in the
AttributeList parameter, but are associated with the entity 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
entity within the current domain. The scope must also have Create
capability.
3. Sensitivity--If the entity being created is linked to a common
entity, the specified sensitivity cannot be greater than the
sensitivity of the common entity.
4. The current version must be in TEST status.
5. The following characters cannot be used by themselves as entity
names although they may be included in them: "?" , "/"