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 DEC CDA Base Services for DECwindows Motif for OpenVMS must be installed 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 DECwindows Motif for OpenVMS: 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. 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 DEC 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 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. 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 DVR$_Facility_Messages 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). 3 BADCOMMENTS 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. 3 BADINFILENAME 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. 3 BADPARAM 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. 3 DEFAULTFONT 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. 3 DRMHIERARCHYFAIL 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 OpenVMS 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. 3 DRMMAINFETCHFAIL 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 OpenVMS 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. 3 DRMPOPUPFETCHFAIL 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 OpenVMS 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. 3 DRMREGISTERFAIL 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. 3 DRMSTRINGFETCHFAIL 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 OpenVMS 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. 3 EOD 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. 3 FATALERROR 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 and you have a support contract, contact your Digital account representative. Otherwise, contact your Digital account representative or your authorized reseller. 3 FILENOTOPEN 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. 3 FORMATERROR 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. 3 FORMATINFO 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. 3 FORMATWARN 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. 3 GRAPHICFAIL 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. 3 IMAGEFAIL 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, and you have a support contract, contact your Digital account representative. Otherwise, contact your Digital account representative or your authorized reseller. 3 INTERNALERROR 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, and you have a support contract, contact your Digital account representative. Otherwise, contact your Digital account representative or your authorized reseller. 3 INVADDR 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. 3 LOADINPROGRESS 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. 3 MEMALLOFAIL 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. 3 MEMDEALLOFAIL 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. 3 NODISPCONT 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. 3 NODPSEXT 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. 3 NOFONT 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. 3 NOPAGE 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. 3 NOPSHEAD 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. 3 NORMAL normal completion Level: Success Explanation: Routine completed as expected. 3 OBSOLETE 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. 3 OPENFAIL 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. 3 PAGENOTFOUND specified page not found Level: Informational Explanation: The CDA Viewer cannot access the requested page. 3 TOPOFDOC 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. 3 UNKOBJTYPE 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. 3 UNKSTRTYPE 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. 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.