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.