HP 3000 Manuals HP 3000 Manuals
SDGetEntVarAttr
Retrieves the variable length attribute value for an entity.
Syntax
SDGetEntVarAttr (Dcb,EntityType,Entity,Attribute,RetrievalID,
Value,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.
Entity Required input; type = NameOrNumberType
This parameter specifies the entity from which
to retrieve the value of the variable length
attribute.
Attribute Required input; type = NameOrNumberType
This parameter specifies the variable length
attribute whose value is to be retrieved.
RetrievalID Required input; Output; type = RetrievalIDType
This parameter is used internally to pass
information between multiple calls of this
intrinsic, to retrieve all of the attribute
value text for this entity.
To find the first line of attribute value text,
initialize the first four bytes of this
parameter to a binary zero. To find additional
lines of text, call this intrinsic once for
each line to be returned.
Value Output; type = ValueLine
This parameter returns 80 characters of the
attribute value text per successful call of
this intrinsic. If the last line is only a
partial line, it will be right blank filled.
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 |
| | |
----------------------------------------------------------------------
| | |
| 25 - 28 | Total number of 80 byte buffers of this variable |
| | attribute for this entity. Valid when input |
| | RetrievalID = 0. |
| | |
----------------------------------------------------------------------
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.