Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

7.29.1 DEF_REPORT Parameters

COPIES

FORMSIZE

FORMTYPE

LAST_LINE

...

RET_OVERF

RET_PAGE

RET_WIDTH


REPORT_NUM

Specifies the report which is to be defined by this command. A function can produce up to 8 reports at one time. Each report is identified by a number in the range 1 to 8. The default value for this report is report number 1.


PRT_FILE

IBM i use only

Specifies the name and library of residence of the IBM i printer file that should be used to produce this report.

...

When a printer file is specified, spool file User Data must be specified in the printer file or, for RDMLX, the OTHER_OVR parameter.


FORMSIZE

Specifies the length and width of the form that the report is to be produced on.

...

Otherwise, nominate the length and width of the form on which the report is to be produced.


LAST_LINE

Specifies the last line upon which report detail lines (DEF_LINE and DEF_BREAK lines) should be allowed to be printed.

...

Otherwise, specify the last print line number required.


OVERFLOW

Specifies overflow line number to be used for the report. No print line (no matter what type) can be printed beyond the overflow line on a report.

...

Info
titleNote
Report footlines can only be defined on lines beyond the last print line and up to and including the overflow line. Thus if LANSA shipped values are used, report footlines can only be defined on lines 58 to 60.
OUTQ

Specifies the output queue name for the spooled output file. Note that library name cannot be specified for the OUTQ parameter.

...

*FILE indicates that the number of copies should be taken from the default value for the printer file.


FORMTYPE

Specifies the type of forms used in the printer for the report. If a form type other than the default is used, the system (when the output is produced) sends a message that identifies the form type to the system operator and requests that the specified type of forms be put in the printer.

*FILE indicates that the form type should be taken from the default value for the printer file.


OTHER_OVR

Additional IBM i printer file override options can be specified in this parameter, for example HOLD(*YES). Refer to the IBM Control Language Reference Manuals for additional overrides. The following overrides cannot be specified in this parameter as they are already handled within the DEF_REPORT command:

FILE

LVLCHK   - (specified as *NO)

TOFILE

SECURE   - (specified as *NO)

OVRFLOW   

SHARE    - (specified as *NO)

OUTQ       

PAGESIZE - (on the IBM i)

FORMTYPE  

COPIES

*NONE indicates that there are no additional overrides.

Info
titleNote
This parameter allows entry of additional printer file overrides which rely heavily on IBM i features - this must be taken into consideration when future use on other platforms may be likely.
RET_LENGTH

Specifies whether the form length should be returned into the field named in the parameter. The field must be defined as a numeric field.

*NONE indicates that the form length will not be returned.


RET_WIDTH

Specifies whether the form width should be returned into the field named in the parameter. The field must be defined as a numeric field.

*NONE indicates that the form width will not be returned.


RET_OVERF

Specifies whether the overflow value for the printer file should be returned into the field named in the parameter. The field must be defined as a numeric field.

*NONE indicates that the overflow value will not be returned.


RET_LINE

Specifies whether the current line number for the printer file should be returned into the field named in the parameter. The field must be defined as a numeric field.

*NONE indicates that the current line number will not be returned.


RET_PAGE

Specifies whether the current page number should be returned to the field named in the parameter. The field must be defined as a numeric field.

...