createDirectory

Mit createDirectory erzeugen Sie ein Verzeichnis. Wenn Sie keinen Partner angeben, wird das Verzeichnis unter der lokalen Benutzerkennung angelegt.

Mit baseDir (siehe Abschnitt „baseDir") können Sie ein Basisverzeichnis festlegen, unter dem das angegebene Verzeichnis angelegt wird.

Die Länge des Verzeichnisnamens (Länge von baseDir plus Länge von dirnames) ist begrenzt und abhängig von der openFT-Version. Die Länge ergibt sich aus der Anzahl der Zeichen plus 1 Zeichen, wenn baseDir nicht mit einem „/“ endet.

Beachten Sie das Verhalten beim Wiederanlauf (siehe Abschnitt „Wiederanlauf").

Einschränkungen

Wenn Sie im Namens-Attribut einen Verzeichnispfad angeben, müssen alle Verzeichnisse bis auf die unterste Stufe bereits existieren.

Format

 <createDirectory ref?="ID" faultIfExists?="yes|no" dirnames >

   comment?
   context?
   partner?
   baseDir?
 </createDirectory>

Attribute

Name	Wert	Bedeutung
ref?	string	Referenz auf ein Verzeichnis-Kontextobjekt.
faultIfExists?	yes | no	Der Standardwert ist no. Existiert das Verzeichnis, wird createDirectory ohne Fehler beendet. Bei Angabe von yes wird createDirectory mit dem Fehlercode ft_exists abgebrochen, wenn das Verzeichnis existiert. Beim Wiederanlauf (siehe Abschnitt „Wiederanlauf") wird, bei existierendem Verzeichnis, createDirectory mit dem Fehlercode ft_recoveryCreateDirectory abgebrochen. Dies kann auch beim Umschalten der Instanz erfolgen.
dirnames	siehe Abschnitt „Verzeichnisnamen-Attribute".

Beispiel

 <?xml version="1.0" encoding="UTF-8"?> 
 <ftscript version="1">
   <context>
     <directory id="myDir" name="myTmp"/>
   </context>
   <createDirectory ref="myDir">
     <partner name="UnixP_1">
       <transferAdmission>
         <ftacAdmission ftacAdmission="FTACADM1"/>
       </transferAdmission>
     </partner>
     <baseDir name="frg_eis_03"/>
   </createDirectory>
 </ftscript>

Erzeugt im Verzeichnis frg_eis_03 das Verzeichnis myTmp für die FTAC-Zugangsberechtigung FTACADM1 auf dem Rechner UnixP_1.

createDirectory wird ohne Fehler beendet, wenn das Verzeichnis schon vorhanden ist. Wenn createDirectory gelaufen ist, existiert das Verzeichnis.

Als baseDir ist frg_eis_03 angegeben. Das zu erzeugende Verzeichnis wird referenziert. Der gesamte Verzeichnispfad (baseDir + name) ist frg_eis_03/myTmp mit 16 Zeichen.

Kann das gewünschte Verzeichnis frg_eis_03/myTmp nicht angelegt werden, weil z.B. der Pfad frg_eis_03 nicht existiert, wird createDirectory mit dem Fehlercode ft_cantCreate beendet.

Ein weiteres Beispiel für createDirectory finden Sie im Abschnitt „foreach".