Index for Section 1

Alphabetical listing for D

dtifanls(1)
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
  -m message_log
      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.

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

  -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, each preceded by -p.

  -d extension
      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:

  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.

  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.

  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.







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