Exit Programm Parameter
Parameterliste Typ 1
Das Parameterlistenformat Typ 1 war das einzige Format, das mit Exit-Programmen in älteren Versionen von i-effect. Sie können dieses Format weiterhin verwenden, aber es wird hauptsächlich unterstützt für Gründe für die Abwärtskompatibilität. Es hat die Einschränkung, dass es nur ein einziges Mal empfangen kann.
Single-Exit-Programmparameter aus den Spooldateien extrahiert, während höhere
Versionen von i-effect mehrere Exit-Programmparameter an den aufgerufenen Exit übergeben können.
Eine Parameterliste vom Typ 1 besteht aus folgendem:
| Nummer | Bezeichnung | Eingabe/Ausgabe | Art |
|---|---|---|---|
| 1 | Spooldateiname | Eingabe | CHAR(10) |
| 2 | Name des Auftrags, der die Spool-Datei erstellt hat | Eingabe | CHAR(10) |
| 3 | Benutzer-ID, die die Spool-Datei erstellt hat | Eingabe | CHAR(10) |
| 4 | Nummer des Auftrags, der die Spool-Datei erstellt hat | Eingabe | CHAR(6) |
| 5 | Spooldateinummer | Eingabe | BINARY(4) |
| 6 | Spooldatei Benutzerdaten | Eingabe | CHAR(10) |
| 7 | Name der gerade erstellten Stream-Datei | Eingabe | CHAR(128) |
| 8 | Verzeichnisname, in dem die Stream-Datei erstellt wurde | Eingabe | CHAR(256) |
| 9 | Benutzerdefinierbarer Exit-Programmparameter | Eingabe | CHAR(1024) |
Beachten Sie, dass Parameter 9 eine 1024 Byte lange Zeichenvariable mit fester Länge ist, die mit nachlaufenden Leerzeichen aufgefüllt wird, wenn der aus der Spool-Datei extrahierte Parameter kleiner
als 1024 Bytes lang ist.
Wenn mehr als ein Parameter aus der Spool-Datei extrahiert wird, wird nur der erste Parameter an ein Exit-Programm übergeben, das mit *TYPE1-Parametern definiert ist. Es wird daher empfohlen, die Parameter *TYPE2 oder *TYPE3 zu verwenden, wenn Sie mehr als eine Parameterzeichenkette aus der Spool-Datei extrahieren möchten.
Wenn Sie eine große Anzahl von benutzerdefinierten Parametern (mehr als 242) extrahieren möchten, müssen Sie die Option *TYPE4 Parameterliste verwenden.
Parameterliste Typ 2
Das Parameterlistenformat Typ 2 wurde eingeführt, um mehrere Parameter an ein Exitprogramm übergeben zu können.
Eine Parameterliste vom Typ 2 besteht aus den folgenden Elementen:
| Nummer | Bezeichnung | Eingabe/Ausgabe | Art |
|---|---|---|---|
| 1 | Spooldateiname | Eingabe | CHAR(10) |
| 2 | Name des Auftrags, der die Spool-Datei erstellt hat | Eingabe | CHAR(10) |
| 3 | Benutzer-ID, die die Spool-Datei erstellt hat | Eingabe | CHAR(10) |
| 4 | Nummer des Auftrags, der die Spool-Datei erstellt hat | Eingabe | CHAR(6) |
| 5 | Spooldateinummer | Eingabe | BINARY(4) |
| 6 | Spooldatei Benutzerdaten | Eingabe | CHAR(10) |
| 7 | Name der gerade erstellten Stream-Datei | Eingabe | CHAR(128) |
| 8 | Verzeichnisname, in dem die Stream-Datei erstellt wurde | Eingabe | CHAR(256) |
| 9 | Erste verarbeitete Seite | Eingabe | BINARY(4) |
| 10 | Letzte verarbeitete Seite | Eingabe | BINARY(4) |
| 11 | Anzahl der folgenden benutzerdefinierten Parameter | Eingabe | BINARY(4) |
| 12 | Benutzerdefinierter Parameter 1 | Eingabe | CHAR(*) |
| 13 | Benutzerdefinierter Parameter 2 | Eingabe | CHAR(*) |
| .... | |||
| Benutzerdefinierter Parameter 200 | Eingabe | CHAR(*) |
Die Anzahl der benutzerdefinierbaren Parameter, die beim Aufruf übergeben werden, wird durch die Angabe in Parameter 11 bestimmt..
Danach folgen zwischen 0 und 200 Zeichenketten variabler Länge, deren Länge von 0 bis 1024 Bytes reicht. Diese entsprechen den ILE-RPG-Zeichenvariablen.
mit dem angegebenen VARYING-Attribut, d.h. sie bestehen aus einer Zwei-Byte-Binärlänge gefolgt von bis zu 1024 Byte Text.
Parameterliste Typ 3
Das Parameterlistenformat Typ 3 wurde eingeführt, um zusätzliche Informationen für Exitprogramm bereits zu stellen, die oft notwendig sind, damit sie in der Lage sind, ihre Arbeit effizient zu erledigen. Insbesondere, zusätzlich zu den für einen *TYPE2 übergebenen Parametern, beinhaltet sie den Ausgangspunkt, an dem der Aufruf stattfindet, und die Format, in das die Stream-Datei konvertiert wird.
Bitte beachten Sie, dass *TYPE3-Programme eine zusätzliche Funktion haben, die nicht auf *TYPE1 oder *TYPE2 Exit-Programme anwendbar sind. Abgesehen davon, dass sie am normalen Exit-Punkt aufgerufen werden, werden sie erneut am Ende der Verarbeitung mit END aufgerufen. Damit soll eine Möglichkeit geschaffen werden, um das Exitprogramm über den Abschluss der Verarbeitung zu informieren, so dass es Bereinigungsaufgaben, wie das Schließen von Dateien, durchzuführen kann.
Eine Parameterliste vom Typ 3 besteht aus den folgenden Elementen:
| Nummer | Bezeichnung | Eingabe/Ausgabe | Art |
|---|---|---|---|
| 1 | Spooldateiname | Eingabe | CHAR(10) |
| 2 | Name des Auftrags, der die Spool-Datei erstellt hat | Eingabe | CHAR(10) |
| 3 | Benutzer-ID, die die Spool-Datei erstellt hat | Eingabe | CHAR(10) |
| 4 | Nummer des Auftrags, der die Spool-Datei erstellt hat | Eingabe | CHAR(6) |
| 5 | Spooldateinummer | Eingabe | BINARY(4) |
| 6 | Spooldatei Benutzerdaten | Eingabe | CHAR(10) |
| 7 | Name der gerade erstellten Stream-Datei | Eingabe | CHAR(128) |
| 8 | Verzeichnisname, in dem die Stream-Datei erstellt wurde | Eingabe | CHAR(256) |
| 9 | Erste verarbeitete Seite | Eingabe | BINARY(4) |
| 10 | Letzte verarbeitete Seite | Eingabe | BINARY(4) |
| 11 | Exitpunkt der verarbeitet wird | Eingabe | CHAR(10) |
| 12 | Format in das die Daten konvertiert werden | Eingabe | CHAR(10) |
| 13 | Anzahl der folgenden benutzerdefinierten Parameter | Eingabe | BINARY(4) |
| 14 | Benutzerdefinierter Parameter 1 | Eingabe | CHAR(*) |
| 15 | Benutzerdefinierter Parameter 2 | Eingabe | CHAR(*) |
| .... | |||
| Benutzerdefinierter Parameter 200 | Eingabe | CHAR(*) |
Die Anzahl der benutzerdefinierbaren Parameter, die beim Aufruf übergeben werden, wird durch die Angabe in Parameter 11 bestimmt..
Danach folgen zwischen 0 und 200 Zeichenketten variabler Länge, deren Länge von 0 bis 1024 Bytes reicht. Diese entsprechen den ILE-RPG-Zeichenvariablen.
mit dem angegebenen VARYING-Attribut, d.h. sie bestehen aus einer Zwei-Byte-Binärlänge gefolgt von bis zu 1024 Byte Text.