﻿<?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 name  = "JobSchedulerManagedUserJob"
       title = "Run database statements for the SQL scheduling interface"
       order = "no"
       tasks = "1">
    <script language   = "java"
            java_class = "sos.scheduler.managed.JobSchedulerManagedUserJob"
            resource   = "1"/>
  </job>

  <releases>
    <release id="1.0" created="2005-09-20" modified="2005-09-20">
      <title>Version 1.0</title>
      <author name="Andreas Liebert" email="andreas.liebert@sos-berlin.com"/>
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">Initiale Auslieferung</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">Initial Release</div></note>
      <changes language="de"><div xmlns="http://www.w3.org/1999/xhtml">Implementierung mit SOSConnection.</div></changes>
      <changes language="en"><div xmlns="http://www.w3.org/1999/xhtml">Implementation with SOSConnection.</div></changes>
    </release>
  </releases>

  <resources>
    <file os="all" type="java" file="sos.scheduler.jar" id="1">
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">Standard-Job der Auslieferung</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">Standard job in distribution</div></note>
    </file>
    <file os="all" type="java" file="sos.spooler.jar" id="2">
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">Klasse Job_Impl</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">Class Job_Impl</div></note>
    </file>
    <file os="all" type="java" file="sos.util.jar" id="3">
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">Klasse SOSLogger</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">Class SOSLogger</div></note>
    </file>
    <file os="all" type="java" file="sos.connection.jar" id="4">
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">Klasse SOSMySQLConnection</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">Class SOSMySQLConnection</div></note>
    </file>
    <file os="all" type="java" file="sos.settings.jar" id="5">
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">Klasse SOSProfileSettings</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">Class SOSProfileSettings</div></note>
    </file>
    <file os="all" type="java" file="mysql*.jar" id="6">
      <note language="de"><div xmlns="http://www.w3.org/1999/xhtml">MySQL JDBC Treiber</div></note>
      <note language="en"><div xmlns="http://www.w3.org/1999/xhtml">MySQL JDBC Driver</div></note>
    </file>

    <database required="true">
      <resource name="SCHEDULER_MANAGED_MODELS" type="table">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Die Tabelle nimmt die Definitionen für Job-Ketten auf und
            wird mit der Web-Oberfläche der Managed Jobs verwaltet.
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            This table contains the definitions of job chains and
            is administered using the Managed Jobs web interface.
          </div>
        </note>
      </resource>
      <resource name="SCHEDULER_MANAGED_JOBS" type="table">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Die Tabelle nimmt die Definitionen der Jobs auf und
            wird mit der Web-Oberfläche der Managed Jobs verwaltet.
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            This table contains the job definitions and
            is administered using the Managed Jobs web interface.
          </div>
        </note>
      </resource>
      <resource name="SCHEDULER_MANAGED_USER_VARIABLES" type="table">
        <note language="de">
          <div xmlns="http://www.w3.org/1999/xhtml">
            Die Tabelle enthält Informationen von Benutzern, für die
            Datenbank-Statements ausgeführt werden und wird intern verwaltet.
          </div>
        </note>
        <note language="en">
          <div xmlns="http://www.w3.org/1999/xhtml">
            This table contains informations of users for which
            database statements are executed and is managed internally.
          </div>
        </note>
      </resource>
    </database>
  </resources>

  <configuration />

  <documentation language="de">
    <div xmlns="http://www.w3.org/1999/xhtml">
      Der Job Scheduler bietet ein SQL Interface zur Ausführung von Statements in der Datenbank,
      analog zum Oracle Scheduling Paket <code>dbms_jobs</code>.
      Weitere Infos finden Sie in der Dokumentation <em>MySQL Job Scheduling</em>.
      Dieser Job sorgt dafür, dass Datenbank-Jobs, die über die SQL Schnittstelle eingestellt oder verändert wurden,
      vom Job Scheduler ausgeführt werden.
      <br/><br/>
      Es ist wichtig, dass das Wiederholungsintervall des Jobs (Voreinstellung 60s)
      höchstens halb so lang ist, wie das kürzeste Wiederholungsintervall eines Datenbank-Jobs.
      Gibt es einen Datenbank-Job, der jede Minute ablaufen soll, dann muss das Startintervall
      des Managed User Jobs auf 30s eingestellt werden.

    </div>
  </documentation>

  <documentation language="en">
    <div xmlns="http://www.w3.org/1999/xhtml">
      The Job Scheduler offers an SQL interface to schedule the execution of database statements
      similarly to what is done with the Oracle scheduling package <code>dbms_jobs</code>.
      See the <em>MySQL Job Scheduling</em> documentation for details.
      This job ensures that database jobs which have been submitted or modified via the SQL interface
      are carried out by the Job Scheduler.
      <br/><br/>
      It is important that the repeat interval for this job (default: 60s) is at the most half as long 
      as the shortest repeat interval of any database job. 
      Therefore, if a database job which repeats every minute is to be carried out,
      then the repeat interval of the Managed User Job has to be set to 30s.
    </div>
  </documentation>

</description>