CXML-GET-ATTRIBUTE

Syntax:

CALL "C$XML" USING CXML-GET-ATTRIBUTE, handle attr-num attr-name attr-value

Parameters:

CXML-GET-ATTRIBUTE Op-code 8. Numeric data item that specifies the operation to perform. Each operation is defined in acucobol.def, which is included with your system.
handle USAGE handle
attr-num numeric value
attr-name pic x(n)
attr-value numeric value
attr-value-len

(optional)

numeric value

On Entry:

CXML-GET-ATTRIBUTE Value 8
handle Is an element handle or parser handle. If handle is a parser handle, it is first set to the handle of the top-level element of the parsed file.

On Exit:

attr-name the name of the attribute
attr-value The attribute's value

Comments:

If the return-code is “0”, it can mean that there are no elements, or that the passed handle is not a valid handle. Query on the last error with op-code CXML-GET-LAST-ERROR to determine which is the case.

Before you use CXML-GET-ATTRIBUTE, we recommend that you use CXML-GET-ATTRIBUTE-COUNT. This op-code tells you how many attributes are in the element of interest. Then when you use CXML-GET-ATTRIBUTE, you know which attribute you are getting (the first attribute is number 0, the second number 1, etc.). Alternatively, if you know the name of the attribute you want and not the number of the attribute, you can use CXML-GET-ATTRIBUTE-BY-NAME. If you have an unknown number of attributes like this:

Limousine 
xmlns:tsd="http://namespaces.softwareag.com/tamino/TaminoSche
maDefinition" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 

and you are searching for a particular attribute, say "xmlns:xsi", you can search for the value with CXML-GET-ATTRIBUTE-BY-NAME, or you can get the count and read the attributes one by one searching for the one you want.