Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Deprecation notice added

Table of Contents
outlinh1. true
outlinh1. true
1printablefalse
2stylh1. none
3indent20px

JITL: The Managed Database Job

Info
titleImportant

This job uses the deprecated sos.scheduler.managed.JobSchedulerManagedDatabaseJob that has been deprecated with Release 1.12.

The JobSchedulerManagedDatabaseJobSOSHibernate job is provided as an alternative.

This job is used to execute (SQL-)statements in a database and can be used standalone or triggered by orders - i.e. as an order job.
It can execute database procedures or SQL statements.

(A general overview of all JITL jobs can be found Library of Standard Jobs - JITL) is used as a standalone solution or triggered by orders to execute statements in a database.
These can be database procedures or SQL statements.

The description JobSchedulerManagedDatabaseJob.xml is stored in the ./jobs directory of your Job Scheduler the JobScheduler installation.

The SQL instructions are written in the command parameter.
It is possible to define more than one instruction in the command parameter.
Such instructions are then carried out in the order in which they are written and must be separated by a semicolon and a subsequent new line.

...

The job chain launchDB.job_chain.xml:

Code Block

 <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/job_chain.xml job_chain] <job_chain orders_recoverable="yes" visible="yes">
     <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/job_chain_node.xml job<job_chain_node] state="launch"  job="launchDB" next_state="success" error_state="error"/>
     <job_chain_node state="success"/>
     <job_chain_node state="error"/>
 </job_chain>

...

The order launchDB,updateMyTable.order.xml:
It contains an update statement and a commit.

Code Block

 <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/order.xml order] <order title="update MY_TABLE">
     <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/params.xml params]><params>
         <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]<param name="command"        value="update MY_TABLE set a='foo' where b='bar';&amp;#10;commit;"/>
     </params>
     <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/run_time.xml run_time]<run_time/>
      </order>

The job launchDB.job.xml (i.e. with a MySQL database connection, examples for other DBMS see below): It executes the statements where the statement in the order command parameter overwrites the statement in the job command parameter.

MySQL (MariaDB)

Code Block

 <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/job.xml job]  <job title="Launch Database Statement" order="yes" stop_on_error="no">
     <description>
        <include file="jobs/JobSchedulerManagedDatabaseJob.xml"/>
    </description>
    <params>
        <param name="db_class"       <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/params.xml params] value="SOSMySQLConnection"/>
        <param name="db_driver"       value="com.mysql.jdbc.Driver"/>
        <param  <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]name="db_url"          value="jdbc:mysql://localhost:3306/scheduler"/>
        <param name="db_classuser"         value="scheduler"/>
        <param name="SOSMySQLConnection"db_password"     value="scheduler"/>
        <param name="command"         value=""/>
    <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]/params>
    <script language="java" java_class="sos.scheduler.managed.JobSchedulerManagedDatabaseJob"/>
    <run_time/>
 </job>

For other database management systems you have to modify the connection parameter like in the following examples:

MS SQL Server

Code Block
 <job title="Launch Database Statement" order="yes" stop_on_error="no">
     <description>
        <include file="jobs/JobSchedulerManagedDatabaseJob.xml"/>
    </description>
    <params>
        <param name="db_class"        value="SOSMSSQLConnection"/>
        <param name="db_driver"       value="com.microsoft.mysqlsqlserver.jdbc.DriverSQLServerDriver"/>
        <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]<param name="db_url"          value="jdbc:mysqlsqlserver://localhost:3306/1433;sendStringParametersAsUnicode=false;selectMethod=cursor;databaseName=scheduler"/>
        <param name="db_user"         value="scheduler"/>
        <param name="db_password"     value="scheduler"/>
        <param <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]name="command"         value=""/>
    </params>
    <script language="java" java_class="sos.scheduler.managed.JobSchedulerManagedDatabaseJob"/>
    <run_time/>
 </job>

Oracle

Code Block
 <job title="Launch Database Statement" order="yes" stop_on_error="no">
     <description>
        <include file="jobs/JobSchedulerManagedDatabaseJob.xml"/>
    </description>
    <params>
        <param name="db_userclass"         value="schedulerSOSOracleConnection"/>
        <param name="db_driver"       <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]value="oracle.jdbc.driver.OracleDriver"/>
        <param name="db_url"          value="jdbc:oracle:thin:@localhost:1521:scheduler"/>
        <param name="db_passworduser"         value="scheduler"/>
        <param name="db_password"     <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/param.xml param ]value="scheduler"/>
        <param name="command"         value=""/>
    </params>
    <script language="java" java_class="sos.scheduler.managed.JobSchedulerManagedDatabaseJob"/>
    <run_time>
 <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/script.xml script ]/job>

See also:

PostgreSQL

Code Block
<job title="Launch Database Statement" order="yes" stop_on_error="no">
	<description>
		<include file="jobs/JobSchedulerManagedDatabaseJob.xml"/>
	</description>
	<params>
		<param name="db_class"		 value="SOSPgSQLConnection"/>
		<param name="db_driver"		 value="org.postgresql.Driver"/>
		<param name="db_url"		 value="jdbc:postgresql://localhost:5432/scheduler"/>
		<param name="db_user"		 value="scheduler"/>
		<param name="db_password"	 value="scheduler"/>
		<param name="command"		 value=""/> 
	</params>
	<script language="java" java_class="sos.scheduler.managed.JobSchedulerManagedDatabaseJob"/> 
	<run_time>
</job>

 

IBM/DB2

Code Block
<job title="Launch Database Statement" order="yes" <[http://www.sos-berlin.com/doc/en/scheduler.doc/xml/run_time.xml run_time]/>
 </job>
stop_on_error="no">
	<description>
		<include file="jobs/JobSchedulerManagedDatabaseJob.xml"/>
	</description>
	<params>
		<param name="db_class"		value="SOSDB2Connection"/> 
		<param name="db_driver"		value="com.ibm.db2.jcc.DB2Driver"/> 
		<param name="db_url"		value="jdbc:db2://localhost:50000/scheduler:driverType=2;retrieveMessagesFromServerOnGetMessage=true;"/>
		<param name="db_user"		value="scheduler"/>
		<param name="db_password"	value="scheduler"/>
		<param name="command"		value=""/>
	</params>
	<script language="java" java_class="sos.scheduler.managed.JobSchedulerManagedDatabaseJob"/> 
	<run_time>
</job>