Free Form Format |
DEVELOPER |
 |
Free Form Format
The free-form format can be up to 134 bytes long. Within that total length, each field can be any length and is delimited by a comma. If there is no value for a given field, the field is delimited by a comma except that trailing empty fields can be omitted entirely. The position of each field within the free-form format is the same as its position in the fixed-form.
For example, the following string has an empty position, a device name, four empty positions, and a Y to specify that detail lines are to be suppressed. Because the remaining fields are not present, they are considered empty.
,PRT_DEVICE_5,,,,,Y
For detailed explanations of the spooler options, see Overrideable $SPOOL Fields.
Overrides to report or update options via @RPTOPT are not permanent; they only affect the function as it is executed from a specific terminal or task. If the contents of @RPTOPT are changed while a specific function is executing, those changes will affect the next report function to be executed. PROIV nulls @RPTOPT after it is executed from a specific function.
PROIV activates @RPTOPT at the start of function execution. If the contents of @RPTOPT are changed while a function is executing, those changes will affect the next report function to be executed.
The following table lists the fields within Report/Update Options ($SPOOL) that you can override along with the character position in the 90 character @RPTOPT system variable. If you do not wish to use some of the fields, fill the appropriate positions with blanks. (See Device Types )
Overrideable $SPOOL Fields
|
Option Number |
Option Description |
Fixed Length Substring Position |
|
1 |
Device Type (left justified) |
1-2 |
|
2 |
Report Device Name |
3-10 |
|
3 |
Form ID |
11-18 |
|
4 |
Number of Copies (Supported on Mainframe only.) |
19-21 |
|
5 |
Create Hold File (Supported on Mainframe only.) |
22 |
|
6 |
Release Terminal (Supported on Mainframe only.) |
23 |
|
7 |
Suppress Detail (Fields) |
24 |
|
8 |
Suppress Page Header |
25 |
|
9 |
Suppress First Line |
26 |
|
10 |
Suppress Page skip at start (First F-Feed) |
27 |
|
11 |
Unused |
28 |
|
12 |
Grouping of reports (Group Output) |
29 |
|
13 |
(Supported on Mainframe only.) |
30-90 |
 |
Note: Some PROIV versions ignore the Device Type specified above, while application functions use them. Thus, application functions that use those Device types may not be portable across all PROIV platforms. |
Topic ID: 730060