5.1 Mandatory parameters

5.1.1 TXT txt-file

It's the name of the input or output (depending on the direction of conversion) text file. There is no default value for this parameter.

Under MVS

'txt-file' can be one of the following :

• a sequential dataset,
• a member of a partitioned dataset,
• a DDname. In this case, the DDname must be preceded by 'DD:'.

Before running TXT2XML, txt-file must exist, except when doing an XML to text conversion under ISPF.

For all other platforms

txt-file has to be a correct file name. The file must exist before running TXT2XML for a text to XML conversion.

5.1.2 COB cob-file

It's the name of the COBOL copybook file. There is no default value for this parameter.

Under MVS

'cob-file' can be one of the following :

• a sequential dataset,
• a member of a partitioned dataset,
• a DDname. In this case, the DDname must be preceded by 'DD:'.

Before running TXT2XML, cob-file must always exist.

For all other platforms

cob-file has to be a correct file name. The file must always exist before running TXT2XML. Since TXT2XML does not handle some COBOL clauses such as REDEFINES, etc, it is best to 'clean up' the copybook by removing all COBOL clauses not handled by the TXT2XML routines.

5.1.3 XML xml-file

It's the name of the input or output (depending on the direction of conversion) XML file. There is no default value for this parameter.

Under MVS

'xml-file' can be one of the following :

• a sequential dataset,
• a member of a partitioned dataset,
• a DDname. In this case, the DDname must be preceded by 'DD:'.

Before running TXT2XML, xml-file must exist, except when doing a text to XML conversion under ISPF.

For all other platforms

xml-file has to be a correct file name. The file must exist before running TXT2XML for an XML to text conversion.

5.1.4 FORMAT format

The value for this parameter may only be (all platforms) :

• X for text to XML conversion,
• T to XML to text conversion.

There is no default value for this parameter.