Liberty サーバー定義の作成

IBM® MQ for z/OS® Unix System Services Web コンポーネントをインストールし、 MQ Consoleまたは REST APIを使用する場合は、 Liberty サーバー定義を作成してカスタマイズする必要があります。

始める前に

Liberty サーバーを使用するには、 SYSTEM.REST.REPLY.QUEUE を作成する必要があります。これを行うには、初期設定入力データ・セットのカスタマイズにある最新の CSQ4INSG サンプルを使用します。

重要: mqweb サーバーの始動時に、以下の出力に示されているようなエラー・メッセージ CWWKG0014Eが表示される場合があります。

     Launching mqweb (MQM MVS/ESA V9 R2.0/wlp...) (en_US)
              ÝAUDIT   ¨ CWWKE0001I: The server mqweb has been launched.                     
              ÝWARNING ¨ CWWKF0009W: The server has not been configured to install any features.
              ÝAUDIT   ¨ CWWKF0011I: The mqweb server is ready to run a smarter planet. The mqweb server started in 6.348 seconds.
              ÝERROR   ¨ CWWKG0014E: The configuration parser detected an XML syntax error while parsing the root of the configuration and the referenced configuration documents. 
                              Error: An invalid XML character (Unicode: 0x4c) was found in the prolog of the document. 
                               File: file:<your filepath>/servers/mqweb/server.xml Line: 1 Column: 1

AUTOCVT の z/OS 設定 (ファイルをあるコード・セットから別のコード・セットに自動的に変換する) を確認し、以下のいずれかを実行して、必要に応じて値を調整する必要があります。

USS 端末の場合:: コマンド echo $_BPXK_AUTOCVT を発行して、この環境変数の値を表示します。環境変数が定義されていない場合、値は表示されません。; 環境変数を設定するには、 _BPXK 環境変数を参照してください。
システム全体:: 「 z/OS Unix System Services (OMVS) の状況の表示」の例 6 は、BPXPRMxx 内のシステム全体の AUTOCVT ステートメントの値を表示する方法を示しています。; 環境変数をシステム全体に設定するには、BPXPRMxx で AUTOCVT ステートメントを使用します。

環境変数 _BPXX_AUTOCVT が USS 端末で設定されている場合、BPXPRMxx 内のステートメント AUTOCVT のシステム全体の設定をオーバーライドします。

本タスクについて

このタスクは、 MQ Console または REST APIを実行する z/OS システムごとに 1 回実行する必要があります。
実行中の IBM MQ のバージョンごとに Liberty サーバーが必要です。
前のバージョンから移行する際に、サーバー構成をリフレッシュまたは変更しなければならない場合があります。

IBM MQ for z/OS Unix System Services Web コンポーネントでは、 mqwebという単一の Liberty サーバーを作成する必要があります。

サーバー構成ファイルとログ・ファイルはすべて、 Liberty ユーザー・ディレクトリーの下に保管されます。

以下の手順を実行して mqweb サーバー定義を作成します。

手順

Liberty ユーザー・ディレクトリーの適切な場所を選択します。
mqweb サーバーを実行するユーザー ID には、このユーザー・ディレクトリーとそのコンテンツへの読み取り権限と書き込み権限が必要です。このユーザー・ディレクトリーにはログ・ファイルやサーバー構成が格納されるため、このディレクトリーは別のファイル・システムに作成する必要があります。
現行ディレクトリーが PathPrefix/web/bin( crtmqweb.sh スクリプトの場所) であることを確認します。
PathPrefix は、 IBM MQ Unix System Services Components のインストール・パスです。
crtmqweb.sh スクリプトを実行して、テンプレート mqweb サーバー定義を含む Liberty ユーザー・ディレクトリーを作成します。

注: crtmqweb.sh スクリプトは、1 つのオプション・パラメーター ( Liberty ユーザー・ディレクトリーの名前) を受け入れます。
Liberty ユーザー・ディレクトリーの名前を指定しない場合は、デフォルト値の /var/mqm/web/installation1 が使用されます。
次のコマンドを使用して、 Liberty ユーザー・ディレクトリー内のディレクトリーおよびファイルの所有権を、 mqweb サーバーが実行されるユーザー ID およびグループに属するように変更します。
```
chown -R userid:group path
```
このパスに対する書き込み権限をグループに付与するには、次のコマンドを実行します。
```
chmod -R 770 path
```

次のタスク

Liberty サーバー用のプロシージャーの作成