Gets a handle to an attribute of an entity.

    Format

      SCA$QUERY_GET_ATTRIBUTE  entity,

                               attribute_kind,

                               attribute_handle,

                               [,iteration_context]

1  –  Arguments

 entity
    type:       $SCA_HANDLE
    access:     read only
    mechanism:  by reference

    An SCA entity handle describing the entity or relationship whose
    attributes are being obtained.

 attribute_kind
    type:       $SCA_ATTRIBUTE_KIND
    access:     read only
    mechanism:  by reference

    The kind of attribute to be obtained.

    Any attribute-kind can be specified on this routine.

 attribute_handle
    type:       $SCA_HANDLE
    access:     write only
    mechanism:  by reference

    An SCA attribute handle that is to describe the obtained
    attribute.

 iteration_context
    type:       $SCA_ITERATION_CONTEXT
    access:     read/write
    mechanism:  by reference

    Optional. The iteration-context. This longword must contain zero
    on the first call to this routine for a particular iteration. This
    routine uses the longword to maintain the iteration context. The
    caller must not change the contents of the longword.

2  –  Condition Values Returned

    SCA$_NORMAL           An attribute has been successfully returned.

    SCA$_NONE             Warning. An attribute has not been returned.
                          Either there are no such attributes at
                          all in the entity or there are no more
                          attributes.

3  –  Description

    The SCA$QUERY_GET_ATTRIBUTE routine gets a handle to an attribute
    of an entity.

    If the iteration_context parameter is not specified, then
    this routine finds the first attribute of the specified kind
    (attribute_kind) and updates attribute_handle to describe that
    attribute.

    In general, several attributes can be associated with a particular
    entity. With this routine you can find all of those attributes by
    using the iteration_context parameter.

    This routine will become obsolete in a future version of SCA. The
    SCA$GET_ATTRIBUTE routine supersedes this routine.