Textdatei in PDF-Datei konvertieren
Komponente: | CONV2PDF |
Funktionsbereich: | Dateiverarbeitung |
Anwendungsbereich: | FILE, SPOOL-PRINT-SERVICES, UTILITIES |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando CONVERT-FILE-TO-PDF konvertiert Textdateien (SAM- oder ISAM-Dateien und textbasierte Bibliothekselemente) in PDF-Dateien. Diese können dann an einem PC mit einem PDF-Viewer (z.B. Adobe Reader) bequem gelesen oder seitenweise ausdruckt werden.
In einem Kommandoaufruf kann der Benutzer auch mehrere Textdateien angegeben. Außerdem kann eine Liste von Dateien auch aus einer Listdatei oder einer CSV-Datei gelesen werden. In diesem Fall werden die Dateien nacheinander konvertiert. Die resultierenden Meldungen enthalten die entsprechende Zeilennummer. Alle Dateinamen einer Liste werden bearbeitet, auch wenn ein Fehler auftritt.
Die Ausgabe erfolgt dann entweder in einzelne PDF-Dateien oder in eine zusammengefasste PDF-Datei. Bei einer zusammengefassten PDF-Datei werden automatisch Lesemarken für die Anfangsseiten der übernommenen Textdateien gesetzt. Über weitere Parameter kann der Benutzer Inhalt und Layout der PDF-Datei direkt steuern:
Datensätze vollständig bzw. nur einen Teilbereich verarbeiten
Zeilenabstand (optional werden vorhandene Drucksteuerzeichen ausgewertet)
Seitenformat
Zeichendichte
Seitenränder
Zeichensatz
Abschneiden oder Umbrechen langer Datenzeilen
Hintergrundbild auf den PDF-Seiten
Alternativ kann der Benutzer das Layout auch über Spool-Parameter analog zum Kommando PRINT-DOCUMENT steuern.
Zu beachten ist, dass abhängig vom Layout nur eine bestimmt Anzahl von Zeichen in einer Zeile darstellbar sind. Datenzeilen, die dabei über den rechten Seitenrand hinausgehen, werden bei der PDF-Erstellung abgeschnitten oder optional umbrochen.
Die Daten in der PDF-Datei sind komprimiert. Der Dateitransfer muss im binären Modus erfolgen.
Format
CONVERT-FILE-TO-PDF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
FROM-FILE = list-poss(16): <filename 1..54 with-wild(80)> / *FROM-FILE(…) / *FROM-CSV-FILE(…) /
*LIBRARY-ELEMENT(...)
Name der zu konvertierenden Textdatei, die entweder als Datei oder Bibliothekselement vorliegt. Mit Musterzeichen oder in einer Liste können mehrere Dateien bzw. Bibliothekselemente angegeben werden. Es werden nur SAM- oder ISAM-Dateien akzeptiert (außer SAM-Dateien mit REC-FORM=U). Mit *FROM-FILE kann auch eine List-Datei angegeben werden, die die Namen der zu konvertierenden Textdateien enthält. Mit *FROM-CSV-FILE kann eine CSV-Datei angegeben werden, die die Namen der zu konvertierenden Textdateien und der Zieldateien enthält.
FROM-FILE = *FROM-FILE(…)
Die Namen der zu konvertierenden Dateien sollen aus einer List-Datei gelesen werden. Jede Zeile der List-Datei sollte genau einen (Quell-) Dateinamen enthalten. Es wird nicht zwischen Groß- und Kleinschreibung unterschieden und Leerzeichen werden ignoriert. Jeder Dateiname wird validiert und, wenn kein Fehler vorliegt, wird aus dieser Datei eine PDF-Datei erzeugt. Die PDF-Datei hat denselben Namen wie die Quell-Datei mit der Erweiterung .PDF.
Tritt ein Fehler auf, wird eine Meldung mit der Zeilennummer des aktuell verarbeiteten Dateinamens ausgegeben.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Gibt den Namen der List-Datei an.
FROM-FILE = *FROM-CSV-FILE(…)
Die Namen der zu konvertierenden Dateien sollen aus einer CSV-Datei gelesen werden. Jede Zeile der CSV-Datei enthält genau 2 Dateinamen - Quell- und Zieldatei, durch Komma oder Semikolon getrennt. Es wird nicht zwischen Groß- und Kleinschreibung unterschieden und Leerzeichen werden ignoriert. Jeder Quelldateiname wird validiert und, wenn kein Fehler vorliegt, wird eine PDF-Datei mit dem Namen der jeweiligen Zieldatei erzeugt.
Tritt ein Fehler auf, wird eine Meldung mit der Zeilennummer des aktuell verarbeiteten Dateinamens ausgegeben.
FROM-FILE = *LIBRARY-ELEMENT(...)
Das angegebene Element aus einer PLAM-Bibliothek soll konvertiert werden. Ein Element ist vollständig definiert durch seinen Namen, seinen Typ und die Version.
Die Sätze eines Elements sind bestimmten Satzarten zugeordnet. Es gibt 255 Satzarten. Es wird unterschieden zwischen Anwendersatzarten (1 bis 159) und Sondersatzarten (160 bis 255). Nur die Anwendersatzarten eines Elements können nach PDF konvertiert werden.
LIBRARY = <filename 1..54 without-vers>
Name der PLAM-Bibliothek, aus der ein Element konvertiert werden soll.
ELEMENT = <composed-name 1..64 with-under with-wild(80)>(...)
Name des Elements, das konvertiert werden soll. Mit Musterzeichen können mehrere Elemente angegeben werden.
VERSION = *HIGHEST-EXISTING / *UPPER-LIMIT /
<composed-name 1..24 with-under with-wild(40)>
Version des Elements, das ausgegeben werden soll. Voreingestellt ist *HIGHEST-EXISTING, d.h. das letzte Element in alphabetischer Reihenfolge.
Wird die Version mit Wildcards angegeben und existieren gleichnamige Bibliothekselemente in Versionen, die durch die Wildcard-Angabe betroffen sind, werden alle diese Bibliothekselemente ausgegeben.
BASE = *STD / <composed-name 1..24 with-under with-wild(40)>
Präfix für die Versionsauswahl. Im Zusammenhang mit VERSION=*HIGHEST-EXISTING kann damit die höchste Version mit einem bestimmten Präfix angesprochen werden. BASE=*STD wirkt wie BASE=*.
Näheres zur Angabe der Basis siehe Handbuch „LMS“ [21].
TYPE = <alphanum-name 1..8 with-wild (12)>
Typ des auszugebenden Bibliothekselements.
Der Name besteht bei Angabe des Typs mit Wildcards aus maximal 12 alphanumerischen Zeichen.
Hinweis
Die Sätze von LMS-Elementen der Typen C, L und R gehören zu den Sondersatzarten (160 bis 255). Darum können keine Sätze von solchen Elementen konvertiert werden.
TO-FILE =
Gibt den Namen der zu erstellenden PDF-Datei an.
TO-FILE = *BY-SOURCE
Der Name einer erstellten PDF-Datei besteht aus dem Namen der entsprechenden Textdatei (Datei- oder Elementname) und dem Suffix „.PDF“. Wenn ein ungültiger Dateiname entsteht, wird das Kommando zurückgewiesen.
TO-FILE = *CONCATENATE(...)
Alle angegebenen Textdateien (Dateien oder Elemente) sollen in einer PDF-Datei zusammengefasst werden. Jede Textdatei beginnt dabei auf einer neuen Seite.
TO-FILE = <filename 1..54 without-gen>
Name der PDF-Datei.
BOOKMARK =
Steuert das Setzen von Lesemarken in der PDF-Datei.
BOOKMARK = *BY-SOURCE
Die Anfangsseiten der Textdateien erhalten jeweils eine Lesemarke mit dem Namen der Textdatei (Datei- oder Elementname).
BOOKMARK = *NONE
Unterdrückt das Setzen von Lesemarken.
BOOKMARK = list-poss(16): <filename 1..54 with-wild-constr(80)>
Die Anfangsseiten der Textdateien erhalten jeweils eine Lesemarke mit den explizit angegebenen Namen. Bei Angabe einer Liste werden die Namen in der angegebenen Reihenfolge als Lesemarken gesetzt. Bei Angabe einer Konstruktionszeichenfolge werden die Lesemarken entsprechend zu der im Operanden FROM-FILE bzw. ELEMENT-NAME angegebenen Musterzeichenfolge gebildet.
TO-FILE = list-poss(16): <filename 1..54 without-gen-vers with-wild-constr(80)>(...)
Gibt den Namen der PDF-Datei(en) explizit an. Wenn bei FROM-FILE bzw. ELEMENT-NAME Musterzeichen angegeben sind, kann für die PDF-Dateien eine
Konstruktionszeichenfolge angegeben werden.
Für Bibliothekselemente ist voreingestellt, dass der angegebene Name zusätzlich einen Suffix mit dem Typ und der Version des Elements erhält (Format: <to-file>.<version>.<type>).
In den folgenden Operanden lässt sich die Erstellung dieses Suffix optional steuern:
WITH-VERSION = *STD / *YES / *NO
Wird nur für Bibliothekselemente ausgewertet:
Gibt an, ob der Suffix die Elementversion enthalten soll. Mit *STD ist *YES voreingestellt.
WITH-TYPE = *STD / *YES / *NO
Wird nur für Bibliothekselemente ausgewertet:
Gibt an, ob der Suffix den Elementtyp enthalten soll. Mit *STD ist *YES voreingestellt.
WRITE-MODE = *CREATE / *REPLACE-ONLY / *ANY
Bestimmt den Schreibmodus für die zu erstellenden PDF-Dateien.
Voreingestellt ist *CREATE, d.h. die Datei wird neu erstellt. Für eine bereits existierende Datei wird das Kommando abgewiesen.
WRITE-MODE = *REPLACE-ONLY
Die Ausgabedatei muss bereits existieren und wird bei der Konvertierung überschrieben. Wenn die Datei noch nicht existiert, wird das Kommando abgewiesen.
WRITE-MODE = *ANY
Die Ausgabedatei wird neu erstellt. Eine bereits existierende Datei wird überschrieben.
FILE-FORMAT = *STD / *SAM / *PAM
Bestimmt das Dateiformat der PDF-Datei.
FILE-FORMAT = *STD
Verwendet das Dateiformat, das in der Parameterdatei SYSPAR.CONV2PDF festgelegt ist. Die Parameterdatei wird an den folgenden Ablageorten gesucht (Suche in der angegebenen Reihenfolge):
Benutzerkennung des Aufrufers
Benutzerkennung TSOS
Falls keine Parameterdatei gefunden wird, gilt FILE-FORMAT=*SAM.
FILE-FORMAT = *SAM
Die PDF-Datei wird im Dateiformat SAM mit REC-FORM=U erstellt.
FILE-FORMAT = *PAM
Die PDF-Datei wird im Dateiformat PAM mit BLOCK-CONTROL=NO erstellt. In diesem Dateiformat kann die PDF-Datei auch als Node-File erstellt werden.
PRESENTATION = *DIRECT-PARAMETERS(...) / *SPOOL-PARAMETERS(...)
Vereinbart das Layout der PDF-Datei. Voreingestellt ist die direkte Angabe der Layout-Eigenschaften. Alternativ kann das Layout über die Angabe von Spool-Parametern (analog zur Druckausgabe) bestimmt werden.
PRESENTATION = *DIRECT-PARAMETERS(...)
Gibt das Layout der PDF-Datei direkt an.
RECORD-PART = *ALL / *PARAMETERS(...)
Vereinbart, ob die Datensätze der Textdatei vollständig oder nur ein bestimmter Teil jedes Satzes verarbeitet werden soll.
Mit der Voreinstellung *ALL werden die Datensätze vollständig verarbeitet.
RECORD-PART = *PARAMETERS(...)
Gibt an, welcher Teil der Datensätze verarbeitet werden soll. Es wird nur der angegebene Teilbereich bei der PDF-Konvertierung berücksichtigt. Mit dieser Angabe können z.B. der ISAM-Schlüssel oder Steuerzeichen in der PDF-Datei weggelassen werden.
FIRST-CHARACTER = 1 / <integer 2..32767>
Ermöglicht die Angabe einer Byte-Nummer (Satzspalte), ab der die Datensätze einer Datei auszugeben sind. Die Bytes eines Datensatzes sind von links nach rechts – mit 1 beginnend – durchnummeriert; ISAM-Schlüssel und Steuerzeichen sind Bestandteile eines Datensatzes.
LAST-CHARACTER = *STD / <integer 1..32767>
Diese Angabe bezeichnet das letzte Byte, das von jedem Datensatz noch verarbeitet werden soll.
LINE-SPACING = 1 / 2 / 3 / *BY-EBCDIC-CONTROL(...) / *BY-IBM-CONTROL(...) / *BY-ASA-CONTROL(...)
Bestimmt die Anzahl der Zeilenvorschübe bzw. die Art der Steuerzeichenauswertung.
LINE-SPACING= 1 / 2 / 3
Die Datensätze sollen mit 1 / 2 / 3 Zeilen Abstand ausgedruckt werden.
LINE-SPACING = *BY-EBCDIC-CONTROL(...) / *BY-IBM-CONTROL(...) / *BY-ASA-CONTROL(...)
Der Inhalt des Datenbytes, das als Vorschubsteuerzeichen ausgewertet wird, soll als EBCDIC-, IBM- oder ASA-Vorschubsteuerzeichen interpretiert werden (siehe Kommando PRINT-DOCUMENT).
CONTROL-CHAR-POS = *STD / <integer 1..2040>
Nummer des Datenbytes, das als Vorschubsteuerzeichen ausgewertet wird. Bei Datensätzen variabler Länge werden die Felder, in denen die Länge steht, nicht zu den Daten gerechnet, d.h. nicht mitgezählt.
PAGE-SIZE = *A4 / *A4-LANDSCAPE / *A3 / *A3-LANDSCAPE / *A5 / *A5-LANDSCAPE /
*PARAMETERS(...)
Bestimmt das Seitenformat der PDF-Datei:
Operandenwert | DIN-Format | Breite x Höhe (mm) |
|---|---|---|
*A4 | DIN-A4 | 210 x 297 |
*A4-LANDSCAPE | DIN-A4 quer | 297 x 210 |
*A3 | DIN-A3 | 297 x 420 |
*A3-LANDSCAPE | DIN-A3 quer | 420 x 297 |
*A5 | DIN-A5 | 148 x 210 |
*A5-LANDSCAPE | DIN-A5 quer | 210 x 148 |
*PARAMETERS(...) | benutzerspezifisch | max. 2040 x 2040 |
PAGE-SIZE = *PARAMETERS(...)
Gibt explizit Breite und Höhe einer PDF-Seite an.
WIDTH = <integer 2..2040>
Gibt die Seitenbreite in mm an.
HEIGHT = <integer 2..2040>
Gibt die Seitenhöhe in mm an.
MARGINS = *PARAMETERS(...)
Definiert die Abstände zu den Seitenrändern.
LEFT = 20 / <integer 0..2040>
Gibt den Abstand zum linken Seitenrand in mm an.
RIGHT = 20 / <integer 0..2040>
Gibt den Abstand zum rechten Seitenrand in mm an. Datenzeilen, die über den rechten Seitenrand hinausgehen, werden abhängig von der Angabe im Operanden LINE-TRUNCATION abgeschnitten oder umbrochen.
TOP = 20 / <integer 0..2040>
Gibt den Abstand zum oberen Seitenrand in mm an.
BOTTOM = 20 / <integer 0..2040>
Gibt den Abstand zum unteren Seitenrand in mm an.
DENSITY = *PARAMETERS(...)
Definiert die Zeilendichte.
LINES-PER-INCH = 6 / <integer 3..24>
Anzahl Zeilen, die pro Zoll ausgegeben werden sollen.
FONT = *PARAMETERS(...)
Bestimmt die zu verwendende Schriftart.
NAME = *COURIER / *HELVETICA / *TIMES
Gibt den Namen der Schrift an.
CHARACTER-STYLE = *NORMAL / *BOLD / *ITALIC / *BOLD-ITALIC
Gibt den Schriftstil an (normal, halbfett, kursiv oder halbfett und kursiv).
SIZE = 8 / <integer 1..72>
Gibt die Schriftgröße in Punkt (pt) an.
LINE-TRUNCATION = *YES / *NO
Gibt an, ob Datenzeilen, die über den rechten Seitenrand hinausgehen, abgeschnitten werden (siehe auch Festlegung des rechten Seitenrands im Operanden MARGINS). Voreingestellt ist *YES, d.h. längere Datenzeilen werden abgeschnitten. Wenn Datenzeilen abgeschnitten werden, wird nach der Konvertierung eine entsprechende Meldung ausgegeben.
LINE-TRUNCATION = *NO
Längere Datenzeilen werden umbrochen. Der Zeilenumbruch erfolgt mit dem Wort, das über den Seitenrand hinausgeht. Dabei ist ein Wort eine Zeichenfolge, die von Leer-, Satz- oder Sonderzeichen begrenzt wird.
OVERLAY = *NONE / *PARAMETERS(...)
Gibt an, ob ein Hintergrundbild verwendet werden soll.
OVERLAY = *PARAMETERS(...)
Die PDF-Seiten sollen ein Hintergrundbild enthalten.
FROM-FILE = <filename 1..54 without-gen-vers>
Datei, die das Hintergrundbild enthält.
FRAME = *PAGE / *TEXT / *CUSTOM(...)
Bestimmt den Rahmen, in dem das Hintergrundbild positioniert wird.
FRAME = *PAGE
Das Hintergrundbild wird innerhalb der physikalischen Seite positioniert (bestimmt durch die Angaben im Operanden PAGE-SIZE).
FRAME = *TEXT
Das Hintergrundbild wird innerhalb des Textrahmens positioniert (bestimmt durch die Angaben im Operanden MARGINS).
FRAME = *CUSTOM(...)
Definiert einen Rahmen über die Abstände zu den Seitenrändern. Dieser Rahmen ist unabhängig vom Textrahmen. Die voreingestellten Werte entsprechen aber den Voreinstellungen in den Operanden PAGE-SIZE und MARGINS.
LEFT = 0 / <integer 0..2040>
Gibt den Abstand zum linken Seitenrand in mm an.
RIGHT = 0 / <integer 0..2040>
Gibt den Abstand zum rechten Seitenrand in mm an.
TOP = 0 / <integer 0..2040>
Gibt den Abstand zum oberen Seitenrand in mm an.
BOTTOM = 0 / <integer 0..2040>
Gibt den Abstand zum unteren Seitenrand in mm an.
HORIZONTAL-ALIGNMENT = *LEFT / *RIGHT / *CENTER
Bestimmt die horizontale Ausrichtung des Bildes innerhalb des Rahmens.
HORIZONTAL-ALIGNMENT = *LEFT
Das Bild wird ausgerichtet zur linken Seite des Rahmens.
HORIZONTAL-ALIGNMENT = *RIGHT
Das Bild wird ausgerichtet zur rechten Seite des Rahmens.
HORIZONTAL-ALIGNMENT = *CENTER
Das Bild wird horizontal zentriert im Rahmen.
VERTICAL-ALIGNMENT = *TOP / *BOTTOM / *CENTER
Bestimmt die vertikale Ausrichtung des Bildes innerhalb des Rahmens.
VERTICAL-ALIGNMENT = *TOP
Das Bild wird nach oben ausgerichtet.
VERTICAL-ALIGNMENT = *BOTTOM
Das Bild wird nach unten ausgerichtet.
VERTICAL-ALIGNMENT = *CENTER
Das Bild wird vertikal zentriert im Rahmen.
SCALE = *UNCHANGED
Bestimmt die Größe des Bildes.
Voreingestellt ist *UNCHANGED, d.h. die Bildgröße wird nicht verändert.
SCALE = *FIT-HEIGHT
Das Bild wird auf die Höhe des Rahmens skaliert.
SCALE = *FIT-WIDTH
Das Bild wird auf die Breite des Rahmens skaliert.
SCALE = *FIT-FRAME
Das Bild wird auf die Höhe und Breite des Rahmens skaliert. Wenn die Größenverhältnisse von Rahmen und Bild voneinander abweichen, kann das Bild verzerrt dargestellt werden.
PRESENTATION = *SPOOL-PARAMETERS(...)
Gibt Spool-Parameter an, die das Layout der PDF-Datei (analog zur Druckausgabe mit dem Kommando PRINT-DOCUMENT) steuern.
RECORD-PART = *ALL / *PARAMETERS(...)
Vereinbart, ob die Datensätze der Textdatei vollständig oder nur ein bestimmter Teil jedes Satzes verarbeitet werden soll.
Mit der Voreinstellung *ALL werden die Datensätze vollständig verarbeitet.
RECORD-PART = *PARAMETERS(...)
Gibt an, welcher Teil der Datensätze verarbeitet werden soll. Es wird nur der angegebene Teilbereich bei der PDF-Konvertierung berücksichtigt. Mit dieser Angabe können z.B. der ISAM-Schlüssel oder Steuerzeichen in der PDF-Datei weggelassen werden.
FIRST-CHARACTER = 1 / <integer 2..32767>
Ermöglicht die Angabe einer Byte-Nummer (Satzspalte), ab der die Datensätze einer Datei auszugeben sind. Die Bytes eines Datensatzes sind von links nach rechts – mit 1 beginnend – durchnummeriert; ISAM-Schlüssel und Steuerzeichen sind Bestandteile eines Datensatzes.
LAST-CHARACTER = *STD / <integer 1..32767>
Diese Angabe bezeichnet das letzte Byte, das von jedem Datensatz noch verarbeitet werden soll.
LINE-PER-PAGE = *STD / <integer 1..32767>
Legt fest, wie viel Zeilen (einschließlich Leerzeilen) auf eine Seite auszugeben sind.
LINE-PER-PAGE = *STD
Wird kein Angabe gemacht, errechnet sich die Zahl der Zeilen pro Seite nach folgender Formel:
Zeilenanzahl = P * Z - A - 6
Dabei bedeuten:
P = Papiergröße in Zoll
Z = Zeilendichte
A = Anzahl der Zeilen vor erstem Vertikaltabulator „Kanal 1“
Ist der bei dem Operanden LINE-PER-PAGE angegebene Wert größer als die angegebene Zeilenanzahl im Loop, wird der im Loop vorgegebene Wert genommen.
LINE-SPACING = 1 / 2 / 3 / *BY-EBCDIC-CONTROL(...) / *BY-IBM-CONTROL(...) / *BY-ASA-CONTROL(...)
Bestimmt die Anzahl der Zeilenvorschübe bzw. die Art der Steuerzeichenauswertung.
LINE-SPACING= 1 / 2 / 3
Die Datensätze sollen mit 1 / 2 / 3 Zeilen Abstand ausgedruckt werden.
LINE-SPACING = *BY-EBCDIC-CONTROL(...) / *BY-IBM-CONTROL(...) / *BY-ASA-CONTROL(...)
Der Inhalt des Datenbytes, das als Vorschubsteuerzeichen ausgewertet wird, soll als EBCDIC-, IBM- oder ASA-Vorschubsteuerzeichen interpretiert werden (siehe Kommando PRINT-DOCUMENT).
CONTROL-CHAR-POS = *STD / <integer 1..2040>
Nummer des Datenbytes, das als Vorschubsteuerzeichen ausgewertet wird. Bei Datensätzen variabler Länge werden die Felder, in denen die Länge steht, nicht zu den Daten gerechnet, d.h. nicht mitgezählt.
FORM-NAME = *STD / <alphanum-name 1..6>
Bestimmt über die Angabe des Formulars das Seitenformat der PDF-Datei. Die Spool-Parameterdatei muss ein Standardformular für den Druckertyp HP-90 enthalten.
Mit der Voreinstellung *STD wird das Standardformular STD für den im Operanden PRINTER-TYPE angegebenen Druckertyp verwendet.
FORM-NAME = <alphanum-name 1..6>
Name des Formulars. Abhängig vom Operanden ROTATION wird entweder der normale Loop oder der Loop für Seitendrehung aus der Formulardefinition verwendet.
Implizit wird mit der Formularangabe ein Loop benannt. Der zugeordnete Loop muss in der Druckersteuerdatei $SYSSPOOL.PRFILE enthalten sein.
Der über den FORM-NAME-Operanden implizit benannte Loop wird ignoriert, wenn zugleich der Operand LOOP-NAME angegeben wird.
Mit FORM-NAME=*STD und LOOP-NAME=*STD wird mit dem für den angegebenen Druckertyp eingetragenen Standardformular gearbeitet.
Formulare werden mit dem Dienstprogramm SPSERVE erstellt. Das Kommando SHOW-SPOOL-FORMS zeigt Informationen über Formulare an.
LOOP-NAME = *STD / <alphanum-name 1..3>
Name des Loops, der in den Vorschubinformationspuffer (VFB) geladen werden soll. Der Loop-Name darf die Zeichen ’$’, ’&’ und ’@’ nicht enthalten.
Mit der Voreinstellung *STD wird der Standard-Loop des Formulars für den angegebenen Druckertyp verwendet.
Loops sind gespeichert in der Druckersteuerdatei PRFILE. Erstellt und verwaltet werden sie mit dem Dienstprogramm PRM.
LOOP-NAME = <alphanum-name 1..3>
Name des Loops, der den Vorschub steuern soll. Die Länge des angegebenen Loops muss mit der Länge des Standard-Loops des verwendeten Formulars übereinstimmen. Entsprechend der Angabe im Operanden PRINTER-TYPE wird aus der PRFILE ein Loop für LP- HP-Drucker ausgewählt.
CHARACTER-SET = *STD / <alphanum-name 1..3>
Name des Fonts, der für die Konvertierung zu verwenden ist.
Als Schriftart wird immer Courier verwendet. Es weden nur die Font-Eigenschaften WEIGHT und CHARACTER-STYLE für die PDF-Konvertierung ausgewertet.
Die folgende Tabelle zeigt den daraus resultierenden Schriftstil (siehe Operand CHARACTER-STYLE bei den Direktparametern):
Font-Eigenschaft WEIGTH= | Font-Eigenschaft CHARACTER-STYLE= | |
|---|---|---|
*ITALICS | anderer Wert | |
*BOLD | *BOLD-ITALICS | *BOLD |
anderer Wert | *ITALICS | *NORMAL |
Mit der Voreinstellung *STD wird der Standardfont für den angegebenen Druckertyp verwendet. Er kann mit SHOW-SPOOL-FORMS abgefragt werden.
Fonts werden mit dem Dienstprogramm SPSERVE erstellt. Das Kommando SHOW-SPOOL-CHARACTER-SETS zeigt Informationen über Fonts an.
PRINTER-TYPE = *HP90-PRINTER / *HP-PRINTER / *LP-PRINTER
Bestimmt über den Druckertyp, welches Formular für die PDF-Konvertierung verwendent werden soll.
PRINTER-TYPE = *HP90-PRINTER
Es wird das Formular für HP90-Drucker verwendet.
PRINTER-TYPE = *HP-PRINTER
Es wird das Formular für HP-Drucker verwendet.
PRINTER-TYPE = *LP-PRINTER
Es wird das Formular für LP-Drucker verwendet.
LEFT-MARGIN = 20 / <integer 0..2040>
Der Ausgabetext soll vom linken Seitenrand um die angegebene Anzahl Millimeter eingerückt werden. Voreingestellt ist eine Einrückung von 20 Millimetern.
ROTATION = *NO / *YES
Gibt an, ob Seitendrehung ausgeführt werden soll.
ROTATION = *NO
Seitendrehung wird nicht ausgeführt. Eventuell in der Datei vorhandene Steuerzeichen für Seitendrehung werden nicht ausgewertet. Der Loop für die Konvertierung bestimmt sich wie folgt:
Bei expliziter Angabe eines Loops im Operanden LOOP-NAME wird der angegebene Loop verwendet.
Wenn kein Loop angegeben wurde (entspricht LOOP=*STD), wird die Formular-Definition ausgewertet:
Wenn im Operanden FORM ein Formular angegeben wurde, wird der für VERTICAL-CONTROL definierte Loop verwendet.
Wenn kein Formular angegeben wurde (entspricht FORM=*STD), wird das Standardformular für den entsprechenden Druckertyp (siehe Operand PRINTER-TYPE) ausgewertet und der für VERTICAL-CONTROL definierte Loop verwendet.
ROTATION = *YES
Seitendrehung wird ausgeführt. Dabei werden in der Datei vorhandene Steuerzeichen für Seitendrehung ausgewertet. Der Loop für die Konvertierung bestimmt sich wie folgt:
Bei expliziter Angabe eines Loops im Operanden LOOP-NAME wird der angegebene Loop verwendet.
Wenn kein Loop angegeben wurde (entspricht LOOP=*STD), wird die Formular-Definition ausgewertet:
Wenn im Operanden FORM ein Formular angegeben wurde, wird der für ROTATION-CONTROL definierte Loop verwendet.
Wenn kein Formular angegeben wurde (entspricht FORM=*STD), wird das Standardformular für den entsprechenden Druckertyp (siehe Operand
PRINTER-TYPE) ausgewertet und der für VERTICAL-CONTROL definierte Loop verwendet.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung / garantierte Meldungen |
|---|---|---|---|
0 | CMD0001 | Kommando ohne Fehler ausgeführt | |
1 | CMD0202 | Syntax- oder Semantikfehler im Kommando |
Hinweis
Zur Konvertierung wird das CCS der angegebenen Datei verwendet. Wenn kein dateispezifisches CCS definiert ist, wird das für die Benutzerkennung festgelegte CCS verwendet. Ohne benutzerspezifisches CCS wird das systemglobal festgelegte CCS verwendet.
Es werden nur Zeichen aus dem CCS dargestellt, die auch in der Windows Code Page WCP1252P enthalten sind (siehe Handbuch „XHCS“ [51]).
Beispiel zur Verwendung des Operanden OVERLAY
Das folgende Bild zeigt 4 Beispiele von PDF-Seiten, bei denen das Hintergrundbild draft.jpg verwendet wurde:
(1) | Positioniert das Hintergrundbild draft.jpg in der Originalgröße (70 x 70 mm) in die Seitenmitte. Angabe im Operanden OVERLAY: OVERLAY=*PAR(FROM-FILE=DRAFT.JPG, FRAME=*PAGE, HORIZONTAL-ALIGNMENT=*CENTER, VERTICAL-ALIGNMENT=*CENTER) |
(2) | Positioniert das Hintergrundbild draft.jpg in Originalgröße rechts oben in einen benutzerspezifisch definierten Rahmen. Der Rahmen ist quadratisch (130 x 130 mm) und beginnt links oben auf der DIN-A4-Seite. Angabe im Operanden OVERLAY: OVERLAY=*PAR(FROM-FILE=DRAFT.JPG, FRAME=*CUSTOM(LEFT=0,RIGHT=80,TOP=0,BOTTOM=167), HORIZONTAL-ALIGNMENT=*RIGHT, VERTICAL-ALIGNMENT=*TOP) |
(3) | Positioniert das Hintergrundbild draft.jpg in denselben benutzerspezifisch definierten Rahmen wie im Beispiel 2. Das Bild wird hier auf die Rahmengröße skaliert. Da die Seitenverhältnisse des Rahmens denen des Bildes entsprechen, tritt keine Verzerrung auf. Angabe im Operanden OVERLAY: OVERLAY=*PAR(FROM-FILE=DRAFT.JPG, FRAME=*CUSTOM(LEFT=0,RIGHT=80,TOP=0,BOTTOM=167), SCALE=*FIT-FRAME) |
(4) | Positioniert das Hintergrundbild draft.jpg in den Textrahmen und skaliert das Bild auf die Rahmengröße. Bei einer DIN-A4 Seite mit jeweils 20 mm Abstand ist der Textrahmen 170 mm breit und 257 mm hoch. Da diese Seitenverhältnisse nicht denen des Bildes entsprechen, tritt hier eine entsprechende Verzerrung auf. Angabe im Operanden OVERLAY: OVERLAY=*PAR(FROM-FILE=DRAFT.JPG, FRAME=*TEXT, SCALE=*FIT-FRAME) |