strmqm (キュー・マネージャーの始動)

目的

strmqm コマンドは、キュー・マネージャーを始動するために使用します。

strmqm コマンドは、作業対象のキュー・マネージャーに関連付けられたインストール済み環境から使用する必要があります。 dspmq -o installation コマンドを使用して、どのインストール済み環境にキュー・マネージャーが関連付けられているかを調べることができます。

キュー・マネージャーに関連付けられたインストール済み環境がなく、システム上に IBM® WebSphere® MQ 7.0.1 のインストール済み環境がない場合、 strmqm コマンドは、 strmqm コマンドを発行したインストール済み環境にキュー・マネージャーを関連付けます。

キュー・マネージャーの始動に数秒を超える時間がかかる場合、 IBM MQ は、始動の進行状況の詳細を示す断続的なメッセージを表示します。

使用上の注意

IBM MQ 9.1以降、 UNIX システム上の data path/log/qm のセキュリティーが 2775 から 2770 に変更されました。

strmqm コマンドは、キュー・マネージャーを完全に開始する前に、 qm.ini ファイル 内の CHANNELS および SSL スタンザの構文を早期に検査します。 qm.ini ファイルにエラーが含まれている場合、この検査によって容易に問題の内容を把握したりそれを迅速に修正したりできるようになります。 エラーが検出された場合、strmqm は AMQ9224 エラー・メッセージを出力し、qm.ini ファイル内のエラー位置を詳細に記載します。 また、キュー・マネージャーを始動せずに即座に終了します。

''IBM MQ 9.2.0からは、環境変数'MQLICENSEを使用して、ライセンスを受諾または表示することができる。

オプション・パラメーター

-a

指定のバックアップ・キュー・マネージャーをアクティブにします。 バックアップ・キュー・マネージャーは始動しません。

活動化すると、制御コマンド strmqm QMgrNameを使用してバックアップ・キュー・マネージャーを開始できます。 バックアップ・キュー・マネージャーのアクティブ化要求により、偶発的な開始が回避されます。

バックアップ・キュー・マネージャーをアクティブ化した後は、更新できなくなります。

バックアップ・キュー・マネージャーの使用について詳しくは、 IBM MQ キュー・マネージャー・データのバックアップと復元を参照してください。

-c

キュー・マネージャーを始動し、デフォルトおよびシステム・オブジェクト を再定義してから、キュー・マネージャーを停止します。 キュー・マネージャーに属する既存のシステムおよびデフォルト・オブジェクトは、このフラグを指定すると置き換えられ、非デフォルトのシステム・オブジェクト値はリセットされます (例えば、MCAUSER の値はブランクに設定されます)。

crtmqm コマンドを使用して、キュー・マネージャーのデフォルト・オブジェクト およびシステム・オブジェクトを作成します。

注: Managed File Transfer 調整キュー・マネージャーとして使用されているキュー・マネージャーで strmqm -c を実行する場合は、調整キュー・マネージャー・オブジェクトを定義する MQSC スクリプトを再実行する必要があります。 このスクリプトは、 Managed File Transfer 構成ディレクトリーにある queue_manager_name.mqscというファイル内にあります。

-c オプションは、ネイティブ HA キュー・マネージャーに対しては使用できません。

--d 情報

情報メッセージを表示するかどうかを指定します。 Information に指定可能な値は、次のとおりです。

値	説明
すべて	すべての情報メッセージが表示されます。 この値がデフォルト値です。
minimal	最小数の情報メッセージが表示されます。
なし	情報メッセージは表示されません。 このパラメーターは -zと同等です。

-z パラメーターは、このパラメーターより優先されます。

--eCMDLEVEL =レベル

このキュー・マネージャーのコマンド・レベルを有効にしてから、キュー・マネージャーを停止します。

キュー・マネージャーは、指定したコマンド・レベルにより提供される全機能を使用できるようになります。 新しいコマンド・レベルをサポートするインストール済み環境でのみ、このキュー・マネージャーを開始できます。

このオプションは、キュー・マネージャーにより使用される現在のコマンド・レベルが、インストール済み環境によりサポートされる最高のコマンド・レベルより低い場合にのみ有効です。 キュー・マネージャーの現在のコマンド・レベルより高く、インストール済み環境でサポートされる最高のコマンド・レベル以下であるコマンド・レベルを指定してください。

有効にする機能に関連付けられている Level の値と同じコマンド・レベルを使用します。

このフラグを -a、-c、-r、または -x とともに指定することはできません。

-f

キュー・マネージャーのデータ・ディレクトリーが欠落または破損しているためにキュー・マネージャーが始動していないことが分かっている場合に、このオプションを使用します。

strmqm -f qmname コマンドは、キュー・マネージャーのデータ・ディレクトリーを再作成してファイルの許可を再設定しようとします。 成功した場合は、キュー・マネージャー構成情報が欠落していなければ、キュー・マネージャーは始動します。 構成情報が欠落しているためにキュー・マネージャーが始動できない場合は、 構成情報を再作成して、キュー・マネージャーを再始動します。

IBM WebSphere MQ 7.0.1より前のリリースの製品では、 -f オプションを指定しない strmqmは、欠落しているデータ・ディレクトリーを自動的に修復してから開始しようとしました。 この動作は変更されました。

IBM WebSphere MQ 7.0.1 以降では、 -f オプションを指定しない strmqmのデフォルトの動作は、欠落または破損したデータ・ディレクトリーを自動的にリカバリーすることではなく、 AMQ6235 または AMQ7001などのエラーを報告し、キュー・マネージャーを開始しないことです。

-f オプションは、 これまでは strmqm によって自動的に実行されていた リカバリー・アクションの実行と見なすことができます。

strmqm の動作が変更された理由は、 IBM WebSphere MQ 7.0.1のネットワーク・ファイル・ストレージのサポートにより、キュー・マネージャーのデータ・ディレクトリーの欠落または破損の原因として最も可能性が高いのは、データ・ディレクトリーが破損したり、取得できないほど使用不可になったりするのではなく、修正できる構成エラーであるためです。

構成を修正することによってキュー・マネージャーのデータ・ディレクトリーを復元できる場合は、strmqm -f を使用してデータ・ディレクトリーを再作成しないでください。

strmqm での問題に対して可能な解決法としては、キュー・マネージャーがネットワーク・ファイル・ストレージ・ロケーションにアクセスできるようにするか、キュー・マネージャーをホスティングするサーバー上のユーザー ID と mqm グループのグループ ID およびユーザー ID と、キュー・マネージャーのデータ・ディレクトリーをホスティングするサーバー上のユーザー ID と mqm グループのグループ ID およびユーザー ID を一致させる方法があります。

IBM WebSphere MQ 7.0.1以降、キュー・マネージャーのメディア・リカバリーを実行する場合は、 -f オプションを使用してキュー・マネージャーのデータ・ディレクトリーを再作成する必要があります。

-ns

キュー・マネージャーの始動時に以下のプロセスが自動的に開始されることがなくなります。

• チャネル・イニシエーター
• コマンド・サーバー
• リスナー
• サービス

このパラメーターはまた、現行値に関係なく、CONNAUTH 属性がブランクであるかのようにしてキュー・マネージャーを実行します。 リスナーが存在しないため、クライアント・アプリケーションは接続できません。 アプリケーションと制御コマンドは、それらを実行するローカル OS ユーザーに基づいて許可されます。 キュー・マネージャーがその許可レコードに LDAP ユーザー/グループを使用していたことがある場合は、次のようになります。

1. キュー・マネージャーが -ns モードで実行されているときには、これらのレコードは無視されます。
2. このモードで作成または修正された許可レコードには、LDAP リポジトリーからではなく、オペレーティング・システムから派生したユーザー名が含まれるため、このモードでは許可レコードを変更したり、オブジェクトを新規作成したりしないでください。

コマンド・サーバーが稼働していないため、管理変更は runmqsc を使用して行う必要があります。

通常の許可サービス処理を再度使用可能にするには、つまり有効な CONNAUTH 値を通常の設定に戻すには、キュー・マネージャーを終了して、-ns パラメーターを指定せずに開始する必要があります。

-r

バックアップ・キュー・マネージャーを更新します。 バックアップ・キュー・マネージャーは始動しません。

IBM MQ は、キュー・マネージャー・ログを読み取り、オブジェクト・ファイルに対する更新を再生することによって、バックアップ・キュー・マネージャーのオブジェクトを更新します。

バックアップ・キュー・マネージャーの使用について詳しくは、 IBM MQ キュー・マネージャー・データのバックアップと復元を参照してください。

注: -r オプションは、ネイティブ HA キュー・マネージャーでは使用できません。

-si

対話式 (手動) キュー・マネージャー始動タイプ。 このオプションは、 IBM MQ for Windows でのみ使用可能です。

キュー・マネージャーはログオン (対話式) ユーザーの下で実行されます。 対話式始動で構成されたキュー・マネージャーは、キュー・マネージャーを開始したユーザーがログオフすると終了します。

このパラメーターを設定すると、 crtmqm コマンド、 amqmdain コマンド、または IBM MQ Explorerによって以前に設定されたすべての始動タイプがオーバーライドされます。

-si または -ss のいずれの始動タイプも指定されなかった場合は、crtmqm コマンドで指定されたキュー・マネージャー始動タイプが使用されます。

-ss

サービス (手動) キュー・マネージャー始動タイプ。 このオプションは、 IBM MQ for Windows でのみ使用可能です。

キュー・マネージャーはサービスとして実行されます。 サービス始動が構成されたキュー・マネージャーは、対話式ユーザーがログオフした後も継続して実行されます。

このパラメーターを設定すると、 crtmqm コマンド、 amqmdain コマンド、または IBM MQ Explorerによって以前に設定されたすべての始動タイプがオーバーライドされます。

-x

ローカル・サーバーで複数インスタンス・キュー・マネージャーのインスタンスを開始して、 可用性を高くすることができるようにします。 キュー・マネージャーのインスタンスが他のどの場所でもまだ実行されていなければ、 キュー・マネージャーが開始され、そのインスタンスがアクティブになります。 アクティブ・インスタンスは、 ローカル・サーバー上のキュー・マネージャーへのローカルおよびリモート接続を受け入れられるようになります。

複数インスタンス・キュー・マネージャー・インスタンスが別のサーバーですでにアクティブになっている場合、新しいインスタンスがスタンバイになり、アクティブなキュー・マネージャー・インスタンスから引き継ぐことができる状態になります。 スタンバイである間は、ローカルまたはリモート接続を受け入れることはできません。

同じサーバーでキュー・マネージャーの 2 つ目のインスタンスを開始することはできません。

デフォルトの動作である、-x オプション・パラメーターの省略では、 単一インスタンス・キュー・マネージャーとしてインスタンスが開始され、 スタンバイ・インスタンスの開始は許可されません。

-z

エラー・メッセージを抑制します。

このフラグは、不要な情報メッセージを抑止するために IBM MQ 内で使用されます。 このフラグを使用すると情報が失われる可能性があるため、コマンド行にコマンドを入力するときは、このフラグを使用しないでください。

このパラメーターは、-d パラメーターより優先されます。

QMgrName

ローカル・キュー・マネージャーの名前を指定します。 省略すると、デフォルトのキュー・マネージャーが使用されます。

戻りコード