stop-job

概要

ジョブを停止します。
ジョブを停止させる場合は、トランザクショナル停止モードと、強制停止モードを指定することができます。
トランザクショナル停止モードとは、実行中の処理をコミット（またはロールバック）したタイミングでジョブを停止させます。
一方、強制停止モードの場合は、仕掛かり中のトランザクションの状態によらず処理を中断し、トランザクションはロールバックしてジョブを停止させます。
ジョブ開始コマンドにリクエストID(--reqid)を指定している場合は、リクエストID指定でジョブを停止させることができます。
リクエストIDを利用しない場合は、ジョブ開始コマンド同様、ジョブ名とジョブパラメータの組合せによって停止させるジョブの実行を特定します。

パス

${BS_HOME}/bin

権限

本コマンドを実行するには、アカウントに以下のいずれかのロールが必要です。

• Administrator
• JobExecutor

書式

stop-job <接続オプション> <コマンドオプション>

接続オプション

WebOTX Batch Serverのコマンドは、バッチドメインエージェントを経由して各バッチコンテナへ指示を行います。
そのため、WebOTX Batch Serverが提供する主なコマンドはバッチドメインエージェントへの接続オプションの指定が必要です。

{--user <user> --password <password> [--host <host>] [--port <port>] [--responseTimeout <responseTimeout>]
 [--responseRetry <responseRetry>]}

コマンドオプション

{[--transactional | --force] [--timeout <timeout>]
 --jobname <jobname> [--batchap <batchap>] [--batchapgroup <batchapgroup>]
 [--reqid <reqid>]
 [--parameterfile <parameterFile>] [jobParameters]
 [--serverResponseTimeoutRatio <serverResponseTimeoutRatio>] | --version | --help}

{[--transactional | --force] [--timeout <timeout>] [--serverResponseTimeoutRatio <serverResponseTimeoutRatio>]
 --reqid <reqid> | --version | --help}

戻り値

実行例

[root@localhost bin]# ./stop-job --user user --password pass --batchapgroup default --batchap default --jobname hello --reqid 15 jobParam1=value1 jobParam2=value2 --transactional

 INFO - Command start processing (stop-job)
 INFO - Command is done. (stop-job)
ExitCode = 0

[root@localhost bin]# ./jobctl.sh start --user user --password pass  --batchapgroup default --batchap default --jobname hello --reqid 15 jobParam1=value1 jobParam2=value2

2010/03/15 18:42:09 026  INFO  main AbstractJobControlCommand - [BS240341001] コマンドの処理を開始します。
2010/03/15 18:42:09 239  INFO  main StartJobCommand - [BS240341002] ジョブの開始を要求しています。
2010/03/15 18:42:09 314  INFO  main StartJobCommand - [BS240341004] ジョブが開始されるのを待機します。
2010/03/15 18:42:09 789  INFO  main StartJobCommand - [BS240341005] ジョブが開始されたことを検知しました。
2010/03/15 18:42:09 790  INFO  main StartJobCommand - [BS240341006] DomainName = batchDomain1, ContainerName = container1-1, JobInstanceId = 26, JobExecutionId = 26
2010/03/15 18:42:09 790  INFO  main StartJobCommand - [BS240341008] ジョブ実行ログを表示します :-

  〜snip〜

2010/03/16 14:38:12 960 ERROR WorkManager-2 ThreadStepInterruptionPolicy - Step interrupted
2010/03/16 14:38:12 961 ERROR WorkManager-2 AbstractStep - Encountered an error executing the step
org.springframework.batch.core.JobInterruptedException: Job interrupted status detected.
        at org.springframework.batch.core.step.ThreadStepInterruptionPolicy.checkInterrupted(ThreadStepInterruptionPolicy.java:44)

  〜snip〜

2010/03/16 14:38:13 173  INFO  main StartJobCommand - [BS240341009] ジョブが終了しました。 status = STOPPED :-

com.nec.webotx.batch.core.execution.RuntimeJobStatus$UserException : original Exception is org.springframework.batch.core.JobInterruptedException : Job interrupted by step execution
original stack trace is :-
Exit Code = 106

関連

• コマンドリファレンス
  • start-job
    
  • result-job
    
  • status-job
    
  • jobctl stop
    
• 運用・利用ガイド
  • バッチアプリケーションの運用・利用ガイド
    • ジョブの実行
      • 実行中のジョブを停止する
• 機能ガイド
  • ジョブ実行制御
    • ジョブの停止