Library /sys$common/syshlp/helplib.hlb  —  CONVERT  /DOCUMENT  Creating the Options File
    You can create an options file prior to specifying the CONVERT
    /DOCUMENT command with the /OPTIONS qualifier. An options file
    is a text file with a default file extension of .CDA$OPTIONS on
    OpenVMS systems.

    The options file contains all the processing options for your
    input file format and your output file format. Processing options
    help ensure minimal changes when your input file is converted to
    a different output file format.

    An options file is not required. Default processing options are
    applied automatically when you convert a file. You may, however,
    require settings other than the default.

    Enter options in the options file using these formats, where
    format is the name of the file format to which the option applies
    and option is the option:

    format_INPUT option         applies only to an input file of the
    [value]                     specified format
    format_OUTPUT option        applies only to an output file of the
    [value]                     specified format
    format option [value]       applies to either an input file or an
                                output file of the specified format

    Use uppercase and lowercase alphabetic characters, digits (0-9),
    dollar signs ($), and underscores (_) to specify the processing
    options.

    Use one or more spaces or tabs to precede values specified for a
    processing option.

    The following example is a typical entry in an options file:

    PS PAPER_HEIGHT 10

    In this example, the extension _OUTPUT is not required for the
    format, since PostScript is available only as an output format.
    The value specified for PAPER_HEIGHT is in inches by default.

    If the options file includes options that do not apply to
    the converters for a particular conversion, those options are
    ignored.

    If you specify an invalid option for an input or output format or
    an invalid value for an option, you receive an error message. The
    processing options described in the following sections document
    any restrictions.

1  –  Example

    $ CONVERT/DOCUMENT /OPTIONS=MY_OPTIONS.CDA$OPTIONS -
    _$ MY_INPUT.DTIF/FORMAT=DTIF MY_OUTPUT.DDIF/FORMAT=DDIF -
    _$ /MESSAGE_FILE=MY_MSGS.MSG

    This command converts an input file named MY_INPUT.DTIF, which
    has the DTIF format, to an output file named MY_OUTPUT.DDIF,
    which has the DDIF format. The specified options file is named
    MY_OPTIONS.CDA$OPTIONS, and the message file is named /MESSAGE_
    FILE=MY_MSGS.MSG.
Close Help