リファレンス・ガイド

サーバーの構成

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

CICSランタイム・サーバー・リファレンス

一般的なTuxedoサーバー構成について

Tuxedo UBBCONFIG構成ファイルで構成されるすべてのTuxedoサーバーは、すべてのサーバーに共通な標準の引数を使用します。この柔軟性はCICSランタイム・サーバーの長所の1つです。

必須の引数は、SVRGRPとSVRIDです。

MIN、MAX、SEQUENCE、CONVなど、他の共通の引数も使用できます。

Tuxedoサーバー構成の用途に関する正確な情報については、Tuxedoのドキュメント(特にUBBCONFIG(5)のSERVERSの項)を参照してください。

これらのオプションの引数のうち、最も有用なものの1つが、CLOPT (Command Line OPTions)引数です。CLOPTオプションは、Tuxedoサーバーの起動時に渡されるコマンド行オプションの文字列です。

このコマンド行オプションは、次の2つの部分に分けられます。

標準の出力とエラーの宛先は特定のファイルです。

CLOPTの使用に関する正確な情報は、Tuxedoドキュメント、とりわけservoptsの項を参照してください。

CICS Runtime固有のサーバーの説明は、2つの必須のサーバー引数SVRGRP & SVRIDと、サーバー・タイプによりシステム的に具体的に必要とされる引数のみを含みます。

CICSランタイム・サーバーの一般的なCLOPTオプション

この項では、すべてのCICSランタイム・サーバーに共通のオプションを説明します。これらのオプションについては、この項にのみ記載されています。

CICS SYSID引数

この引数は、CICSシステムの名前を定義します。

形式

-s TEST

説明

EXEC CICS ASSIGN SYSIDによってプログラムに戻された値を設定します。

文字、1-256, A-Za-z0-9[/:-]。

システム識別子(CICS SYSID)は4文字に制限されています。

除外

このオプションは、ARTTCPLサーバーと接続サーバーには適用されません。

CICSアプリケーションIDの引数

この引数は、CICSシステムのAPPLID名前を定義します。

形式

-a INVOICE

説明

EXEC CICS ASSIGN APPLIDによってプログラムに戻された値を設定します。

文字、1-256, A-Za-z0-9[/:-]。

アプリケーションID (CICS APPLID)は8文字に制限されています。

除外

このオプションは、ARTTCPLサーバーと接続サーバーには適用されません。

グループ引数の動的リスト

この引数は、このサーバーによってロードされるリソース・グループのリストを定義します。

形式

-L LIST1:LIST2:…

説明

実行中のサーバーのリストでグループの動的変更を有効化します。-L引数によって参照されるリストは、list_of_groups構成ファイルで定義する必要があります。この引数は、非推奨になった-lオプションのかわりとなります。

リソース構成ファイルのリストは、10文字の文字列によって定義されます。いずれかのリストに含まれるいずれかのグループに属するメモリー・リソースでのみ、サーバーはロードします。

テスト・サーバーまたは一般的なサーバーのためのファシリティとして、-L ‘*’を使用することによりフィルタリングを削除し、list_of_groups構成ファイルで定義されているすべてのリソースを、サーバーがロードできるようにします。グループは、-L ‘*’を指定するサーバーによってロードされますが、1つ以上のリストに含まれる場合に限ります。

除外

このオプションは、ARTTCPLサーバーと接続サーバーには適用されません。

グループ引数の静的リスト

この引数は非推奨になり、-L引数に置き換えられました。このリリースではまだサポートされていますが、今後のリリースでは削除される予定です。

この引数は、リソースのロード時にこのサーバーで検討されるリソース・グループをリストします。

CLOPTで静的に定義されるグループのリストは、動的に変更できません。リストの動的変更を実装する場合は、かわりに-Lオプションを使用します。

形式

-l group1:group2:…:groupn

説明

リソース構成ファイルのグループは、10文字の文字列によって定義されます。サーバーは、これらのグループの1つに属するメモリー・リソースでのみロードします。

テスト・サーバーまたは一般的なサーバーのためのファシリティとして、– l ‘*’を使用することによりフィルタリングを削除し、構成ファイルで定義されているすべてのリソースを、サーバーがロードできるようにします。

除外

このオプションは、ARTTCPLサーバーと接続サーバーには適用されません。

WebSphere MQキュー・マネージャ名

この引数は、WebSphere MQキュー・マネージャのデフォルト名を指定します。

形式

-m queue_manager_name 

説明

モニター対象のWebSphere MQキュー・マネージャのデフォルト名を指定します。

1つのサーバーに指定できるWebSphere MQキュー・マネージャは1つのみです。メインフレームから移行されたトランザクション・プログラムにMQCONNアクションがない場合、デフォルト・キュー・マネージャが使用されます。

除外

このオプションは、ARTTCPLサーバーと接続サーバーには適用されません。

関連項目

『Oracle Tuxedo Application Runtime for CICSユーザー・ガイド』の「WebSphere MQとの統合の実装」

IMS DB引数

この引数は、アクセスするIMS/DBシステムを定義します。

形式

--IMSDB -x -o host:port:dra

説明

アクセスするIMS/DBシステムを定義します。この引数は、CLOPTの最後の引数である必要があります。

--IMSDB

host

port

dra

除外

このオプションは、次のサーバーのみに適用されます。ARTSTRN、ARTSTR1、ARTATRN、ARTATR1、ARTCTRN、ARTCTR1、ARTWTRN、ARTWTR1およびARTDPL。

RM再接続引数

この引数は、リクエストされたときにARTアプリケーション・サーバーがRMに再接続できるようにします。

形式

-R [MAX_TRANS_NUM] 

説明

この引数は、リクエストされたときにARTアプリケーション・サーバーがRMに再接続できるようにします。

-R MAX_TRANS_NUM

除外

CICSランタイム・サーバーの構成リファレンス

ARTTCPL/ARTTCPHの構成

サーバー名

ARTTCPL - ターミナル制御プログラム・リスナー。

形式

ARTTCPL SRVGRP="identifier" SRVID="number" CLOPT="[servopts options] -- -n netaddr -S ssladdr -L pnetaddr [-m minh] [-M 

maxh] [-x session-per-handler] [-p profile-name] [-z minencryptbits] [-Z maxencryptbits] [-t Application_list_transid] [-T minutes] [-D] [+H trace-level] [-K seconds]"

説明

ターミナル制御プログラム(ARTTCP)は、3270ターミナル・エミュレータのCICS Runtimeへの接続を管理するTuxedoサーバーのグループです。プログラムを実行すると、ARTTCPはターミナル・エミュレータを、ARTTCPに割り当てられているネットワーク・ポートに接続します。ARTTCPは、Telnetプロトコルを使用してエミュレータと通信します。

ARTTCPサーバーは、単一のARTTCPリスナー(ARTTCPL)プロセスと1つ以上のARTTCPハンドラ(ARTTCPH)プロセスの、2つのタイプのサーバーで構成されます。ARTTCPLプロセスは、ターミナル・エミュレータが接続する可能性があるWell Knownリスニング・ポート・アドレスを確立します。ARTTCPHプロセスは、このポートでリスニングして、着信接続リクエストを受け入れます。ARTTCPHプロセスは、接続のためにユーザー・セッションを確立し、ターミナル・エミュレータのそれ以降のすべての画面I/Oを処理します。パフォーマンス拡張として、各ARTTCPHプロセスは、複数のセッションを同時に管理できます。ポートからエミュレータを切断すると、ARTTCPHはセッションを終了します。

ART Runtimeに3270ターミナルを参加させるには、UBBCONFIGファイルのMACHINESセクションでMAXWSCLIENTSパラメータを指定する必要があります。MAXWSCLIENTSは、ARTTCPL専用の唯一のパラメータです。MAXWSCLIENTSに指定された値は、Oracle ARTの起動時に通知され、3270ターミナル用に確保するアクセッサ・スロットの数が決まります。

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

構文はMAXWSCLIENTS=numberです。

パラメータ

次のCLOPT実行時パラメータが認識されます。

-n netaddr

-S ssladdr

-L pnetaddr

[-m minh]

[-M maxh]

[-x session-per-handler]

[-p profile-name]

[-z minencryptbits]

[-Z maxencryptbits]

[-t Application_list_transid]

[-T minutes]

[-D ]

[+H trace-level]

[-K seconds]

例

*MACHINES

DEFAULT:

MAXWSCLIENTS = 20

...

*SERVERS ARTTCPL SRVGRP="TCPGRP" SRVID=1000 RESTART=Y GRACE=0

CLOPT="-- -n //hostname:4000 -L //hostname:4002 -m1 -M10 "

ARTSTRNの構成

サーバー名

ARTSTRN - 同期ターミナル指向のMAXACTIVE > 1のトランザクションのためのCICSランタイム・メイン・サーバー。

形式

ARTSTRN SRVGRP="identifier" SRVID="number" CONV=Y MIN=minn MAX=maxn RQADDR=queueaddr REPLYQ=Y CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2 --IMSDB -x -o host:port:dra"

説明

ARTSTRNサーバーはアプリケーション・トランザクションをTuxedoサービスとして提供し、トランザクション・リクエストを受信すると、対応するプログラムを実行します。

これらのサーバーは、真の対話型CICSトランザクションを管理するために、対話型になっています。

tranclassに属さないか、maxactive >1であるtranclassに属しているトランザクションだけが、これらのサーバーにより通知されます。

パラメータ

CONV

minn and maxn

CLOPTオプション

使用されている環境変数

例

*SERVERS

ARTSTRN SRVGRP="TCPGRP" SRVID=1000 RESTART=Y GRACE=0

CONV=Y MIN=2 MAX=3 RQADDR=QKIX1000 REPLYQ=Y

CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTSTR1の構成

サーバー名

ARTSTR1 - 同期ターミナル指向のMAXACTIVE = 1のトランザクションのためのCICSランタイム・メイン・サーバー。

形式

ARTSTR1 SRVGRP="identifier" SRVID="number" CONV=Y MIN=1 MAX=1 CLOPT="[servopts] -- -s System_ID -a Application_ID-L list1:list2,… --IMSDB -x -o host:port:dra"

説明

ARTSTRNサーバーがMAXACTIVE > 1のトランザクションだけを提供するのに対して、これらのサーバーは、MAXACTIVE = 1のトランザクションだけを提供することに特化したARTSTRNサーバーです。

サーバーのMINとMAXの数が1に設定されていることは重要であり、起動時にSTR1サーバーにより検証されます。(MAXACTIVE = 1の)グループ内の1つのみのトランザクションの並列処理が、同一のトランザクションを提供する少数のサーバーを起動するか、Tuxedoにより起動させるという、これらのサーバーの目標は、STR1サーバーの場合、自己矛盾です。

MINとMAXが1に設定されているので、Tuxedo引数RQADDRは不要であり、単純さを維持するため、使用しないでください。

残りの構成とSTR1サーバーの動作は、STRNサーバーと正確に同じです。

例

*SERVERS

ARTSTR1 SRVGRP="TCPGRP" SRVID=1000 RESTART=Y GRACE=0

CONV=Y MIN=1 MAX=1

CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTTSQの構成

サーバー名

ARTTSQ - CICS Runtime一時記憶域キュー・サーバー

形式

ARTTSQ SRVGRP="identifier" SRVID="number" MIN=1 MAX=1

        CLOPT"[servopts] -- -L list1:list2"

説明

ARTTSQは一時記憶域キューを管理し、EXEC CICS (WRITEQ TS、READQ TSおよびDELETEQ TS)が必要とする機能を提供します。ARTTSQ (Oracle DB用)とARTTSQ_UDB (UDB用)の2バージョンのARTTSQサーバーがあります。TMSおよびOPENINFOを適宜定義します。

ARTTSQは、次の2つの主要な種類のサービスを公開します。

パラメータ

次のCLOPT実行時パラメータが認識されます。

-L ListName(s)

DBMS制約

サーバーが含まれるグループのOPENINFOで示されているDBMSユーザーは、直接(このスキーマで作成されるオブジェクト)、またはDBLINKを介して、TS_QCONTENT表にアクセスできる必要があります。

この既存の表では、選択、挿入、更新および削除権限を持っている必要があります。

Oracle用の表を作成するスクリプトは、以下にリストされています。

drop table TS_Q_CONTENT purge;

create table TS_Q_CONTENT

( TS_QUEUE   char(16) NOT NULL,

  TS_ITEM    number(8) NOT NULL,

  TS_LENGTH  number(8),

  TS_RAW     LONG RAW,

  primary key (TS_QUEUE, TS_ITEM)

); 

使用されている環境変数

例

*SERVERS

ARTTSQ SRVGRP="GRP02" SRVID=30 RESTART=Y GRACE=0

        MIN=1 MAX=1 CLOPT=" -- -L list1:list2"

ARTTSQP構成

サーバー名

ARTTSQP - CICS Runtime一時記憶域キュー・プール・サーバー

形式

ARTTSQP SRVGRP="identifier" SRVID="number"

CLOPT="[servopts] -- -L list1:list2"

説明

ARTTSQPは、TSプールで定義された一時記憶域キューを管理します。これはEXEC CICS (WRITEQ TS、READQ TS、およびDELETEQ TS)で必要とされる機能を提供します。ARTTSQP (Oracle DB用)とARTTSQP_UDB (UDB用)の2バージョンのARTTSQPサーバーがあります。TMSおよびOPENINFOを適宜定義します。CICSリージョンは複数のARTTSQPサーバーを持つことが可能で、異なるTuxedoドメインが同じデータベースを使うことができます。したがって、複数のTuxedoドメインにある異なるCICSリージョンで1つのTSキューを共有できます。

複数のARTTSQPサーバーを構成して、同一のTSMODELにサービスを提供させることができるという事実は、ART for CICSのHA機能の特徴です。

パラメータ

次のCLOPT実行時パラメータが認識されます。

-L List_name(s)

必須の引数、「グループ引数の動的リスト」を参照してください。

DBMS制約

サーバーが含まれるグループのOPENINFOで示されているDBMSユーザーは、直接(このスキーマで作成されるオブジェクト)、またはDBLINKを介して、ARTTSQP_INFO、ARTTSQP_CONTENT、およびARTTSQP_MAN表にアクセスできる必要があります。

DBMSユーザーは、これらの既存の表に対する選択、挿入、更新および削除権限を持っている必要があります。

テーブルを作成するためのサンプル・スクリプトは$KIXDIR/toolsのcrtsptable_{Oracle|UDB}にあります。

UDBを使用するときには、次の手順に従って、ARTTSQP_UDBを再バインドしてください。

1. 環境変数MT_DB_LOGINを設定し、データベース接続情報を入力します。

2. $KIXDIR/binに移動します。

3. 次を実行します。

../tools/bind.sh tspool_UDB.bnd

bind.shスクリプトはDB2 BINDコマンドを発行します。パラメータは、実際のシナリオに合わせて変更できます。変更はARTTSQP_UDBに影響を与えるだけでなく、buildartcicsのようなコマンドを介して、ARTSRM_UDBやARTTSQ_UDBにも影響します。

使用されている環境変数

例

*SERVERS

ARTTSQP SRVGRP="GRP02" SRVID=1000 RESTART=Y

CLOPT=" -- -L list1:list2"

ARTTDQの構成

サーバー名

ARTTDQ - CICS Runtime一時データ・キュー・サーバー

形式

ARTTDQ SRVGRP="identifier" SRVID="number" MIN=1 MAX=1

CLOPT"[servopts] -- -L list1:list2:..."

説明

ARTTDQは一時データ記憶域キューを管理しますが、これはEXEC CICS (WRITEQ TD、READQ TDおよびDELETEQ TD)が必要とする機能を提供します。

ARTTDQは、宣言されたキューにつき1つのサービスを、「_TDQ」という接尾辞が付いたTDQueueの名前で公開します。

同じサービスを2回公開しないように、1つのリソースのグループは、単一のARTTDQサーバーに割り当てられる必要があります。これは起動時に確認され、違反時には、起動フェーズでエラー・メッセージが生成されますが、アクションはとられません。

サーバー数のMINとMAXが1に設定されていることは重要であり、起動時にTDQサーバーにより検証されます。

余分なパーティションTDQデータは、このサーバーがダウン(停止またはクラッシュ)した後、失われます。

パラメータ

ARTTDQ

-L ListName(s)

使用されている環境変数

例

*SERVERS

ARTTDQ SRVGRP="GRP02" SRVID=30 RESTART=Y GRACE=0

        MIN=1 MAX=1 CLOPT=" -- -s PROW -l group1:group2"

ARTDPLの構成

サーバー名

ARTDPL - 分散プログラム・リンク実行のためのCICSランタイム・サーバー。

形式

ARTDPL SRVGRP="identifier" SRVID="number" MIN=minn MAX=maxn

	CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2 -b suffix -d suffix --IMSDB -x -o host:port:dra"

説明

これらのサーバーは、DPLサブセットに制限されたアプリケーション・プログラムをtuxedoサービスとして提供し、DPLサービス・リクエストを受信すると、対応するプログラムを実行します。これらのプログラムは、ターミナル・ユーザーと直接対話できない、画面のないプログラムです。これらのサーバーは、プリンシパル・ファシリティ(ユーザー・ターミナル)に対応する必要がない(できない)ため、対話型である必要はありません。純粋なRPCモード・サーバーです。

プログラムがLINKをリクエストしていて、リクエストされたプログラムがDPLとして構成されている場合、リンクは、通常のように呼出しによってではなく、このサービス(このDPLプログラム)を提供するDPLサーバーの1台が提供するtpcallにより解決されます。

属性REMOTESYSTEM(sysid)がDPLに置かれているプログラムのみが、DPLサーバーと、-sオプションを介して示されているシステムとしてこのsysidを持つサーバーのみによって通知されます。

ARTDPLは、その初期化や停止時に、独力でなんらかの特殊なプログラムを起動するかどうかを選択できます。次の2つの方法があります。1つは、-b suffix_nameまたは-d suffix_nameオプションをそのUBBCONFIGファイルのCLOPTに指定する方法です。もう1つは、PLTPIまたはPLTSDパラメータをsystem.desc構成ファイルに指定する方法です。どちらの方法も、program_list_table.desc構成ファイルを記述する必要があります。この関数は、XA DISABLE機能をサポートしていません。

初期化または停止時に、program_list_table.desc (PLTPIまたはPLTSDで指定)にリストされているプログラムが最初に実行され、次に、-bまたは-dオプションで指定されたプログラムが実行されます。

パラメータ

minn and maxn

CLOPTオプション

使用されている環境変数

例

*SERVERS

ARTDPL SRVGRP="GRP02" SRVID=60 RESTART=Y GRACE=0

MIN=1 MAX=1

CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTATRNの構成

サーバー名

ARTATRN - 非同期指向のMAXACTIVE > 1のトランザクションのためのCICSランタイム・サーバー。

形式

ARTATRN SRVGRP="identifier" SRVID="number" CONV=N MIN=minn MAX=maxn RQADDR=QKIXATR REPLYQ=Y CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2:... --IMSDB -x -o host:port:dra"

説明

ARTATRNサーバーはアプリケーション・トランザクションをTuxedoサービスとして提供し、トランザクション・リクエストを受信すると、対応するプログラムを実行します。

これらのプログラムは、ターミナルのユーザーと直接対話できない、画面のないプログラムです。

ARTSTRN サーバーと対照的に、これらのサーバーは、真のCICSトランザクションを管理するためにトランザクショナルになっています。他のサーバー(START TRANSID)からのみ呼び出され、ターミナルやクライアントから直接呼び出されることはありません。

起動時に、ARTATRNサーバーは、提供するトランザクション1つにつき1つのサービスを公開します。これらのトランザクションは、「ASYNC_{transaction_name}」という名前です。

このサーバーは、ASYNC_QUEUEと呼ばれる内部トランザクションの公開も行います。

tranclassesに属さないか、maxactive >1であるtranclassに属しているトランザクションだけが、これらのサーバーにより通知されます。

パラメータ

CONV

minn and maxn

CLOPT

使用されている環境変数

例

*SERVERS

ARTATRN SRVGRP="TCPGRP" SRVID=2000 RESTART=Y GRACE=0

  CONV=N MIN=2 MAX=3 RQADDR=QKIXATR REPLYQ=Y

  CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTATR1の構成

サーバー名

ARTATR1 - 非同期指向のMAXACTIVE = 1のトランザクションのためのCICSランタイム・メイン・サーバー。

形式

ARTATR1 SRVGRP="identifier" SRVID="number" CONV=N MIN=1 MAX=1 CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2:... --IMSDB -x -o host:port:dra"

説明

ARTATRNサーバーがMAXACTIVE > 1のトランザクションだけを提供するのに対して、ARTATR1サーバーは、MAXACTIVE = 1のトランザクションを提供することに特化したARTATRNサーバーです。

サーバーのMINとMAXの数が1に設定されていることは重要であり、起動時にATR1サーバーにより検証されます。これらのサーバーの目標は、(MAXACTIVE =1の)グループ内の1つのみのトランザクションの並列処理を保証することです。Tuxedoが同一のトランザクションを提供する複数のサーバーを起動することを許すことは、ATR1サーバーの場合、自己矛盾です。

MINとMAXが1に設定されているので、Tuxedo引数RQADDRは不要であり、単純さを維持するため、使用しないでください。

残りの構成とATR1サーバーの動作は、ATRNサーバーと正確に同じです。

例

*SERVERS

ARTATR1 SRVGRP="TCPGRP" SRVID=2000 RESTART=Y GRACE=0

CONV=N MIN=1 MAX=1

CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTCTRNの構成

サーバー名

ARTCTRN - 非対話指向のMAXACTIVE > 1のトランザクションのためのCICSランタイム・サーバー。

形式

ARTCTRN SRVGRP="identifier" SRVID="number" CONV=Y MIN=minn MAX=maxn RQADDR=QKIXCTR REPLYQ=Y CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2:... --IMSDB -x -o host:port:dra"

説明

ARTCTRNサーバーはアプリケーション・トランザクションをTuxedoサービスとして提供し、トランザクション・リクエストを受信すると、対応するプログラムを実行します。

これらのプログラムは、ターミナルのユーザーと直接対話できない、画面のないプログラムです。

ARTSTRN サーバーと対照的に、これらのサーバーは、真のCICSトランザクションを管理するためにトランザクショナルになっています。他のサーバー(CONVERSE)からのみ呼び出され、ターミナルやクライアントから直接呼び出されることはありません。

起動時に、ARTCTRNサーバーは、提供するトランザクション1つにつき1つのサービスを公開します。これらのトランザクションは、「{SysId}_{transaction_name}」という名前です。

{SysId}は、-sパラメータで定義されているこのリージョンの名前です。

tranclassesに属さないか、maxactive >1であるtranclassに属しているトランザクションだけが、これらのサーバーにより通知されます。

パラメータ

CONV

minn and maxn

CLOPT

ARTCTRNの起動時に渡されるコマンド行オプションの文字列。次のパラメータは、ゲートウェイ・プロセスの実行時パラメータとして認識されます。

使用されている環境変数

例

*SERVERS

ARTCTRN SRVGRP="TCPGRP" SRVID=2500 RESTART=Y GRACE=0

  CONV=Y MIN=2 MAX=3 RQADDR=QKIXATR REPLYQ=Y

  CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTCTR1の構成

サーバー名

ARTCTR1 - 非対話指向のMAXACTIVE = 1のトランザクションのためのCICSランタイム・メイン・サーバー。

形式

ARTCTR1 SRVGRP="identifier" SRVID="number" CONV=Y MIN=1 MAX=1

CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2:... --IMSDB -x -o host:port:dra"

説明

ARTCTRNサーバーがMAXACTIVE > 1のトランザクションだけを提供するのに対して、ARTCTR1サーバーは、MAXACTIVE = 1のトランザクションを提供することに特化したARTCTRNサーバーです。

サーバーのMINとMAXの数が1に設定されていることは重要であり、起動時にARTCTR1サーバーにより検証されます。これらのサーバーの目標は、(MAXACTIVE =1の)グループ内の1つのみのトランザクションの並列処理を保証することです。Tuxedoが同一のトランザクションを提供する複数のサーバーを起動することを許すことは、ARTCTR1サーバーの場合、自己矛盾です。

MINとMAXが1に設定されているので、Tuxedo引数RQADDRは不要であり、単純さを維持するため、使用しないでください。

残りの構成とARTCTR1サーバーの動作は、ARTCTRNサーバーと正確に同じです。

例

*SERVERS

ARTCTR1 SRVGRP="TCPGRP" SRVID=2000 RESTART=Y GRACE=0

  CONV=Y MIN=1 MAX=1

  CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTWTRNの構成

サーバー名

ARTWTRN - 同期非3270sクライアント指向のMAXACTIVE > 1のトランザクションのためのCICSランタイム・アプリケーション・サーバー。

形式

ARTWTRN SRVGRP="identifier" SRVID="number" CONV=N MIN=minn MAX=maxn CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2 --IMSDB -x -o host:port:dra"

説明

ARTWTRNサーバーはアプリケーション・トランザクションをTuxedoサービスとして提供し、トランザクション・リクエストを受信すると、対応するプログラムを実行します。

これらのサーバーは、擬似対話型CICSトランザクションをサポートするために非対話型です。

tranclassに属さないか、MAXACTIVE >1であるtranclassに属しているトランザクションのみが、これらのサーバーにより通知されます。

パラメータ

CONV

minn and maxn

CLOPTオプション

使用されている環境変数

例

*SERVERS

ARTWTRN SRVGRP="TCPGRP" SRVID=1000 RESTART=Y GRACE=0

MIN=2 MAX=3

CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTWTR1の構成

サーバー名

ARTWTR1 – 同期非3270sクライアント指向のMAXACTIVE = 1のトランザクションのためのCICSランタイム・アプリケーション・サーバー。

形式

ARTWTR1 SRVGRP="identifier" SRVID="number" CONV=N MIN=1 MAX=1 CLOPT="[servopts] -- -s System_ID -a Application_ID-L list1:list2,… --IMSDB -x -o host:port:dra"

説明

ARTWTRNサーバーがMAXACTIVE > 1のトランザクションのみを提供するのに対して、これらのサーバーは、MAXACTIVE = 1のトランザクションのみを提供することに特化したARTWTRNサーバーです。

サーバーのMINとMAXの数が1に設定されていることは重要であり、起動時にWTR1サーバーにより検証されます。(MAXACTIVE = 1の)グループで1つのトランザクションのみの並列処理を保証し、同一のトランザクションを提供する少数のサーバーを起動するか、Tuxedoにより起動させるという、これらのサーバーの目標は、WTR1サーバーの場合、自己矛盾です。

残りの構成とWTR1サーバーの動作は、WTRNサーバーとまったく同じです。

例

*SERVERS

ARTWTR1 SRVGRP="TCPGRP" SRVID=1000 RESTART=Y GRACE=0

MIN=1 MAX=1

CLOPT=" -- -s PROW -a INVOICE -L list1:list2 --IMSDB -x -o wasa.us.oracle.com:6799:IMSD"

ARTCNXの構成

サーバー名

ARTCNX - ユーザー接続の管理のためのCICS Runtime接続サーバー。

形式

ARTCNX SRVGRP="identifier" SRVID="number" CONV=Y MIN=1 MAX=1 RQADDR=QKIX110 REPLYQ=Y CLOPT="[servopts]"

説明

このサーバーは、ユーザーの接続および切断フェーズでターミナル・ハンドラが必要とする内部サービスを提供します。

たとえば、connectやdisconnectなどの、内部メッセージ指向のサービスを提供します。

次に示す、少数の古典的CICSトランザクションも提供します。

認証エラーの際にハンドラによって使用される内部トランザクションauthfailも公開します。

これらのサーバーは、CICSトランザクションCESN、CESFを管理するために対話型になっています。

このサーバーは、CICSランタイム・システム内で一意である必要があります。

パラメータ

CONV

minn and maxn

CLOPT

-t

-s

-a

-l:

-L:

使用されている環境変数

KIX_TRACE_LEVEL

例

*SERVERS

ARTCNX SRVGRP="TCPGRP" SRVID=1000 CONV=Y MIN=1 MAX=1

ARTLOGNの構成

サーバー名

ARTLOGN - CICSランタイム・ログオン・サーバー

形式

ARTLOGN SRVGRP="identifier" SRVID="number" CONV=Y MIN=1 MAX=1 RQADDR=QKIX110 REPLYQ=Y CLOPT="[servopts]"

説明

このサーバーは、ユーザーがART CICSにログオンするときにターミナル・ハンドラが必要とする次の技術サービスを提供します。

ART_LOGONは、「ARTランタイムへようこそ」パネルを送信し、APPLID入力を求めます。

gensessは、各ターミナルに対して16文字のグローバルに一意なID (すべてのCICSリージョンで一意)を生成します。

delsessは、対応するターミナルの切断時にそのセッションIDを解放します。

パラメータ

CONV

使用されている環境変数

ARTADMの構成

サーバー名

ARTADM — 管理サーバー

形式

ARTADM SRVGRP="identifier" SRVID="number" SEQUENCE=1

説明

このサーバーは、CICSリソースの管理を担当します。次の機能を提供します。

システムの各マシン(マスターまたはスレーブ)でARTADMサーバーを構成する必要があります。ARTADMサーバーは、その他のARTサーバーの前に起動する必要があります。マスター・マシンのARTADMサーバーは、スレーブ・マシンのサーバーより前に起動する必要があります。このシーケンスを確保するには、SEQUENCEを使用して次の構成を実行する必要があります。

使用されている環境変数

KIXCONFIG

KIX_TRACE_LEVEL

例

*SERVERS

ARTADM SRVGRP="ADMGRP" SRVID=1000 RESTART=Y SEQUENCE=1

ARTCKTIの構成

サーバー名

ARTCKTI — ART CICSトランザクション・トリガー・モニター

形式

ARTCKTI SRVGRP="identifier" SRVID="number" CLOPT="[servopts options] -- [-i trigger_interval] [-s retry_interval] [-m queue_manager_name] -q queue_name1,queue_name2,...”

説明

ART CICS Transaction Trigger Monitor (ARTCKTI)は、CICS CKTIトランザクションと同じ動作をします。1つまたは複数のWebSphere MQ開始キュー上でリスニングし、トリガー・イベントが発生するとトリガー・メッセージを取得し、その後の操作のために、トリガー・メッセージをターゲット・トランザクションに転送します。

ARTCKTIサーバーは、ubbconfigファイル用に次のパラメータを受け入れます。

-i trigger_interval

-s retry_interval

-m queue_manager_name

-q queue_name1,queue_name2,……

サーバー接続パラメータ

ARTCKTIサーバーはWebSphere MQクライアントとして動作するので、WebSphere MQキュー・マネージャに接続するARTCKTIには、MQクライアントのチャネル情報が必要です。

通常、これをするための手段は2つあります。1つはクライアント構成ファイル内で指定することで、もう1つは、環境変数MQSERVERを使用して指定することです。

チャネル情報には、使用するWebSphere MQサーバーの位置と、通信方式が含まれる必要があります。ChannelName/TransportType/ConnectionNameという書式の文字列です。

ConnectionNameは、完全修飾ネットワーク名である必要があります。チャネル名、トランスポート・タイプおよび接続名を区切るために使用されるため、ChannelNameには、スラッシュ(/)文字が含まれてはなりません。

ARTCKTIサーバーは、WebSphere MQマルチスレッドのライブラリを必要とします。

詳細は、Websphere MQ Clientのドキュメントを参照してください。

ARTCKTIサーバーのビルド

異なるバージョンのWebSphere MQに基づく独自のARTCKTIサーバーをビルドするユーザーのために、オブジェクト・ファイルも提供されます。

ARTCKTIサーバーをビルドするには、$KIXDIR/binディレクトリへの書込み権限を持つTuxedo管理者として、次のコマンドを実行します。

buildserver -o $KIXDIR/bin/ARTCKTI -t -f "$KIXDIR/objs/ARTCKTI.o $KIXDIR/objs/list.o" -l "-L/$MQM/lib64 -lmqic_r"

$MQMは、WebSphere MQがインストールされているパスです。

ARTSRMの構成

サーバー名

ARTSRM - CICSシステムおよびリソース管理サーバー。

形式

ARTSRM SRVGRP="identifier" SRVID="number" MIN=minn MAX=maxn CLOPT="[servopts] -- -s System_ID -a Application_ID -L list1:list2:… -l GroupList"

説明

ARTSRMは、アプリケーションによって生成および問合せが行われるARTランタイム情報を集中管理します。このサーバーは、/Qを使用するかわりにトランザクションの開始を遅らせるための間隔の制御に使用されます。このサーバーは、ART for CICSアプリケーション・サーバーが異常終了した場合のランタイム・リソース(ファイル・リソース、ENQリソースなど)の解放にも使用されます。ARTSRMは、「複数サーバー、単一キュー構成(MSSQ)」構成をサポートしません。

システムおよびリソース管理サーバー(ARTSRM)には、ARTSRM、ARTSRM_ORA (Oracle用)およびARTSRM_UDB (UDB用)の3つのバージョンがあります。ARTSRMは共有メモリーを使用します。ARTSRM_ORA (Oracle用)およびARTSRM_UDB (UDB用)はデータの格納に共有メモリーまたはデータベースを使用します。データベースを使用するよう構成された場合、サーバーはDBを利用してHA機能を提供します。

ARTSRMサーバーで共有メモリーを使用し、SRM_IPCKEYを指定しない場合は、同じリージョンのARTSRMを同じTuxedoグループで構成する必要があります。

ARTSRM_ORAまたはARTSRM_UDBを使用するには、起動の前にデータベース表を作成する必要があります。これらの表を作成するサンプル・スクリプトはcrsrmtable_{Oracle|UDB}という名前で、$KIXDIR/toolsにあります。ARTSRM_ORAまたはARTSRM_UDBが存在するTuxedoグループは、OPENINFOを構成する必要があります。同じリージョンのARTSRM_ORAまたはARTSRM_UDBは、同じデータベースを使用する必要があります。

ARTSRM_UDBを使用する場合、次の手順を実行して再バインドします。

1. 環境変数MT_DB_LOGINを設定し、データベース接続情報を入力します。

2. $KIXDIR/toolsに移動します。

3. 次を実行します。

bindsrm.sh

ユーザー・アプリケーションについては、構成されているARTSRMはすべて同じストレージ・メディア(データベースまたはメモリー)を使用する必要があります。そうしないと、名前付きカウンタが正しく機能しません。

サーバーが再起動すると、ランタイム情報は失われます。

ARTSRMが正しく動作するためには、2つのシステム・サーバーをUBBCONFIGファイルで事前に構成する必要があります。

パラメータ

CLOPTオプション

関連機能

次の関連機能を有効にするには、ARTSRMを設定する必要があります。

ARTSHM構成

サーバー名

ARTSHM: 共有記憶域管理サーバー

形式

ARTSHM SRVGRP="identifier" SRVID="number" 

説明

このサーバーは、GETMAIN SHAREDの共有メモリー管理を行います。GETMAIN SHAREDの共有メモリーを作成および初期化し、メモリーの割当てと解放の管理、およびHA機能を提供します。

このサーバーは、すべてのART CICSアプリケーション・サーバーより前に起動し、すべてのアプリケーション・サーバーよりも後に停止するように構成する必要があります。

使用されている環境変数

例

*SERVERS

ARTSHM SRVGRP="SHMGRP" SRVID=10 RESTART=Y

ARTCSKL構成

サーバー名

ARTCSKL - ART for CICS TCP/IPソケット・リスナー。

形式

ARTCSKL SRVGRP="identifier" SRVID="number" MIN=minn MAX=maxn CLOPT="[servopts] -- -g ListenerGroupID -p port -D -t seconds"

説明

ARTCSKLはART for CICS TCP/IPソケットのリスナーで、CICS TCP/IPリスナーCSKLと同じ機能を実行できます。クライアント・リクエストを受信すると、作業タスクにリクエストを渡して処理を依頼し、別のクライアント・リクエストを待機します。ARTCSKLは標準モードまたはエンハンス・モードで実行できます。モードは、ART for CICS TCP/IPソケット・リスナー構成ファイル(listener.desc)のFORMATパラメータを介して設定できます。

パラメータ

minnおよびmaxn

CLOPT

-g ListenerID

-p port

-D

-t seconds

使用されている環境変数

例

*SERVERS

ARTCSKL		SRVGRP=GRP02

		SRVID=30

		MIN=1 MAX=1 RESTART=Y MAXGEN=10

		CLOPT="-o /home/kixdev/KIX12130RP/test/CIT_ORA/sample_04/LOGS/sysout/stdout_cskl -e /home/kixdev/KIX12130RP/test/CIT_ORA/sample_04/LOGS/sysout/stderr_cskl -r -- -g section2 -D -t 1" 

関連項目

『Oracle Tuxedo Application Runtime for CICSユーザー・ガイド』のART for CICS TCP/IPソケット・インタフェースの使用の実装に関する項