ddifanls - convert DDIF formatted files to CDA analysis formatted files
ddifanls [-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 options for this converter.
The ddifanls command reads a DDIF formatted file from inputfile and writes a CDA analysis file to outputfile. To convert from file.ddif to file.cda_analysis, type:
ddifanls file.ddif file.cda_analysis
If you do not supply an input file, or if you use a minus sign (-) as an argument, ddifanls reads the DDIF file from the standard input file. If you do not supply an output file, or if you use a minus sign (-) as an argument, ddifanls writes the CDA analysis file to the standard output. If you specify a log file, ddifanls redirects the standard error to the log file. The ddifanls conversion is also invoked by the cdoc command when you use that command and specify the option -d analysis or -d anls.
If the DDIF input file is a newer version of the DDIF grammar than that understood by the converter, data represented by the new grammar elements is lost.
A document syntax error in the DDIF input file causes a fatal input processing error. The conversion stops and no further input processing occurs.
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. Search the analysis output
file for all occurrences of the string ``ERF_LABEL,'' followed
by the subfile name in double quotes (") to determine whether a document
has links to other files.
When using the converter you can produce 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 DDIF application programs. You can specify the following converter options: Specifies that the analysis is shown with attribute inheritance enabled. Inherited attributes are marked by ``[inherited value]'' in the output. 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). To override this option, supply 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), dtifanls(1), dtoc(1), cda(4), cda_msg(4), ddif(4), dots(4), dtif(4)