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.