1 VIEW
Invokes the CDA Viewer, which has a character-cell interface for
viewing text files and an DECwindows Motif for OpenVMS interface
for viewing compound documents and files containing graphics,
images, and tabular data.
NOTE
The CDA Base Services for DECwindows Motif for OpenVMS
must be installed to use new versions of the CDA Viewer and
CDA Base Services converters.
Specify the input file name and format as shown below. The
default input file format is DDIF (DIGITAL Document Interchange
Format). DDIF is a standard format for the storage and
interchange of compound documents, which can include text,
graphics, and images.
DDIF is the format in which the CDA Viewer displays all input
files. When the CDA Viewer processes a non-DDIF file for display,
it invokes the converter for the input file format you specify.
The input file is converted to DDIF, and the resulting output is
displayed.
The CDA Viewer displays file formats supported by converters
installed with the CDA Base Services for DECwindows Motif
for OpenVMS: text, DDIF, and DTIF. PostScript files are no
longer supported. VSI's CDA Converter Library provides additional
converters that support display of other popular file formats. If
you have the CDA Converter Library Version 2.2 or later installed
on your system, see HELP CDA_Converters for more information.
Format
VIEW [input-file]
2 Parameter
input_file
Specifies the name of the file to be viewed. If you do not
specify an input file name, you are prompted for one. You
cannot use the asterisk (*) and the percent sign (%) wildcard
characters in the file specification.
The default input file format is DDIF, and the default file type
is DDIF. Valid input file formats are any of those for which
there is an input converter installed on the system.
2 Qualifiers
/FORMAT
/FORMAT=fmt-name
/FORMAT=DDIF (default)
Specifies the format of your input file. The input formats that
you can use with the CDA Viewer depend on the CDA converters
installed on your system. The default input format is DDIF. Input
formats supported by converters installed with the CDA Base
Services for DECwindows Motif for OpenVMS and their default file
extensions are as follows:
Input Format File Extension
DDIF .DDIF
DTIF .DTIF
TEXT .TXT
VSI's CDA Converter Library provides additional converters that
support display of other popular file formats. If you have the
CDA Converter Library Version 2.2 or later installed on your
system, see HELP CDA_Converters for more information, or contact
your system manager for a complete list of input converters
available on your system.
/HEIGHT
/HEIGHT=nn
Specifies the height of the page in number of characters. If
you specify the /OVERRIDE_FORMAT qualifier, or if the document
being viewed has no inherent format, this page height is used.
On the DECwindows Motif display, the default height is 66 lines,
which is equivalent to the default page height of 11 inches.
On character cell displays, the page height defaults to your
terminal's screen height. However, if you use the /OUTPUT
qualifier, the page height depends on the page height of your
document.
/INTERFACE
/INTERFACE=DECWINDOWS
/INTERFACE=CHARACTER_CELL (default)
Specifies the type of display you are using.
/OPTIONS
/OPTIONS=options-filename
Specifies a text file that contains processing options applied
to the input file while it is processed for display. The default
file extension for an options file is .CDA$OPTIONS.
/OUTPUT
/OUTPUT=output-filename
/NOOUTPUT (default)
Specifies a file that you want to receive the output instead of
having it displayed on the screen. You cannot use this qualifier
when you have specified the /INTERFACE=DECWINDOWS qualifier.
If you specify /OUTPUT but you do not specify a file name, the
CDA Viewer creates a file with the same name as your input
file but with a file type of LIS. If you specify the /OUTPUT
qualifier, you cannot also specify the /PAGE qualifier.
/OVERRIDE_FORMAT
/OVERRIDE_FORMAT
/NOOVERRIDE_FORMAT (default)
Controls whether the CDA Viewer overrides the format of your
document or uses the formatting information stored in your
document.
/PAGE
/PAGE
/NOPAGE (default)
On a character cell terminal, this qualifier determines whether
the output display of the CDA Viewer pauses after displaying
each page of your file. If you specify the /PAGE qualifier,
you can page backward and forward, or jump to the top or
bottom of the document. Note that if you specify the /PAGE
qualifier, you cannot specify either the /OUTPUT qualifier or
the /INTERFACE=DECWINDOWS qualifier.
/WIDTH
/WIDTH=nn
Specifies the number of characters per line. If you specify the
/OVERRIDE_FORMAT qualifier, or if the document being viewed has
no inherent format, this page width is used. On the DECwindows
Motif display, the default width is 85 characters, which is
equivalent to the default page width of 8.5 inches. On character
cell displays, the page width defaults to your terminal's screen
width. However, if you use the /OUTPUT qualifier, the default is
132 columns.
2 Domain_Converter_Options
When you view a tabular input file (for example, a DTIF file),
the file format first undergoes an automatic domain conversion
from a table format to the DDIF format. The output is then
displayed on your screen.
To help ensure minimal format and content changes when the
tabular file is processed for display, you can create an options
file containing processing options that apply to any CDA-
supported tabular file format. Data tables and spreadsheets are
examples of tabular file formats.
In the options file, type the DTIF_TO_DDIF format name, followed
by the processing options described here. Specify the DTIF_TO_
DDIF processing options in addition to the processing options for
a particular tabular input file format.
3 COLUMN_TITLE
COLUMN_TITLE displays the column titles as contained in the
column attributes centered at the top of the column.
3 CURRENT_DATE
CURRENT_DATE displays the current date and time in the bottom
left corner of the page. The value is formatted according to the
document's specification for a default date and time.
3 DOCUMENT_DATE
DOCUMENT_DATE displays the document date and time as contained
in the document header in the top left corner of the page. The
value is formatted according to the document's specification for
a default date and time.
3 DOCUMENT_TITLE
DOCUMENT_TITLE displays the document title or titles as contained
in the document header centered at the top of the page, one
string per line.
3 PAGE_NUMBER
PAGE_NUMBER displays the current page number in the top right
corner of the page.
3 PAPER_SIZE_keyword
PAPER_SIZE specifies the size of the paper to be used when
formatting the file. Valid values for the size argument are as
follows:
Keyword Size
A0 841 x 1189 millimeters (33.13 x 46.85 inches)
A1 594 x 841 millimeters (23.40 x 33.13 inches)
A2 420 x 594 millimeters (16.55 x 23.40 inches)
A3 297 x 420 millimeters (11.70 x 16.55 inches)
A4 210 x 297 millimeters (8.27 x 11.70 inches)
A5 148 x 210 millimeters (5.83 x 8.27 inches)
A 8.5 x 11 inches
B 11 x 17 inches
B4 250 x 353 millimeters (9.84 x 13.90 inches)
B5 176 x 250 millimeters (6.93 x 9.84 inches)
C 17 x 22 inches
C4 229 x 324 millimeters (9.01 x 12.76 inches)
C5 162 x 229 millimeters (6.38 x 9.02 inches)
D 22 x 34 inches
DL 110 x 220 millimeters (4.33 x 8.66 inches)
E 34 x 44 inches
10x13_ENVELOPE 10 x 13 inches
9x12_ENVELOPE 9 x 12 inches
BUSINESS_ENVELOPE 4.13 x 9.5 inches
EXECUTIVE 7.5 x 10 inches
LEDGER 11 x 17 inches
LEGAL 8.5 x 14 inches
LETTER 8.5 x 11 inches
LP 13.7 x 11 inches
VT 8 x 5 inches
The A paper size (8.5 x 11 inches) is the default.
3 PAPER_HEIGHT_value
PAPER_HEIGHT specifies a paper size other than one of the
predefined values provided. The default paper height is 11
inches.
3 PAPER_WIDTH_value
PAPER_WIDTH specifies a paper size other than one of the
predefined sizes provided. The default paper width is 8.5
inches.
3 PAPER_TOP_MARGIN_value
PAPER_TOP_MARGIN specifies the width of the margin provided at
the top of the page. The default value is 0.25 inch.
3 PAPER_BOTTOM_MARGIN_value
PAPER_BOTTOM_MARGIN specifies the width of the margin provided at
the bottom of the page. The default value is 0.25 inch.
3 PAPER_LEFT_MARGIN_value
PAPER_LEFT_MARGIN specifies the width of the margin provided on
the left-hand side of the page. The default value is 0.25 inch.
3 PAPER_RIGHT_MARGIN_value
PAPER_RIGHT_MARGIN specifies the width of the margin provided on
the right-hand side of the page. The default value is 0.25 inch.
3 PAPER_ORIENTATION_keyword
PAPER_ORIENTATION specifies the paper orientation to be used in
the output file. The valid values for the orientation argument
are as follows:
Keyword Meaning
PORTRAIT The page is oriented so that the larger dimension
is parallel to the vertical axis.
LANDSCAPE The page is oriented so that the larger dimension
is parallel to the horizontal axis.
The default is PORTRAIT.
2 Creating_the_Options_File
You can create an options file prior to specifying the VIEW
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. Processing options help ensure minimal format
and content changes while the CDA Viewer processes your input
file for display.
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 this format, where format
is the name of the file format to which the option applies and
option is the option:
format option [value] applies an input 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:
DTIF_TO_DDIF PAPER_HEIGHT 11
The value specified for PAPER_HEIGHT is in inches by default.
If the options file includes options that do not apply to
the converter for a particular file format, 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.
2 Example
$ VIEW MY_INPUT.DTIF/FORMAT=DTIF/OPTIONS=MY_
OPT.CDA$OPTIONS /NOOUTPUT -
_$ /NOPAGE /INTERFACE=DECWINDOWS /OVERRIDE_
FORMAT /WIDTH=80 /HEIGHT=66
This command invokes the CDA Viewer to view a file named MY_
INPUT.DTIF, which has the DTIF format. The display interface
is DECwindows Motif, and the CDA Viewer will override the
document's default format. The display width will be 80
characters, and the display height will be 66 lines.