writeToFile

Puts the content of the data item associated with an XMLStream object into an XML file.

General format

void writeToFile ( Xml-Destination )

Syntax rules

1.	Xml-Destination can be either a Data Item or a Nonnumeric Literal.

General rules

1.	Xml-Destination refers to a regular disk file.

2.	When the write method is invoked, the whole content of the data item associated with the XMLStream object is put into Xml-Destination.

 

NOTE - If the number of occurrences of an XML fields is not known at the time the program is written, specifying the DYNAMIC phrase of the OCCURS clause is recommended.

3.	The XMLStream write method will indent the output according to the value of the property iscobol.xmlstream.indent_number. The default is -1 which disables indentation. For example, to indent each level 2 columns set this property as follows:

iscobol.XMLStream.indent_number=2

4.	To omit empty elements from the XML output, set the property iscobol.xmlstream.omit_empty_elements (boolean) to true. The default value of this property is false, that means empty elements are generated.

Code example

... configuration section. repository.      class xmlStream  as "com.iscobol.rts.XMLStream"     . ... working-storage section. ... 77 objXmlStream object reference xmlStream. ... procedure division. ... objXmlStream:>writeToFile("Sample.xml") ...