リファレンス・ガイド

Oracle Tuxedo Application Runtime for IMSリファレンス・ガイド

Oracle Tuxedo Application Runtime for IMS (Tuxedo ART for IMS)リファレンス・ガイドでは、Tuxedo ART for IMSソフトウェアとともに配布されるシステム・プロセスおよびコマンドについて説明します。

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

Tuxedo ART for IMSのユーティリティ

表1に、Tuxedo ART for IMSのユーティリティを示します。

chgcobol.sh

名前

chgcobol.sh - Tuxedo ART for IMSに対してMicro Focus COBOLとCOBOL-ITの間を切り替えるために使用されるシェル・スクリプト。

形式

chgcobol.sh [mf|cit]

説明

Micro Focus COBOLとCOBOL-ITの両方を同じホストにインストールしておくことができ、相互に切替え可能です。chgcobol.shは、Micro Focus COBOLとCOBOL-IT間の切り替えに使用されます。COBOLランタイムの切り替えには、最初にTuxedo ART for IMSアプリケーションを停止する必要があります。

chgcobol.shには、次のオプションを指定できます。

オプションなし

cit

mf

例

./chgcobol.sh

./chgcobol.sh mf

DFSRRC00

名前

DFSRRC00: ARTIBMPまたはARTIBMPTサーバーをアクティブ化するために使用されるユーティリティ。

形式:

DFSRRC00 "BMP,${MBR},${PSB},${IN},,,,,${CKPTID},,,,,,,,,,,,"

説明

DFSRRC00は、DFSRRC00入力を待機しているARTIBMP/ARTIBMPTサーバーをアクティブ化するために使用されます。DFSRRC00パラメータは、ワークベンチによってJCLから変換されたスクリプトから渡された文字列です。現在、文字列に含まれるサブパラメータでサポートされているものは、5つのみです("BMP, ${MBR}, ${PSB}, ${IN}, ${CKPTID}")。文字列内の残りのサブパラメータは無視されます。

IMSサーバー・エラーや異常終了がなく、ユーザー・プログラムもクラッシュしていない場合、ユーザー・プログラムのリターン・コードはDFSRRC00です。

DFSRRC00クライアント名の書式は、次のとおりです。"${MBR}-DFSRRC00"。tmadminを使用すると、現在実行中のBATCHプログラムを確認できます。

トランザクションやプログラムの開始/終了時に、プログラム起動ログ・ファイルに、次の形式でトレース行が追加されます: "transaction name, program name, Sstart time, Eend time, group id, server id" (注意: 使用する場合、"-"は空の値を示します)。

2つの重複するFML32フィールド(IMS_BMP_APPNAME_ROUTEとIMS_JOB_NAME_ROUTE)を、DFSRRC00がBMPサービスを呼び出すときに、ルーティング・フィールドとして使用できます。このため、特定のアプリケーション・プログラムまたはバッチ・ジョブを特定のBMPサーバー・グループにルーティングできます。これらの2つのFML32フィールドは、$IMSDIR/include/ROUTEFMLで定義されています。

パラメータ

BMP

${MBR}

${PSB}

{IN}

{CKPTID}

genimsprofile

名前

genimsprofile - セキュリティ・プロファイル・ジェネレータ

形式:

genimsprofile [-f <output_file>]

説明

このユーティリティは、Tuxedoアプリケーションのセキュリティ・プロファイルを生成します。このユーティリティが起動されると、Tuxedoアプリケーション・パスワード、ユーザー名およびユーザー・パスワードの入力を求められます。出力は、ユーザー名と暗号化されたパスワードを含むセキュリティ・プロファイル・ファイルです。生成されたセキュリティ・プロファイル・ファイルは、imsadmin、ARTICTLおよびDFSRRC00で、Tuxedoドメインに参加するために使用できます。

パラメータ

-f <output_file>

imsadmin

名前

imsadmin - Tuxedo ART for IMSのランタイム管理ツール。

形式:

imsadmin 		[-p <profile>] -l PGM1, PGM2
imsadmin  		[-p <profile>] -u -d <directory> 
imsadmin 		[-p <profile>] -c -d <directory> 
imsadmin		 -x flushperf|cleanperf|enableperf|disableperf 
			[-m machine]|[-g groupid [-s serverid] ]
imsadmin		 -x settracelevel number [-m machine]|
			[-g groupid [-sserverid] ]
imsadmin 		[-v]
imsadmin 		[-h]

説明

このユーティリティは、実行中のIMSシステムへの変更を行うための管理ツールとして使用できます。これにより、IMSシステムにプログラムの再ロード・リクエストを送信できます(変更済のユーザーのCOBOLプログラムが再ロードされます)。これはまた、構成の検証またはIMSシステムへの再ロード・リクエストにも使用されます。

パラメータ

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

[-p <profile>]

-l PGM1, PGM2

-u

-c

-d <ディレクトリ>

-x flushperf|cleanperf|enableperf|disableperf

-x settracelevel number

[-m machine]

[-g groupid]

[-s serverid]

[-v]

[-h]

例

imsgenconf

名前

imsgenconf - Tuxedo ART for IMSの構成生成ツール。

形式

imsgenconf -i inputdir [-o outputdir] [-h]

説明

imsgenconfを使用すると、特定のトランザクションおよびバッチ・アプリケーション用のTuxedo ART for IMSの構成を生成できます。

ファイル生成処理中、imsgenconfにより、Tuxedo ART for IMSがそのフィールド定義に応じて使用するフィールド定義が検証されます。検証に失敗した場合、特定のエラーがレポートされ、構成ファイルの生成が停止されます。

成功した場合、レポート・ファイル(imsgenconf_report)が出力ディレクトリに生成されます。現在、このレポート・ファイルには、トランザクションが定義ファイル名と行番号とともに含まれます。

パラメータ

-i inputdir

[-o outputdir]

[-h]

imsperf

名前

imsperf - Tuxedo ART for IMSのランタイム・パフォーマンス分析ツール

形式

imsperf [-d path] [-h]

説明

トランザクションおよびアプリケーションのパフォーマンス・レポートを生成するには、このツールを使用します。

-dオプションを指定すると、指定したパスの下でパフォーマンス・トレース・ファイルが検索されます。

-dオプションを指定しない場合、パフォーマンス・トレースはまず$IMS_TRACE_PATHの下で検索され、次に$APPDIR/logの下で検索されます。詳細は、 『Tuxedo ART for IMSユーザーズ・ガイド』を参照してください。

imsperfにより、パフォーマンス・トレース・ファイルと同じディレクトリに、トランザクション/アプリケーションのパフォーマンス・レポートが次のような形式で生成されます。

tranname.csv

application.csv。

時間の単位はマイクロ秒です。このCSV形式のレポート・ファイルは、直接開くことができます。パフォーマンス・レポートに含まれる処理の説明を表2に示します。

オプション

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

[-d path]

[-h]

例

/home/oracle/logの下にパフォーマンス・トレース・レポートを生成するには、次のようにします。

imsperf -d /home/oracle/log

MFSGEN

名前

MFSGEN: ARTICTLサーバーのバイナリ制御ブロック・ジェネレータ。

形式

mfsgen 	[-options…] 	files

説明

このユーティリティは、ART MFSの開発に使用します。ユーザーが記述した制御文をMFSバイナリ制御ブロックに変換します。

図 1は、MFSGENワークフローを示しています。

オプション

コマンド・オプションは次のとおりです。

-l

-d dir

ファイル

MFSGENユーティリティで、次のファイルが作成されます。

FILE.MSG

FILE.FMT

FILE.lst

戻りコード

0

1

2

例

ソース・ファイルfile.mfsを変換するには、次のコマンドを使用します。

$mfsgen file1.mfs  file.mfs   file3.mfs

odbastop

名前

odbastop: z/OS上のODBAプロキシを停止するために使用されるオープン・システム・ツール。

形式

odbastop -l host -p port -c cmd

説明

オープン・システム上でodbastopを使用して、z/OS上で実行されているODBAプロキシを停止します。

パラメータ

host

port

cmd

prepro-ims.pl

名前

prepro-ims.pl - z/OS上のCプログラムをTuxedo ART for IMSで実行可能な形式に変換するために使用されるユーティリティ。

形式:

prepro-ims.pl -i source-file -o dest-file [-m yourmakefile]

説明

prepro-ims.plは、z/OS上のCプログラムをTuxedo ART for IMSで実行可能な形式に変換するために使用されます。ファイルの変換に失敗した場合、障害情報および障害の原因となったソース・ファイルの行がstderrに出力されます。完了すると、サマリーがstdoutに報告されます。

処理ルールは次のとおりです。

制限

依存関係

パラメータ

prepro-ims.plのパラメータ、終了コード、およびサポート・モードを、それぞれ表 3、表 4および表 5に示します。

-i

-o

-m

0

1

2

ソース・プログラムはリスト1に類似したものになります。

/* #pragma runopts(env(IMS), plist(IMS)) */
#include <ims.h>
#include <stdio.h>
#define n 20  /* I/O area size - Application dependent */
typedef struct {PCB_STRUCT(10)} PCB_10_TYPE;

int main() 
{
static const char func_GU[4] = "GU  ";
static const char func_ISRT[4] = "ISRT";

char ssa_name[] = "ORDER ORDER   (ORDERKEY   = 666666)";

int rc;
char msg_seg_io_area[n];
char db_seg_io_area[n];
char alt_msg_seg_out[n];

PCB_STRUCT_8_TYPE *alt_pcb;
PCB_10_TYPE *db_pcb;
IO_PCB_TYPE *io_pcb;

io_pcb = (IO_PCB_TYPE *)__pcblist[0];
alt_pcb = __pcblist[1];
db_pcb = (PCB_10_TYPE *)__pcblist[2];
..
/* get first message segment from message area */
rc = ctdli(func_GU, io_pcb, msg_seg_io_area, NULL);
..
/* get the data from the database having the specified key value */
rc = ctdli(func_GU, db_pcb, db_seg_io_area, ssa_name, NULL);
..
/* build output message in program's I/O area */
rc = ctdli(func_ISRT, alt_pcb, alt_msg_seg_out, NULL);
..
}

RUNPROXY(z/OS)

名前

RUNPROXY: z/OS上のODBAプロキシを開始するために使用します。

形式:

USER.ODBA.JCL(RUNPROXY) JCLを変更し、それを送信してODBAプロキシを開始します。詳細は、Oracle Tuxedo Application Runtime for IMSユーザーズ・ガイドのODBAプロキシの使用方法に関する項を参照してください。

説明

z/OS上でRUNPROXYを使用して、z/OS上のODBAプロキシを開始します。

STOPROXY(z/OS)

名前

STOPROXY: z/OS上のODBAプロキシを停止するために使用します。

形式:

USER.ODBA.JCL(STOPROXY) JCLを変更し、それを送信してODBAプロキシを停止します。詳細は、Oracle Tuxedo Application Runtime for IMSユーザーズ・ガイドのODBAプロキシの使用方法に関する項を参照してください。

説明

z/OS上でSTOPROXYを使用して、z/OS上で実行されているODBAプロキシを停止します。

Tuxedo ART for IMSのDL/Iサポート

Tuxedo ART for IMSでは、DL/Iは、動的にロードされるライブラリのグループ内に実装されます。サポート対象のDL/I機能は、次のとおりです。

サポート対象のDL/Iインタフェース

表 6は、サポート対象のDL/Iインタフェースを示しています。

CBLTDLI

名前

CBLTDLI: OS/39におけるIMS/TMでのDL/I呼出しの0エントリ。

説明

Tuxedo ART for IMSでは、CBLTDLIは、DLIライブラリのエントリとして機能する関数です。CBLTDLIは、それに渡された関数コードに基づいて適切な関数を呼び出します。

パラメータ

関数コード(GUなど)、I/O PCBまたは代替PCB、I/O領域、MOD

AIBTDLI

名前

AIBTDLI: DL/Iレイヤー全体のエントリ関数。

説明

AIBTDLIは、z/OSにおけるIMS/TMでのDL/I呼出しのエントリです。Tuxedo ART for IMSでは、AIBTDLIは、DL/Iライブラリのエントリとして機能する関数です。AIBTDLIは、AIBマスクで指定されているPCB名に従ってPCBアドレスを取得し、見つかったPCBアドレスとともにそれに渡された関数コードに基づいて適切な関数を呼び出します。

パラメータ

関数呼び出し(GUなど)、AIBマスク、I/O領域、入力または出力バッファ。表 7は、AIBマスク・パラメータを示しています。

AIBマスク・フィールドAIBRSNM1におけるPCB名の指定の詳細なルールは、次のとおりです。

I/O PCB

代替PCB

DB PCB

CTDLI

名前

CTDLI: DL/Iレイヤー全体のエントリ関数。

説明

Tuxedo ART for IMSでは、CTDLIは、DLIライブラリのエントリとして機能する関数です。CTDLIは、それに渡された関数コードに基づいて適切な関数を呼び出します。

パラメータ

関数呼び出し(GUなど)、PCB (I/O PCBまたは代替PCB)、I/O領域、入力または出力バッファ。

op引数は、実行するDL/I関数を指定します。ctdli()呼出し形式は、選択した関数によって異なります。詳細は、「CBLTDLI」を参照してください。

メッセージ処理

DL/Iは、受信メッセージの処理およびIMS/TMでのPCBに対する送信メッセージの構築を担当します。Tuxedo ART for IMSでは、メッセージ・キューおよびメッセージ配信はTuxedoインフラストラクチャが担当するため、受信メッセージの処理は現在のリクエスト・メッセージにのみ関係します。DLIライブラリは、COBOLアプリケーションからのリクエストに基づいて最初および後続のセグメント(FMLフィールド)を取得できます。送信メッセージを構築するために、各PCBは中間記憶域として関連するメッセージ・バッファ(FML)を持っており、メッセージが送信される前にそのメッセージ・データがそこに格納されます。メッセージ処理用の詳細なAPIを、表 8に示します。

GU

名前

GU: IMS/TM環境のメッセージ・キューから最初のセグメントを取得するために使用されます。

形式

説明

パラメータ

I/O PCB

AIB

I/O領域

結果(ステータス・コード)

'bb': 成功(2つの空白)。

'AB': セグメントI/O領域が指定されていません。

'AD': 関数パラメータが無効です。関数呼出しがCBLTDLIに指定されていないか、無効な関数呼び出し名がCBLTDLIに指定されています。

'QC': 入力メッセージがありません。

'QF': セグメントが5文字未満です。

GN

名前

GN: IMS/TM環境のメッセージ・キューから後続のセグメントを取得するために使用されます。

形式

I/O PCB or AIB, I/O Area

説明

最後のセグメントが取得された後、GN呼出しは、QDステータス・コードがPCBで返されるという結果になります。Tuxedo ART for IMSでは、処理中のメッセージのFMLバッファの次のフィールドを取得するために、シミュレートされたGN呼出しが使用されます。

パラメータ

SI/O PCB

AIB

I/O領域

結果(ステータス・コード):

'bb': 成功(2つの空白)。

'AB': セグメントI/O領域が指定されていません。

'AD': 関数パラメータが無効です。関数呼出しがCBLTDLIに指定されていないか、無効な関数呼び出し名がCBLTDLIに指定されています。

'QD': セグメントはこれ以上ありません。

ISRT

名前

ISRT: IMS/TMにおいて指定されているPCBに関連付けられているメッセージにセグメントを追加するために使用されます。

形式

I/O PCB or alternate PCB or AIB, I/O Area, MOD

説明

Tuxedo ART for IMSでは、指定されたPCBに関連付けられているFMLバッファにCARRAYタイプのフィールドを追加するために、シミュレートされたISRT呼出しが使用されます。会話型トランザクションの場合、最初のセグメントは常にSPAです。メッセージ・セグメントの最大長は32767です。

パラメータ

I/O PCBまたは代替PCB

AIB

I/O領域

MOD

結果(ステータス・コード):

'bb': 成功(2つの空白)

'AB': セグメントI/O領域が指定されていません。

'AD': 関数パラメータが無効です。関数呼出しがCBLTDLIに指定されていないか、無効な関数呼び出し名がCBLTDLIに指定されています。

'QF': セグメントが5文字未満です。

'QH': PCBに宛先名がありません。

'XA': リクエストに応答した後に、そのリクエストを別のトランザクションに転送しようとしています。

'XB': リクエストを別のトランザクションに転送した後に、それに応答しようとしています。

'XC': Z1ビットが0ではありません。それは予約済であり、常に0として保持されます。

'A6': 呼出しで出力セグメント・サイズ制限を超えました

PURG

名前

PURG: そのメッセージが低速PCBに対して完了したことをIMS/TMに通知するために使用されます。

形式

I/O PCB or alternate PCB or AIB, I/O Area (optional), MOD (optional)

説明

PURG呼出しは正常ですが、送信されなかったか、メッセージが高速PCBに対してただちに送信されました。

I/O領域がPURG呼出しに提供されている場合、PURG呼出しもISRT呼出しとして機能します。つまり、PURGは、PCBに関連付けられている(現在の)メッセージを完了としてマークし、I/O領域のデータを次のメッセージの最初のセグメントとしてISRTします。最終結果は、ISRT呼出しが後に続くI/O領域のないPURG呼出しと同じです。

Tuxedo ART for IMSでは、低速PCBに対して関連付けられたメッセージが完了したとマークするため、または高速PCBに対して関連付けられたメッセージを送信するために、シミュレートされたPURG呼出しが使用されます。ただし、I/Oバッファが指定されている場合は、単一のPCBに対する複数の保留メッセージはサポートされていないため、それは無視され、したがってMODも無視されます。ただし、ステータス・コードはカスタマ・プログラムによってチェックされるため、この場合、特別なステータス・コードは追加されません。

パラメータ

I/O PCBまたは代替PCB

AIB

I/O領域

MOD

結果(ステータス・コード):

'bb': 成功(2つの空白)

'AD': 関数パラメータが無効です。関数呼出しがCBLTDLIに指定されていないか、無効な関数呼び出し名がCBLTDLIに指定されています

'A3': 宛先が設定されていないが、それに対してPURGが呼び出される変更可能なTP PCB

CHNG

名前

CHNG: IMS/TMにおいてPCB内の宛先を変更するために使用されます。

形式

Alternate PCB or AIB、宛先トランザクション・コード

説明

Tuxedo ART for IMSでは、シミュレートされたCHNGにより、代替PCBの別のサービス名(のみ)が指定されます。宛先トランザクション名は、8バイト以下であり、その制限を超えている場合、それは8までに切り捨てられます。後続の空白も削除されます。トランザクション名は、それがimstrans.descファイルに存在し、かつ正しい構成である場合に、有効として評価されます。

1つのTuxedoドメイン内の1つのトランザクション・コードが、異なるドメインの他のサービスに切り替えるように設計されている場合、切り替えられるトランザクション・コードは、[imstrans.desc]構成ファイルで有効なトランザクションとして定義されている必要がありますが、それをそのクラスの制御で公開しないでください。

プログラム切替えの場合、新しいターゲットは別のトランザクション・コードです。会話型プログラム切替えの場合、Tuxedo ART for IMSでは、元のコードおよびターゲット・コードのspaサイズに制限はありません。

パラメータ

I/O PCB

AIB

結果(ステータス・コード):

'bb': 成功(2つの空白)。

'AD': 関数パラメータが無効です。宛先が指定されていません。関数呼出しが無効です。

'A1': PCBが有効ではありません。

'A2': PCBが変更可能でないか、ISRT操作がすでに実行されています。

'QH': 代替PCBに指定するトランザクションが空白であるか無効です。

CMD

名前

CMD: プログラムでIMSコマンドを発行可能にするために使用されます。

形式

I/O PCBまたはAIB、I/O領域

説明

IMSコマンドを送信または発行し、応答メッセージの最初のセグメントを取得します。

CMDは、IMSコマンドを発行するために使用されます。これは、すべてのサポートされているIMSコマンドを処理できると想定されるインタフェースにIMSコマンドを転送します。CMD呼出しは、そのインタフェースによってIMSコマンドが処理されるまで待ち、その応答メッセージの最初のフィールドを取得します。

制限事項

コマンドには、"/DIS TRAN"、"/DIS PGM"および"/DIS USER"のみサポートされます。これらのコマンドがCMD APIによって発行されると、関連するタイトル・セグメントがI/O領域を介して返され、それには、後続のセグメントの各フィールドの意味が記述されています。

パラメータ

I/O PCB

AIB

I/O領域

結果(ステータス・コード)

'bb': 成功(2つの空白)。ただし、応答セグメントはありません。

'CC': 1つまたは複数の応答セグメントが生成されました。

'AB': セグメントI/O領域が指定されていません。

'CH': AOIコマンド・インタフェースがシステム・エラーを検出し、そのコマンドを処理できなかったため、発行したCMD呼出しはIMSによって無視されます。IMSの処理は続行されます。

GCMD

名前

GCMD: CMDコマンドの応答メッセージの2番目および後続のセグメントを取得します。

形式

I/O PCB or AIB, I/O Area

説明

GCMDは、アプリケーション・プログラムによってCMD呼出しを使用してIMSコマンドが処理されるときに、IMS TMから2番目および後続の応答セグメントを取得します。返されるセグメントそれぞれには、前述の"CMD"呼出しのタイトル・セグメントに応じたフィールドが含まれます。最後のセグメントが取得された後に、GCMD呼出しは、"QD"ステータス・コードがPCBで返されるという結果になります。

パラメータ

I/O PCB

AIB

I/O領域

結果(ステータス・コード):

'bb': セグメントは正常に取得されました(2つの空白)。

'AB': セグメントI/O領域が指定されていません。

'QD': セグメントはこれ以上ありません。

'QE': CMDの前のGCMDリクエスト。

GUID

名前

GUID - ARTIMPPサーバーの長いユーザー名モードで、完全なユーザー名の取得に使用する偽のDL/I。

形式

I/O PCB or AIB, I/O Area

説明

GUIDは、長いユーザー名/パスワードのモードでのみ推奨されるARTIMPPサーバーの完全ユーザー名を取得するために使用します。

パラメータ

I/O PCB

I/O領域

結果(ステータス・コード):

'bb': セグメントは正常に取得されました(2つの空白)。

'AB': セグメントI/O領域が指定されていません。

'AD': 指定されたPCBはI/O PCBではありません。

データベース処理

DLIライブラリは、MPPまたはBMPプログラムから発行されたデータベース処理を実行します。これは、指定されたセグメント検索基準に応じた1つの特定のセグメントの取得および保持、特定のセグメントの更新、特定の位置へのセグメントの挿入、特定のセグメントの削除などを実行できます。データベース処理の詳細なAPIを、表 9に示します。

GU/GHU

名前

GU/GHU: 現在の位置(存在する場合)またはデータベースの先頭から基準(存在する場合)を満たす最初のセグメントを取得(および保持)します。

形式

DB PCB,GSAM PCBまたはAIB, I/O Area, and SSA list (optional)またはRSA (Mandantory for GSAM)

説明

GUは、指定されているSSAを満たし、順次処理の開始位置を確立する最初のセグメントを取得するために使用されます。GUの検索開始位置は、データベースの先頭(つまり、ルート・レベル)です。呼出しを満たす最初のセグメントを見つけた後、現在の位置が順次処理の開始位置となります。

GHUは、GUに加えて、順次書込み操作(置換、削除など)のためにセグメントをロックします。GHUはGSAMには適用されません。

パラメータ

DB PCB

AIB

I/O領域

SSA:

RSA:

GN/GHN

名前

GN/GHN: 現在の位置から基準(存在する場合)を満たす次のセグメントを取得(および保持)します。

形式

DB PCB,GSAM PCB or AIB, I/O Area, and SSA list (optional) or RSA(opitional for GSAM)

説明

GNは、現在の位置から検索して、指定されているSSAを満たす次のセグメントを取得するために使用されます。セグメントを見つけた後、順次処理のために現在の位置が更新されます。DBに現在の位置が確立されていない場合、GNはGUのように動作します(つまり、先頭から検索します)。階層型DBにおける順次取得は、常に上から下、かつ左から右(つまり、ツリーの前順取得)です。

GHNは、GNに加えて、返されるセグメントをそれに対する順次書込み操作のためにロックします。GHNはGSAMには適用されません。

パラメータ

GNのパラメータの使用方法と制限事項は、GUに似ています。

RSA:

GNP/GHNP

名前

GNP/GHNP: 確立した親の依存セグメントから基準を満たす次のセグメントを取得(および保持)します。

形式

DB PCB, GSAM PCB or AIB, I/O Area, and SSA list (オプション)

説明

GNPは、確立した親の依存セグメントで、次の修飾セグメントを取得するために使用されます。階層型DBにおける確立した親とは、前の成功したGU/GN呼出しで返された最も下位のセグメントであり、失敗したGU/GN呼出しによって取り消されます。

GHNPは、GNPに加えて、返されたセグメントを順次書込み操作のためにロックします。

パラメータ

GNP/GHNPのパラメータの使用方法と制限事項は、GUに似ています。

ISRT

名前

ISRT: 既存のセグメント・タイプの新しいオカレンスを階層型データベースに挿入するために使用されます。

形式

DB PCB, GSAM PCB or AIB, I/O Area, and SSA list or RSA(opitional for GSAM)

説明

ISRTは、既存のセグメント・タイプの新しいオカレンスを階層型データベースに挿入するために使用されます。挿入位置は、挿入されるセグメントのレベルを除いた一連の修飾SSAによって、または非修飾SSAの場合は現在の位置によって決定されます。

パラメータ

I/O

AIB

SSA

RSA

REPL

名前

REPL: 既存のセグメントを更新するために使用されます。

形式

DB PCB or AIB, I/O Area, and SSA list

説明

REPLは、既存のセグメントを更新するために使用されます。最初にGet Hold呼出しを使用してセグメントを取得し、その後、そのセグメントを変更および更新する必要があります。I/O領域のセグメントのフィールドの長さは変更できません。

パラメータ

パラメータの使用方法と制限事項は、GUに似ています。

DLET

名前

DLET: セグメントとその依存関係を削除するために使用されます。

形式

DB PCB or AIB, I/O Area, and SSA list (オプション)

説明

DLET呼出しは、セグメントとその依存関係を削除するために使用されます。これは、Get Hold呼出しの後に続く必要があります。修飾SSAは、DLET呼出しに指定しないでください。

パラメータ

パラメータの使用方法と制限事項は、GUに似ています。

FLD

名前

FLD: セグメント内のフィールドにアクセスし、変更するために使用されます。

形式

DB PCB or AIB, I/O Area, and SSA list

説明

FLD呼出しは、セグメント内のフィールドにアクセスし、変更するために使用されます。

パラメータ

I/O

AIB

SSA

POS

形式

説明

パラメータ

DB PCB

AIB

SSAリスト

OPEN

名前

OPEN: GSAMデータベースを明示的に開くために使用されます。

形式

GSAM PCB or AIB,  i/o area

説明

GSAMデータベースを明示的に開きます。GASMデータベースに対する次の処理によって、GSAMデータベースが再度開かれることはありません。GSAMデータベースを明示的に開かない場合、他の操作によってGSAMデータベースが暗黙的に開かれます。

パラメータ

GSAM PCB

AIB

CLSE

名前

形式

説明

パラメータ

GSAM PCB

AIB

IMS/DBの様々な実装のためのプラグイン定義

IMS/DBの様々な種類の実装をサポートするため、IMS/DBのサポートは、Tuxedo ART for IMSにプラグイン可能で、プラグイン後にTuxedo ART for IMSサーバーによってロード可能な動的リンク・ライブラリ(DLL)として設計されています。このプラグアンドプレイ・メカニズムを有効化するには、DLLによってどのAPIがエクスポートされるのかのアグリーメントが必要です。

Tuxedo ART for IMSサーバー(ARTIMPPおよびARTIBMP)は、オンラインまたはバッチCOBOLプログラムを実行するためのコンテナとして使用されます。プログラムによつて発行されるデータベース・アクセス操作を有効化するには、通常、サーバーは、データベースの実装に対してなんらかの初期化または構成を実行する必要があり、COBOLプログラムを起動する前に何かを実行する必要があり、プログラムの完了後に何かを実行する必要があり、サーバーが停止する前になんらかのクリーンアップを実行する必要があります。そのほかに、CBLTDLIを介した各データベース処理が、特定のAPIにマップされている必要があります。

IMS/DBプラグインのデータ構造定義

DB PCB構造を指すポインタは、Tuxedo ART for IMSサーバーからCOBOLプログラムに渡され、最後にIMS/DBのプラグインのdb_entry()に渡されます。プラグインが適切に機能するようにするには、各COBOLプログラムを呼び出す前にDB PCB構造に適切に入力する必要があります。この項では、DB PCBへの入力方法に関する詳細な要件を定義します。

DB PCB構造の例をリスト2に示します。

struct { 
    char dbname[8];
    char seglevel[2];
    char stat_code[2];
    char opt[4];
    char res[4]; 
    char segname[8];
    char keylen[4]; 
    char segnum[4];
    char keyfa[IMS_FEEDAREA_LEN];
};

リスト3は、get_dbpcbattrインタフェースに使用される構造定義を示しています。コンテンツはPSBファイルから読み取られ、get_dbpcbattrインタフェースを介してアプリケーションに返されます。

enum PCBTYPE {IOPCB = 1, ALTPCB = 2, GSAMPCB = 3, DBPCB = 4};

enum SEQUENTIALBUFFERING {NO = 1, COND = 2};

enum PCBPOS {SINGLE = 1, MULTIPLE = 2};

enum SENSITIVITY {READ = 1, UPDATE = 2};

struct __SENFLD {

	char name[8];			/* mandatory, less than 8 filled with blank */

	unsigned short start;	/* mandatory, range [1-32767] */

	int replace;			/* optional, default is 1 */

};

struct SSPTR {

	unsigned short pointer; /* range[1-8], default 0 */

	enum SENSITIVITY sens;	

};

struct __SENSEG {

	char segname[8]; /* mandatory, less than 8 filled with blank */

	char parent[8];  /* mandatory, less than 8 filled with blank */

	char procopt[4]; /* optional, default filled with blank */

	SSPTR ssptr[8]; /* each slot contains a subset pointer number and associated sensitivity, pointer of 0 indicates end, totally up to 8 can be specified */

	char indices[8]; /* optional, default filled with blank */

	SENFLD * senfld; /* optional, default is NULL */

	unsigned short senfld_num; /* optional, default is 0, up to 255 SENFLD can be defined for each SENSEG */

};

struct __DB_PCB_ATTR { /* PCB Attributes */

	enum PCBTYPE type; /* mandatory */

	char dbname[8];   /* db name, default filled with blank */

	char pcbname[8]; /* pcb name, optional, default filled with blank */

	char procopt[4]; /* procopt , default filled with blank */

	enum SEQUENTIALBUFFERING sb; /* optional, default is NO */

	enum PCBPOS pos; /* optional, default is SINGLE */

	int keylen; /* optional, default is invalid value 0 */

	char procseq[8]; /* optional, default filled with blank */

	int msdb_commit; /* optional, default is 0 */

	int list; /* optional, default is 1 */

	char *areas; /* area list set by SETR in DFSCTL, no change will be applied on it in ART/IMS */

	int senseg_num; /* optional, default is 0 */

	struct SENSEG * senseg; /* optional, default is NULL */

};

IMS/DBプラグインのAPI定義

IMS/DBプラグインのAPIを定義するには次の手順を実行する必要があります。

IMS/DBのデフォルトの実装

Tuxedo ART for IMS内では、デフォルトDLLはIMS/DBのOracleソリューションとして提供されています。

トランザクション管理

DLIライブラリは、COBOLアプリケーションによって渡される命令に従い、トランザクション管理作業(つまり、すでに行われた変更のコミット、すでに作成されたメッセージの送信またすべての変更のロールバック、すべてのメッセージの削除)を実行します。COBOLアプリケーションによってトランザクションをコミットする明確な命令が発行されない場合は、ARTIMPPによってトランザクションがコミットされます。

表 10は、トランザクション管理のプロセスおよびコマンドを示しています。

CHKP (基本)

名前

CHKP (基本): 明示的なコミット・ポイントを設定するために使用されます。

説明

CHKPは、明示的なコミット・ポイントを設定するために使用されます。コミット・ポイントで、IMS/TMが、アプリケーション・プログラムによって行われた変更(通常はデータベースの更新)をコミットし、すべてのメッセージを完了としてマークして(低速PCBの場合はPURGによって)送信し、指定されたIOAREAに次の入力メッセージを取得します。

Tuxedo ART for IMSでは、tpcommit()コマンドを使用して行われた変更をコミットするために、シミュレートされたCHKPが使用されます。完了とマークされているメッセージが送信されます。明示的なPURG呼出しによってマークされていないメッセージも送信されます。

トランザクションが永続トランザクションで、永続モードのARTIMPPによって処理されているか、ARTIBMPTによって処理されている場合、次のメッセージはこのトランザクションの/Qから取得されます。

トランザクションが永続トランザクションでない場合、次のメッセージは取得されません。

パラメータ

I/O PCB or AIB, I/O Area

I/O PCB

AIB

I/O領域

結果(ステータス・コード)

'bb': 成功(2つの空白)。

'AD': 関数パラメータが無効です。関数呼出しがCBLTDLIに指定されていないか、無効な関数呼び出し名がCBLTDLIに指定されています。

'AB': I/O領域は提供されません。

'QC': 入力メッセージがありません。

'QF': セグメントが5文字未満です。

CHKP (シンボリック)

名前

CHKP (シンボリック): 明示的なコミット・ポイントを設定するために使用されます。プログラムを開始できるチェック・ポイントを設定し、プログラムに7つのデータ領域を保存し、現在のGSAM DB取得位置を記録します。

説明

CHKP (シンボリック)は、リカバリのために使用できます。これによって、プログラムによって行われたすべての変更がコミットされ、アプリケーション・プログラムが異常終了した場合は、そのプログラムが再開できるポイントが確立されます。さらに、シンボリックCHKP呼出しは次のことを実行できます。

Tuxedo ART for IMSでは、シュミレートされたCHKP (シンボリック)を使用して、次のことが実行されます。

パラメータ

I/O PCB or AIB, I/O Area, I/O Area Length, IO Area, area length, area, …

I/O PCB

AIB

I/O領域の長さ

I/O領域

領域の長さ

最初の領域からチェック・ポイントまでの長さ(バイナリ形式)を含むプログラム内の4バイトのフィールドを指定します。このパラメータは、入力パラメータです。最大7つの領域の長さを指定できます。領域の長さごとに、領域パラメータを指定することも必要です。

領域

結果(ステータス・コード)

'bb': 成功(2つの空白)。

'AD': 関数パラメータが無効です。Tuxedo ART for IMSによって関数呼出しが提供されていません

'AB': I/O領域は提供されません。

'QC': 入力メッセージがありません。

'QF': セグメントが5文字未満です。

ROLB

名前

ROLB: データベースの更新を取り消すために使用されます。

形式

I/O PCB or AIB, I/O Area

説明

ROLBは、データベースの更新を取り消すために使用されます。伝送できないすべての挿入済メッセージが取り消されます。高速PCBの場合、メッセージは、IMSがメッセージの完了を認識したとき(つまりPURG呼出しが呼び出されるとき)に、伝送に使用できるようになります。低速PCBでは、プログラムがコミット・ポイントに到達するまではメッセージが送信可能になりません。

Tuxedo ART for IMSでは、tpabort()を使用することでアプリケーション・プログラムによって行われたすべての変更をロールバックし、送信されていないメッセージ・バッファを空にするために、シミュレートされたROLB呼出しが使用されます。

永続トランザクション(TPまたはトランザクション指向BMPプログラム)では、永続モードのARTIMPPで処理されているか、ARTIBMPTで処理されている場合、ROLBは最後のコミット・ポイントから最初のメッセージの最初のセグメントをIOAREAに返し、/Qの最後のコミット・ポイントから最初のメッセージを削除します。

非永続トランザクション(TPまたはトランザクション指向バッチ)では、Tuxedo ART for IMSは現在処理中のメッセージの最初のセグメントのみを返します。

パラメータ

I/O PCB

AIB

I/O領域

結果(ステータス・コード):

'bb': 成功(2つの空白)。

'AD': 関数パラメータが無効です。関数呼出しがCBLTDLIに指定されていないか、無効な関数呼び出し名がCBLTDLIに指定されているか、PCBが指定されていません。

'QE': IOAREAがNULLでない場合、GUが以前に呼び出されていません。

'QC': 入力メッセージがありません。

'QF': セグメントが5文字未満です。

ROLL

名前

ROLL: データベースの更新を取り消し、Tuxedo ART for IMSに戻るために使用されます。

形式

ROLL

説明

ROLLは、データベースの更新を取り消し、挿入されたが伝送に使用できないすべてのメッセージを取り消します。高速PCBの場合、メッセージは、IMSがメッセージの完了を認識したとき(つまりPURG呼出しが呼び出されるとき)に、伝送に使用できるようになります。低速PCBでは、プログラムがコミット・ポイントに到達するまではメッセージが送信可能になりません。

Tuxedo ART for IMSでは、tpabort()を使用してアプリケーション・プログラムによって作成されたすべての変更をロールバックし、未送信のメッセージ・バッファを空にするために、シミュレートされたROLL呼出しが使用されます。これは、Tuxedo ART for IMSにコントロールを返しますが、呼出し元プログラムにはコントロールを返しません。

永続トランザクション(TPまたはトランザクション指向BMPプログラム)では、永続モードのARTIMPPで処理されているか、ARTIBMPTで処理されている場合、ROLLにより/Qの最後のコミット・ポイントから現在のメッセージが削除されます。

パラメータ

ROLLの呼び出しに必要なパラメータはコール関数のみです。

結果(ステータス・コード):

ステータス・コードは返されません。

SYNC

名前

SYNC: アプリケーション・プログラムによって行われた変更(通常は、データベースの更新)をコミットするために使用されます。

形式

I/O PCB or AIB

説明

Tuxedo ART for IMSでは、プログラムが異常終了した場合、すでに行われた変更をコミットするためにシミュレートされたSYNCが使用され、プログラム内には再開位置が設定されません。

パラメータ

I/O PCB

AIB

INQY

名前

INQY: 実行環境、宛先タイプおよびステータス、およびセッション・ステータスに関する情報を要求するために使用されます。INQYは、AIBTDLIインタフェースを使用している場合にのみ有効です。

形式

AIB I/O Area

説明

IMSでは、次のサブ関数のみがサポートされています。NULL、FINDbbbb、PROGRAMb、DBQUERYb。

NULLサブ関数の場合、ART/IMSは、ART/IMSがサポート可能なPCB関連情報のみがI/O領域に返されます。"端末の位置"および"トランザクションの位置"は、"LOCAL"を使用する場合にのみサポートされています。

"FINDbbbb"の場合、PCBアドレスはAIBRSA1フィールドで返されます。

64ビット・プラットフォームでは、アドレスの長さが8バイトであるため、AIBRES3の最初の4バイトも使用されます。

サブ関数"PROGRAMb"は、I/O領域の最初の8バイトでプログラム名を返します。

"DBQUERYb"サブ関数の場合、PSBで定義されているDBPCBがない場合、"BJ"がIO PCBステータスで返されます。それ以外の場合、IO PCBステータスは、データベースの使用可能性に従って返されます。

パラメータ

AIB

I/O領域

AIBでの結果:

戻りコードおよび理由コードは、IBMの戻りコードおよび理由コードの説明に沿って調整されます。"DBQUERYb"の場合、データベースの使用可能性ステータスは、IOPCBステータスです。

' bb' (2つの空白): 呼出しは成功し、すべてのデータベースが使用可能です。

'BJ': DB PCBがPSBに存在していません。または、PSB内のデータベースのいずれも使用可能でないか、PSBにPCBが存在していません。すべてのデータベースPCB (GSAMを除く)には、INQY DBQUERY呼出しの処理結果としてNAステータス・コードが含まれています。

'BK': PSBの少なくとも1つのデータベースが、使用可能でないか、使用可能性が制限されています。少なくとも1つのデータベースPCBに、INQY DBQUERY呼出しの処理結果としてNAまたはNUステータス・コードが含まれています。

IMSでは、"DBQUERYb"呼出しの後に、各DB PCBのステータス・コードを使用してDBステータスを確認することはできません。

XRST

名前

XRST: プログラムを再起動するために使用されます。プログラム内でシンボリック・チェックポイント呼出しを使用する場合、XRST呼出しを使用する必要があります。

説明

XRSTは、プログラムを再起動するために使用されます。プログラム内でシンボリック・チェックポイント呼出しを使用する場合、XRST呼出しを使用する必要があります。

Tuxedo ART for IMSでは、関連するCHKP (シンボリック)呼出しに保存されたデータをリカバリするために、シミュレートされたXRSTが使用されます。GSAMは、CHKP (シンボリック)呼び出しが行われた記録位置に再配置されるので、後続のすべての"GN"呼び出しはリカバリされた位置で続行します。関連するすべてのGSAM/DB PCBのステータス・コードは、XRSTコール(既存のCHKPIDを使用)が成功した後、空白になります。

特定のCHKP IDの場合、XRSTは、Job name + program name + psb name + CHKP IDという検索キーを使用して、レコード・ログ・ファイル内で、先頭から末尾の方向に、CHKPレコードを検索します。検索キーに一致する1つ目のCHKPレコードが検出された場合、XRSTはこのレコード内のデータをリストアし、成功を返します。検索キーに一致するCHKPレコードが存在しない場合、XRSTは異常終了します。

CHKP IDがLASTの場合、XRSTは、Job name + program name + psb nameという検索キーを使用して、レコード・ログ・ファイル内で、末尾から先頭の方向に、CHKPレコードを検索します。検索キーに一致する1つ目のCHKPレコードが検出された場合、XRSTはこのレコード内のデータをリストアし、成功を返します。検索キーに一致するCHKPレコードが存在しない場合、XRSTは異常終了します。

パラメータ

I/O PCB or AIB, I/O Area, I/O Area Length, IO Area, area length, area, …

I/O PCB

AIB

次のフィールドは、AIB内で初期化されている必要があります。

I/O領域の長さ

I/O領域

領域の長さ

領域

結果(ステータス・コード)

'bb': 成功(2つの空白)。

'AD': 関数パラメータが無効です。Tuxedo ART for IMSによって関数呼出しが提供されていません

Tuxedo ART for IMSの言語環境

CEE3ABD/ART3ABD

CEE3ABDは、Tuxedo ART for IMSがプログラムの実行を異常終了コードで終了することをリクエストします。この関数からは何も返されず、関数に関連付けられた条件もありません。Tuxedo ART for IMSでは、次の手順を実行してこの関数を起動できます。

パラメータ

abcode

clean-up

Tuxedo ART for IMSのMFSサポート

IMS MFS制御ブロック・サポート

メッセージ形式およびデバイス形式の定義は、定義文の別の階層セットで実行されます。表11は、すべての定義文とそれらの説明を示しています。

前述の表の"END"文は、入力ファイルの終わりを定義します。その後のすべてのコンテンツは無視されます。入力ファイルに"END"がない場合、MFSGENによって警告メッセージが生成され、入力ファイルにそれが追加されます。

文の名前ごとに、いくつかのフィールドがあります。詳細なフィールド名および値の要件を、表12および表13に示します。他のすべての文は、現在、サポートされていないフィールドとみなされます(表14に示す)。

前述の表の最後の列について、「サポート対象」とはフィールドがサポートされていることを意味し、「警告」とはフィールドはサポートされておらず、このフィールドは指定されてないかのようにツールによって無視され、警告が生成されることを意味します。「エラー」とはフィールドがサポートされておらず、ツールによってエラーが報告され、現在の定義文セットの解析に失敗することを意味します。

Tuxedo ART for IMSの非端末アクセス・サポート

MPPによってエクスポートされたサービスへの非端末アクセスをサポートし、より多くのクライアントがMPPによってエクスポートされたサービスを使用できるように、この機能によってTuxedo ART for IMSの非端末アクセス・サポートが強化されています。ユーザーは、非端末アプリケーション(ネイティブのOracle Tuxedoクライアント、SALTクライアント、JCAクライアントなど)を介してTuxedo ART for IMSのMPPサービスを使用できます。

この機能は非端末tuxedoクライアント(ネイティブのTuxedoクライアント、SALTクライアント、JCAクライアントを含む)とMQアプリケーションの両方をサポートしています。

非端末tuxedoクライアントの場合、プログラミング・インタフェースが提供されます。クライアントは、次のプログラミング・インタフェースを使用して、MPPサービスにアクセスできます。

非端末Oracle Tuxedoクライアントと異なり、WebSphere MQアプリケーションはOracle Tuxedoクライアントではありません。MQメッセージ形式と、MQアプリケーションと従来のIMSアプリケーション間のメッセージ・フローは、WebSphere MQアプリケーション・プログラミング・ガイドですでに定義済です。IMS環境では、MQアプリケーションがMQ-IMSブリッジを使用して暗黙的なMQIサポートを有効にすることで、従来のIMSアプリケーションをリライト、再コンパイル、再リンクしなくても、WebSphere MQメッセージがそれらにアクセスできるようにします。この機能では、Oracle Tuxedo MQ Adapterを利用して、MQアプリケーションをOracle Tuxedoクライアントに変換します。

プログラミング・インタフェース

非端末Oracle Tuxedoクライアントのプログラミング・インタフェース

Tuxedo ART for IMSでは、非端末クライアントとTuxedo ART for IMSのMPPサーバー間のブリッジとして機能するサーバー、ARTIGWが提供されます。非端末クライアントは、次に示すプログラミング・インタフェースに従って、ARTIGWサービスを呼び出します。ARTIGWはサービス・リクエストをARTMPPに転送します。

ARTIGWと非端末Oracle Tuxedoクライアント間の唯一のインタフェースは、FML表です。

アプリケーション・バッファでIMSトランザクション(TRANS1など)を実行するには、次の手順を実行します。

インタフェースのFMLフィールド表(ARTIGWFML)とヘッダー・ファイル(ARTIGWFML.h)は、$IMSDIR/includeの下にあります。リスト4は、ARTIGWFMLの内容を示しています。

*base 30000700

#name         rel-number    type     flags     comment
#-----        -----------   ------   -------   ------------------------
IMS_SVC_NAME		   181        string
IMS_SVC_FLAG		   182        long
IMS_SVC_RESULT		   183        long
IMS_SEG_DATA		   184        carray
IMS_SVC_SYSMSG		   185        carray

MQアプリケーションに対してサポートされているMQメッセージ

MQ-Tuxedo ART for IMSブリッジは次のメッセージ・タイプを受け入れます。

構成

Oracle Tuxedo MQ Adapterの構成

MQアプリケーションをサポートするには、ユーザーはTuxedo 12cR1 RP17以降を適用し、次に示す手順に従う必要があります。

ARTIGWの構成

ARTIGWは、非端末クライアントとARTIMPPサーバー間のブリッジとして機能するTuxedoサーバーです。詳細は、「サーバーの構成」を参照してください。

クロス・ドメイン構成

ARTIGWとARTIMPPが異なるドメインにデプロイされている場合、ARTIGWは<tuxclt_service_name>_REPLY_<grpid>_<srvid>および<mq_service_name>_REPLY_<grpid>_<srvid>という名前でサービスをエクスポートします。GRPIDとSVRIDは5文字です(0で始まります)。

前述のサービス名は、ARTIMPPが属しているすべてのリモート・ドメインのDMCONFIGファイルのDM_REMOTE_SERVICESセクションで構成されている必要があります。さらに、ARTIGWが配置されている各ドメインによって適切なサービス名がエクスポートされ、サービス競合がないようにする必要があります。

たとえば、ARTIGWがドメインGWにあり、ARTIMPPがドメインMPPにあると想定します。ARTIGWは、SRVID=101, SRVGRP= GROUP1で、デフォルト・サービス名を使用するように構成されています。リスト5は、MPPおよびGWドメインに対するDMCONFIGファイルの例を示しています。

制限

非端末Oracle Tuxedoクライアントの制限事項

MQアプリケーションの制限事項

Tuxedo ART for IMSの永続メッセージ・サポート

Tuxedo ART for IMSでは、ALT PCBを使用するプログラムに対してのみ、永続メッセージがサポートされます。ALT PCBによるプログラム切替えでは、ターゲット・トランザクションが永続トランザクションの場合、メッセージはそのトランザクションの/Qに格納されます。永続トランザクションの定義方法については、imsresource.descに関する項を参照してください。

永続メッセージをサポートするために、ARTIMPPは2つの実行モードで区別されます。1つは標準モードのARTIMPPで、もう一方は永続モードのARTIMPPです。2つのARTIMPPサーバー・モードの定義方法については、ARTIMPPの構成に関する項を参照してください。

標準モードのARTIMPPはトランザクションをサービスとして通知し、端末リクエストやARTIGWからのリクエストなど、フロントエンドからの標準サービス・リクエストを処理します。サービス・リクエストはTuxedoフレームワークによってスケジュールされ、Tuxedo IPCキュー経由で渡されます。

永続モードのARTIMPPは、サービスを通知しません。これは、CLASSが属している永続トランザクションのすべての/Qが、ARTIMPPの" -l class_list"パラメータに対応しているかどうかをモニターします。永続トランザクションの/Qからメッセージを取得し、トランザクションに対応するプログラムを実行します。

ARTIBMPTは永続メッセージのサポートに関連するサーバーでもあります。ARTIBMPTが提供するトランザクション指向BMPプログラムは、永続トランザクションのみである必要があります。"トランザクション指向BMP"の詳細は、ARTIBMPTの構成に関する項を参照してください。トランザクション指向BMPプログラムでは、GU操作によってトランザクションの/Qからメッセージを取得します。

サーバーの構成

表18は、サーバー構成のプロセスとおよびコマンドを示しています。

ARTICTL

名前

ARTICL - 3270端末をTuxedo ART for IMSランタイムに結合するために使用されます。

形式:

ARTICTL SRVGRP="identifier"

SRVID="number"

CLOPT="[servopts options] -- -n netaddr -L pnetaddr [-S ssladdr] [-m minh] [-M maxh] [-x session-per-handler] [-p profile-name][-z mine] [-Z maxe]
[-D [+H handler-number]]"

説明

UBBCONFIGファイルのMACHINESセクションでMAXWSCLIENTSパラメータを指定する必要があります。MAXWSCLIENTSは、ARTICTLに対して特別な意味を持つ唯一のパラメータです。MAXWSCLIENTSは、3270端末専用に予約されているアクセス・スロットの数を、起動時にOracle ARTに通知します。

MAXWSCLIENTSに対して、ノードに接続できる3270端末の最大数を指定します。デフォルトは0です。指定しない場合、端末から、指定されたマシンに接続できません。

構文は、MAXWSCLIENTS=numberです。

パラメータ

-n netaddr

-L pnetaddr

[-m minh]

[-M maxh]

[-x session-per-handler]

[-S ssladdr]

[-p profile-name]

-z minencryptbits

– Z maxencryptbits

[-D [+H handler-number]]

例

*MACHINES
DEFAULT:
MAXWSCLINETS = 20
...
*SERVERS
ARTICTL SRVGRP="MFSGRP"
SRVID=1000
RESTART=Y GRACE=0
CLOPT="-- -n //hostname:4000 -L //hostname:4002 -m 1 -M 10"

ARTIMPP

名前

ARTIMPP: TPタイプCOBOL/Cプログラムのサービス・ハンドラおよびコンテナ。

形式:

ARTIMPP SRVGRP="identifier"

SRVID="number"

CLOPT="[servopts options] -- -l class_list [-V][-p][-m cobol mode][-D trace-level][-x parameter list for DB plugin]"

説明

ARTIMPPは、TPタイプCOBOL/Cプログラムのサービス・ハンドラおよびコンテナとして機能するTuxedoサーバーです。ARTIMPPには2つの実行モードがあります。1つは標準モード(CLOPTで-pの指定なし)のARTIMPP、もう一方は永続モード(CLOPTで-pを指定)のARTIMPPです。

標準モードのARTIMPPは、フロントエンドから受け取ったサービス・リクエスト(端末、ARTIGWからのリクエスト)に従って、対応するCOBOL/Cプログラムを起動します。

永続モードのARTIMPPは、ARTIMPPのCLOPTにある"-l class_list"パラメータでクラスが定義されている永続トランザクションの/Qをモニターします。これは/Qからメッセージを受信し、対応するCOBOL/Cプログラムを起動します。

パラメータ

[-l class_list]

-p

-V

[-m cobol mode]

[-D trace-level]

[-x]

Oracle IMS/DBソリューションの場合、パラメータ・リストは次のとおりです。

-o host:port:dra

これは、IMS/DB用のOracleプラグインで必要とされるパラメータです。

制限

ROLBまたはROLLを発行する永続トランザクションの場合、トランザクションは永続モード・サーバーの1つのARTIMPPによってのみ処理できます。つまり、(imstrans.descで定義された)トランザクションのCLASS定義は、永続モード・サーバーの1つのARTIMPPの-lパラメータのみと一致します。

ARTIMPP_ORA

説明

ARTIMPP_ORAは、ARTIMPPのすべての機能を備えています。また、外部リソース・マネージャ(RM)として使用されるOracle Databaseもサポートできます。これは、Oracle Databaseによって提供されるいくつかのライブラリを使用します。Oracle Databaseでこの環境変数を使用するには、UBBCONFIGファイルでRMセクションを適切に構成する必要があります。

ARTIBMP

名前

ARTIBMP: BATCHタイプCOBOL/Cプログラムのプログラム・コンテナ。

形式:

ARTIBMPSRVGRP="identifier"

SRVID="number"

CLOPT="[servopts options] -- [-V][-m cobol mode][-D trace-level][-x parameter list for DB plugin] "

説明

ARTIBMPは、BATCHタイプのCOBOL/Cプログラムのプログラム・コンテナとして機能するTuxedoサーバーであり、受信したプログラム名に応じて対応するCOBOLプログラムを起動します。エラーや異常終了がなく、ユーザー・プログラムもクラッシュしていない場合、ユーザー・プログラムのリターン・コードはDFSRRC00です。

パラメータ

-V

[-m cobol mode]

[-D trace-level]

[-x]

Oracle IMS/DBソリューションの場合、パラメータ・リストは次のとおりです。

-o host:port:dra

これは、IMS/DB用のOracleプラグインで必要とされるパラメータです。

ARTIBMPT

名前

ARTIBMPT: トランザクション指向バッチ・プログラムを処理するOracleTuxedoサーバー。

形式

ARTIMPP SRVGRP="identifier" SRVID="number"

CLOPT="[servopts options] -- -l class_list [-m cobol mode][-D trace-level] [-x parameter list for DB plugin] "

説明

トランザクション指向BMPプログラムは、ARTIBMPTによって処理され、 ${IN}パラメータの指定されたDFSRRC00によってトリガーされる必要があります。トランザクション指向BMPプログラムは、imstrans.descで定義され、imsapps.descでもTYPE=BATCHによって定義されているプログラムです。

トランザクション指向BMPプログラムは永続トランザクションにする必要があり、imsresource.descで定義する必要があります。ARTIBMPTサーバーは、トランザクション指向BMPプログラムのみを処理します。

エラーや異常終了がなく、ユーザー・プログラムもクラッシュしていない場合、ユーザー・プログラムのリターン・コードはDFSRRC00です。

パラメータ

[-l class_list]

[-m cobol mode]

[-D trace-level]

[-x]

Oracle IMS/DBソリューションの場合、パラメータ・リストは次のとおりです。

-o host:port:dra

これは、IMS/DB用のOracleプラグインで必要とされるパラメータです。

制限

ROLBまたはROLLを発行するトランザクション指向BMPプログラムの場合、トランザクションは1つのARTIBMPTサーバーによってのみ処理できます。

つまり、(imstrans.descで定義された)トランザクションのCLASS定義は、1つのARTIBMPTサーバーの"-l class_list"パラメータのみと一致します。

ARTIBMP_ORA

説明

ARTIBMP_ORAは、ARTIBMPのすべての機能を備えています。また、外部リソース・マネージャ(RM)として使用されるOracle Databaseもサポートできます。これは、Oracle Databaseによって提供されるいくつかのライブラリを使用します。Oracle Databaseでこの環境変数を使用するには、UBBCONFIGファイルでRMセクションを適切に構成する必要があります。

ARTIADM

名前

ARTIADM - Tuxedo ART for IMSランタイムの管理を担当するOracle Tuxedoサーバー。

形式

ARTIADM SRVGRP="identifier"

SRVID="number"

CLOPT="[servopts options]--[-D trace-level]"

説明

分散ターゲット環境では、このサーバーを各ノード上に構成して、構成の通知を実行することができます。これらのサーバーを使用すると、マスター・ノード上では、構成ファイルのみ構成する必要があり、管理サーバーは構成ファイルを各スレーブ・ノードに通知します。

起動時に、マスター・ノード上で動作している管理サーバーは、ディレクトリ${ART_IMS_CONFIG}にあるすべての構成ファイルを読み込みます。スレーブ・ノード上で動作する各管理サーバーの起動起動時には、マスター・ノード上の管理サーバーと通信して、構成ファイルの内容をフェッチします。

続いてスレーブ・ノード上の管理サーバーは、スレーブ・ノード上のディレクトリ${ART_IMS_CONFIG}にある、対応する構成ファイルに書き込みます。存在しない場合は、新しい構成ファイルが作成されます。構成ファイル同期関数はオプションです。デフォルトでは、この関数は無効になっています。

パラメータ

[-D trace-level]

ARTITERM

名前

ARTITERM: 異なるドメインに配置されているARTICTLとARTIMPPの間のメッセンジャとして機能します。

形式:

ARTITERM SRVGRP="identifier"

SRVID="number"

CLOPT=""

説明

クロス・ドメイン環境では、ARTITERMサーバーは、異なるドメインに配置されているARTICTLとARTIMPPの間のメッセンジャとして機能するために使用されます。ARTITERMは、ARTIMPPに特別なサービスを提供し、したがって、ARTIMPPはデータをARTITERMに渡すことができ、それは次にそのデータをARTICTLに渡します。

ARTIGW

名前

ARTIGW: 非端末クライアントとARTIMPPサーバー間のブリッジとして機能するOracle Tuxedoサーバー。

形式:

ARTIGWSRVGRP="identifier"

SRVID="number"

CLOPT="[servopts options] [-m mq_service_name] [-s tuxclt_service_name] [-V][-D trace-level]"

説明

ARTIGWは、非端末クライアントとARTIMPPサーバー間のブリッジとして機能するOracle Tuxedoサーバーです。主な機能は次のとおりです。

パラメータ

mq_service_name

tuxclt_service_name

-V

[-D trace-level]

ODBAPROX

名前

ODBAPROX - z/OS上のソケット・サーバーであり、TCP/IPを介してTuxedo ART for IMSサーバーと通信するものです。

形式:

ODBAPROX -h host -l command_port -p odba_port -n max_handler_num [-D]

説明

ODBAプロキシは、ソケット・サーバーであり、TCP/IPを介してTuxedo ART for IMSサーバーと通信します。ODBAPROXは、Tuxedo ART for IMS内のプログラムと通信するように開発され、これらのプログラムのかわりにデータベース処理を実行します。

パラメータ:

[-h]

[-l]

[-p]

[-n]

[-D]

詳細は、Oracle Tuxedo Application Runtime for IMSユーザーズ・ガイドのODBAプロキシの使用方法に関する項を参照してください。

セキュリティ構成

認証構成

Tuxedoでは、セキュリティ・メカニズムのどのタイプでも、Tuxedo ATMIアプリケーションに参加するためのプロセスの一部として、すべてのユーザーにアプリケーション・パスワードの入力が要求されますが、Tuxedo ART for IMSでは、IMSがz/OS上に配置されている場合と同じ動作を保つため、それは削除されました。ユーザーはアプリケーション・パスワードをNULLとして保持する必要があります。Tuxedoアプリケーション・パスワードを構成する方法の詳細情報は、Tuxedoのドキュメントを参照してください。USER_AUTHおよびACL/必須ACLセキュリティ・メカニズムでは、ユーザーはTuxedo ART for IMSランタイムに参加するために有効なユーザー名とパスワードを入力することを要求されます。ユーザーごとのパスワードは、tpusrという名前のファイルに格納されたユーザー名に関連付けられているパスワードと一致する必要があります。クライアント名は、使用されません。tpusrのパスワードおよびユーザー名に対するユーザーごとのパスワードの照合は、Tuxedo認証サーバーAUTHSVRによって提供される、Tuxedo認証サービスAUTHSVCによって行われます。Tuxedo USER_AUTHおよびACL/必須ACL認証を構成する方法の詳細は、Tuxedoのドキュメントを参照してください。

詳細は、Oracle Tuxedoユーザーズ・ガイドのATMIアプリケーションにおけるセキュリティの使用に関する項を参照してください。

SSL構成

Tuxedo ART for IMSでは、次の既存のUBBCONFIGファイル・パラメータを使用して、SSL識別文字列およびSSL証明書の暗号化パスワードの場所に関する情報が構成されます。