Nachdem wir uns im letzten Artikel mit dem IBM SQL Service GENERATE_SPREADSHEET beschäftigt haben, wenden wir uns jetzt der Funktion GENERATE_PDF zu.
Die SYSTOOL Entwicklerfunktionen
Folgende SQL Services sollen hier bzw. in den folgenden Artikeln angesprochen werden:
- GENERATE_SPREADSHEET: Daten der DB2 in ein Tabellenformat (ASCII) konvertieren
- GENERATE_PDF: Der Name spricht für sich; PDF Dokumente aus IBM i Spools erstellen
- SEND_EMAIL: Auch hier spricht der Name; Emails versenden
- LPRINTF: Nachrichten ins IBM i Joblog ausgeben
- COMPARE_IFS: IFS-Verzeichnisse miteinander vergleichen. Diese Funktion ist nicht Bestanteil der Bibliothek SYSTOOLS, sondern in QSYS2
Eine Dokumentation dieser Services finden Sie hier und hier.
GENERATE_PDF
Die Skalarfunktion GENERATE_PDF generiert im integrierten Dateisystem (IFS) eine PDF-Datei mit dem Inhalt einer Spooldatei.
Diese Funktion erfordert folgendes Produkt: 5770TS1 – Option 1 – Transform Services – AFP-zu-PDF-Transformation:
Quelle: LuttkusDie Parametrisierung von GENERATE_PDF sieht wie folgt aus:
Quelle: IBM
Quelle: LuttkusKennen Sie sich ein wenig mit den Metadaten einer Spooldatei aus, so finden Sie in diesen Parametern die üblichen Verdächtigen wieder:
- JOB_NAME: Qualifizierter Name des Jobs der die Spooldatei erzeugt hat
- SPOOLED_FILE_NAME: Name der Spooldatei
- SPOOLED_FILE_NUMBER: Nummer der Spooldatei. *LAST ist möglich
- PATH_NAME: Zielpfad für das PDF-Dokument im IFS
Aufruf der Funktion GENERATE_PDF:
Quelle: LuttkusDas Ergebnis der Funktion ist eine Ganzzahl. Bei erfolgreichem Befehl gibt die Funktion den Wert 1 zurück. Bei einem Fehler gibt die Funktion den Wert -1 zurück.
Hier sehen Sie das im IFS erzeugte PDF-Dokument.
Quelle: LuttkusInhaltliche Anzeige des Dokuments:
Quelle: LuttkusIm nächsten Artikel wenden wir uns der Funktion SEND_EMAIL zu.
Lesen Sie dazu SQL Application Services – Teil 15.02: IFS Services als Tools für den Anwendungsentwickler.
Sie erreichen den Autor unter: