dtifanls - convert DTIF formatted files to CDA analysis formatted files
dtifanls [-m message_log] [-O optionfile] [-o outputfile] [-p options_line]... [-d extension] [inputfile [outputfile [logfile]]]
Enables enhanced messaging and logs all messages to message_log or, if `-' is specified, to the standard error in place of the message_log. If you do not specify this option, only serious errors are reported. Specifies the name of the options file containing processing options for this converter.
The dtifanls command reads a DTIF (table) formatted file from inputfile and writes a CDA analysis file to outputfile. To convert from file.dtif to file.cda_analysis, type:
dtifanls file.dtif file.cda_analysis
If you do not supply an input file, or if you supply a minus sign (-) as an argument, dtifanls reads the DDIF file from the standard input file. If you do not supply an output file, or if you supply a minus sign (-) as an argument, dtifanls writes the CDA analysis file to standard output. You can also invoke the dtifanls conversion with the cdoc command when you use that command and specify the options -s dtif and -d analysis. dtifanls produces an analysis of the CDA in-memory structure in the form of text output showing the named objects and values stored in the document. This is useful for debugging DTIF application programs.
If the DTIF input file is a newer version of the DTIF grammar than that understood by the converter, data represented by the new grammar elements is lost. To resolve any external references within the DTIF input file, specify -p INHERIT.
Application end users use an analysis output file to determine whether an input file contains references of links to multiple ``subfiles''. You must copy each subfile separately across a network because subfiles are not automatically included when an input file is transferred across a network, unless the input file is transferred using DOTS.
A document syntax error in the DTIF input file causes a fatal input
processing error. The conversion stops and no further input processing occurs.
When you are converting any table format to any document format, you can specify the following domain converter processing options using a format name of DTIF_TO_DDIF: Overrides the default. For data of type BYTE STRING, the Analysis output does not display the hexadecimal translation if all the characters in the byte string are printable characters (hex values 20 through 7E). You can override this feature by supplying the TRANSLATE_BYTE_STRINGS option. Overrides the default. For the special case of byte string data for item DDIF_IDU_PLANE_DATA (a bitmapped image), the following comment appears on the display: ! *** Bit-mapped data not displayed here ***
cdoc(1), ctod(1), ddifanls(1), dtifddif(1), dtoc(1), cda(4), cda_msg(4), ddis(4), dots(4), dtif(4)