Die Funktion textReport.startReport() übergibt die Steuerung des Druckens vom Textberichthandler an die Java™-Berichtsengine. Sie müssen Werte für alle Argumente angeben. Setzen Sie das Schlüsselwort null an jeder Position ein, an der Sie den Standardwert akzeptieren möchten. Diese Argumente überschreiben alle Standardwerte oder Werte, die von der Konstruktorfunktion festgelegt wurden (siehe TextReport-Variable erstellen).
Als Ergebnis der Funktion textReport.startReport() ruft die Engine keine Funktionen im Handler auf. Header werden gedruckt, nachdem die Funktion textReport.outputToReport() aufgerufen wurde (siehe outputToReport()).
Die Signatur der Funktion unterscheidet sich leicht bei einer COBOL-Generierung und einer Java-Generierung. Bei der COBOL-Generierung wird das Argument 'topOfForm' nicht verwendet, weil Sie einen Bericht nicht direkt an einen Drucker senden können.
textReport.startReport(
fileName STRING? in,
topMargin INT? in,
bottomMargin INT? in,
leftMargin INT? in,
rightMargin INT? in,
pageLength INT? in,
topOfForm STRING? in)
| Plattform | Ziel |
|---|---|
| z/OS Batch, IMS BMP | In der JCL definierter DD-Name |
| CICS | Name einer Übergangsdatei |
| IMS/VS | Warteschlangenname |
Im folgenden Beispiel wird der Berichterstellungsprozess gestartet. Dabei werden alle Standardwerte akzeptiert, mit Ausnahme des Namens der Ausgabedatei und des Zeichens zum Springen an den Anfang eines Formulars (das Standard-ASCII-Zeichen für den Formularvorschub, 0x0C, wird angegeben). Da das Verzeichnistrennzeichen unter Windows dasselbe ist wie das Escapezeichen in EGL, müssen Sie einen doppelten Backslash verwenden, um Verzeichnisnamen zu trennen, oder Sie müssen einen Schrägstrich verwenden, den Java in den entsprechenden Separator für die logische Plattform übersetzt.
myReport TextReport = new TextReport();
...
myReport.startReport("C:/temp/reportFile.txt",
null, null, null, null, null, "\u000C");