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

About the DST file

As an alternative to defining the distribution for a report or report section in the Distribution dialog box, you can also create a DST file and specify its name on the command line with the DESTINATION keyword to distribute the report.

Note: This method is supported for backward compatibility; the preferred and recommended method of distributing reports with the Distribution dialog box or using XML, as described in the chapter "Creating Advanced Distributions" in the Oracle Application Server Reports Services Publishing Reports to the Web manual, available on the Oracle Technology Network Oracle Reports Documentation page (http://www.oracle.com/technology/documentation/reports.html)

If a DST file is specified on the command line, the distribution that it defines overrides the distribution defined using the Distribution dialog box.

Note: if you trace report distribution to identify distribution errors, the trace file format is very similar to the DST file, so you can cut and paste to generate a DST file from the trace file.

The format of each line of a DST file is as follows:

dist_ID:output_def

where

dist_ID

is an identifier for a distribution destination.

output_def

is a series of rwrun or rwclient command line keywords that specify the distribution definition. In addition, the following keyword is valid:

 

LEVEL

specifies the scope of the distribution.

Values

REPORT means that the distribution applies to the entire report.

Header_Section means that the distribution applies to the header section only.

Main_Section means that the distribution applies to the main (body) section only.

Trailer_Section means that the distribution applies to the trailer section only.

Default

REPORT

Example

The definition in this example sends report output to an HTML file, 3 copies of the main section to a printer, and the header section to a PDF file.

;dst file (specified with the DESTINATION keyword on the command line)
DEST1: DESNAME=testdst1.HTM DESTYPE=file 
DESFORMAT=HTML COPIES=1 LEVEL=Report
DEST2: DESNAME=\\luna\2op813 DESTYPE=printer
DESFORMAT=BITMAP COPIES=3
LEVEL=Main_Section
DEST3: DESNAME=SECTION1.pdf DESTYPE=file
DESFORMAT=pdf COPIES=1
LEVEL=Header_Section

See also

About report distribution

About report sectioning and sections

Distributing a report to multiple destinations