VMS Help CONVERT, /DOCUMENT, CDA Base Service Converters, Analysis Output Converter  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Analysis output converter produces formatted text output of
    the in-memory DDIF or DTIF format of the input file. The analysis
    output file shows the named objects and values stored in the
    input file. Application programmers use an analysis output file
    for debugging purposes.

    Application end users use an analysis output file to determine
    whether an input file contains references or links to multiple
    subfiles. Each subfile must be copied separately across a network
    because subfiles are not automatically included when an input
    file is transferred across the network.

    You can search the analysis output file for all occurrences of
    the string "ERF_". The following example shows that the image
    file "griffin.img" is linked to the DDIF compound document that
    is the input file:

    ERF_LABEL ISO LATIN1 "griffin.img" ! Char. string.
    ERF_LABEL TYPE RMS_LABEL TYPE "$RMS"
    ERF_CONTROL COPY_REFERENCE ! Integer = 1

    Note that an analysis output file is intended as a programmer's
    tool. The coded information in the file is not intended for
    modification but rather to examine the content of a file. The
    previous example shows how you can search analysis output for
    references to linked files.

1 - Analysis Converter Options

    The Analysis output converter supports the following options:

    o  TRANSLATE_BYTE_STRINGS

       Overrides the default. For data of type BYTE STRING, the
       analysis output no longer displays the hexadecimal translation
       if all the characters in the byte string are printable
       characters (hex values 20 through 7E). This feature may be
       overridden 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
       analysis output previously included both a hexadecimal and an
       ASCII translation display, neither of which were of particular
       value to most users. With the new version, both displays will
       be replaced with the following comment:

       ! *** Bit-mapped data not displayed here ***

       To retain the hexadecimal display, supply the IMAGE_DATA
       option. Even with this option turned on, there will be no
       translation into ASCII.

    o  INHERITANCE

       Specifies that the analysis is shown with attribute
       inheritance enabled. Inherited attributes are marked as
       "[Inherited value.]" in the output. This option also causes
       external references to be imported into the main document.