Toolmaker Produkt-Dokumentation
pdflib
Inhaltsübersicht
Volltextsuche
Verwendung und Konfiguration
Grundlegende Information
Aus dem Produktportfolio der Firma PDFLib unterstützen wir drei Komponenten zum Einsatz auf IBM i:
- PDFLib (+PDI)
- PDFLib: Erzeugen von PDF-Dokumenten
- PDI: Import von PDF-Dokumenten
- PLOP (Linearisierung, Optimierung, Sicherheit und Digitale Signaturen für PDF)
- TET (Text Extraction Tool)
Aktuelle Version
| PDFLib inkl. PDI | 10.0.0 | Freigegeben am 2022-08-11 | PDI wird über einen eigenen Lizenzcode freigeschaltet |
| PLOP | 4.10 | Freigegeben am 2015-07-30 | Die native-RPG-Schnittstelle ist auf Version 4.1 eingefroren. Neuere Versionen sind nur direkt über PASE verwend- und ansprechbar |
| TET | 5.30 | Freigegeben am 2022-08-11 | Ab IBM i V7R2M0 |
Wichtige Informationen vom Hersteller
- Für die Produkte pdflib und tet stellt der Hersteller native RPG-Schnittstellen in einer eigenen Bibliothek zur Verfügung
- Für plop stand dieser Service bis zur Version 4.10 zur Verfügung. Ab Version 5 kann man die plop-Funktionen noch über das Kommandozeilen-tool (Befehl
strsh) ansprechen.
Weitere Information über die Verwendung von pdflib-Produkten auf IBM i auf der Hersteller-Website: https://www.pdflib.com/de/dokumentation/aix-binaries-fuer-iseries/.
Installationsvoraussetzungen
- IBM i mindestens Version 7.2
- IBM i Option "Portable App Solutions Enviroment" (PASE), in IBM i Version 7 ist es die Option 33
Die bei Ihnen installierte Version können sie ermitteln:
| PDFLib | Mit dem Befehl |
| PLOP | Mit dem Befehl WRKLIB PLOPLIB, Auswahl 5 die Objekte in der Bibliothek tragen die Versionsnummer in der Beschreibung |
| TET | Mit dem Befehl WRKLIB TETLIB, Auswahl 5 die Objekte in der Bibliothek tragen die Versionsnummer in der Beschreibung |
Software-Downloads
Aktuelle Version
Die aktuelle Version wird als PC .exe-Datei auf der Toolmaker Homepage zur Verfügung gestellt:
https://www.toolmaker.de/downloads/software-downloads/
Installation
Erst-Installation und Aktualisierung
Die Installation und Aktualisierung erfolgt über den Toolmaker PC-Installer.
Änderungen an den pdflib-APIs möglich
Von Release zu Release kann es passieren, dass pdflib-APIs geändert oder entfernt werden. Bitte prüfen Sie vor einer Aktualisierung, ob Ihre Programme davon betroffen sind!
Details dazu finden Sie auf der Seite Neuerungen pdflib, plop und tet. Die Seite enthält auch links auf die entsprechenden pdflib-Handbücher mit detaillierten Auflistungen der betroffenen APIs.
Bibliotheken und IFS-Verzeichnisse (bei der Datensicherung berücksichtigen)
| Komponente | Bibliothek | IFS-Pfad |
| PDFLib | PDFLIB | /pdflib/pdflib |
| PLOP | PLOPLIB | /pdflib/plop |
| TET | TETLIB | /pdflib/tet |
Weitere Dokumentation zu PDFLib
Weitere Informationen zu den drei Produkten, pdflib, plop und tet, finden Sie auf hier: pdflib Dokumentation.
Fehlersuche und -behebung für PDFLib
Versionen und Kompatiblität
PDFlib
| Version | Veröffentlicht | Lauffähig ab IBM i | Kompatibel mit IBM i V7R4 | Hinweise |
|---|---|---|---|---|
| 10.0.0 | 2022-Mrz | V7R2 | ja | |
| 9.3.1 | 2021-Apr | V7R2 | ja | |
| 9.2.0 | 2019-Apr | V5R4 | ? | falls erforderlich, das download-link bei der Hotline anfragen: hotline@toolmaker.de |
Hinweise zur Lizenzierung
Sie erhalten von uns einen Lizenzcode. Dieser muss entweder in einer Lizenzdatei hinterlegt werden oder er wird bei jedem Programmaufruf mit gegeben.
Der Lizenzcode ist versions-abhängig
Der Lizenzcode ist - neben den üblichen IBMi Systemwerten - auch von der Produktversion abhängig: für unterschiedliche Versionen von pdflib gibt es unterschiedliche Lizenzcodes (auf derselben IBMi ).
Geben Sie deshalb beim Anfordern des Lizenzkeys auch die pdflib-Version an, die Sie installiert haben.
Für die Plattform IBM i gibt es zwei Möglichkeiten
- Übergabe des Lizenzschlüssels beim Aufruf von pdflib aus einem RPG-, Cobol- oder C-Programm
- Speichern in einer Lizenzdatei
Je nachdem, welche Art gewählt wurde, muss entweder die Programmquelle oder die Lizenzdatei geprüft werden.
Übergabe beim Aufruf (Programmquelle prüfen)
| Programmierspache | Aufruf |
|---|---|
| ILE-RPG | c callp PDF_set_option(p:%ucs2('license=...Ihr Lizenzschlüssel...') |
| C |
hier können an Stelle des Lizenzschlüssels selbst auch Pfad und Name der Lizenzdatei (s. unten) angegeben werden. |
| Cobol | analog zum RPG-Aufruf |
Speichern in einer Lizenzdatei
- Die Lizenzdatei muss in ASCII codiert sein.
- Sie benötigt zwei Zeilen für das Produkt und den Lizenzschlüssel.
- Zeilen, die mit einem #-Zeichen beginnen, werden als Kommentare angesehen und bei der Verarbeitung ignoriert.
# Lizenzinformation für Produkte der PDFlib GmbH PDFlib license file 1.0 PDFlib 9.1.0 ...Ihr Lizenzschlüssel...
Es ist möglich, die Lizenzschlüssel für mehrere Produkte des Herstellers (PDFlib GmbH) in der Lizenzdatei aufzunehmen.
Default-Name "licensekeys.txt" verwenden
Das System sucht in diesen Pfaden nach der Datei "licensekeys.txt":
Dabei wird <v.r> durch Version und Release von pdflib ersetzt. Zum Beispile: "9.1"
- /PDFlib/PDFlib/<v.r>/resource/cmap
- /PDFlib/PDFlib/<v.r>/resource/codelist
- /PDFlib/PDFlib/<v.r>/resource/glyphlst
- /PDFlib/PDFlib/.1/resource/fonts
- /PDFlib/PDFlib/<v.r>/resource/icc
- /PDFlib/PDFlib/<v.r>
- /PDFlib/PDFlib
- /PDFlib
Eine (selbstbenannte) Lizenzdatei in der Umgebungsvariable "PDFLIBLICENSEFILE" registrieren
Zum Beispiel:
ADDENVVAR ENVVAR(PDFLIBLICENSEFILE) VALUE('/ACMEGMBH/PDFLIB/Lizenzdatei.txt') LEVEL(*SYS)