1. Application Runtime for Batchリファレンス・ガイド
  2. Tuxedo Job Enqueueing Service (TuxJES)
  3. TuxJESのサーバー、コマンドおよびユーティリティ
  4. artjesadmin
  5. パラメータとオプション

3.1.4.4 パラメータとオプション

artjesadminでは、以下のパラメータとオプションがサポートされます。

-h
オプション-hは、前述でリストされているように、artjesadminの使用率情報を出力します。
-v
オプション-vは、Oracle Tuxedo Application Runtime for Batchの現在のバージョンを表します。
-f
genjesprofileによって生成されるセキュリティ・プロファイル・ファイル。デフォルト値は~/.tuxAppProfileです。セキュリティ・プロファイルの所有者は、必ずartjesadminの実行ユーザーであることが求められます。このプロファイルのユーザー名は、送信されたジョブの所有者です。所有者が指定されていないジョブには、所有者名「*」が割り当てられます。
個別の所有者を持つジョブは、その所有者のみが制御できます。個別の所有者(*)のないジョブは、誰でも制御できます。いかなるユーザーでも、すべてのジョブを出力できます。

ノート:

  • -f profileを指定すると、指定したプロファイル・ファイルが使用されます。
  • プロファイルを指定せずに-fを指定すると、プロファイル・ファイルとして~/.tuxAppProfileが使用されます。
  • -fを指定しない場合、プロファイル・ファイルとして何も使用されません。
-p and -j
オプション-pと-jは、artjesadminコンソールを使用せずにジョブ・ステータスを取得するために追加されたオプションです。
次の表に、-pを指定したときのartjesadminの終了コードを示します。

表3-2 終了コード

終了コード 説明 備考
0 ジョブが正常に終了しました。ジョブ・ステータス = DONE ジョブが正常に終了しました。
1 コマンド実行が失敗しました。 失敗の原因は、内部エラー、ネットワーク・エラーまたは構文エラーのいずれかです。
3 ジョブ・ステータス = FAIL ジョブ実行が失敗しました。
4 ジョブ・ステータス = CANCEL ジョブがキャンセルされました。
5 ジョブ・ステータス = CONVING ジョブは変換を待機しています。
6 ジョブ・ステータス = EXECUTING ジョブは実行中です。
7 ジョブ・ステータス = HOLD_CONVING ジョブは、変換なしの保留状態です。
8 ジョブ・ステータス = HOLD_WAITING ジョブは、変換後の保留状態です。
9 ジョブ・ステータス = WAITING ジョブは実行を待機しています。
10 ジョブ・ステータス = DISCARD このステータスは、tpenqueue()が失敗したときに発生します。
11 ジョブ・ステータス = INDOUBT ジョブが実行されているときに、JESサーバーARTJESINITIATORがシャットダウンして再起動した場合、ジョブ・ステータスはINDOUBTになります。
22 ジョブは存在しません。 なし
次の表に示す情報は、次の書式でstdoutに出力されます。
<JOBID>,<JOBNAME>,<JOBSTATUS>,<JOB RETURN CODE>

表3-3 標準出力

出力内容 説明 サンプル
<JOBID> ジョブID 00005097
<JOBNAME> ジョブ名 JOBA
<JOBSTATUS> ジョブの現在のステータス DONE
<JOB RETURN CODE> EJRから返された、ジョブのリターン・コード(ジョブが完了した場合のみ) C000

リスト 例: ジョブが正常に終了しました 

00000002,JOBA,DONE,C0000

リスト 例: ジョブは終了しましたが、失敗しています 

00000002,JOBA,FAILED,U0568

リスト 例: ジョブが実行中です 

00000002,JOBA,EXECUTING
-x showjobexec|resumejobexec|stopjobexec [[lmid=machine|grpid=groupid|grpid=groupid,srvid=serverid];...]
オプション-xは、ARTJESINITIATORサーバーを制御するために指定します。これは、showjobexec、resumejobexec、またはstopjobexecでなければなりません。詳細は、「サブコマンド」を参照してください。
-t <timeout>
オプション-t <timeout>は、同期モード、非同期モード、またはコンソール・モードでジョブを発行するときのタイムアウトしきい値を制御するために指定します。-tオプションを使うと、タイムアウトの制御に整数を指定できます。タイマーが指定されていない場合、クライアントは永遠に待機します。
  • 同期モードでは、タイマーはジョブ(発行から実行まで)の完了を待機するために使用されます。
  • 非同期モードまたはコンソール・モードでは、タイマーはジョブ(発行のみ)の完了を待機するために使用されます。
-T
オプション-Tは、テスト・モードでジョブを送信するために指定します。このジョブの実行ではなくチェックのみが行われます。テスト・モードの詳細は、EJRの構文の-t file|NULL引数を参照してください。
-o <Job Execution Engine Options>
-oを使用すると、ジョブ実行エンジンに特別なオプションを渡すことができます。ジョブがKSHに存在する場合は、KSH実行エンジンにオプションが渡され、ジョブがJCLに存在する場合は、ネイティブのJCL実行エンジンにオプションが渡されます。
  • KSH実行エンジンで使用可能なオプションが次のようにリストされます。
    -o “-f <envfile>”
    現在のジョブの環境変数を含む環境ファイルのフルパスを指定します。これは、シェル・スクリプトの構文に準拠する必要があります。このファイルには、export <KEY>=<VALUE>または<KEY>=<VALUE>;export <KEY>を使用して環境変数を設定する必要があります。
  • JCL実行エンジンで使用可能なオプションが次のようにリストされます。
    -o “-e <envfile>”
    現在のジョブの環境変数を含む環境ファイルのフルパスを指定します。これは、<KEY>=<VALUE>の形式の構文に準拠する必要があります。
-y
オプション-yは、ジョブを同期的に発行するために追加されたオプションです。このオプションは、ジョブが終了するまで待機する同期モードを有効にします。

ノート:

同期的にジョブを発行するには、TuxJES構成ファイルにEVENTPOST=Aを設定する必要があります。
次の表に、-yを指定したときのartjesadminの終了コードを示します。

表3-4 終了コード

終了コード 説明 備考
0 ジョブは正常に完了しました。 なし
1 コマンド実行が失敗しました。 このコードは、無効なタイムアウト値またはコマンド行の構文エラーのどちらかによって返されます。
2 ジョブ変換が失敗しました。 ジョブは正常に送信されましたが、ジョブ変換が失敗しました。
3 ジョブ実行が失敗しました。 ジョブは正常に送信されましたが、ジョブ実行が失敗しました。
4 ジョブが取り消されました。 ジョブは正常に送信されましたが、最終ステータスに到達する前にキャンセルされました。
20 タイムアウトが発生しました。 -tオプションで指定された時間内にジョブが完了しませんでした。
次の表に示す情報は、次の書式でstdoutに出力されます。
<JOBID>,<JOBNAME>,<JOBSTATUS>,<JOB RETURN CODE>

表3-5 標準出力

出力内容 説明 サンプル
<JOBID> ジョブID 00005097
<JOBNAME> ジョブ名 JOBA
<JOBSTATUS> ジョブの最終ステータス(タイムアウトが発生する前に終了した場合のみ) DONE
<JOB RETURN CODE> EJRから返された、ジョブのリターン・コード(タイムアウトが発生する前にジョブが完了した場合のみ) C000

リスト 例: ジョブが正常に実行されました 

00000002,JOBA,DONE,C0000

リスト 例: ジョブが失敗しました 

00000002,JOBA,FAILED,U0568

リスト 例: タイムアウトが発生しました 

00000002,JOBA,Already Timeout!
-i
オプション-iは、KSHジョブを送信するために指定します。scriptfileはフルパスにするか、APPDIR環境変数またはJOBREPOSITORY構成項目の相対パスにする必要があります。
-I
オプション-lは、JCLジョブを送信するために指定します。scriptfileはフルパスにするか、APPDIR環境変数またはJOBREPOSITORY構成項目の相対パスにする必要があります。
-x settracelevel [trclvl=trace_level[,[lmid=machine|grpid=groupid|grpid=groupid,srvid=serverid];...]]
オプション-x settracelevelは、TuxJESトレース・メッセージ・レベルを設定するために指定します。詳細は、「サブコマンド」を参照してください。
-x setjesacl aclfile=rulepath[,aclfiletype=PLAIN|ENCRYPTED[,aclmode=MAC|DAC]]
オプション-x setjesaclは、ジョブ・アクセス認可を変更するために指定します。詳細は、「サブコマンド」を参照してください。

親トピック: artjesadmin