Diese Anweisung beschreibt die seitengerechte Gestaltung der Ausgabedatei.
Die SET-PAGE-LAYOUT-Anweisung kann entfallen, wenn in der ASSIGN-OUTPUT-FILE-Anweisung FILE=*SYSOUT bzw. FILE=*SYSLST oder wenn eine SET-GROUP-ATTRIBUTES-Anweisung angegeben wurde. In diesen Fällen wird eine Aufbereitung entsprechend der Standardwerte durchgeführt (siehe "Aufbereiten von Sätzen oder Blöcken").
Beziehen sich in einem Konvertierungsschritt mehrere SET-PAGE-LAYOUT-Anweisungen auf den gleichen Dateikettungsnamen, wird für diesen Dateikettungsnamen nur die zuletzt gegebene Anweisung ausgeführt.
Beim Aufbereiten einer Ausgabe für SYSOUT werden folgende Zeilen nicht berücksichtigt:
Kopfzeilen (unabhängig von der Angabe im Operanden HEADER-LINE)
Leerzeilen
Benutzerzeilen (unabhängig von der Angabe im Operanden USER-LINE)
Beim Aufbereiten eines Ausgabesatzes werden die in ihm enthaltenen Steuerzeichen X'00' bis X'3F' behandelt. Dies kann vom Benutzer durch den Operanden REPLACE-CONTROL-CHAR unterdrückt werden, wenn er z.B. selbst Steuerzeichen zur Druckersteuerung in den Satz einfügt.
SET-PAGE-LAYOUT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OUTPUT-LINK-NAME =
Dateikettungsnamen der Ausgabedateien, auf die sich diese Anweisung beziehen soll.
OUTPUT-LINK-NAME = *STD
Diese Anweisung bezieht sich auf alle bisher angegebenen Ausgabedateien.
OUTPUT-LINK-NAME = list-poss(2000): <filename 1..8 without-gen>
Soll sich die Anweisung nur auf einige Ausgabedateien beziehen, müssen die Dateikettungsnamen dieser Dateien angegeben werden.
HEADER-LINE =
Kopfzeile, die pro Seite ausgegeben wird.
HEADER-LINE = *STD
Beim Kopieren von Dateien: HEADER-LINE=*PAGE-COUNTER Beim Editieren von Bändern: HEADER-LINE=*TITLE
HEADER-LINE = *NONE
PERCON gibt keine Kopfzeile aus.
HEADER-LINE = *PAGE-COUNTER
Der Text PAGE xxxxxx wird pro Seite in Zeile 1, Spalte 119 eingefügt. xxxxxx ist der aktuelle Stand des Seitenzählers.
HEADER-LINE = *TITLE
PERCON gibt eine Standard-Kopfzeile in Zeile 1 aus.
|
|
|
|
|
|
OUTPUT-AREA =
Definiert über FIRST-LINE und LAST-LINE die Anfangs- und Endezeile eines Zeilenbereichs pro Druckseite, in den PERCON die Ausgabesätze ausgibt. Es können mehrere solcher Zeilenbereiche pro Druckseite definiert werden.
Mit diesem Operand kann die Kopfzeile überschrieben werden.
OUTPUT-AREA = *LINE-RANGE (...)
Der Zeilenbereich wird festgelegt.
FIRST-LINE = 5 / <integer 1..112>
Anfangszeile für die Datenausgabe.
LAST-LINE = 66 / <integer 1..112>
Endezeile für die Datenausgabe.
SPACING = 0 / <integer 0..3>
Anzahl der Leerzeilen, die nach jeder Druckzeile ausgegeben werden.
OUTPUT-FORMAT =
Ausgabeformat der auszugebenden Daten.
OUTPUT-FORMAT = *STD
Beim Kopieren von Dateien: OUTPUT-FORMAT = *CHARACTER
Beim Editieren von Bändern: OUTPUT-FORMAT = *BOTH
OUTPUT-FORMAT = *CHARACTER
Die Daten werden als Zeichen ausgegeben. Nicht abdruckbare Zeichen werden nur dann durch Leerzeichen ersetzt, wenn REPLACE-CONTROL-CHAR=*YES gilt und keine von XHCS gelieferte Tabelle der druckbaren Zeichen verfügbar ist.
OUTPUT-FORMAT = *HEXADECIMAL
Die Daten werden in sedezimaler Form ausgegeben.
OUTPUT-FORMAT = *BOTH
Die Daten werden in sedezimaler Form ausgegeben. Abdruckbare Zeichen werden zusätzlich in einer zweiten Zeile über den entsprechenden Sedezimalverschlüsselungen ausgegeben. Nicht abdruckbare Zeichen werden nur dann durch Leerzeichen ersetzt, wenn REPLACE-CONTROL-CHAR=*YES gilt und keine von XHCS gelieferte Tabelle der druckbaren Zeichen verfügbar ist. Es werden demnach von jedem Ausgabesatz (bzw. jedem Teil desselben, wenn er länger als die Zeile ist, siehe Operand LINE-SIZE) zwei Datenzeilen belegt.
LINE-SIZE = *STD / <integer 1..204>
Anzahl der Zeichen des aufzubereitenden Satzes, die pro Zeile auszugeben sind. Dadurch kann ein Ausgabesatz auf mehrere Zeilen aufgeteilt werden. Neben dem Operand LINE-SIZE bestimmen die Operanden COLUMN-SIZE und OUTPUT-FORMAT die Länge einer Ausgabezeile.
Haben die aufzubereitenden Sätze variables Satzformat, wird auch das Satzlängenfeld ein Teil der auszugebenden Daten.
Am Anfang jeder Zeile wird zusätzlich ein Vorspann ausgegeben, dessen Länge in folgender Weise vom gewählten Ausgabemedium und der ausgewählten Funktion abhängt.
Funktion | Ausgabedatei | |
SYSLST, katalogisierte Datei | SYSOUT | |
Datei kopieren | kein Vorspann | 9 Zeichen |
Band editieren | 21 Zeichen | 9 Zeichen |
COLUMN-SIZE = *LINE-SIZE / <integer 1..204>
Anzahl der Zeichen des Ausgabesatzes, die zu einer Gruppe zusammenzufassen und durch Leerzeichen von der nächsten Gruppe zu trennen sind.
COLUMN-SIZE = *LINE-SIZE
Es erfolgt keine Aufteilung in Gruppen.
SUPPRESS-EQUAL-LINES =
Beeinflusst das Ausdrucken von Zeilen eines Satzes mit gleichem Inhalt. Die letzte Zeile eines aufbereiteten Satzes wird immer ausgegeben, unabhängig von der Belegung des Parameters SUPPRESS-EQUAL-LINES.
SUPPRESS-EQUAL-LINES = *YES
Folgen zwei oder mehr identische Zeilen aufeinander, wird die sich wiederholende Zeile nur einmal ausgedruckt. Es folgt in der nächsten Zeile der Text
’xxxxxx IDENTICAL LINES SUPPRESSED’,
wobei xxxxxx die Anzahl der Zeilen mit gleichem Inhalt angibt.
SUPPRESS-EQUAL-LINES = *NO
Es werden alle, auch sich wiederholende Zeilen, ausgegeben.
REPLACE-CONTROL-CHAR =
Regelt die Steuerzeichenbehandlung für die Druckersteuerung.
REPLACE-CONTROL-CHAR = *YES
Die Steuerzeichen X ́00 ́ bis X ́3F ́ in den Ausgabesätzen werden durch Leerzeichen ersetzt, wenn entweder das Subsystem XHCS nicht aktiv ist oder wenn bei aktivem XHCS die Ausgabedatei keinen CCSN besitzt.
Ist das Subsystem XHCS aktiv und hat die Ausgabedatei einen CCSN, so wird die XHCS-Tabelle der druckbaren Zeichen für dieses CCS zum Ersetzen herangezogen.
REPLACE-CONTROL-CHAR = *NO
In den Ausgabesätzen sind Zeichen enthalten, die nicht verändert werden sollen.
Auf nichtdruckbare Zeichen wird nicht geprüft. Zeichen werden nicht durch andere ersetzt.
USER-LINE =
Gibt Kennwörter und Literale an bestimmten Seitenpositionen aus. Kopfzeile und Zeilenbereiche, die durch den Operand OUTPUT-AREA festgelegt wurden, können überschrieben werden.
USER-LINE = *NONE
Es werden keine Benutzerzeilen ausgegeben.
USER-LINE = *RECORD-LENGTH(...)
LINK-NAME = <filename 1..8 without-gen>
Dateikettungsname der Ein-/Ausgabedatei oder des Eingabebandes, deren (dessen) aktuelle Satzlänge man in der Benutzerzeile verwenden will.
Dargestellt als 8-stellige Dezimalzahl.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die die Satzlänge geschrieben wird.
OUTPUT-COLUMN = <integer 1..197>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
OUTPUT-LENGTH = *STD / <integer 1..32>
Länge des Ausgabefeldes. Die Voreinstellung *STD entspricht der Länge 8.
USER-LINE = *BLOCK-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Dateikettungsname des Eingabebandes, dessen aktuellen Blockzählerwert man in der Benutzerzeile verwenden will. Dargestellt als 8-stellige Dezimalzahl.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die der Wert des Blockzählers geschrieben wird.
OUTPUT-COLUMN = <integer 1..197>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
OUTPUT-LENGTH = *STD / <integer 1..32>
Länge des Ausgabefeldes. Die Voreinstellung *STD entspricht der Länge 8.
USER-LINE = *BYTE-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Dateikettungsname der Ein-/Ausgabedatei oder des Eingabebandes, deren (dessen) aktuellen Bytezählerwert man in der Benutzerzeile verwenden will.
Dargestellt als 10-stellige Dezimalzahl.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die der Wert des Bytezählers geschrieben wird.
OUTPUT-COLUMN = <integer 1..195>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
OUTPUT-LENGTH = *STD / <integer 1..32>
Länge des Ausgabefeldes. Die Voreinstellung *STD entspricht der Länge 10.
USER-LINE = *RECORD-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Dateikettungsname der Ein-/Ausgabedatei, deren aktuellen Satzzählerwert man in der Benutzerzeile verwenden will. Dargestellt als 8-stellige Dezimalzahl.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die der Wert des Satzzählers geschrieben wird.
OUTPUT-COLUMN = <integer 1..197>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
OUTPUT-LENGTH = *STD / <integer 1..32>
Länge des Ausgabefeldes. Die Voreinstellung *STD entspricht der Länge 8.
USER-LINE = *PAGE-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Dateikettungsname der Ausgabedatei, deren aktuellen Seitenzählerwert man in der Benutzerzeile verwenden will.
Dargestellt als 6-stellige Dezimalzahl.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die die Seitennummer geschrieben wird.
OUTPUT-COLUMN = <integer 1..199>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
OUTPUT-LENGTH = *STD / <integer 1..32>
Länge des Ausgabefeldes. Die Voreinstellung *STD entspricht der Länge 6.
USER-LINE = *DATE(...)
Datum des Startes des PERCON-Konvertierungsschrittes als 8-stellige Zeichenfolge im Format jj-mm-tt.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die das Datum geschrieben wird.
OUTPUT-COLUMN = <integer 1..197>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
CENTURY = *NO / *YES
Bei der Angabe von CENTURY=*YES wird das Datum als 10-stellige Zeichenfolge mit der Angabe des Jahrhunderts im Format jjjj-mm-tt ausgegeben. Damit verringert sich der Maximalwert für OUTPUT-COLUMN um 2.
USER-LINE = *TIME(...)
Uhrzeit des Startes des PERCON-Konvertierungsschrittes als 8-stellige Zeichenfolge im Format hh:mm:ss.
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die die Uhrzeit geschrieben wird.
OUTPUT-COLUMN = <integer 1..197>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
USER-LINE =<c-string 1..204 with-low>(...)
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die die Zeichenkonstante geschrieben wird.
OUTPUT-COLUMN = <integer 1..204>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.
USER-LINE =<x-string 1..408>(...)
OUTPUT-LINE = <integer 1..112>
Nummer der Zeile, in die die Zeichenkonstante geschrieben wird.
OUTPUT-COLUMN = <integer 1..204>
Anfangsposition des Ausgabefeldes bezogen auf den Anfang der Benutzerzeile.