xml.DomDocument.createEntityReference

Creates an XML EntityReference DomNode object for a DomDocument object

Syntax

createEntityReference(
   ref STRING )  
  RETURNING object xml.DomNode

ref is the name of the entity reference.

Usage

Creates an XML EntityReference DomNode object for this DomDocument object, where ref is the name of the entity reference.

Returns a DomNode object, or NULL.

An Entity Reference node is read-only and cannot be modified.

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).