HP 3000 Manuals

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