i-effect Manual

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.