Previous Topic

Next Topic

Book Contents

Book Index

report

Start a report definition.

The REPORT commands starts up a report definition. It defines the output file, report width and other basic parameters.

General format

report [COLUMNS = number_of_columns] -


[,EDIT_STRING = "edit_string"] -
[,FILL_TO_WIDTH]
[,LINES = lines_per_page] -
[,NOPAGINATION] -
[,NOJUSTIFICATION] -
[,OUTPUT = file_name] -
[,SRCARG = "parameter"] -
[,SRCRTN = routine_name] -
[,SRCSHR = image_name] -
[,TITLE = "string/string/..."]

Examples

report title="Funded usage/between",columns=80

Qualifiers

columns = number_of_columns (default = 80)

The columns specification defines the total width of a report. Any width can be specified. Typical values are 80 or 132. Edit_string supplies the format to print the field value in. Please refer to the section describing all the various elements of an edit string.

fill_to_width

If a print declaration is narrow enough then this option will cause the data to be printed across until the line is full. Once the line is full a new line is started.

lines = lines_per_page (default = SYS$LP_LINES)

Lines specifies the number of lines to print per page. This is typically 55. To create a system wide value define a logical of the name SYS$LP_LINES.

nopagination

By specifying this option all page breaks and page headings are suppressed.

nojustification

All reports are normally left and right justified. By specifying this option right justification is suppressed. Each line begins at the left margin.

output = file_name (default = REPORT.LIS)

The output specification supplies the name of the output file to use. To get the report directly on your terminal, use SYS$OUTPUT as the file name. This name can be prompted for.

srcarg = "parameter"

The SRCARG option provides additional information that can be used by the database handler routine. Refer to the definition of the specific database handler for more details.

srcrtn = routine_name

The SRCRTN defines the name of the database handler contained in the sharable image defined by SRCSHR.

srcshr = image_name

The SRCSHR defines the sharable image in which the database handler is located.

title = "string/string/..."

Title establishes the heading for this report. Several lines can be defined, with each line separated by a "/" slash.

See Also

Field breaks

end

print

print (no data)

select

sort