SOS JobSchedulerを他のシステムと統合したいと思うことがあります。例えば、既存システムからジョブをキックするとか、ジョブの実行状況をNagiosやZabbixといった監視システムから取得するといったことです。
そうした場合でも、JobSchedulerなら安心です。TCP通信でXMLのコマンドを投げると、結果を返してくれるようになっているのです。また、TCP通信でのXMLのやりとりをラッピングしたPHPライブラリも提供されています。
Telnetで通信してみよう！
例えば、/test/job_chain1というジョブチェーンがあるとして、それをTelnetから実行してみましょう。
BASH
telnet localhost 4444 →localhostにJobSchedulerがインストールされているとする
Trying localhost…
Connected to localhost.
Escape character is '^]'.
JobSchedulerとTelnet（TCP）での会話が出来るようになりました。
ここで、以下のXMLを送信してみましょう。
XML
<add_order job_chain="/test/job_chain1" at="now" />
すると、JobSchedulerからこんな回答が返ってきます。
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
<spooler>
<answer time="2013-01-15 20:31:00.540">
<ok>
<order path="/" order="2" id="2" state="step-1" initial_state="step-1" job_chain="/test/job_chain1" job="/test/job1" priority="0" created="2013-01-15 20:31:00.543">
<file_based state="not_initialized">
<requisites/>
</file_based>
</order>
</ok>
</answer>
</spooler>
ほほう！
JOC（JobScheduler Operation Centre）を見てみると・・・
たしかに実行されているようです。
PHPでJobSchedulerを操る
上記のようにTCPでXMLを送信するとJobSchedulerを操作できますから、あとはお好きなプログラム言語でソケットプログラミングすればOKということになります。
SOS社では、PHPでのAPIライブラリを提供しています。
上記ページの説明どおり、package_scheduler.zipとpackage_class.zipをそれぞれダウンロード→展開して、次のようなコードを書いてみましょう。
PHP
$launcher = new SOS_Scheduler_OrderCommand_Launcher(
'localhost', //アドレス
4444, //ポート
30 //タイムアウト
);
$order = $launcher->add_order(’/test/job_chain1', null);
$order->replace = 'yes';
$order->id = 1; //任意のジョブオーダーID
//パラメータの指定（パラメータが必要な場合）
$order->addParam($key, $value);
//実行時間の指定
$order->at('now');
$launcher->execute($order);
エラー制御とかは一切していないコードですが、これで先ほど説明したTCPでXMLを投げた場合と同じことが出来ます。
