REPORT$
- Purpose
- Provides controls over the reports to be run, output destination and other operational parameters for Report-IV.
- Used By
- CONNECT REPORT from a method.
Contents
| REPORT$[0] | Return status: | |
|---|---|---|
| “R” | On input indicates a report is being selected. | |
| “.” | On output indicates normal termination. | |
| REPORT$[1] | Report library name. A two-character library name. | |
| REPORT$[2] | From Report. | |
| REPORT$[3] | To Report. | |
| REPORT$[4] | Mask for report range. | |
| REPORT$[5] | Sort number. | |
| REPORT$[6] | Report device: | |
| “Y” | Select printer prompt. | |
| null | Ask hard copy question. | |
| “N” | Terminal output only. | |
| “LP” | Printer name. | |
| “Pn” | Printer name. | |
| “OP” | Use operator default printer. | |
| “SP” | Use last printer opened by operator. | |
| “CH:nn” | Use channel nn for output. | |
| “/file-name” | Create or overwrite output to this file name. Garbage may exist after output text. | |
| “CR” | Report is connected from another report. | |
| [1] | Report name (LLRRRR). | |
| [2] | X$ not returned. | |
| [3] | H$ returned to calling report. | |
| [4] | T$ returned to calling report. | |
| REPORT$[7] | Type of output: | |
| “P” | ||
| space | ||
| “W” | WRITE | |
| “R” | WRITERECORD | |
| “N” | No output | |
| REPORT$[8] | Report mode: | |
| “D” | Print detail lines only (D, CTnn, STnn, CBnn). Header and footer lines will not be printed. | |
| “ “ | Normal printing will be done. | |
| REPORT$[9] | Method to execute prior to printing each report detail line. | |
| REPORT$[10] | Window name for a user-supplied window. |
The parameters described above are made available to the report through X$, as shown in the table below. Within the report definition, say, in the ENTRY SECTION, you can use Thoroughbred Basic code to evaluate X$ as required.
For example, to determine the sort number from REPORT$[5], evaluate X$(49,2).
| REPORT[XX] | [1] | [2] | [3] | [4] | [5] | [6] | [7] | [8] | [9] |
|---|---|---|---|---|---|---|---|---|---|
| X$(m,n) | (5,2) | (7,6) | (72,6) | (78,6) | (49,2) | (68,2) | (65,1) | (64,1) | (51,12) |
When CONNECT REPORT is called from a menu or data name the parameters are supplied in a comma-separated string.
For example:
CONNECT REPORT OERNAME,,,2,NExecutes the report RNAME from library OE, using sort number 2 and putting the result straight to the terminal. This directive will populate REPORT$ as follows: