Toolmaker Produkt-Dokumentation
pdflib
Inhaltsübersicht
- 1 Grundlegende Information
- 2 Installation
- 3 Bibliotheken und IFS-Verzeichnisse (bei der Datensicherung berücksichtigen)
- 4 Weitere Dokumentation zu PDFLib
- 5 Fehlersuche und -behebung für PDFLib
- 6 Versionen und Kompatiblität
- 6.1 PDFlib
- 7 Hinweise zur Lizenzierung
- 8 Deinstallation der IBM i-Software
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 und Download
Die aktuelle Version wird als PC .exe-Datei auf der Toolmaker Homepage zur Verfügung gestellt:
Komponente | Version | Freigabe am | Hinweise |
|---|---|---|---|
PDFLib inkl. PDI | 11.0.0 | Hersteller-Freigabe Toolmaker-Freigabe | PDI wird über einen eigenen Lizenzcode freigeschaltet |
PLOP | 4.10 | 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 | 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
Die bei Ihnen installierte Version können sie ermitteln:
PDFLib | Mit dem Befehl |
PLOP | Mit dem Befehl |
TET | Mit dem Befehl |
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.
In diesem Kapitel sind die wesentlichen Punkte zur Lizenzierung von pdflib auf IBM i zusammengefasst. Die komplette Dokumentation dazu ist im "Tutorial" zur verwendeten Version (z.B. PDFlib-9.1.0-tutorial-D.pdf) im Kapitel "0 Anwendung des PDFlib- Lizenzschlüssels" dargestellt.
Sie finden das Handbuch auf der Hersteller-Website: pdflib Dokumentation.
Übergabe beim Aufruf (Programmquelle prüfen)
Programmierspache | Aufruf |
|---|---|
ILE-RPG |
|
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.
Beispiel für eine Lizenzdatei der Version 9.1.0
# 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)
Aktive Lizenzen und Optionen anzeigen
Verfügbare Lizenz-Optionen für PDFLib
Deinstallation der IBM i-Software