Digital

NAME

dtifanls − convert DTIF formatted files to CDA Analysis formatted files
 

SYNOPSIS

dtifanls [−m message_log] [−O optionfile] [−o outputfile] [−p options_line]... [−d extension] [inputfile [outputfile [logfile]]]

DESCRIPTION

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 the standard output file. 
 
You can also invoke the dtifanls conversion with the cdoc(1) 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. 

A document syntax error in the DTIF input file causes a fatal input processing error. The conversion stops and no further input processing occurs. 
 

FLAGS

−m message_log
Logs messages to the specified file or, if a minus sign (−) is encountered as an argument, to the standard error file.
 
If this option is not specified and three files are specified, then the logfile will only contain serious errors.

−O optionfile
Specifies the name of the options file containing processing options for this converter.

−o outputfile
Specifies the name of the output file. Included in the command syntax for compatibility with the cdoc command. 

−p options_line
Allows options to be specified on the command line and has the same effect as specifying an options file for this converter. Up to 100 options can be specified.

−d extension
Allows the specification of a default file extension that is compatible with other operating systems.

Converter Processing Options

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:

o TRANSLATE_BYTE_STRINGS
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.

o IMAGE_DATA
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 ∗∗∗

To retain the hexadecimal display, supply the IMAGE_DATA option.  There is no translation into ASCII. 

o INHERITANCE
dtifanls supports an inheritance processing option, which specifies that the Analysis is shown with attribute inheritance enabled.  Inherited attributes are marked by "[default]" in the output. 

RELATED INFORMATION

cdoc(1), ddifanls(1), ddifps(1), ddiftext(1), dtifddif(1), textddif(1)