xml.DomNode.getElementsByTagName

Returns a DomNodeList object containing all XML Element DomNode objects with the same tag name.

Syntax

getElementsByTagName(
   tag STRING )
  RETURNS xml.DomNodeList
  1. tag defines the name of the XML Element tag to match or "*" to match all tags.

Usage

Returns a DomNodeList object containing all XML Element DomNode objects with the same tag name, or NULL; tag is the name of the XML Element tag to match, or "*" to match all tags.

The getElementsByTagName and getElementsByTagNameNS methods return a xml.DomNodeList object, unlike the other methods that return a DomNode object. The DomNodeList is restricted to objects with the same tag name and/or namespace.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).