WebSphere Business Integration Server Express を i5/OS にインストールすると、i5/OS システムに多くの i5/OS オブジェクトが作成されます。以下の表に、それらのオブジェクトを示します。
項目 | 名前 | 説明 |
---|---|---|
ユーザー・プロファイル | QWBISVR44 | インストール済みコンテンツのすべてを所有するデフォルトのユーザー・プロファイルです。これに従ってジョブが実行されます。 |
ライブラリー | QWBISVR44 | すべての i5/OS ネイティブ・オブジェクトを含みます。 |
ジョブ記述 | QWBIxxxx。xxxx はプロセスごとに固有 | サブシステム内で実行されているジョブを識別するのを支援します。個々のジョブごとにカスタマイズできます。ジョブ記述を表示するには、WRKJOBD JOBD(QWBISVR44/*ALL) を使用します。 |
Interchange Server Express インスタンス | QWBIDFT44 | インストールにより、すべてのインストール済みサンプルを実行するコンテンツとともに、サーバーへのコラボレーション・ファウンデーションを作成、構成、および配置します。 |
MQ Queue Manager | QWBIDFT44.QUEUE.MANAGER | インストールにより、デフォルト・ポートの MQ リスナーとともに、キュー・マネージャーが作成されます。 |
DB2/400 データベース | QWBIDFT44 | QWBIDFT44 InterChange Server のリポジトリーです。 |
サブシステム記述 | QWBISVR44/QWBISVR44 | i5/OS プロセスが実行される、QWBISVR44 サブシステムの属性を含みます。 |
TCP/IP 自動始動サーバー | QWBISVR44 | TCP/IP 自動始動サーバーの活動化によりサブシステムを自動的に始動します。 |
自動始動ジョブ | QWBITNAMES | InterChange Server、Adapter、および Tool が相互に通信するために必要なネーム・サーバーです。ネーム・サーバーのデフォルト・ポートを使用します。 |
自動始動ジョブ | QWBIDFT44 | インストール済み InterChange Server を始動します。 |
HTTP Server および WebSphere Application Server | ICSMON44 | HTTP Server および WebSphere Application Server のインスタンスです。 |
i5/OS のサポートは、QWBISVR44 サブシステムにおいて QWBISVR44 というユーザー・プロファイルで実行されます。i5/OS は、以下のコンポーネントそれぞれに、固有のジョブ記述オブジェクトを割り当てます。
ジョブを検索する場合は、WRKACTJOB SBS (QWBISVR44) を使用します。コンポーネントごとに、ジョブ名とジョブ記述名が一致します。
サブシステム内の名前付きジョブに関連付けられた、QP0ZSPWP、 QP0ZSPWT、 QZSHSH などのジョブが数個存在しており、それらは管理が不要です。
QWBIDFT44 などの他のジョブでは、例えば JText アダプターの場合の QWBIJTEXTC などのように、サーバー状況やアダプター状況を検査します。必須ではありませんが、同じアダプターを複数実行させている場合 (例えば、JText アダプターを 2 個) は、アダプターのインスタンスごとに異なるジョブ名と記述を作成することをお勧めします。
i5/OS では、QCCSID システム値に対する QWBISVR44 ユーザー・プロファイルの CCSID を使用して、すべてのジョブが実行されます。システムが 5026 または 290 日本語 CCSID を実行している場合は、製品を正しく機能させるために、QWBISVR44 ユーザー・プロファイルの CCSID パラメーターを 5035 に変更する必要があります。
システムで TCP/IP が始動するときに WebSphere Business Integration Server Express を自動的に始動させない場合は、RMVTCPSVR SVRSPCVAL(*QWBISVR44) コマンドを使用して、自動始動 TCP サーバーとしての QWBISVR44 を除去します。
システムで TCP/IP が始動するときに、サブシステムを自動的に始動させず、QWBIDFT44 サーバーも自動的に始動させない場合は、remove_autostart_server.sh スクリプトを使用して、自動的に始動した InterChange Server をサブシステムから除去します。
このスクリプトを実行する前に、最初に QSH CL コマンドを実行して QShell 環境に入ってください。remove_autostart_server.sh スクリプトでは次の構文を使用します。
/QIBM/ProdData/WBIServer44/bin/remove_autostart_server.sh QWBIDFT44
ネーム・サーバーは、自動始動ジョブとしてサブシステムに残すことをお勧めします。このジョブを自動的に始動させると、モニターが使用可能になり、制御された方法でサブシステムまたはシステムが終了するときが検出されます。このモニターがなければ、QWBISVR44 サブシステムとそのジョブは、制御された終了の結果として終了しません。
InterChange Server、アダプター・エージェント、および Object Discovery Agent を自動的に始動するには、start_server.sh (InterChange Server の場合)、特定のアダプター・スクリプト (例えば、start_JText.sh)、または Object Discovery Agent のスクリプト (例えば、start_JDBCODA.sh) を QWBISVR44 サブシステムで直接実行します。
実行可能ファイル、リポジトリー・データベース、および特定のファイルはすべて、ユーザー・プロファイルで保護されます。これは、QWBISVR44 サブシステムを使用する場合に重要です。また、常に QWBISVR44 ユーザー・プロファイルに従って InterChange Server を実行させ、予測不能な権限問題が生じないようにしてください。
アダプター・エージェント・ジョブを異なるユーザー・プロファイルに従って実行させる場合は、ジョブ記述のユーザー・パラメーターを QWBISVR44 から別のユーザー・プロファイルに変更してください。これは、QWBISVR44 ユーザー・プロファイルが、別のユーザー・プロファイルによって保護されているアプリケーション・データにアクセスするのを禁止する必要がある場合に役立ちます。
IBM ORB ポートを変更するには、以下の手順を実行します。
Windows クライアント・ツールを使用している場合は、製品ディレクトリーの CWSharedEnv.bat ファイルを変更し、アクティブなツールがあれば一度終了して再始動する必要があります。
サーバー・インスタンスを作成する場合は、create_instance.sh スクリプトを使用して、MQ リスナー・ポートを指定できます。MQ リスナー・ポートを変更するには、以下の手順を実行します。
<tns:name>PORT</tns:name>
<tns:value xml:space="preserve">1416</tns:value>
CHGJOBD JOBD(QWBISVR44/QWBIDFT44) RQSDTA('QSYS/CALL
PGM(QWBISVR44/QWBIDFT44) PARM(QWBIDFT44 ''1417'')')
サーバー・インスタンスを作成する場合は、create_instance.sh スクリプトを使用して、InterChange Server リポジトリー名を指定できます。リポジトリー名を変更するには、以下の手順を実行します。
サーバー・インスタンスを作成する場合は、create_instance.sh スクリプトを使用してキュー・マネージャー名を指定します。キュー・マネージャー名を変更するには、以下の手順を実行します。
WebSphere Business Integration Server Express は、i5/OS に固有の多くのスクリプトを付けて出荷されます。これらのスクリプトは、/QIBM/ProdData/WBIServer44/bin ディレクトリーにあります。
以下のセクションでは、各スクリプトについて詳しく説明します。
このスクリプトは、InterChange Server が QWBISVR44 サブシステムによって始動したときに、アダプター・エージェントが自動的に配置されるようにセットアップします。また、このスクリプトは、サーバー・インスタンスの自動始動ジョブに情報を追加し、サーバー・インスタンスがアダプター・エージェントのジョブをサブミットできるようにします。
add_autostart_adapter.sh の構文を次に示します。
add_autostart_adapter.sh adapterName instanceName startScript jobDescription
ここで、
JText アダプターの例を次に示します。
add_autostart_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC
このスクリプトは、サブシステムとともに自動的に始動するように InterChange Server を構成します。create_instance.sh スクリプトを使用してサーバー・インスタンスを作成する場合は、インスタンスがサブシステムとともに自動的に始動するように設定されます。remove_autostart_server.sh スクリプトを使用してこの機能を除去する場合は、add_autostart_server.sh を使用して自動始動をリセットします。
add_autostart_server.sh の構文を次に示します。
add_autostart_server.sh serverName jobDescription
ここで、
このスクリプトは、新規の InterChange Server インスタンスを作成するとともに、InterChange Server の /QIBM/UserData/WBIServer44 に新規ディレクトリーを作成します。また、このスクリプトは、インストール済みアダプターをこのディレクトリーにコピーし、リポジトリー DB2/400 データベースおよびインスタンスと同じ名前の MQ キューを作成し、特定のポート番号の MQ キュー用の MQ リスナーを作成し、自動始動ジョブ入力を新規 InterChange Server の QWBISVR44 サブシステムに追加します。
create_instance.sh の構文を次に示します。
create_instance.sh [ -rrepositoryName ] [ -qqueueManagerName [ -exists ] ] [ -uuser -ppassword ] [ -dsystem -ndbUser -wdbPassword ] serverName mqPortNumber httpPortNumber
このスクリプトは、/QIBM/UserData/WBIServer44 にあるサーバーのディレクトリー、サーバーのリポジトリー DB2/400 データベース、および QWBISVR44 サブシステム記述からサーバーの自動始動ジョブ入力を削除するとともに、Interchange Server インスタンスも削除します。このスクリプトは、サーバーの既存のキュー・マネージャーは削除しません。
delete_instance.sh の構文を次に示します。
delete_instance.sh instanceName
ここで、
このスクリプトは、InterChange Server インスタンスの自動始動ジョブを編集し、アダプター・エージェント・ジョブをサブミットするステートメントを除去するとともに、現在サーバー・インスタンスによって自動的に始動されているアダプター・エージェントから自動始動指定を除去します。
remove_autostart_adapter.sh の構文を次に示します。
remove_autostart_adapter.sh adapterName instanceName
ここで、
このスクリプトは、QWBISVR44 サブシステムから InterChange Server インスタンスの自動始動ジョブ入力を除去するとともに、Interchange Server インスタンスから自動始動指定を除去します。
remove_autostart_adapter.sh の構文を次に示します。
remove_autostart_server.sh instanceName
ここで、
このスクリプトは、InterChange Server のモードを設定します。このスクリプトは、InterChange Server が次に始動するときに、design、production、testOn、または testOff のいずれかの新規モードを適用します。
set_ics_server_mode.sh の構文を次に示します。
set_ics_server_mode.sh instanceName mode
ここで、
このスクリプトは、i5/OS の CL プログラムまたはコマンド入力から InterChange Server を正常に停止します。これは、正常なシャットダウン・コマンドを発行する System Manager または System Monitor に相当します。
stop_server_gracefully.sh の構文を次に示します。
stop_server_gracefully.sh instanceName
ここで、
このスクリプトは、System Manager または System Monitor を使用するのが実際的ではない場合に、アダプター・エージェント・ジョブを正常に停止します。
stop_adapter.sh の構文を次に示します。
stop_adapter.sh instanceName adapterName
ここで、
JText アダプターの例を次に示します。
stop_adapter.sh QWBIDFT44 JText
このスクリプトは、QWBISVR44 サブシステムで実行されるアダプター・エージェント・ジョブをサブミットします。このコマンドを使用する前に、QWBISVR44 サブシステムを始動する必要があります。
submit_adapter.sh の構文を次に示します。
submit_adapter.sh adapterName instanceName startScript jobDescription [parm5] [parm6] [parm7]
ここで、
JText アダプターの例を次に示します。
submit_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC -c/ QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/JText.cfg
このスクリプトは、QWBISVR44 サブシステムで実行される InterChange Server インスタンス・ジョブをサブミットし、start_server.sh スクリプトを使用してバッチ・ジョブを実行するのに必要なロジックを提供します。このスクリプトには、2 から 6 までのオプショナル・パラメーターがあり、submit_ics_server.sh スクリプトを通して start_server.sh スクリプトにパラメーターを渡すことができます。
submit_ics_server.sh の構文を次に示します。
submit_ics_server.sh instanceName [parm2] [parm3] [parm4] [parm5] [parm6]
ここで、
このスクリプトは、QWBISVR44 サブシステムで実行されるネーム・サーバー・ジョブをサブミットします。
このスクリプトは、QWBISVR44 サブシステムで実行される Object Discovery Agent ジョブをサブミットし、QWBISVR44 サブシステムでジョブをサブミットしてパラメーター 1 として渡されるスクリプト名を実行するために必要なロジックを提供します。
submit_oda.sh の構文を次に示します。
submit_oda.sh startODAScript jobDescription
ここで、
JDBC ODA の例を次に示します。
submit_oda.sh /QIBM/ProdData/WBIServer44/product/oda/JDBC/start_JDBCODA.sh QWBIJDBODA
セキュリティー上の理由により、例えば JDBC データベース権限または JText ディレクトリーやファイルなど、アダプターのエージェント・プロセスが実行されるときのユーザー・プロファイルを変更することが必要になります。ユーザー・プロファイルを変更すると、QWBISVR44 ユーザー・プロファイルはこれらのアダプターのプロセスへのアクセスを禁止されます。
ユーザー・プロファイルを変更するには、以下の手順を実行します。
i5/OS を使用してサブシステムを停止する場合は、ENDSBS *CNTRLD アクションを制御する sigaction ハンドラーをコードに含めます。このハンドラーにより、ローカル・システムで実行されているジョブまたはアダプターをすべて終了させるとともに、InterChange Server を正常に終了することによって QWBISVR44 サブシステムを制御された方法で終了させることができます。この操作が完了すると、ハンドラーは自動終了します。