Content-type: text/html Man page of dtifanls

dtifanls

Section: User Commands (1)
Index Return to Main Contents
 

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]]]


 

OPTIONS

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 options file has a default file type of .cda_options. Each line of the options file specifies a format name that can optionally be followed by _input or _output to restrict the option to either an input or output converter. The second word is a valid option preceded by one or more spaces, tabs, or a slash (/) and can contain uppercase and lowercase letters, numbers, dollar signs, and underlines. The case of letters is not significant. If an option requires a value, then spaces, tabs, or an equal sign can separate the option from the value.
You can precede any line by spaces and tabs. To terminate a line, use any character other than those used to specify the format names and options. The syntax and interpretation of the text that follows the format name is specified by the supplier of the front and back end converters for the specified format.
To specify several options for the same input or output format, specify one option on a line. If an invalid option for an input or output format or an invalid value for an option is specified, the option may be ignored or an error message may be returned. Each input or output format that supports processing options specifies any restrictions or special formats required when specifying options.
By default, any messages that occur during processing of the options file are written to the standard error. For those input and output formats that support a LOG option, messages can be directed to a log file or to a common message log. Specifies the name of the output file. Included in the command syntax for compatibility with the cdoc command. 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, each preceded by -p. Allows the specification of a default file extension that is compatible with other operating systems.
 

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

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: 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 ***

To retain the hexadecimal display, supply the IMAGE_DATA option. There is no translation into ASCII. 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.
 

SEE ALSO

cdoc(1), ctod(1), ddifanls(1), dtifddif(1), dtoc(1), cda(4), cda_msg(4), ddis(4), dots(4), dtif(4)


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
CONVERTER PROCESSING OPTIONS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:43:00 GMT, October 02, 2010