vdoc(1)vdoc(1)Namevdoc - invokes CDA Viewer for character-cell displays
Syntaxvdoc [ -f format ] [ -O options_file ] [-r] [-w paper_width] [-h
paper_height] [-p] inputfile
Description
The vdoc command invokes the CDA Viewer that enables you to view input‐
file on a character-cell terminal. If inputfile is not specified, vdoc
reads from standard input.
Options-f format Specifies the format of inputfile and invokes an appropriate
input converter. The DDIF, DTIF and Text input converters are
provided in the UDTCDABASE and UDTCDAPGMR subsets. You can
add additional converters by other layered products. Contact
your system manager for a complete list of the input formats
supported on your system. The default format is DDIF.
-O options_file
Names the file passed to the input converter to control spe‐
cific processing options in that converter. Refer to your
documentation set for a description of converter options.
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 upper- 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 speci‐
fied format.
To specify several options for the same input or output for‐
mat, 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 for‐
mats required when specifying options.
By default, any messages that occur during processing of the
options file are written to the system standard error loca‐
tion. For those input formats that support a LOG option,
messages can be directed to a log file.
-r Specifies that the CDA Viewer is to override the format of
the document. If the -r qualifier is not specified, the CDA
Viewer retains the formatting information stored in the docu‐
ment.
-w paper_width
Specifies the paper width in units of characters. The -w
qualifier always specifies the fallback formatted document
page width to be used when the -r (override format) qualifier
is specified or when the document has no inherent format.
When used with the -p (page mode) qualifier, the display page
width is determined from the terminal and is unrelated to the
formatted page width. In nonpage mode, the specified -w value
is used for both fallback document page width and the display
page width. If the -w qualifier is not specified, the default
width is 80 characters.
-h paper_height
Specifies the paper height in units of characters. The -h
qualifier always specifies the fallback formatted document
page height to be used when the -r (override format) quali‐
fier is specified or when the document has no inherent for‐
mat. When used with the -p (page mode) qualifier, the display
page height is determined from the terminal and is unrelated
to the formatted page height. In nonpage mode, the specified
-h value is used for both fallback document page height and
the display page height. If the -h qualifier is not speci‐
fied, the default height is dependent on the document.
-p Specifies that the CDA Viewer is to pause after displaying
each page. The user can also page backward and go directly to
the top or bottom of the document. If the -p qualifier is not
specified, the CDA Viewer displays each page without pausing.
See Alsocdoc(1), dxvdoc(1X), CDA(5), cda_msg(5), DDIF(5), DTIF(5), dvr_msg(5)vdoc(1)