Mit Kommando jobvar kann dem FTP-Client mitgeteilt werden, ob er Fehlerinformationen in einer Jobvariablen hinterlegen soll.
Eine Alternative zur Hinterlegung von Fehlerinformationen bietet das Kommando svar (siehe "svar - Fehlerinformationen in einer SDF-P-Variablen hinterlegen").
Tritt bei der Bearbeitung des jobvar-Kommandos ein Fehler auf und ist der Schalter 1 gesetzt (Batch-Betrieb), dann wird der FTP-Client mit TERMJ beendet. Der Batch-Job bzw. die Prozedur wird somit erst nach der nächsten STEP-Anweisung fortgesetzt.
Wenn die Versorgung einer Jobvariablen aktiviert ist, verändert sich das Verhalten von Kommandos, die mehrere Einzelaktionen ausführen (Kommandos mdir, mls, mget, mput, mdelete). Bei diesen Kommandos wird die Kommando-Verarbeitung nach der ersten fehlerhaften Aktion abgebrochen.
Dagegen wird der FTP-Client im Batch-Betrieb nicht mit TERMJ beendet, wenn die Berechtigungsdaten beim open-Kommando fehlerhaft sind.
jobvar |
<jv-name> | *NONE | *OFF | *ON |
<jv-name>
Name der Jobvariablen, die der FTP-Client nach Absetzen des jobvar-Kommandos mit den Kommando-Return-Informationen versorgen soll. Falls die Jobvariable <jv-name> nicht bereits existiert, wird sie neu erstellt.
*NONE
Die Angabe von *NONE veranlasst, dass nicht länger eine Jobvariable mit Kommando-Return-Informationen des FTP-Clients versorgt wird.
*OFF
Die Angabe von *OFF veranlasst, dass die Jobvariable (vorübergehend) nicht mehr mit Kommando-Return-Informationen des FTP-Clients versorgt wird. Zusammen mit dem Pendant *ON kann die Versorgung der Jobvariable auf Kommandos eingeschränkt werden, deren Return-Information relevant ist. Dies kann beispielsweise für einen einfachen Batch-Betrieb genutzt werden, bei dem nicht jedes von einer Prozedur abgesetzte FTP-Kommando ausgewertet wird. Stattdessen wird nach einem einzelnen put-Kommando die Job-Variablenversorgung deaktiviert, sodass ein nachfolgendes quit-Kommando die Jobvariable nicht mehr überschreibt.
*ON
Die Angabe von *ON veranlasst, dass die Jobvariable wieder mit Kommando-Return-Informationen des FTP-Clients versorgt wird.
Layout der Jobvariable
Offset / Länge | Feld | Feldbeschreibung |
0 / 3 | Status-Indicator | '$S ': Kommando erfolgreich ausgeführt |
3 / 1 | Filler | stets "0" |
4 / 4 | TSN | TSN der FTP-Client-Task |
8 / 4 | catid | mit Leerzeichen versorgt |
12 / 4 | Session number | System-Laufnummer |
16 / 16 | User command name | Name des FTP-Client-Kommandos |
32 / 96 | Command Parameter | FTP-Kommando-Parameter |
128 / 4 | FTP protocol command | vom Client an den Server gesendetes Kommando |
132 / 124 | FTP message | Lokale Meldung bzw. Server-Antwort |