Invokes the CDA Viewer, which has a character-cell interface
   for viewing text files and a VMS DECwindows Motif interface for
   viewing compound documents and files containing graphics, images,
   and tabular data.

                                  NOTE

      The DEC CDA Base Services for VMS DECwindows Motif Version
      1.0 or later must be installed in order to use new versions
      of the CDA Viewer and DEC 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 DEC CDA Base Services for VMS DECwindows Motif:
   text, DDIF, and DTIF. PostScript files are also supported when
   running to displays with servers containing the Display PostScript
   Extension. Digital's CDA Converter Library provides additional
   converters that support display of other popular file formats.

   Format

   VIEW infile/FORMAT=informat

Additional information available:

ParameterExampleDVR$ Facility Messages

/FORMAT/HEIGHT/INTERFACE/OPTIONS/OUTPUT/OVERRIDE_FORMAT
/PAGE/WIDTH

infile
   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
   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.

Additional information available:

/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 DEC CDA
   Base Services for VMS DECwindows Motif and their default file
   extensions are as follows:

   Input Format     File Extension

   DDIF             .DDIF

   DTIF             .DTIF

   TEXT             .TXT

   PostScript file viewing is also supported, but only in the
   DECwindows Motif CDA Viewer and when running to displays with
   servers containing the Display PostScript Extension. To view
   a PostScript file, you must specify the /INTERFACE=DECWINDOWS
   qualifier. PostScript file viewing does not support processing
   options.

   Digital's CDA Converter Library provides additional converters
   that support display of other popular file formats. Contact your
   system manager for a complete list of input converters available
   on your system.

Additional information available:

/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.

Additional information available:

/INTERFACE

      /INTERFACE=DECWINDOWS
      /INTERFACE=CHARACTER_CELL (default)

   Specifies the type of display you are using.

Additional information available:

Domain Converter OptionsCreating the Options File

/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.

Additional information available:

COLUMN_TITLECURRENT_DATEDOCUMENT_DATEDOCUMENT_TITLE
PAGE_NUMBERPAPER_SIZEPAPER_HEIGHTPAPER_WIDTH
PAPER_TOP_MARGINPAPER_BOTTOM_MARGINPAPER_LEFT_MARGIN
PAPER_RIGHT_MARGINPAPER_ORIENTATION

   COLUMN_TITLE displays the column titles as contained in the column
   attributes centered at the top of the column.

   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.

   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.

   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.

   PAGE_NUMBER displays the current page number in the top right
   corner of the page.

   PAPER_SIZE keyword 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        13 x 254 millimeters (15.600 x 10 inches)

   9x12_ENVELOPE         12 x 229 millimeters (14.400 x 9 inches)

   BUSINESS_ENVELOPE     9.5 x 105 millimeters (11.400 x 4.13 inches)

   EXECUTIVE             10 x 191 millimeters (12.000 x 7.5 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.

   PAPER_HEIGHT value specifies a paper size other than one of the
   predefined values provided. The default paper height is 11 inches.

   PAPER_WIDTH value specifies a paper size other than one of the
   predefined sizes provided. The default paper width is 8.5 inches.

   PAPER_TOP_MARGIN value specifies the width of the margin provided
   at the top of the page. The default value is 0.25 inch.

   PAPER_BOTTOM_MARGIN value specifies the width of the margin
   provided at the bottom of the page. The default value is 0.25
   inch.

   PAPER_LEFT_MARGIN value specifies the width of the margin provided
   on the left-hand side of the page. The default value is 0.25 inch.

   PAPER_RIGHT_MARGIN value specifies the width of the margin
   provided on the right-hand side of the page. The default value
   is 0.25 inch.

   PAPER_ORIENTATION keyword 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.

   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 VMS 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 to 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.

      /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 a VMS options file is .CDA$OPTIONS.

Additional information available:

/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.

Additional information available:

/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.

Additional information available:

/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.

Additional information available:

/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.

     $ VIEW MY_INPUT.DTIF/FORMAT=DTIF /OPTIONS=MY_OPT.CDA$OPTIONS -
     _$ /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.

   The DVR$ facility messages generated by the CDA Viewer are
   described here. A brief explanation and recommended user action
   follows each message, unless a user action is not required. The
   messages are listed in alphabetical order, by message name.

                                  NOTE

      The CDA Viewer routines may also return a status defined by
      the CDA access routines (CDA$ facility messages described in
      the DCL HELP CONVERT/DOCUMENT topic).

Additional information available:

BADCOMMENTSBADINFILENAMEBADPARAMDEFAULTFONT
DRMHIERARCHYFAILDRMMAINFETCHFAILDRMPOPUPFETCHFAILDRMREGISTERFAIL
DRMSTRINGFETCHFAILEODFATALERRORFILENOTOPEN
FORMATERRORFORMATINFOFORMATWARNGRAPHICFAIL
IMAGEFAILINTERNALERRORINVADDRLOADINPROGRESSMEMALLOFAIL
MEMDEALLOFAILNODISPCONTNODPSEXTNOFONTNOPAGE
NOPSHEADNORMALOBSOLETEOPENFAILPAGENOTFOUNDTOPOFDOC
UNKOBJTYPEUNKSTRTYPE

comments wrong, ignoring them for this file
   Level: Warning

   Explanation: A PostScript file contains invalid comments. The CDA
   Viewer will continue viewing the file while ignoring the comments.
   Note that this status applies only to PostScript file viewing.

error parsing input file name
   Level: Severe

   Explanation: Improper file name passed to a routine.

   User Action: Ensure that the file name you are specifying conforms
   to the naming conventions on your operating system.

bad parameter detected
   Level: Severe

   Explanation: Invalid parameter passed to a routine.

   User Action: Ensure that you are properly calling the routine.
   Some parameters must be passed by value, and some must be passed
   by reference. Check the documentation to ensure that you are
   correctly passing the correct number of parameters.

default font
   Level: Informational

   Explanation: The CDA Viewer was unable to load a specified font,
   so it has defaulted to using a fallback font (12 point Courier).

   User Action: If you are using the CDA Viewer application, check
   for diagnostic error messages in the CDA Viewer's Diagnostic
   Information dialog box.

   If you are using the DVR callable widget interface, specify a
   callback to a viewer widget instance and look for DvrCRcdaError
   callback reasons in your callback procedure. The DvrCRcdaError
   callback reasons should specify which font the CDA Viewer cannot
   find. Determine where the DDIF file was originally created so that
   you can check for an X server, which may contain the specified
   font.

DVR routines could not open Resource Manager hierarchy, aborting
   Level: Severe

   Explanation: Attempt to open a viewer UID file has failed.

   User Action: Ensure that the proper viewer UID files are
   installed. On VMS systems, the DDIF$VIEW.UID and DDIF$VIEWWGT.UID
   files must be in the DECW$SYSTEM_DEFAULTS: directory. On ULTRIX
   systems, the DXvdoc and DXdvr files must be in the /usr/lib/X11
   /uid directory. This message does not apply to OS/2 and MS-DOS
   systems.

DVR routines could not fetch main window, aborting
   Level: Severe

   Explanation: Attempt to fetch viewer's main window from UID file
   has failed.

   User Action: Ensure that the proper viewer UID files are
   installed. On VMS systems, the DDIF$VIEW.UID and DDIF$VIEWWGT.UID
   files must be in the DECW$SYSTEM_DEFAULTS: directory. On ULTRIX
   systems, the DXvdoc and DXdvr files must be in the /usr/lib/X11
   /uid directory. This error may occur if you have an incorrect
   version of a UID file in the system area. This message does not
   apply to OS/2 and MS-DOS systems.

DVR routines could not fetch pop-up window
   Level: Severe

   Explanation: Attempt to fetch one of the CDA Viewer's popup dialog
   windows has failed.

   User Action: Ensure the proper viewer UID files are installed.
   On VMS systems, the DDIF$VIEW.UID and DDIF$VIEWWGT.UID files must
   be in the DECW$SYSTEM_DEFAULTS: directory. On ULTRIX systems, the
   DXvdoc and DXdvr files must be in the /usr/lib/X11/uid directory.
   This error may occur if you have an incorrect version of a UID
   file in the system area. This message does not apply to OS/2 and
   MS-DOS systems.

DVR routines could not register widget, aborting
   Level: Severe

   Explanation: Attempt to register a viewer widget with the Resource
   Manager failed. This will happen if the Resource Manager fails
   while trying to allocate memory to register the widget.

   User Action: Reduce the system load and try again. If the Resource
   Manager fails again, you may require a system with more memory to
   run the CDA Viewer.

DVR routines could not fetch strings, aborting
   Level: Severe

   Explanation: Attempt to fetch one of the CDA Viewer's text string
   resources has failed.

   User Action: Ensure that the proper viewer UID files are
   installed. On VMS systems, the DDIF$VIEW.UID and DDIF$VIEWWGT.UID
   files must be in the DECW$SYSTEM_DEFAULTS: directory. On ULTRIX
   systems, the DXvdoc and DXdvr files must be in the /usr/lib/X11
   /uid directory. This error may occur if you have an incorrect
   version of a UID file in the system area. This message does not
   apply to OS/2 and MS-DOS systems.

end of document
   Level: Informational

   Explanation: The end of a document has been reached. Attempts to
   move forward in a given document will not be successful.

fatal error, submit an SPR
   Level: Severe

   Explanation: Unrecoverable error.

   User Action: Check routine parameters to ensure that they are
   properly called. If everything appears normal, submit an SPR.

file is not open
   Level: Informational

   Explanation: The routine expects a file to be loaded before
   calling, that is, you must call the DvrViewerFile() routine
   before calling the DvrNextPage() routine.

   User Action: Ensure that you have called the necessary routines to
   open a file before trying to manipulate it.

formatting error in diagnostic info
   Level: Severe

   Explanation: The CDA Viewer has issued a diagnostic error message
   regarding the DDIF content of a given document.

   User Action: Using the CDA Viewer application, you can access the
   diagnostic information using the Diagnostic Information option
   under the File pulldown menu.

   If you are using the callable viewer widget, specify an activate
   callback procedure and examine the callback data upon receiving a
   DvrCRcdaError callback reason.

formatting information in diagnostic info
   Level: Informational

   Explanation: The CDA Viewer has issued a diagnostic informational
   message regarding the DDIF content of a given document.

   User Action: If you are using the CDA Viewer application, you
   can access the diagnostic information using the CDA Viewer's
   Diagnostic Information option under the File pulldown menu.

   If you are using the callable viewer widget, specify an activate
   callback procedure and examine the callback data upon receiving a
   DvrCRcdaError callback reason.

formatting warning in diagnostic info
   Level: Warning

   Explanation: The CDA Viewer has issued a diagnostic warning
   message regarding the DDIF content of a given document.

   User Action: If you are using the CDA Viewer application, you can
   access the diagnostic information using the viewer's Diagnostic
   Information option under the File pulldown menu.

   If you are using the callable viewer widget, specify an activate
   callback procedure, and examine the callback data upon receiving a
   DvrCRcdaError callback reason.

error processing graphic information, cannot display
   Level: Informational

   Explanation: The document contains nondisplayable graphic data
   that could be invalid DDIF, or that might not yet be supported by
   the CDA Viewer.

   User Action: Check the content of DDIF document using the Analysis
   output converter or the application that created the file.

error processing image information, cannot display
   Level: Informational

   Explanation: The document contains invalid image data or
   unsupported image data. Some image features are not yet supported
   by the CDA Viewer, including color mappings other than RGB and
   pixel aspect ratios other than 1:1.

   User Action: Report the problem to the party that created the
   image data. If the image data seems valid, submit an SPR.

internal program error
   Level: Severe

   Explanation: Unrecoverable CDA Viewer error.

   User Action: Check the routine parameters to ensure that they are
   properly called. If all routine parameters are correct, submit an
   SPR and provide a way to reproduce the behavior.

invalid address
   Level: Severe

   Explanation: Invalid parameter passed to a routine.

   User Action: Ensure that you are properly calling the routine.
   Some parameters must be passed by value and some must be passed
   by reference. Check the documentation to ensure that you are
   correctly passing the correct number of parameters.

load in progress
   Level: Error

   Explanation: User has attempted to load a new document before a
   previous load has completed. This status applies only to OS/2 and
   MS-DOS users using the DvrLoadFile() and DvrDisplayFirstPage()
   routines.

   User Action: Ensure that the call to the DvrLoadFile() routine
   has completed before trying to load a new file.

memory allocation failed
   Level: Severe Explanation: There is insufficient memory on your
   system to view the requested document page. User Action: Reduce
   the system load and try again. If memory allocation fails again,
   you may require a system with more memory to view the requested
   document page.

memory deallocation failed
   Level: Severe

   Explanation: The CDA Viewer's attempt to give back system memory
   has failed.

   User Action: Ensure that the system is functioning properly.

no displayable content
   Level: Informational

   Explanation: The DDIF document does not contain any displayable
   content.

   User Action: If you are using the character-cell CDA Viewer, try
   converting the file to PostScript output, or view the file with
   the windowing CDA Viewer to check whether there is content in the
   document which cannot be displayed on a character-cell device.

   If you are using the windowing CDA Viewer, check the content
   of the DDIF document using the Analysis output converter or the
   application that created the file, or check with the creator of
   the document to find an appropriate method of viewing the file.

server does not have the PostScript extension
   Level: Severe

   Explanation: Attempt to view a PostScript file on an X display
   that does not contain the Display PostScript Extension. The CDA
   Viewer requires a server with the Display PostScript Extension to
   display PostScript files. Note that this status applies only to
   viewing PostScript files.

   User Action: Set the display to a server with the Display
   PostScript Extension and retry the operation.

cannot load font
   Level: Informational

   Explanation: The CDA Viewer could not load a specified font. If an
   application created a DDIF file specifying a font that does not
   exist on the X server, the CDA Viewer will use a default font (12
   point Courier) when trying to view this file.

   User Action: If you are using the CDA Viewer application, check
   for diagnostic error messages in the CDA Viewer's Diagnostic
   Information dialog box.

   If you are using the DVR callable widget interface, specify a
   callback to a viewer widget instance and look for DvrCRcdaError
   callback reasons in your callback procedure. The DvrCRcdaError
   callback reasons should specify which font the CDA Viewer cannot
   find. Determine where the DDIF file was originally created so that
   you can check for an X server, which may contain the specified
   font.

document contains no pages
   Level: Severe

   Explanation: The document does not contain any displayable pages.
   A blank window will appear in the CDA Viewer.

   User Action: Check the content of the DDIF document using the
   Analysis output converter or the application that created the
   file.

file does not contain a Postscript header
   Level: Severe

   Explanation: Attempt to view a PostScript file that does not begin
   with the standard characters "%!". Note that this status only
   applies to PostScript file viewing.

   User Action: Modify the PostScript file to begin with the standard
   characters "%!". Or, if you are using the CDA Viewer application,
   the restriction will be turned off and you will be prompted to
   view the file again.

   If you are using the callable viewer widget, you can set the
   DvrNheaderRequired resource using the XtSetValues routine.

normal completion
   Level: Success

   Explanation: Routine completed as expected.

obsolete viewer entry point referenced
   Level: Error

   Explanation: Attempt to call an obsolete CDA Viewer entry point.

   User Action: Update your file to include currently supported CDA
   Viewer entry points.

file cannot be opened
   Level: Severe

   Explanation: File could not be opened.

   User Action: Ensure that the file is set with the correct
   protections so that it can be opened. Ensure that the network
   is up if you are accessing a file over the network. Ensure that
   the file exists.

specified page not found
   Level: Informational Explanation: The CDA Viewer cannot access the
   requested page.

attempt to move past beginning of document
   Level: Informational Explanation: The top of a document has been
   reached. Attempts to move backward in a given document will not be
   successful.

unknown internal object type
   Level: Informational

   Explanation: The document contains an unknown DDIF object type.

   User Action: Check the content of the DDIF document using the
   Analysis output converter or the application that created the
   file.

unknown internal structure type
   Level: Severe

   Explanation: The document contains an unknown DDIF structure type.

   User Action: Check the content of the DDIF document using the
   Analysis output converter or the application that created the
   file.