fault

Mit fault brechen Sie die Eltern-Aktivität (und alle ihre laufenden Kind-Aktivitäten) mit einem selbst definierten Fehlercode ab und setzen die Ausführung im passenden faulthandler fort. Der faulthandler der Eltern-Aktivität wird zuerst durchlaufen.

Der Fehler wird mit dem passenden faulthandler (default oder case) abgefangen (siehe Abschnitt „faulthandler"). Die Aktivität des faulthandler wird ausgeführt.

Alle noch laufenden Aufträge zur Dateiübertragung, welche von der Eltern-Aktivität aus gestartet wurden, werden ebenfalls abgebrochen (ft_cancel). Dies führt gegebenenfalls zur Ausführung des remoteFailureScript (siehe Abschnitt „remoteFailureScript").

Kann dem Fehlercode kein faulthandler zugeordnet werden, wird das gesamte Script abgebrochen.

Einschränkungen

Der Fehlercode darf nicht mit "ft_" beginnen. Diese Fehlercodes sind für openFT-Script reserviert.

Format

 <fault code="faultcode">
   comment?
 </fault>

Attribute

Name	Wert	Bedeutung
code	Text	Der Fehlercode, der in einem faulthandler abgefangen werden kann.

Beispiel

 <?xml version="1.0" encoding="UTF-8"?>
 <ftscript version="1">
   <parallel>
     <context>
       <partner id="remote" name="UnixP_1">
         <transferAdmission>
           <ftacAdmission ftacAdmission="FTACADM1"/>
         </transferAdmission>
       </partner>

       <faulthandler>
         <case code="intercept">
           <deleteFile name="target1.bin">
             <partner ref="remote"/>
             <directory name="frg_eis_08NotAvailable"/>
           </deleteFile>
           <deleteFile name="target2.bin">
             <partner ref="remote"/>
             <directory name="frg_eis_08"/>
           </deleteFile>
         </case>
       </faulthandler>
     </context>
     <transferFile>
       <context>
         <faulthandler>
           <default>
             <fault code="intercept"/>
           </default>
         </faulthandler>
       </context>
       <fromLocalFile name
              "W:/openFT/ftscript/Test/data/small/bin.mp3"/>
       <toRemoteFile name="target1.bin">
         <partner ref="remote"/>
         <directory name="frg_eis_08NotAvailable"/>
       </toRemoteFile>
     </transferFile>      <transferFile>
       <context>
         <faulthandler>
           <default>
             <fault code="intercept"/>
           </default>
         </faulthandler>
       </context>
       <fromLocalFile name
            "W:/openFT/ftscript/Test/data/large/bin.mp3"/>
       <toRemoteFile name="target2.bin">
         <partner ref="remote"/>
         <directory name="frg_eis_08"/>
       </toRemoteFile>
     </transferFile>
   </parallel>
 </ftscript>

Es werden zwei Dateiübertragungen parallel ausgeführt.
Tritt bei einer der Übertragungen ein Fehler auf, wird dieser auf den Fehlercode intercept abgebildet. Dieser wird im faulthandler abgefangen.
Die andere Dateiübertragung wird abgebrochen (ft_cancel).
Beide Zieldateien werden im faulthandler gelöscht. Hierbei auftretende Fehler werden ignoriert.

Mit diesem Script erreichen entweder beide Dateien oder keine der Dateien ihr Ziel.

Ist für die über ft_cancel abgebrochene Dateiübertragung ein remoteFailureScript definiert, kann dieses noch laufen, während der faulthandler bereits aktiv ist.