HP 3000 Manuals HP 3000 Manuals
SDGetEnt
Retrieves an entity's attributes.
Syntax
SDGetEnt (Dcb,EntityType,Entity,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 whose attributes are to be retrieved.
Entity Required input; type = NameOrNumberType
This parameter specifies the entity whose
attributes are 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.
CommonEntity Output; type = NameType
This parameter returns the name of the common
domain entity to which this local domain entity
is linked. If it is not linked to a common
domain entity, this parameter returns ASCII
blanks.
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 entity 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 entity.