A script-enabled browser is required for this page to function properly.

DESFORMAT command line keyword

DESFORMAT specifies either the output format for the report, or the printer definition to use when formatting the report when DESTYPE=FILE and DESNAME=filename.

The executables that can use this keyword are:

rwbuilder yes (not recommended; overrides the DESFORMAT system parameter set in Reports Builder)
rwrun yes
rwclient yes
rwcgi yes
rwserver no
rwservlet yes
rwconverter no

Syntax

DESFORMAT=desformat

Values

Description

desformat

Any valid destination format not to exceed 1K in length. Reports Builder supports the following destination formats:

DFLT The report output is sent to a file that uses the default printer driver to format the report (for example, a PostScript driver generates PostScript output format).
DELIMITED The report output is sent to a file that can be read by standard spreadsheet utilities, such as Microsoft Excel. If you do not specify a delimiter (with the DELIMITER keyword), the default delimiter is a TAB.
DELIMITEDDATA Provides the same functionality as DELIMITED, and is used when you have problems running large volume reports with DESFORMAT=DELIMITED.

HTML

The report output is sent to a file that is in HTML format.

HTMLCSS

The report output is sent to a file that includes style sheet extensions.

PDF

The report output is sent to a file that is in PDF format and can be read by a PDF viewer, such as Adobe Acrobat. PDF output is based upon the currently configured printer for your system. The drivers for the currently selected printer are used to produce the output; you must have a printer configured for the machine on which you are running the report.

RTF

The report output is sent to a file that can be read by standard word processors (such as Microsoft Word). When you open the file in MS Word, you must choose Viewright arrowPage Layout to view all the graphics and objects in your report.

SPREADSHEET

(Command line only) The report output is sent to an HTML file that is compatible with spreadsheet applications, such as Microsoft Excel. You can generate spreadsheet output from the paper layout of reports saved in any format (rdf,jsp,xml). For more information, see About spreadsheet output.

XML

The report output is saved as an XML file. The report can be opened and read in an XML-supporting browser, or your choice of XML viewing application.

printer definition

The printer definition to use when formatting the report when DESTYPE=FILE and DESNAME=filename:

  • If MODE=BITMAP, this is the name of the printer. A value of DFLT means the default printer driver is used.

  • If MODE=CHARACTER, this is the name of a printer definition file (.prt file), such as hpl, hplwide, dec, decwide, decland, dec180, dflt,or wide. Ask your System Administrator for a list of valid printer definitions.

(Default)

Taken from the Initial Value property of the DESFORMAT system parameter (defined in Reports Builder at design time). When you run a report through Reports Builder and DESFORMAT is blank or DFLT, then the current printer driver (specified in Fileright arrowPrinter) is used. If a Printer Name has been selected, then Reports Builder defaults to PostScript output format.

Usage notes

See also

Command line keywords

Using the command line

Running a report from the command line