WRITE

Mit der Notation (rep) kann ein bestimmter Report angegeben werden, wenn ein Programm mehrere Ausgaben erzeugen soll.

Es kann ein Wert von 0 bis 31 oder ein logischer Name, der mit einem DEFINE PRINTER-Statement zugewiesen wurde, angegeben werden.

Wenn (rep) nicht angegeben wird, bezieht sich das WRITE-Statement auf den ersten Report (Report 0).

Wenn diese Druckdatei für Natural als PC definiert wird, wird der Report auf den PC heruntergeladen, siehe Beispiel 5.

Informationen, wie Sie das Format eines mit Natural erstellten Ausgabe-Reports steuern, finden Sie im Abschnitt Steuerung der Ausgabe von Daten im Leitfaden zur Programmierung.

Natural generiert für jede über ein WRITE-Statement ausgegebene Seite eine Kopfzeile. Diese Kopfzeile enthält die laufende Seitennummer, Uhrzeit und Datum. Die Uhrzeit wird zu Beginn der Programmausführung gesetzt. Die Ausgabe dieser Standard-Kopfzeile kann durch Angabe des Schlüsselwortes NOTITLE oder durch ein WRITE TITLE-Statement unterdrückt werden.

Beispiele:

• Ausgabe einer Standard-Kopfzeile:

  WRITE NAME

• Ausgabe einer eigenen Kopfzeile:

  WRITE NAME WRITE TITLE 'user-title'
  

• Ausgabe ohne Kopfzeile:

  WRITE NOTITLE NAME

Anmerkungen:

1. Wenn die NOTITLE-Option verwendet wird, gilt sie für alle DISPLAY-, PRINT- und WRITE-Statements im selben Objekt, die Daten auf denselben Report schreiben.
2. Natural prüft, wann ein Seitenvorschub erforderlich ist, bevor ein WRITE-Statement ausgeführt wird. Während der Ausführung eines WRITE-Statements werden keine neuen Seiten mit Kopf- oder Fußzeilen generiert.

Das WRITE-Statement selbst erzeugt keine Spaltenüberschriften. Wenn Sie allerdings das WRITE-Statement zusammen mit einem DISPLAY-Statement verwenden, können Sie mit der Option NOHDR des WRITE-Statements die vom DISPLAY-Statement generierten Spaltenüberschriften unterdrücken.

Die NOHDR-Option ist nur relevant, wenn das WRITE-Statement nach einem DISPLAY-Statement steht, die Ausgabe sich insgesamt über mehr als eine Seite erstreckt und die Ausführung des WRITE-Statements zur Ausgabe einer neuen Seite führt.

Ohne NOHDR-Option würden auf dieser neuen Seite die DISPLAY-Spaltenüberschriften ausgegeben, mit NOHDR werden sie dort nicht ausgegeben.

Unmittelbar nach dem WRITE-Statement können Sie auf Statement-Ebene in Klammern einzelne Session-Parameter angeben. Die Werte dieser Parameter haben dann für das betreffende Statement vor auf übergeordneter Ebene mittels GLOBALS-Kommando, SET GLOBALS- (nur im Reporting Mode) oder FORMAT-Statement gesetzten Parameterwerten.

Wenn Sie mehrere Parameter angeben, müssen Sie sie durch ein oder mehrere Leerzeichen voneinander trennen. Eine einzelne Parameterangabe darf sich nicht über zwei Sourcecode-Zeilen erstrecken.

Anmerkung:
Die hier gültigen Parameter-Einstellungen kommen nur für Variablen-Felder in Betracht und haben keine Auswirkungen auf Text-Konstanten. Wenn Sie Feldattribute für eine Text-Konstante setzen möchten, dann müssen diese explizit für dieses Element gesetzt werden; siehe Parameter-Definition auf Element-Ebene.

Siehe auch:

• Liste der Parameter

• Beispiel für die Benutzung von Parametern auf Statement- und Element-Ebene

• Beispiel 5 − WRITE-Statement mit ’=’ und Parametern auf Statement/Element-Ebene.

Siehe Feld-Positionierung im Abschnitt Formatierung der Ausgabe.

Siehe Text-, Attribut-Zuweisung, Ausgabe-Elemente im Abschnitt Formatierung der Ausgabe.

Mit der nX Notation können Sie zwischen zwei Feldern n Leerzeichen einfügen. n darf nicht 0 sein.

Beispiel:

WRITE NAME 5X SALARY

Siehe auch:

• Beispiel 2 − WRITE-Statement mit nX-, nT-Notation (weiter unten)

• Spaltenabstand − der SF-Parameter und die Notation nX (im Leitfaden zur Programmierung)

Mit der Notation nT setzen Sie Tabulatoren, d.h. die Ausgabe eines Feldes beginnt ab Spalte n. Ein Tabulator, der bereits durch eine andere Ausgabe belegt ist, darf nicht gesetzt werden.

In dem folgenden Beispiel wird das Feld NAME ab Spalte 25 und SALARY ab Spalte 50 ausgegeben:

WRITE 25T NAME 50T SALARY

Siehe auch:

• Beispiel 2 − WRITE-Statement mit nX-, nT-Notation (weiter unten)

• Tabulator-Notation nT (im Leitfaden zur Programmierung)

Mit der Notation x/y erreichen Sie, dass ein Feld x Zeilen unter der Ausgabe des letzten Statements, und zwar ab Spalte y ausgegeben wird. y darf nicht 0 sein. Eine Spalte, die in derselben Ausgabezeile bereits belegt ist, darf nicht angegeben werden.

Siehe auch Positionierungsnotation x/y (im Leitfaden zur Programmierung).

Mit der Notation T* können Sie die WRITE-Ausgabe nach der Position eines in einem vorangegangenen DISPLAY-Statement ausgegebenen Feldes (field-name) ausrichten. Es ist nicht erlaubt, auf eine bereits belegte Position zu positionieren.

Siehe auch:

• Beispiel 3 − WRITE-Statement mit Notation T* (weiter unten)

• Tabulator-Notation T*field (im Leitfaden zur Programmierung)

Mit der Notation P* können Sie die WRITE-Ausgabe nach der Position und Zeile eines in einem vorangegangenen DISPLAY-Statement ausgegebenen Feldes (field-name) ausrichten. Diese Notation wird vor allem nach DISPLAY VERTICALLY-Statements verwendet. Es ist nicht erlaubt, auf eine bereits belegte Position zu positionieren.

Siehe auch:

• Beispiel 4 − WRITE-Statement mit Notation P* (weiter unten)

• Tabulator-Notation P*field (im Leitfaden zur Programmierung)

Ein Gleichheitszeichen in Apostrophen ('=') vor einem Feld bewirkt, dass vor dem Feldwert die (im DEFINE DATA-Statement oder im DDM) für das Feld definierte Überschrift ausgegeben wird.

Siehe auch:

• WRITE-Statement mit '=', 'text', '/'

• WRITE-Statement mit '=' und Parametern auf Statement/Element-Ebene

Ein Schrägstrich (/) zwischen Feldern/Textelementen bewirkt einen Zeilenvorschub, d.h. die nachfolgenden Felder/ Textelemente werden in der nächsten Zeile ausgegeben.

Beispiel:

WRITE NAME / SALARY

Für mehrfachen Zeilenvorschub geben Sie mehrere Schrägstriche an.

Siehe auch:

• WRITE-Statement mit '=', 'text', '/' (weiter unten)

• Zeilenvorschub − die Schrägstrich-Notation (im Leitfaden zur Programmierung)

• Beispiel für Zeilenvorschub in WRITE-Statement (im Leitfaden zur Programmierung)

Der in Apostrophen stehende Text wird ausgegeben.

Beispiel:

WRITE 'EMPLOYEE' NAME 'MARITAL/STATUS' MAR-STAT

Siehe auch:

• WRITE-Statement mit '=', 'text', '/' (weiter unten)

• Text Notation, Mit einem Statement zu benutzenden Text definieren - die 'text'-Notation (im Leitfaden zur Programmierung)

Das in Apostrophen stehende Zeichen (character) wird n-mal unmittelbar vor dem Feldwert ausgegeben.

Zum Beispiel:

WRITE '*' (5) '=' NAME

führt zur Ausgabe von

***** SMITH

Siehe auch Text-Notation, Vor einem Feldwert n mal anzuzeigendes Zeichen definieren - die 'c'(n)-Notation (im Leitfaden zur Programmierung).

Es ist möglich, den auszugebenden Feldern/Texten Anzeige- und Farbattribute zuzuordnen. Diese Attribute und die zu benutzende Syntax sind im Abschnitt Ausgabeattribute weiter unten beschrieben.

Beispiele:

WRITE 'TEXT' (BGR)
WRITE 'TEXT' (B)
WRITE 'TEXT' (BBLC)

operand1 gibt das Feld an, dessen Inhalt an diese Stelle geschrieben wird.

Arrays mit Bereichen, die es ermöglichen, die Anzahl der Ausprägungen zur Ausführungszeit zu variieren, dürfen nicht angegeben werden.

Anmerkung:
Bei DL/I-Datenbanken: DL/I-AIX-Felder können nur angezeigt werden, wenn ein PCB verwendet wird, in dem die AIX im PROCSEQ-Parameter angegeben ist. Andernfalls gibt Natural zur Laufzeit eine Fehlermeldung aus.

Unmittelbar nach operand1 können Sie auf Element-Ebene in Klammern einzelne Session-Parameter setzen. Diese Parameterwerte haben dann für das betreffende Feld Vorrang vor den mit einem GLOBALS-Kommando, SET GLOBALS- (nur im Reporting Mode) oder FORMAT-Statement oder auf Statement-Ebene gesetzten Parameterwerten.

Wenn Sie mehrere Parameter angeben, müssen Sie sie durch ein oder mehrere Leerzeichen voneinander trennen. Eine Parameterangabe darf sich jeweils nicht über zwei Sourcecode-Zeilen erstrecken.

Siehe auch:

• Liste der Parameter

• Beispiel für die Parameter-Benutzung auf Statement- und Element-Ebene

Diese Option verwenden Sie, wenn Sie für die Ausgabe eine (mit dem Natural Map Editor erstellte) Map verwenden wollen.

WRITE USING MAP bedeutet nicht, dass jedesmal, wenn die Map ausgegeben wird, automatisch eine neue Seite ausgegeben wird.

Für den Zeilenabstand muss der Parameter LS um ein Byte größer gesetzt werden als die Zeilenlänge der Map.

operand1 ist der Name der zu verwendenden Map.

operand2 ist der Name des auszugebenden Feldes bzw. der auszugebenden Felder.

Ist operand1 eine Konstante und wird operand2 nicht angegeben, so werden bei der Kompilierung die Felder aus der Map-Source übernommen.

Die Felder müssen bezüglich Anzahl, Reihenfolge, Format, Länge und (bei Arrays) Anzahl der Ausprägungen mit den Feldern in de/mr referenzierten Layout/Map übereinstimmen, sonst tritt ein Fehler auf.

Die Optionen NOTITLE und NOHDR sind unter Syntax 1 des WRITE-Statements beschrieben.