svar - Fehlerinformationen in einer SDF-P-Variablen hinterlegen

Mit dem Kommando svar können Sie dem FTP-Client mitteilen, ob er Kommando-Return-Information in einer SDF-P-Variablen hinterlegen soll.

Eine Alternative zur Hinterlegung von Fehlerinformationen bietet das Kommando jobvar (siehe "jobvar - Fehlerinformationen in einer Jobvariablen hinterlegen").

Tritt bei der Bearbeitung des svar-Kommandos ein Fehler auf und ist der Schalter 1 gesetzt (Batch-Berieb), 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 S-Variablen 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.

svar

<sv-name> | *NONE | *OFF | *ON

<sv-name>

Name der SDF-P-Variablen (S-Variable), die der FTP-Client nach Absetzen des svar-Kommandos mit den Kommando-Return-Informationen versorgen soll. Hierzu wird diese S-Variable neu erstellt. Falls bereits eine S-Variable mit dem Namen <sv-name> existiert, wird sie zunächst gelöscht.

*NONE

Bei Angabe von *NONE wird die Versorgung der S-Variablen gestoppt.

*OFF

Bei Angabe von *OFF wird die Versorgung der S-Variablen (temporär) gestoppt. Zusammen mit dem Pendant *ON kann die Versorgung der S-Variablen 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 S-Variablenversorgung deaktiviert, sodass ein nachfolgendes quit-Kommando die S-Variable nicht mehr überschreibt.

*ON

Bei Angabe von *ON wird die S-Variable wieder mit Kommando-Return-Informationen versorgt.

Layout der S-Variablen

Element	Elementbeschreibung
<sv-name>.STATUS	'$S ': Kommando erfolgreich ausgeführt '$E ': Kommando mit Fehler beendet '$T ': FTP-Client normal beendet '$A ': FTP-Client wegen Fehler abnormal beendet
<sv-name>.USERCMD	Name des FTP-Client-Kommandos
<sv-name>.CMDPARAM	FTP-Kommando-Parameter
<sv-name>.PROTCMD	vom FTP-Client an den FTP-Server gesendetes Kommando
<sv-name>.MESSAGE	lokale Meldung bzw. Server-Antwort