mqsichangeconfigmgr コマンド

サポートされるプラットフォーム

目的

mqsichangeconfigmgr コマンドを使用して、構成マネージャーの特定のプロパティーを変更します。

mqsistop を使用して、構成マネージャーを停止する必要があります (mqsistop コマンドを参照)。

mqsistart を使用して構成マネージャーを再始動する際は (mqsistart コマンドを参照)、 変更済みパラメーターが使用されます。

構文

Windows

Linux および UNIX システム

z/OS

z/OS コンソール・コマンド

同義語: cc

パラメーター

configmgrName
(オプション - Windows。 必須 - LinuxUNIX システム、および z/OS) 変更する構成マネージャーの名前。

LinuxUNIX システム、および z/OS では、これが最初に指定するパラメーターでなければなりません。 LinuxUNIX システム、および z/OS では、大/小文字の区別があります。

このパラメーターが指定されていない場合、Windows でのデフォルト名は 'ConfigMgr' です。

-a ServicePassword
(オプション - Windows プラットフォーム、Linux、および UNIX システムのみ) ServiceUserID のパスワード。

構成マネージャー を作成して、このユーザー ID とパスワードをデータベース・アクセスにも使用する (つまり、-a ServicePassword-i ServiceUserID を使用してサービス・ユーザー ID に同じユーザー ID とパスワードを指定した) 場合、パスワードのすべてのインスタンスをこのコマンドで更新してください。

パスワードの変更を正常に完了するには、以下を行う必要があります。

  • 構成マネージャーを停止します。
  • 適切なオペレーティング・システムの機能を使ってパスワードを変更します。
  • このコマンドを使って、このパスワードを参照するすべてのパラメーターを更新します。
  • 構成マネージャーを再始動します。

既存のシステムとの互換性を保つために、引き続き <password> を指定することができます。しかし、コマンドの実行時にパスワードをこのパラメーターとともに指定しない場合は、起動時にパスワードを入力するようにプロンプトが出され、正しく入力したことを確認するためにパスワードをもう一度入力するようにプロンプトが出されます。

-i ServiceUserID
(オプション - Windows プラットフォーム、Linux、および UNIX システムのみ) Windows システム・サービスの実行に使用するユーザー ID。 この値を変更する場合は、パスワードも変更する必要があります。

これは、プラットフォーム用の有効なユーザー名の構文の形式で指定できます。

このユーザー ID の非修飾形式 (username) を Windows システムで使用すると、 オペレーティング・システムによって、ローカル・システムから始めてドメイン全体でこのユーザー ID が検索されます。この検索が完了するまでに多少の時間がかかることがあります。

指定する ServiceUserID は、ローカル・グループ mqbrkrs のメンバーでなければなりません。これは、このグループの間接または直接のメンバーとして指定することができます。 また ServiceUserID は、 ホーム・ディレクトリー (WebSphere Message Broker のインストール先) と作業ディレクトリー (mqsicreateconfigmgr -w フラグで指定した場合) へのアクセスも許可されていなければなりません。さらに、この ID はローカル・グループ mqm の (直接または間接の) メンバーである必要もあります。

ServiceUserID のセキュリティー要件は、Windows プラットフォームの場合はWindows プラットフォームでのセキュリティー要件に、UNIX プラットフォームの場合はLinux および UNIX プラットフォームでのセキュリティー要件に説明されています。

-pmigrationDataBasePassword
(オプション - Windows プラットフォーム、Linux、および UNIX システムのみ) マイグレーションする DB2 データベースのパスワード

このパスワードの使用のインスタンスを、確実にすべて変更してください。データベース・アクセス以外にサービス・ユーザー ID にも同じユーザー ID とパスワードを使用するために構成マネージャーを作成 (または変更) した場合、 すべてのインスタンスを同時に更新しなければなりません。 詳しくは、-a の説明を参照してください。

-s UserNameServerQueueManagerName
(オプション) ユーザー・ネーム・サーバーと関連した WebSphere MQ キュー・マネージャーの名前。 トピックのセキュリティーを除去する場合は、空ストリング (二重引用符 "") を指定してください。
-j MaxJVMHeapSize
(オプション) Java 仮想マシン (JVM) の最大ヒープ・サイズ (メガバイト単位)。設定できる最小値は 64 です。 このパラメーターを設定しない場合、デフォルトのサイズの 128 MB が使用されます。

上記以外のプロパティーを変更する場合は、構成マネージャーを削除して再作成しなければなりません。 DataBaseUserID を変更する場合は、コンポーネント・データベース・アクセスの変更 の指示を参照してください。

応答

このコマンドは、以下の応答を戻します。
  • BIP8012 システム・コンポーネントに接続できません
  • BIP8013 コンポーネントが存在しません
  • BIP8018 コンポーネントが実行中です
  • BIP8021 ユーザー ID/パスワードが誤っています
  • BIP8022 ユーザー ID/パスワードが無効です
  • BIP8023 パスワードが必要です
  • BIP8030 ユーザー ID 特権を変更できません

mqsichangeconfigmgr CMGR01 -i ADMIN
mqsichangeconfigmgr CMGR01 -s ""
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
an23010_