SDGetAttr [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation
HP System Dictionary XL Intrinsics
SDGetAttr
Retrieves information about an attribute.
Syntax
SDGetAttr (Dcb,Attribute,AttributeParms,AttributeEdits,
EditsLength,Ownerscope,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
Attribute Required input; type = NameOrNumberType
This parameter specifies the attribute whose
parameters are to be returned.
AttributeParms Output; type = AttributeDescription
This parameter describes the attribute. It has
two elements. The first element specifies the
attribute's data type (1 thru 6) and the second
element (shown in parentheses) specifies the
attribute's length.
1 = Alias Name (always 32)
2 = Boolean (always 1)
3 = Character (1 thru 255)
4 = Floating Point (4 or 8)
5 = Integer (2 or 4)
6 = Variable Character (always 0)
AttributeEdits Output; type = AttributeEditsType
This parameter returns the edits specified for
this attribute.
EditsLength Output; type = 4 byte Integer
This parameter returns the byte length of the
AttributeEdits parameter, and will not exceed
255.
OwnerScope Output; type = NameType
If the current scope either has Secure
capability or owns the attribute, this
parameter returns the name of the scope that
owns the attribute. Otherwise, this parameter
will return only 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 attribute number |
| | |
----------------------------------------------------------------------
Discussion
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary can be opened in any mode.
2. Security--This intrinsic will succeed with any current scope.
MPE/iX 5.0 Documentation