リファレンス・ガイド

Tuxedo Job Enqueueing Service (TuxJES)

この章には次のトピックが含まれます:

TuxJESのサーバー、コマンドおよびユーティリティ

TuxJESジョブの操作

TuxJESのサーバー、コマンドおよびユーティリティ

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

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

genjesprofile

名前

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

形式

genjesprofile [-f userprofile]

説明

genjesprofileはTuxJESシステム・セキュリティ・プロファイルを生成します。genjesprofileを起動すると、MT_DB_LOGINのOracle Tuxedoアプリケーション・パスワード、ユーザー名、ユーザー・パスワード、データベース接続文字列、MT_GDG_DB_ACCESS、MT_DB_LOGIN2、MT_CATALOG_DB_LOGINそれぞれのデータベース接続文字列、およびMT_FTP_PASSに対するftpパスワードを入力するように要求されます。

出力はセキュリティ・プロファイル・ファイルで、これにはMT_DB_LOGINのOracle Tuxedoアプリケーション・パスワード、ユーザー名、ユーザー・パスワード、データベース接続文字列、MT_GDG_DB_ACCESSとMT_DB_LOGIN2のデータベース接続文字列、MT_CATALOG_DB_LOGINのデータベース接続文字列にファイル権限-rw-------を指定したもの、およびMT_FTP_PASSに対するftpパスワードが記録されます。

パラメータとオプション

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

[-f <output_file>]

関連項目

artjesadmin

genjesacl

名前

genjesacl - TuxJESシステム用に暗号化されたジョブ・アクセス認可構成ファイルを生成します。

形式

genjesacl [-f <output_file>]

説明

genjesaclはSTDIN行から1行ずつルールを読み取り、EOFに到達したら(端末の行の先頭でCtrl+Dを押すとEOFが発生します)、暗号化された構成ファイルを生成します。これは、JES_ACL_FILE_TYPE=ENCRYPTEDが指定されている場合に使用します。

生成された暗号化済みの構成ファイルは、ARTJESADMツールでのTuxJESジョブ・アクセスの認可に使用できます。

パラメータとオプション

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

[-f <output_file>]

関連項目

ARTJESADM

gensysprofile

名前

gensysprofile – TuxJESデータベースの接続情報を暗号化および格納するファイルを生成します。

形式

gensysprofile -d <JESROOT>

説明

gensysprofileはTuxJESデータベースの接続情報を暗号化および格納するファイルを生成します。

パラメータとオプション

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

-d <JESROOT>

artjesadmin

名前

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

形式

説明

artjesadminはTuxJESコマンド・インタフェースです。まず、TuxJESシステムを起動する必要があります。

パラメータとオプション

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

-h

-v

-f

-pと-j

00000002,JOBA,DONE,C0000

00000002,JOBA,FAILED,U0568

00000002,JOBA,EXECUTING

-x showjobexec|resumejobexec|stopjobexec [[lmid=machine|grpid=groupid|grpid=groupid,srvid=serverid];...]

-t <timeout>

-o ejr option

-y

00000002,JOBA,DONE,C0000

00000002,JOBA,FAILED,U0568

00000002,JOBA,Already Timeout!

-i

-I

-x settracelevel [trclvl=trace_level[,[lmid=machine|grpid=groupid|grpid=groupid,srvid=serverid];...]]

-x setjesacl aclfile=rulepath[,aclfiletype=PLAIN|ENCRYPTED[,aclmode=MAC|DAC]]

サブ・コマンド

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

submitjob (smj) -i|-I scriptfilename [-t timeout] [-o ejr option]

showjobexec(she) [-n machine] | [-g groupid [-i serverid]]

stopjobexec(ste) [-n machine] | [-g groupid [-i serverid]]

resumejobexec(rse) [-n machine] | [-g groupid [-i serverid]]

settracelevel(stl) -t tracelevel [-n machine] | [-g groupid [-i serverid]]

setjesacl (sja) -f rulepath [-t PLAIN|ENCRYPTED] [-m MAC|DAC]

エラー

正常に呼び出されると、リターン・フォーマットJob xxxが正常に送信されます。エラーが発生した場合、エラー・メッセージが出力されます。

artjesadminは、次の書式を使用する直接ジョブ送信もサポートします。artjesadmin [-o='xxx'] -i/-I scriptfile。

表6にまとめられているようなエラーが発生した場合、artjesadminの戻りコードは0意外になります。

印刷

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

> ptj -a

JOBNAME   JobID    Owner    Prty C     Type     Status

-------- -------- -------- ---------  ------   --------

 cjob     00000015 *           5 A     KSH      DONE

 cjob     00000016 *           5 A     KSH      DONE

 cjob     00000018 *           5 A     KSH      CONVING

total:3

success:3

関連項目

artjescleanlock

名前

artjescleanlock – MPモードでロック・ファイル内の失効ロック・レコードを消去するユーティリティ。

形式

artjescleanlock -c [-y] [-h <hostname>] [-f <filefullpath>]

artjescleanlock -l [-h <hostname>] [-f <filefullpath>]

説明

Artjescleanlockは、オプションで指定されるフィルタ基準に基づいて、ロック・ファイル内のロック・レコードをリストまたは消去するために使用されます。このユーティリティを実行する前に、環境変数MT_ACC_FILEPATHを正しく設定する必要があります。

パラメータとオプション

artjescleanlockでは、次のオプションがサポートされます。

-l

-c

[ -h hostname ]

[ -f filename ]

[-y]

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

例

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]

-n concurrent_num

-d

例

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つのキュー・スペースに作成されます。バッチ・ジョブは、表7にリストされたキューにあり、またはそこに転送されるメッセージによって表されます。

TuxJESキュー作成スクリプト

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

推奨/Q作成値

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

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

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

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

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

推奨されるキューの領域サイズ: 4K x (1日当たりのジョブ数) x (自動パージされるまでにJESキューにジョブが留まる日数)

TuxJESユーザー代入

JESは、ジョブを実行する特定のOSユーザーを定義することをサポートします。TuxedoユーザーとOSユーザーをマッピングするメカニズムを使用すると、JESシステムはジョブに準拠するTuxedo AAA資格証明を、ジョブを処理する際にリソースへの限定アクセス権しか持たないOSユーザーに関連付けることが可能です。

用語

表8は、この項で説明されるユーザー代入機能をよく理解する上で知っておく必要がある用語のリストです。

様々な使用状況でのジョブ所有者の職種

JESシステムによって指定されるジョブ所有者は、artjesadminおよびPRIVILEGE_MODE上の構成の組合せに左右されます。表9は、ジョブ所有者の指定と様々な使用状況との間の関係を示します。

ジョブ操作の権限

表10および表11は、ユーザーの代入を有効化しているTuxJESシステムでジョブを操作する場合の異なるIDを持つユーザーの権限を示します。

TuxJESにおけるユーザー代入の有効化

TuxJESでユーザー代入を有効化するには、次の操作を実行する必要があります。

TuxJESにおけるJESCONFIGの構成

JESCONFIGにおけるPRIVILEGE_MODEの値は、MAPPING_CREDENTIALまたはIDENTITY_CREDENTIALに指定する必要があります。

JESCONFIGにおけるPRIVILEGE_MODEの値がMAPPING_CREDENTIALの場合、USER_MAPPING_FILEの値を指定する必要があり、ユーザー・マッピング・ファイルにはOracle TuxedoユーザーとOSユーザーとの間のマッピングが含まれる必要があります。

ルート・ユーザーによるJESシステムの起動

JESがSHMモードで稼働している場合、起動はルート・ユーザーが行う必要があります。

JESがMPモードで稼働している場合、次のいずれかを実行します。

JESシステムに関与するすべてのマシンは、同一のNISシステムを使用することをお薦めします。

Tuxedo UBBCONFIGの構成

ジョブ・ユーザーは全員、JESシステムのIPCリソースへのフル権限を持つ必要があります。

TUXCONFIGのRESOURCEセクションにあるSECURITYパラメータは、USER_AUTH、ACLまたはMANDATORY_ACLにする必要があります。

次はUBBCONFIGの例です。

#	(c) 2011 Oracle. All Rights Reserved.

#

*RESOURCES

IPCKEY	 	 <IPCKEY> # for example 132770

DOMAINID	 	jessample

MASTER		 SITE1

MODEL		 SHM

MAXACCESSERS    200

MAXSERVERS      50

NOTIFY          SIGNAL

PERM		0666 #Adding "PERM=0666" in RESOURCES section

SECURITY          USER_AUTH

AUTHSVC           "AUTHSVC"

*MACHINES

#

<uname -n>

	LMID = SITE1 

	TUXDIR ="<full path of TUXEDO software>"

	TUXCONFIG = "<full path of APPDIR>/tuxconfig"

	TLOGDEVICE ="<full path of APPDIR>/TLOG"

	TLOGSIZE=10

	APPDIR = "<full path of APPDIR>"

	ULOGPFX = "<full path of APPDIR>/ULOG"

*GROUPS

ARTGRP

	LMID = SITE1  GRPNO = 1

QUEGRP

LMID = SITE1  GRPNO = 2

	TMSNAME = TMS_QM TMSCOUNT = 2

	OPENINFO = "TUXEDO/QM:<full path of APPDIR>/QUE:JES2QSPACE"

EVTGRP

                LMID= SITE1 GRPNO=3

#

*SERVERS

# Adding RQPERM=0666 RPPERM=0666 in all JES servers entry in SERVERS section

DEFAULT:	 	CLOPT="-A"

TMUSREVT        SRVGRP=EVTGRP SRVID=1 CLOPT="-A"

				RQPERM=0666 RPPERM=0666

TMQUEUE

	SRVGRP = QUEGRP  SRVID = 1

	GRACE = 0  RESTART = Y CONV = N MAXGEN=10

	CLOPT = "-s JES2QSPACE:TMQUEUE -- -t 5 "

	RQPERM=0666 RPPERM=0666

ARTJESADM        SRVGRP =ARTGRP  SRVID = 1 MIN=1 MAX=1

                CLOPT = "-A -- -i jesconfig"

                RQPERM=0666 RPPERM=0666

ARTJESCONV       SRVGRP =ARTGRP  SRVID = 20 MIN=1 MAX=1

                CLOPT = "-A --"

RQPERM=0666 RPPERM=0666

ARTJESINITIATOR       SRVGRP =ARTGRP  SRVID =30  

                CLOPT = "-A -- -n 20 -d"

                RQPERM=0666 RPPERM=0666

ARTJESPURGE       SRVGRP =ARTGRP  SRVID = 100

                CLOPT = "-A --"

AUTHSVR SRVGRP=ARTGRP SRVID=104 CLOPT="-A"

	RQPERM=0666 RPPERM=0666

*SERVICES

ファイル・システム権限の構成

ユーザー代入を正常に有効化するには、異なるIDを持つユーザーのファイル・システム権限が次の要件を満たすように構成されているか確認する必要があります。

TuxJESトレース・メッセージの制御

TuxJESトレース・メッセージはTuxJESトレース・ファイルに保存されます。デフォルトでは、TuxJESトレース・ファイルは${APPDIR}/Logsディレクトリに保存されます。Batch Runtimeを実行する前に、環境変数JES_TRACE_PATHを設定して、このディレクトリを変更できます。

TuxJESトレース・メッセージ・レベルにはERROR、WARN、INFO、およびDEBUGの4段階があります。デフォルト値はWARNです。環境変数JESTRACEを使用して、TuxJESトレース・メッセージ・レベルを設定したり、artjesadminコマンドを使用して動的に変更したりして、どのレベルのメッセージが表示されるかを決定できます。

詳細は、『Oracle Tuxedo Application Runtime for Batchユーザー・ガイド』の「Tracing TuxJES」や『Oracle Tuxedo Application Runtime for Batchリファレンス・ガイド』の「artjesadmin」を参照してください。

TuxJESジョブの操作

TuxJESでは、標準のジョブ操作インタフェースをサポートしています。サービス規約として一連のFML32フィールドが定義されています。TuxJES付属のartjesadminユーティリティでは、通常のTuxedo ATMI API (詳細は、Oracle Tuxedo API: ATMIに関する項を参照)を使用してジョブ情報を送信、制御および出力します。ユーザーは、TuxJESジョブ管理システムと通信する、パーソナライズされたアプリケーションの作成もサポートされています。このドキュメントでは、一般的な手順とプログラミング手法について説明します。

TuxJESジョブの操作で使用されるFML32フィールド

TuxJESジョブに関連するすべてのフィールドは、$JESDIR/udataobj/jesfldsで定義されます。対応するヘッダー・ファイルは、$JESDIR/include/jesflds.hにあります。表12は、ジョブ操作で使用されるフィールドを示しています。

前述のフィールドを使用するには、ソース・コードにヘッダー・ファイル$JESDIR/include/jesflds.hをインクルードし、Tuxedo FML32 APIを使用して入出力のFML32バッファを操作する必要があります。詳細は、 『FMLを使用したOracle Tuxedo ATMIアプリケーションのプログラミング』を参照してください。

TuxJESジョブの操作で使用されるATMIサービス

ARTJESADMサーバーでは、ジョブ処理のエントリとして、次のATMIサービスが提供されています。クライアント・プログラムでは、tpcallとFML32バッファなど、標準のATMI APIを使用してこれらのサービスを呼び出すことができます。このとき、入力および出力用にフィールドが準備または取得されます。

JES2SUBMIT

このサービスは、ジョブを送信する機能を提供します。

入力

必須フィールド

省略可能フィールド

出力

成功

出力バッファ内のフィールドは次のとおりです。

失敗

JES2PRINT

このサービスは、ジョブ情報の問合せで使用されます。インタフェースでは、指定のジョブIDの特定のジョブ、同じジョブ名およびジョブ・クラスの一連のジョブ、またはすべてのジョブを取得できます。結果に複数のジョブ・インスタンスが含まれる場合、これらはFML32オカレンス・スタイルとなり、オカレンスは0から始まります。たとえば、3つのジョブが返された場合、1番目のジョブがオカレンス0、2番目のジョブが1、3番目のジョブが2となります。

入力

必須フィールド

省略可能フィールド

出力

成功

失敗

JES2HOLD

このサービスは、実行中でなく、終了ステータスでもないジョブを保留するために使用されます。ジョブ・コレクションのインタフェースはJES2PRINTと同じです。

入力

必須フィールド

省略可能フィールド

出力

成功

失敗

一般的な操作が失敗した場合、JES2_JOB_ERRORにはエラー・メッセージが保持され、tperrnoはTPESVCFAILに設定されます。

JES2RELEASE

このサービスは、保留ステータスのジョブを解放するために使用されます。ジョブは、hold操作により、time typerunを送信して、保留ステータスにできます。ジョブ・コレクションのインタフェースはJES2PRINTと同じです。

入力

必須フィールド

省略可能フィールド

出力

成功

失敗

JES2CANCEL

このサービスは、ジョブの取消しで使用されます。ジョブ・コレクションのインタフェースはJES2PRINTと同じです。

入力

必須フィールド

省略可能フィールド

出力

成功

失敗

JES2PURGE

このサービスは、ジョブのパージで使用されます。ジョブがまだ終了していない場合、その効果はJES2CANCELと同じです。ジョブ・コレクションのインタフェースはJES2PRINTと同じです。

入力

必須フィールド

省略可能フィールド

出力

成功

失敗

ジョブ・ステータスの変更に対するイベント・サブスクリプション

TuxJESは、Tuxedo EventBrokerに基づくイベント通知メカニズムを備えています(詳細は、 イベントへのサブスクライブに関する項を参照)。各ステージで何か発生すると、次のユーザー・レベルのイベントが提供されます。各イベントのデータ・バッファは、特定のジョブのFML32バッファです。

イベントのポストはARTJESADM内のJESCONFIG構成に依存するため、すべてのイベントまたは一部のイベントの必要に応じて、スイッチをオンにする必要があります。

セキュリティの考慮事項

ジョブ管理サービスのインタフェースを使用するアプリケーションは、Tuxedo ATMIセキュリティの規則に従う必要があります(詳細は、ATMIセキュリティの概要を参照)。適切なアプリケーション・パスワードおよびユーザー名/パスワードを、クライアント・アプリケーション内のtpinit()で指定する必要があります。サービスの権限を制御するには、「TuxJESジョブの操作で使用されるATMIサービス」でリストされているサービスに対して、適切なACLまたはMANDATORY ACLをUBBCONFIGで構成する必要があります。

ジョブの送信の例

次の例は、ジョブの送信方法を示しています。-I $JESDIR/includeにはCFLAGSを含める必要があります。

#include <stdio.h>

#include <tpadm.h>

#include <fml32.h>

#include <jesflds.h>

main(int argc, char *argv[])

{

  FBFR32 *input;

  FBFR32 *output;

  long buflen;

  if (tpinit((TPINIT *) NULL) == -1) {

    (void)fprintf(stderr, "Tpinit failed: %s\n", tpstrerror(tperrno));

    exit(1);

  }

  input = tpalloc("FML32",NULL,1024);

  output = tpalloc("FML32",NULL,1024);

  if (input == NULL || output == NULL) {

    (void)fprintf(stderr, "Tpinit failed: %s\n", tpstrerror(tperrno));

    exit(1);

  }

  if (Fappend32(input,JES2_JOB_SCRIPT, "JOBA", 0) < 0 ) {

    (void)fprintf(stderr, " Fappend32 failed: \n");

    exit(1);

  }

  Findex32(input,0);

  if (tpcall("JES2SUBMIT", input, 0, &output,&buflen,0) < 0 ) {

          (void) fprintf(stderr, "Can't send request to service JES2SUBMIT");

    exit(1);

  }else {

        char *jobid;

        jobid = Ffind32(output,JES2_JOB_ID,0,NULL);

        if (jobid != NULL) {

                fprintf(stdout,"Job %s is submitted\n",jobid);

        }

 }

tpfree(input);

  tpfree(output);

  (void)tpterm();

  return(0);

}