﻿<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="scheduler_job_documentation.xsl"?>
<description xmlns="http://www.sos-berlin.com/schema/scheduler_job_documentation_v1.0" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sos-berlin.com/schema/scheduler_job_documentation_v1.0 http://www.sos-berlin.com/schema/scheduler_job_documentation_v1.0.xsd">
  <job order="both" name="JobSchedulerExistsFile" tasks="unbounded" title="check for file existence">
    <script language="java" java_class="sos.scheduler.file.JobSchedulerExistsFile" resource="1"/>
  </job>

  <releases>
    <release id="1.3" created="2006-12-11" modified="2008-03-06">
      <title>version 1.3</title>
      <author name="Florian Schreiber" email="florian.schreiber@sos-berlin.com" />
    </release>
  </releases>

  <resources>
    <file os="all" type="java" file="sos.scheduler.jar" id="1" />
    <file os="all" type="java" file="sos.spooler.jar" id="2" />
    <file os="all" type="java" file="sos.util.jar" id="3" >
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">verwendet die Klasse SOSFileOperations</div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">Makes use of the SOSFileOperations class</div>
        </note>
    </file>
  </resources>

  <configuration>
    <note language="de">
      <div xmlns="http://www.w3.org/1999/xhtml">Dieser Job kann standalone oder auftragsgesteuert eingesetzt werden.
        Die Parameter werden entsprechend als Job- oder Auftragsparameter verarbeitet.
      </div>
    </note>
    <note language="en">
      <div xmlns="http://www.w3.org/1999/xhtml">This job can be used standalone or as an order driven job.
        Parameters are respectively accepted as job parameters or as order parameters.
      </div>
    </note>
    <params>
      <param name="file" required="true">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
          	Datei oder Verzeichnis
          	<p>
                Unterstützt Substitution von Masken im Datei- und Verzeichnisnamen mit Formatangaben, die mit <em>[</em> und <em>]</em> geklammert sind.
                Folgende Formate werden unterstützt:
                <br/><br/>
                <ul>
                  <li><code>[date:<em>date format</em>]</code><br/>
                    <em>date format</em> muss ein gültiger Java Format-String für Datumsangaben sein, z.B.<br/>
                    <em>yyyyMMddHHmmss</em>, <em>yyyy-MM-dd.HHmmss</em> etc.
                  </li>
                </ul>
            </p>
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
          	file or directory
          	<p>
                Supports masks for substitution in the file name and directory name with format strings that are enclosed by <em>[</em> and <em>]</em>.
                The following format strings are supported:
                <br/><br/>
                <ul>
                  <li><code>[date:<em>date format</em>]</code><br/>
                    <em>date format</em> must be a valid Java data format string, e.g.<br/>
                    <em>yyyyMMddHHmmss</em>, <em>yyyy-MM-dd.HHmmss</em> etc.
                  </li>
                </ul>
              </p>
          </div>
        </note>
      </param>

      <param name="file_spec" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Regulärer Ausdruck als Dateifilter.
            Verhält sich CASE_INSENSITIVE.
            <br />
            Nur wirksam, wenn der Parameter
            <code>file</code>
            ein Verzeichnis ist.
					</div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Regular Expression for file filtering.
            The behaviour is CASE_INSENSITIVE.
            <br/>
            Only effective if the parameter
            <code>file</code>
            is a directory.
          </div>
        </note>
      </param>

			<param name="min_file_age" default_value="0" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
Vereinbart das Mindestalter einer oder mehrerer Dateien.
Ist eine Datei jünger, dann gilt sie als nicht vorhanden.<br/>
<br/>
Mögliche Werte sind:<br/>
0 (parameter wird ignoriert)<br/>
Sekunden<br/>
Stunden:Minuten<br/>
Stunden:Minuten:Sekunden
					</div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
Specifies the minimum age of one or multiple files.
If the files is newer then it is classified as non-existing.<br/>
<br/>
Possible values:<br/>
0 (disabled)<br/>
seconds<br/>
hours:minutes<br/>
hours:minutes:seconds
          </div>
        </note>
      </param>

			<param name="max_file_age" default_value="0" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
Vereinbart das Höchstalter einer oder mehrerer Dateien.
Ist eine Datei älter, dann gilt sie als nicht vorhanden.<br/>
<br/>
Mögliche Werte sind:<br/>
0 (parameter wird ignoriert)<br/>
Sekunden<br/>
Stunden:Minuten<br/>
Stunden:Minuten:Sekunden
					</div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
Specifies the maximum age of one or multiple files.
If the files is older then it is classified as non-existing.<br/>
<br/>
Possible values:<br/>
0 (disabled)<br/>
seconds<br/>
hours:minutes<br/>
hours:minutes:seconds
          </div>
        </note>
      </param>

      <param name="min_file_size" default_value="-1" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Vereinbart die minimale Größe einer oder mehrerer Dateien in Bytes:
            unterschreitet die Größe einer der Dateien diesen Wert,
            dann gilt sie als nicht vorhanden.<br/>
<br/>
Mögliche Werte sind:<br/>
-1 (parameter wird ignoriert)<br/>
Zahl (Byte), z.B. 40<br/>
ZahlKB, z.B. 5KB (Groß/Kleinschreibung wird ignoriert)<br/>
ZahlMB, z.B. 20MB (Groß/Kleinschreibung wird ignoriert)<br/>
ZahlGB, z.B. 10GB (Groß/Kleinschreibung wird ignoriert)
					</div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Specifies the minimum size of one or multiple files in bytes:
            should the size of one of the files fall below this value,
            then it is classified as non-existing.<br/>
<br/>
Possible Values:<br/>
-1 (disabled)<br/>
number (Byte), e.g. 40<br/>
numberKB, e.g. 5KB (case insensitive)<br/>
numberMB, e.g. 20MB (case insensitive)<br/>
numberGB, e.g. 10GB (case insensitive)
          </div>
        </note>
      </param>

      <param name="max_file_size" default_value="-1" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Vereinbart die maximale Größe einer oder mehrerer Dateien in Bytes:
            überschreitet die Größe einer der Dateien diesen Wert,
            dann gilt sie als nicht vorhanden.<br/>
<br/>
Mögliche Werte sind:<br/>
-1 (parameter wird ignoriert)<br/>
Zahl (Byte), z.B. 40<br/>
ZahlKB, z.B. 5KB (Groß/Kleinschreibung wird ignoriert)<br/>
ZahlMB, z.B. 20MB (Groß/Kleinschreibung wird ignoriert)<br/>
ZahlGB, z.B. 10GB (Groß/Kleinschreibung wird ignoriert)
					</div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Specifies the maximum size of one or multiple files in bytes:
            should the size of one of the files exceed this value,
            then it is classified as non-existing.<br/>
<br/>
Possible Values:<br/>
-1 (disabled)<br/>
number (Byte), e.g. 40<br/>
numberKB, e.g. 5KB (case insensitive)<br/>
numberMB, e.g. 20MB (case insensitive)<br/>
numberGB, e.g. 10GB (case insensitive)
          </div>
        </note>
      </param>

			<param name="skip_first_files" default_value="0" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
Die angegebene Anzahl Dateien wird vom Beginn der Ergebnismenge entfernt.
Auf diese Dateien wirkt sich die weitere Operation nicht aus.<br/>

Der Parameter wirkt auf die resultierende Menge von min_file_size, min_file_age etc.<br/>
<br/>
Die Menge ist sortiert entsprechend der verwendeten einschränkenden Parameter:<br/>
+ min_file_age, max_file_age: aufsteigend nach Änderungsdatum der Datei, d.h. jüngere zuerst<br/>
+ min_file_size, max_file_size: aufsteigend nach Größe, d.h. kleinere zuerst<br/>
+ sind sowohl Parameter für Größe wie Alter angegeben, dann erfolgt die Sortierung nach Alter<br/>
<br/>
Es darf nur entweder skip_first_files oder skip_last_files gesetzt sein.
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
The number of files are removed from the beginning of the set resulting by min_file_size, min_file_age etc.
These files are excluded from further operations.<br/>
<br/>
The result set is sorted according to the used constraining parameters:<br/>
+ min_file_age, max_file_age: in ascending order by date of last modification, the newest file first.<br/>
+ min_file_size, max_file_size: in ascending order by file size, the smallest file first.<br/>
+ if parameters for file age as well as file size are given the set is sorted by file age.<br/>
<br/>
Only either skip_first_files or skip_last_files is allowed to be set at one time.
          </div>
        </note>
      </param>

			<param name="skip_last_files" default_value="0" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
Die angegebene Anzahl Dateien wird vom Ende der Ergebnismenge entfernt.
Auf diese Dateien wirkt sich die weitere Operation nicht aus.<br/>

Der Parameter wirkt auf die resultierende Menge von min_file_size, min_file_age etc.<br/>
<br/>
Die Menge ist sortiert entsprechend der verwendeten einschränkenden Parameter:<br/>
+ min_file_age, max_file_age: aufsteigend nach Änderungsdatum der Datei, d.h. jüngere zuerst<br/>
+ min_file_size, max_file_size: aufsteigend nach Größe, d.h. kleinere zuerst<br/>
+ sind sowohl Parameter für Größe wie Alter angegeben, dann erfolgt die Sortierung nach Alter<br/>
<br/>
Es darf nur entweder skip_first_files oder skip_last_files gesetzt sein.
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
The number of files are removed from the end of the set resulting by min_file_size, min_file_age etc.
These files are excluded from further operations.<br/>
<br/>
The result set is sorted according to the used constraining parameters:<br/>
+ min_file_age, max_file_age: in ascending order by date of last modification, the newest file first.<br/>
+ min_file_size, max_file_size: in ascending order by file size, the smallest file first.<br/>
+ if parameters for file age as well as file size are given the set is sorted by file age.<br/>
<br/>
Only either skip_first_files or skip_last_files is allowed to be set at one time.
          </div>
        </note>
      </param>

      <param name="gracious" default_value="false" required="false">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Schaltet Fehlermeldungen an oder aus, die aufgrund einer
            nicht existierenden Datei oder eines nicht existierenden Verzeichnisses ausgelöst werden,
            die/das mit den Parametern <code>file</code> bzw. <code>file_spec</code> spezifiziert wurde.
            <br/><br/>
            Gültige Werte:
            <em>true, 1, on, yes, y, ja, j, all</em>
            und
            <em>false, 0, off, no, n, nein, none</em>
            <br/><br/>
            Bei auftragsgesteuerter Verwendung dieses Jobs gilt:
            <br/><br/>
            <ul>
              <li>
                Wird der Wert <em>all</em> für diesen Parameter angegeben, dann wird
                der Auftrag in der Job-Kette fortgesetzt unabhängig davon, ob Dateien
                kopiert werden konnten.
              </li>
              <li>
                Wird der Wert <em>true</em> oder ein anderer entsprechend positiver Wert angegeben,
                dann wird der Auftrag in der Job-Kette nicht fortgesetzt, wenn keine
                Datei kopiert werden konnte.
              </li>
            </ul>
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Enables or disables error messages that are caused by a nonexistent file or directory
            being specified with the parameters <code>file</code> and respectively <code>file_spec</code>.
            <br/><br/>
            Valid values:
            <em>true, 1, on, yes, y, ja, j, all</em>
            and
            <em>false, 0, off, no, n, nein, none</em>
            <br/><br/>
            The following rules apply when used with orders:
            <br/><br/>
            <ul>
              <li>
                If the value <em>all</em> is specified for this parameter,
                then an order will be continued in its job chain regardless of whether any files could be copied or not
              </li>
              <li>
                If the value <em>true</em> or any other positive value is specified,
                then the order will not be continued in its job chain if it has not been possible to copy any files.
              </li>
            </ul>
          </div>
        </note>
      </param>
    </params>
  </configuration>

  <documentation language="de">
    <div xmlns="http://www.w3.org/1999/xhtml">Prüft auf die Existenz einer Datei, eines Verzeichnisses, oder auf bestimmte Dateien innerhalb eines Verzeichnisses.</div>
  </documentation>

  <documentation language="en">
    <div xmlns="http://www.w3.org/1999/xhtml">Checks for the existence of one file, one directory or for specific files inside of a directory.</div>
  </documentation>
</description>