WRITE-EXTERNAL-DTD( ) method

Adds an external Document Type Definition (DTD) reference to an XML document represented by a SAX-writer object.

Return type:

LOGICAL

Applies to:

SAX-writer object handle

 

Syntax 

WRITE-EXTERNAL-DTD ( name , systemID [ , publicID ] )

name

A CHARACTER or LONGCHAR expression evaluating to the fully qualified or unqualified name of the XML document root node.

systemID

A CHARACTER or LONGCHAR expression evaluating to the system ID of the DTD.

publicID

A CHARACTER or LONGCHAR expression evaluating to the public ID of the DTD.

Call this method to add an external DTD reference to the prolog of the XML document.

You can only call this method before the first call of START-ELEMENT. That is, only call this method when the WRITE-STATUS is SAX-WRITE-BEGIN. After the call, the status remains SAX-WRITE-BEGIN.

If the STRICT attribute is TRUE, and you call this method after you create the root element (or when the CREATE-FRAGMENT attribute is TRUE), then the method fails.

The value of name must match the value in the root node. If the STRICT attribute is TRUE and the two values do not match, then the method fails and generates an error.