リンケージ・プロパティー・ファイルは、Web トランザクションを検索する場所、および Web トランザクションと通信する方法をゲートウェイ・サーブレットに指示します。 このファイルによって提供される機能は、 VisualAge® Generator クライアント/サーバー・プログラムのリンケージ・テーブルによって提供される機能に似ています。 このファイルは、ゲートウェイ・サーブレット・パラメーターの hptLinkageProperties パラメーターによって指定されます。デフォルトでは、 リンケージ・プロパティーは、JavaResources¥JavaSource フォルダーの csogw.properties ファイルに保管されます。
リンケージ・プロパティー・ファイルは、 application、serverLinkage、および options の 3 つの型のエントリーによって構成されます。各 application エントリーは、1 つ以上の Web トランザクションを識別し、これらの Web トランザクションへの接続方法を示す serverLinkage エントリーに関連付けられています。
application.WEBUITRAN=CICS5 application.WEBUI*=CICS5 application.STF*=idaho application.MATT*=IMSC application.BASIC*=rtpas400 application.Z*=remoteC serverLinkage.CICS5.commtype=CICSECI serverLinkage.CICS5.contable=CSOE037 serverLinkage.CICS5.location=nracics5 serverLinkage.CICS5.serverid=CPMI serverLinkage.CICS5.javaProperty=my.pkg serverLinkage.idaho.commtype=TCPIP serverLinkage.idaho.contable=CSOX437 serverLinkage.idaho.location=machine01 serverLinkage.idaho.serverid=9877 serverLinkage.idaho.javaProperty=my.pak serverLinkage.IMSC.commtype=TCPIMS serverLinkage.IMSC.contable=CSOE037 serverLinkage.IMSC.location=carimsc serverLinkage.IMSC.tcpport=4000 serverLinkage.IMSC.javaProperty=my.pak serverLinkage.IMSC.imsgroupid=mygroup serverLinkage.IMSC.imsdestid=IMSC serverLinkage.IMSC.serverid=* serverLinkage.rtpas400.commtype=as400 serverLinkage.rtpas400.contable=CSOE037 serverLinkage.rtpas400.location=rtpas400 serverLinkage.rtpas400.javaProperty=my.pag serverLinkage.rtpas400.library=sdearth serverLinkage.remoteC.commtype=cicseci serverLinkage.remoteC.contable=CSOI1252 serverLinkage.remoteC.location=CSONT2 serverLinkage.remoteC.serverid=CPMI serverLinkage.remoteC.ctgLocation=ctghostname serverLinkage.remoteC.ctgPort=2006 serverLinkage.remoteC.javaProperty=my.cicspkg
application.webtran=servername
最終文字は、 ワイルドカード文字 (*) にすることができます。 例えば、application.webui*=CICS5 エントリーは、 webui 文字で始まるすべての Web トランザクションに使用することができます。
application.webui*=abc application.webuit*=defこの場合、2 番目の文が使用されます。
application.SERVER1=CICS5
SERVER1 と呼ばれる Web トランザクションにアクセスするために、ゲートウェイ・サーブレットは、 CICS5 によって識別される serverLinkage エントリーを参照します。
serverLinkage.servername.parameter=value
ある特定の Web トランザクションに対する、 一連の serverLinkage エントリーに割り当てる任意の名前。 名前は、application エントリーに存在しなければなりません。
CSOzxxxx;
SUN Java 変換ルーチンは、UI レコードのデータ定義に基づいてデータを変換します。 さまざまな言語およびプラットフォームの変換テーブルの詳細については、 「VisualAge Generator クライアント/サーバー コミュニケーション・ガイド」を参照してください。
トランザクション ID が CPMI ではないときに CPMI が始動されるのを避けるには、tpn_ を trans_id の前に付加します。 トランザクション ID が WEBT の場合は、例えば、tpn_WEBT を指定します。 しかし、トランザクション ID が CPMI の場合は、CPMI のみを指定します。tpn_ を付加せずに WEBT を指定した場合には、CICS は CPMI を開始し、次に制御権を WEBT に切り替えます。
commtype=TCPIP の場合、serverid は、 Web トランザクションが存在するマシンの listen ソケットのポート番号を指定します。
commtype=TCPIMS の場合、serverid は、 IMS トランザクション・コードを指定します。serverid=* に設定すると、servername の値がトランザクション・コードとして使用されます。
commtype=AS/400 の場合は、 serverid は使用されません。
このエントリーにより、 Web アプリケーション・サーバーの停止と始動をしなくとも、 リンケージ・プロパティー・ファイルに実施したすべての変更点を動的に有効にすることができます。 インスペクション後に起動された Web トランザクションは、新規の値で呼び出されます。 0 の値は、ゲートウェイ・サーブレットがリンケージ・プロパティー・ファイルを始動時にしか 調べないことを表します。