CICS Transaction Server for z/OS Channel Connectivity サンプルのセットアップ
CICS Transaction Server for z/OS Channel Connectivity サンプルをセットアップするには、CICSConnection 構成可能サービスを使用することによって、IBM WebSphere Message Broker から CICS Transaction Server for z/OS への接続を構成します。
それから WMBCHAN1 CICS プログラムの変換、コンパイル、およびリンクを行い、ターゲットの CICS 領域にデプロイできます。
CICS Transaction Server for z/OS Channel Connectivity サンプルのインポートとデプロイを実行する前に、CICSConnection 構成可能サービスを使用して、WebSphere Message Broker と CICS との間の接続を構成する必要があります。
CICS Transaction Server for z/OS Channel Connectivity サンプルを実行する前に、ターゲット CICS 領域で WMBCHAN1 プログラムの変換、コンパイル、およびリンクを行う必要があります。
このサンプルをインポートしてデプロイするために必要な最小構成の手順を以下に示します。
mqsicreateconfigurableservice コマンドまたは WebSphere Message Broker Explorer を使用して、CICSSampleConnectionService という名前の CICSConnection 構成可能サービスを作成します。
mqsicreateconfigurableservice コマンドを使用して CICSConnection 構成可能サービスを作成する
- 以下の例を使用して、mycicsregion.com ポート 12345 で実行する CICS インスタンスの CICSConnection 構成可能サービスを作成します。
ブローカーは、アプリケーション ID (APPLID) BRKApp と修飾子 BRKQual で指定します。
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o CICSSampleConnectionService -n cicsServer -v tcp://mycicsregion.com:12345
- mqsistop コマンドと mqsistart コマンドを使用することによって、WebSphere Message Broker Explorer でブローカーを再始動します。例えば、
mqsistop MB8BROKER
mqsistart MB8BROKER
- CICSRequest ノードまたはメッセージ・フローが実行時に接続情報を参照する構成可能サービスを作成するための詳細を確認したり、CICSConnection 構成可能サービスの使用可能なプロパティーを表示したりする場合は、WebSphere Message Broker の資料にある『CICSRequest ノードの接続情報の変更』と『構成可能サービスのプロパティー』を参照してください。
WebSphere Message Broker Explorer を使用して CICSConnection 構成可能サービスを作成する
- 「ナビゲーター」ビューで、新しい構成可能サービスを追加するブローカーを拡張します。
- 「構成可能サービス」フォルダーを右クリックして、「新規」>「構成可能サービス」をクリックします。「構成可能サービス」ウィンドウが表示されます。
- 「名前」フィールドで、構成可能サービスの名前として CICSSampleConnectionService を入力します。
- 「タイプ」フィールドで、作成する構成可能サービスのタイプとして「CICSConnection」を選択します。
- 「テンプレート」フィールドで、作成するテンプレートのタイプとして「CICSConnectionTemplate」を選択します。
- 構成可能サービスの cicsServer プロパティーの値を tcp://mycicsregion.com という形式で入力します (mycicsregion は CICS 領域です)。
- 「終了」をクリックして、新しい構成可能サービスを作成します。
- mqsistop コマンドと mqsistart コマンドを使用することによって、WebSphere Message Broker Explorer でブローカーを再始動します。例えば、
mqsistop MB8BROKER
mqsistart MB8BROKER
- WebSphere Message Broker Explorer を使用して、CICSRequest ノードまたはメッセージ・フローが実行時に参照する構成可能サービスを作成するための詳細については、WebSphere Message Broker の資料にある『新しい構成可能サービスの作成』を参照してください。CICSConnection 構成可能サービスの使用可能なプロパティーを表示する場合は、WebSphere Message Broker の資料にある『構成可能サービスのプロパティー』を参照してください。
この時点で、サンプルをインポートしてデプロイできます。
詳細については、CICS Transaction Server for z/OS Channel Connectivity サンプルを参照してください。
WMBCHAN1 CICS プログラムの変換、コンパイル、およびリンクを行うには、以下のステップを実行します。
- この CICS プログラムは、サンプル・プロジェクト CICSConnectivity Channel Message Flow 内に WMBCHAN1.c として格納されています。
このファイルを抽出して MVS データ・セットに入れます。
- CICS は、サンプル・プログラムのコンパイルに使用できるサンプル JCL プロシージャーを提供しています。
このプロシージャーを使用するには、CICS Transaction Server for z/OS バージョン 4.1 インフォメーション・センターの、『Sample JCL to install C application programs』という見出しの下の指示に従ってください。
- <cicshlq>.SDFHPROC(DFHYITDL) にあるサンプル JCL をカスタマイズし、プロシージャー・ライブラリーに入れます。
- WMBCHAN1.c をカスタマイズし、正しいジョブ制御ヘッダーと変換プログラム・オプションを設定します (CICS インフォメーション・センターの指示に従う)。
- WMBCHAN1.c の下部のロード・モジュール名をカスタマイズし、ジョブとして実行依頼します。
- 正常に応答されたことを確認します。
正常でない場合は、CICS Transaction Server for z/OS バージョン 4.1 インフォメーション・センターの、『Sample JCL to install C application programs』という見出しの下のトピックを参照してください。
- プログラムが正常に変換され、コンパイルされてロード・モジュールにリンクされた後に、ロード・モジュールが CICS 領域に関する DFHRPL JCL ステートメント内で名前指定されていることを確認します。
- 新しい WMBCHAN1 プログラムに関する PROGRAM 定義を作成し、この定義をインストールします。
CICS Transaction for z/OS Channel Connectivity サンプルを実行できるようになりました。
詳しくは CICS Transaction for z/OS Channel Connectivity サンプルの実行を参照してください。
サンプルのホームに戻る