リファレンス・ガイド

     前  次    新規ウィンドウで目次を開く    PDFとして表示 - 新規ウィンドウ  Adobe Readerを取得 - 新規ウィンドウ
コンテンツはここから始まります

Tuxedo Job Enqueueing Service(TuxJES)

この章では、TuxJES機能に含まれるサーバー、コマンドおよびユーティリティについて説明します。

表1に、TuxJESのコマンドと関数を示します。

表1 TuxJESのサーバー、コマンドおよびユーティリティ
名前
説明
genappprofile
TuxJESシステムのセキュリティ・プロファイルを生成します。
artjesadmin
TuxJESコマンド・インタフェース。
ARTJESADM
TuxJES管理サーバー。
ARTJESCONV
TuxJES変換サーバー。
ARTJESINITIATOR
TuxJESジョブ制御API。
ARTJESPURGE
ジョブ・キューをパージします。
TuxJESキュー・システム
TuxJESキュー・システム。

 

genappprofile

名前

genappprofile – TuxJESシステムのセキュリティ・プロファイルを生成します。

概要 

genapprofile [-f userprofile]

説明

このユーティリティは、TuxJESシステムのセキュリティ・プロファイルを生成します。genappprofileが起動されると、Oracle Tuxedoのアプリケーション・パスワード、ユーザー名、ユーザー・パスワードおよびデータベース接続(MT_DB_LOGIN)の入力を求められます。出力されるのはセキュリティ・プロファイル・ファイルです。このファイルにはOracle Tuxedoアプリケーション・パスワード、ユーザー名、ユーザー・パスワードおよびデータベース接続が含まれます。

注意: 生成されたセキュリティ・プロファイル・ファイルは、artjesadminツールで、Oracle Tuxedoドメインにログインするために使用できます。

パラメータとオプション

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

[-f <output_file>]

生成されたセキュリティ・プロファイル・ファイルの場所。このオプションを指定しない場合のデフォルト値は~/.tuxAppProfileです。

関連項目

artjesadmin

 

artjesadmin

名前

artjesadmin – TuxJESコマンド・インタフェース。

概要 

artjesadmin [-f security_profile]

説明

artjesadminは、TuxJESコマンド・インタフェースです。TuxJESシステムが先に開始されている必要があります。

パラメータとオプション

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

-f

genappprofileによって生成されるセキュリティ・プロファイル・ファイル。このプロファイルのユーザー名は、送信されたジョブの所有者です。所有者が指定されていないジョブには、所有者名「*」が割り当てられます。
個別の所有者を持つジョブは、その所有者のみが制御できます。個別の所有者(*)のないジョブは、誰でも制御できます。いかなるユーザーでも、すべてのジョブを出力できます。

artjesadminは、次のサブ・コマンドをサポートします。

submitjob(smj ) [-o='xxx'] -i scriptfile

ジョブをTuxJESシステムに送信します。scriptfileパラメータは、送信されるジョブ・スクリプトです。
注意: artjesadminは、scriptfileの通知を担当しません。変換と実行が同じマシン上にない場合、共有ファイル・システム上にあるはずです。オプションは次のとおりです。
o='xxx': EJRに渡されるオプション文字列。 -i =scriptfile: スクリプト・ファイル。パスは、絶対パスか、現在の作業ディレクトリとの相対パスで指定できます。絶対パスでは、長さが1023文字に制限されています。 正常に呼び出されると、リターン・フォーマットJob xxxが正常に送信されます。エラーが発生した場合、エラー・メッセージが出力されます。artjesadminは、artjesadmin [-o='xxx'] -i scriptfileのフォーマットを使用してジョブの直接送信もサポートします。 表2でリストされているようなエラーが発生する場合、artjesadminにはゼロ以外のリターン・コードが含まれます。

表2 エラー・コード
コード
説明
0
ランタイム・エラーなし
251
ARTJESADMサーバーによって戻されたartjesadminコマンド自体のエラー
252
JES2SUBMITサービス・エラー
その他
EJRノン・ゼロ終了コード

printjob(ptj) -n jobname | -j jobid | -c job_class |-a [-v]

既存のジョブを表示します。オプションが指定されない場合、すべてのジョブを表示します。オプションは次のとおりです。
-n jobname: 指定されたジョブ名を持つジョブを表示します
-j jobid: 個別のジョブ情報を表示します
-c job_class: 個別のクラス・ジョブ情報を表示します
-a: すべてのジョブを表示します
-v: 冗長モード
リスト1 printjobの出力 
> ptj -a
JOBNAME 	JobID    Owner    Prty C     Status
 -------- -------- -------- --------- ---------
 cjob     00000015 *           5 A     DONE
 cjob     00000016 *           5 A     DONE
 cjob     00000018 *           5 A     CONVING
total:3
success:3
冗長モードでは、ジョブの詳細情報が表示されます。
オプションを指定しない場合、-aオプションとみなされます。

holdjob(hj) -n job name | -j jobid | -c job_class | -a

CONVINGまたはWAITINGステータスの、指定されたジョブを保留します。オプションは次のとおりです。
-n jobname: 指定されたジョブ名を持つジョブを保留します。
-j jobid: 個別のジョブを保留します
-c job_class: 個別のクラス・ジョブを保留します
-a: すべてのジョブを保留します
オプションを指定しない場合、-aオプションとみなされます。

releasejob(rlj) -n job name |-j jobid | -c job_class | -a

ARTJESCONVによる変換、またはARTJESINITIATORによる実行の対象として選択できるように、HOLD_WAITINGまたはHOLD_CONVINGステータスのジョブを解放します。オプションは次のとおりです。
-n jobname: 指定されたジョブ名のジョブを解放します
-j jobid: 個別のジョブを解放します
-c job_class: 個別のクラス・ジョブを解放します
-a: すべてのジョブを解放します
オプションを指定しない場合、-aオプションとみなされます。

canceljob(cj) -n job name |-j jobid | -c job_class l -a

ジョブを取り消して出力キューに送ります。実行中のジョブでは、このコマンドは関連するARTJESINITIATORを通知し、"-k"オプションを使用してEJRを呼び出します。その他のジョブは直接出力キューに送られます。TuxJESシステムは、EJRが返されるとジョブが終了したとみなします。オプションは次のとおりです。
-n jobname: 指定されたジョブ名を持つジョブを取り消します
-j jobid: 個別のジョブを取り消します
-c job_class: 個別のクラス・ジョブを取り消します
-a: すべてのジョブを取り消します
オプションを指定しない場合、-aオプションとみなされます。

purgejob(pgj) -n job name | -j jobid | -a

出力キューの完了されたジョブが、パージ・キューへ移動されます。他のジョブの場合、purgejobが、canceljobと同じ効果を持っています。purgejobコマンドは、ジョブを直接パージしません。ARTJESPURGEサーバーが、TuxJESシステムからジョブを削除します。ARTJESPURGEが開始されない場合、ジョブは出力キューに残ります。
使用できるオプションは次のとおりです。
-n jobname: 指定されたジョブ名を持つジョブをパージします
-j jobid: 個別のジョブをパージします
-a: すべてのジョブをパージします
オプションを指定しない場合、-aオプションとみなされます。

changeconcurrent(chco) -g groupname -i serverid -n concurrent_num

-gと-iオプションで指定されたARTJESINITIATORサーバーの最大同時実行ジョブ数を変更します。変更は、ARTJESINITIATOR サーバーを再起動しなくても有効になります。
使用できるオプションは次のとおりです。
-g groupname: ARTJESINITIATORサーバーのTuxedoグループ名
-i serverid: ARTJESINITIATORサーバーのTuxedoサーバーID
-n concurrent_num: 最大同時実行ジョブ数
変更は永続的ではなく、ARTJESINITIATORサーバーが再起動すると、数がリセットされます。

printconcurrent(pco) -g groupname -i serverid

-gと-iオプションで指定されたARTJESINITIATORサーバーの最大同時実行ジョブ数を表示します。
使用できるオプションは次のとおりです。
-g groupname: ARTJESINITIATORサーバーのTuxedoグループ名
-i serverid: ARTJESINITIATORサーバーのTuxedoサーバーID

event (et) [-t S,C,E,P,A] on|off

このコマンドは、個別のジョブ・イベントをサブスクライブするようにartjesadminに指示します。オプションは次のとおりです。
S: ジョブ送信イベント。イベント名は、ARTJES_JOBSUBMITです
C: ジョブ変換完了イベント。イベント名はARTJES_JOBCVTです
E: ジョブ実行終了イベント。イベント名は、ARTJES_JOBEXECです
P: ジョブ・パージ・イベント。イベント名はARTJES_ARTJESPURGEです
A: サポートされているすべてのイベント。イベントがonに設定されている場合、Aがデフォルトです。
on |off: 送信がonまたはoffです。on設定は、-tオプションとともに使用できます。offにすると、すべてのイベント・サブスクリプションのサブスクライブが解除されます。
サブスクライブされているイベント・タイプがJESCONFIG内に構成されていない場合は、エラーがレポートされます。

verbose(v) on|off

冗長モードのオン/オフを切り替えます。

関連項目

Oracle Tuxedo Application Runtime for Batchユーザー・ガイド

 

ARTJESADM

名前

ARTJESADM – TuxJES管理サーバー。

概要

ARTJESADM

SRVGRP=”identifier”

SRVID=”number” CLOPT=” [-A][servopts options] -- -i JESCONFIG”

説明

ARTJESADMは、TuxJESによって提供されるOracle Tuxedoアプリケーション・サーバーです。artjesadminコマンドは、大部分のタスクでARTJESADMと通信します。

ARTJESADMが提供するサービスに他のTuxJESサーバーがアクセスするため、ARTJESADMは、UBBCONFIGファイル内で他のTuxJESサーバーより前に構成されている必要があります。JESCONFIGを変更した場合、新しい構成が有効になるには、すべてのTuxJES関連のサーバーを再起動する必要があります。

パラメータとオプション

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

-i JESCONFIG

JESCONFIG は、TuxJESシステム構成ファイルのフル・パス名を表します。次のパラメータを使用できます。

JESROOT

ジョブ情報を格納するルート・ディレクトリのフル・パス名。必須の属性です。このディレクトリが存在しない場合、ARTJESADMが自動的に作成します。
JESROOT=/xxx/xxx

DEFAULTJOBCLASS

ジョブに対してジョブ・クラスが設定されていない場合のデフォルト・ジョブ・クラス。オプションの属性です。この属性が設定されていない場合、デフォルト・ジョブ・クラスはAです。
DEFAULTJOBCLASS=[A-Z],[0=9]

DEFAULTJOBPRIORITY

ジョブに対してジョブ優先度が設定されていない場合のデフォルトのジョブ優先度。オプションの属性です。この属性が設定されていない場合、デフォルトのジョブ優先度は0です。
DEFAULTJOBPRIORITY=[0-15]

DUPL_JOB=NODELAY

設定されていない場合、あるジョブ名に対して、1つのジョブだけが実行ステータスであることができます。NODELAYは、依存性チェックを削除します。デフォルト値は、遅延実行です。

EVENTPOST=S,C,E,P,A

個別のステージで、ジョブに対してイベントがポストされるかどうかを指定します。
S: ジョブ送信イベント。イベント名: ARTJES_JOBSUBMIT
C: ジョブ変換完了イベント。イベント名: ARTJES_JOBCVT
E: ジョブ実行終了イベント。イベント名: ARTJES_JOBFINISH
P: ジョブ・パージ・イベント。イベント名:ARTJES_JOBPURGE
A: サポートされているすべてのイベント。
EVENTPOSTが指定されない場合、イベントはポストされません。イベントのポストでのデータ・バッファはFML32タイプで、フィールドはJESDIR/include/jesflds.hで定義されます。

JOBREPOSITORY

ジョブが格納されるジョブ・リポジトリのパス。設定された場合、ジョブ送信で入力されたスクリプト・ファイル・パスに、JOBREPOSITORY内の相対パスを使用できます。

例

UBBCONFIGの例:

ARTJESADM

SRVID=1 SRVGRP=SYSGRP CLOPT="-A -- -i /nfs/users/jes/jesconfig"

関連項目

Oracle Tuxedo Application Runtime for Batchユーザー・ガイド

 

ARTJESCONV

名前

ARTJESCONV – TuxJES変換サーバー。

概要

ARTJESCONV

SRVGRP=”identifier”

SRVID=”number” CLOPT=” [-A][servopts options] -- ”

説明

TuxJES変換サーバー。ジョブ変換をするためのEJR起動を担当します。

例

UBBCONFIGの例:

ARTJESCONV

SRVID=2 SRVGRP=SYSGRP CLOPT="-A -- "

関連項目

Oracle Tuxedo Application Runtime for Batchユーザー・ガイド

 

ARTJESINITIATOR

名前

ARTJESINITIATOR – ジョブ・イニシエータ

概要

ARTJESINITIATOR

SRVGRP=”identifier”

SRVID=”number” CLOPT=” [-A][servopts options] -- -C jobclasses [-n concurrent_num] [-d]”

説明

ARTJESINITIATORは、Oracle Tuxedoアプリケーション・サーバーにより提供されるTuxJESです。ジョブを実行するためのEJR起動を担当します。

実行中のジョブがある間にARTJESINITIATOR が強制終了またはシャットダウンされると、そのジョブは、再起動時にINDOUBT状態に入れられます。

パラメータとオプション

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

-c jobclasses[jobclass]

このARTJESINITIATORサーバーが関連付けられているジョブ・クラスを指定します。このオプションを指定しない場合、ARTJESINITIATORはすべてのジョブ・クラスに関連付けられます。

-n concurrent_num

このARTJESINITIATORサーバーの最大同時実行ジョブ数を指定します。デフォルト値は1です。

-d

このARTJESINITIATORサーバーの最大同時実行ジョブ数を指定しますが、artjesadmin changeconcurrentコマンドで変更できます。

例

UBBCONFIGの例:

ARTJESINITIATOR

SRVID=3 SRVGRP=SYSGRP MIN=10 CLOPT="-A -- -c AHZ"

この例では、10のARTJESINITIATORインスタンスが構成され、A、HおよびZジョブ・クラスに関連付けられます。

関連項目

Oracle Tuxedo Application Runtime for Batchユーザー・ガイド

 

ARTJESPURGE

名前

ARTJESPURGE – ジョブ・キューをパージします

概要

ARTJESPURGE

SRVGRP=”identifier”

SRVID=”number” CLOPT=” [-A][servopts options] -- ”

説明

ARTJESPURGEは、パージ・キューを監視します。パージ・キューにジョブを検出すると、キュー内のジョブを削除し、ディレクトリJESROOT/<JOBID>を削除します。

関連項目

Oracle Tuxedo Application Runtime for Batchユーザー・ガイド

 

TuxJESキュー・システム

z/OS JES2システムをエミュレートするために、TuxJESシステムは、キュー機構を使用してバッチ・ジョブのライフサイクルを管理します。すべてのキューは、JES2QSPACEと呼ばれる1つのキュー・スペースに作成されます。バッチ・ジョブは、表3にリストされたキューにあり、またはそこに転送されるメッセージによって表されます。

表3 TuxJESキュー
キュー
説明
変換キュー
バッチ・ジョブがTuxJESシステムに送信されると、まず変換キューに入れられます。システムには、変換キューは1本だけ存在します。変換されたジョブは、変換キューから実行キューに移動されます。キューのジョブは、FIFO順に処理されます。
キュー名: CONV
保留キュー

ジョブがHOLD状態(JCLHOLDまたはHOLD)の場合、保留キューに入れられます。解放されると、typrunパラメータに基づいて、変換キューまたは待機キューに移動されます。

キュー名: HOLD
実行キュー
36のジョブ・クラス(A - Zおよび0 - 9)があります。ジョブには、0 - 15の優先度値もあります。ジョブは、ジョブ・クラスと優先度に基づいてスケジュールされます。
1つのジョブ・クラスは、1つの/Qキュー(36のキューをまとめたもの)にマップされます。これらは、ジョブが保留状態で格納され、実行を待機するキューです。ジョブ優先度は、キュー・メッセージ優先度にマップされます。キューはすべて、優先度に基づいて作成されます。
キュー名: [A-Z]、[0-9]。
実行中キュー
このキューは、動作中/実行中のジョブを格納します。システムに、実行中のキューは1つだけです。ジョブが実行キューから取り出され、実行中の状態に正常に移行すると、ジョブは実行中キューに移動されます。このキューのジョブは、FIFO順に処理されます。
キュー名: EXEC
出力キュー
完了するか、エラーが発生したジョブは出力キューに送信されます。出力キューは1つのみ存在します。キュー内のジョブは、FIFO順に処理されます。
キュー名: OUTPUT
パージ・キュー
パージされる予定のジョブは、パージ・キューへ移動されます。システムに、パージ・キューは1つのみ存在します。
キュー名: PURGE
内部キュー
ART JESも、内部使用のためにJES2QSPACE上にいくつかの内部キューを持っています。

TuxJESキュー作成スクリプト

キュー・スペース(JES2QSPACE)と、表3にリストされたキューを作成するために、TuxJESシステムには、サンプル・シェル・スクリプト(jesqinit)が用意されています。環境に合わせてスクリプトを変更することはできますが、以下を厳守する必要があります。

  1. キュー順序は、変更できません
  2. キュー名とキュー・スペース名は固定です
  3. スクリプトは、キュー・スペース/キュー作成パラメータに合わせてカスタマイズできます

推奨/Q作成値

ページのデバイス・サイズ: 10000

ページのキュー・スペース・サイズ: 5000(ジョブの最大数は10000、各ジョブは2kバイト消費し、ページ・サイズは4kと想定します)

キュー内のメッセージ数: 10000

同時トランザクション数: 1000

キュー内の同時プロセス数: 100

注意: これらのパラメータは、固有の環境に合わせてカスタマイズできます。

  先頭に戻る       前  次