Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Dummy-Routine

&pagelevel(5)&pagelevel

Die Exit-Routine wird beim Starten des FTP-Client-Programms bzw. der verbindungsspezifischen Server-Task automatisch aus der Modul-Bibliothek SYSLNK.TCP-IP-AP.nnn bzw. SKMLNK.TCP-IP-AP.nnn (bei x86-Rechnern) nachgeladen. Damit es hierbei nicht zu „UNRESOLVED EXTERNAL REFERENCES“-Fehlern kommt, muss in den genannten Bibliotheken immer ein Modul mit dem Entry YAPFEXIT vorhanden sein.

Die genannten Modul-Bibliotheken werden deshalb mit einer Dummy-Routine ausgeliefert, die in dem LMS-Element EXITFTP enthalten ist. Diese Routine führt keine Umwandlung durch, sondern protokolliert die übergebenen Daten auf der Standardausgabe und liefert sie ansonsten unverändert zurück. Den Quelltext für diese Routine, der sich im S-Element EXITFTP.C in der Bibliothek SYSSRC.TCP-IP-AP.nnn befindet, können Sie als Ausgangspunkt für eigene Routinen verwenden. Die hierfür notwendige Header-Datei finden Sie in der Bibliothek SYSLIB.TCP-IP-AP.nnn. Falls Sie die Routine in Assembler erstellen wollen, verwenden Sie hierfür den Makro YAPFX. Hierbei ist zu beachten, dass die Routine nach C-Konventionen aufgerufen wird.

Bei Verwendung einer eigenen Routine beachten Sie bitte, dass sich in der Modul-Bibliothek jeweils nur ein einziger Modul mit dem Einsprungspunkt YAPFEXIT befinden darf, da andernfalls evtl. der falsche Modul nachgeladen wird. Sie müssen also insbesondere das mitgelieferte Modul-Element EXITFTP entfernen.

Da der Einsprungspunkt YAPFEXIT standardmäßig nicht angesprungen wird, müssen Sie ihn per FTP-Server-Option bzw. per Kommando aktivieren.