Pre Convert Method Name

The name of the Method to be executed immediately after the converter has been selected as the output device and before the Report is generated.

Defined by global: #OOFPDF1.PRE-CONV-METHOD
Required or optional: optional
Maximum size: 8
Default value: none
Must be Source type “M”, Basic Method

REMARKS

The Pre Convert Method is executed immediately after the printer configured for the Report-IV to PDF converter is selected as the output device and before the Report is generated and converted. This provides a mechanism to customize settings in #OOFPDF1 on a report-by-report basis without having to modify existing application Scripts or 3GL programs.

When called the following information is passed to the Pre Convert Method:

PDFC$[0] set by Pre Convert Method to indicate if the Report should continue or if some error condition has been encountered.

PDFC$[0]=“.” Indicates no errors, Report-IV should continue processing.

PDFC$[0]=“” Indicates an error has occurred. The default error message (help module OOER139) will be displayed. The user will be prompted to select another printer.

PDFC$[0]=“h” + help module name. Indicates an error has occurred. Instead of displaying the default help module (OOER139), the supplied help module will be displayed. The user will be prompted to select another printer.

PDFC$[1] = 8 byte Report-IV definition name
PDFC$[2] = 40 byte Report-IV definition description
PDFC$[3] = Terminal date (#IDSV.TERMINAL-DATE)
PDFC$[4] = System date (DAY)
PDFC$[5] = File Suffix (#IDSV.FILE-SUFFIX)

The Report-IV to PDF run time environment can be accessed by including the global format: FORMAT INCLUDE #OOFPDF1, OPT=“NONE”.

The method is only called when #OOFPDF1.ENABLE-PRE-METHOD = “Y”.

See Example 4 in the Examples - Report-IV section of this manual.

From the Report-IV to PDF Installation and User Guide, version 8.9.1. Open this page in the PDF