result-job

概要

ジョブの結果を取得します。
start-jobコマンドで指定したオプションと同一のアカウント名、ジョブ名、ジョブパラメータを指定して、そのジョブの実行結果(コマンドの戻り値とジョブ実行ログ)を取得します。
ジョブを投入する事を除けば、start-jobコマンドと同様の動作を行います。
ジョブが開始されていない場合、ジョブが開始されることを待機します。
指定されたジョブをバッチドメインエージェントが受け付けていない場合はエラーとなります。

パス

${BS_HOME}/bin

権限

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

• Administrators
• JobExecutors
• JobObserver

書式

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

接続オプション

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

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

コマンドオプション

{--jobname <jobname> [--batchap <batchap>] [--batchapgroup <batchapgroup>] [--reqid <reqid>]
 [--exitcodemapping <exitcodeMappingFile>] [--silent]
 [--parametersfile <parametersFile>] [jobParameters]
 [--serverResponseTimeoutRatio <serverResponseTimeoutRatio>] | --version | --help}

{--reqid <reqid> [--exitcodemapping <exitcodeMappingFile>] [--silent]
 [--serverResponseTimeoutRatio <serverResponseTimeoutRatio>] | --version | --help}

戻り値

下表の戻り値は、jobctlコマンドのstart , result、および、start-jobコマンド、result-jobコマンド特有の戻り値です。これらのコマンドの戻り値は、ExitStatus との対応関係によって決まります。これらの戻り値は、戻り値定義ファイル の設定により変更可能です。
戻り値 と ExitStatus との対応関係については、ExitCodeMapping機能 を参照してください。

コマンド共通の戻り値は、ExitCodeマッピング機能では変更できません。

実行例

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

 INFO - Command start processing (result-job)
 INFO - waiting to job is started.
 INFO - Job process is started. DomainName = batchDomain1, ContainerName = container1-1, JobInstanceId = 23, JobExecutionId = 23

 INFO - Start Job Execution Log :-

<ジョブ実行時のログが表示されます>

 INFO - Command is done. (result-job)
ExitCode = 0

関連

• コマンドリファレンス
  • start-job
    
  • stop-job
    
  • status-job
    
  • jobctl result
• 運用・利用ガイド
  • バッチアプリケーションの運用・利用ガイド
    • ジョブの実行
      • ジョブの実行結果を取得する
      • ジョブ終了時のコマンド戻り値を設定する
• 機能ガイド
  • ジョブ実行制御
    • ジョブの実行結果取得
  • ExitCodeMapping機能
• 定義ファイルリファレンス
  • DOMAIN_HOME/config/batch/exitcode/
    • mapping.properties