mqsichangeusernameserver コマンド

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

目的

Windows プラットフォーム、Linux、および UNIX システムでは、mqsichangeusernameserver コマンドを使用してユーザー・ネーム・サーバーのさまざまなプロパティーを変更します。

z/OS では、mqsichangeusernameserver コマンドを使用して、ユーザー・ネーム・サーバーの最新表示インターバルおよび認証プロパティーを変更します。

このコマンドを発行する前に、Windows プラットフォームおよび UNIX プラットフォームでは mqsistop を使用し、z/OS では stopcomponent を使用して (mqsistop コマンドを参照) ユーザー・ネーム・サーバーを停止する必要があります。

Windows プラットフォームおよび UNIX プラットフォームでは mqsistart、z/OS では startcomponent を使用して (mqsistart コマンドを参照) ユーザー・ネーム・サーバーを再始動する場合は、変更済みパラメーターが使用されます。

構文

Windows プラットフォーム、Linux、および UNIX システム

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

同義語: cu

パラメーター

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

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

Linux および UNIX システムでは、-a は Windows プラットフォームとの互換性を保つのに必要ですが、ServiceUserID に関連して使用されるわけではありません。

-i ServiceUserID
(オプション - Windows プラットフォーム、Linux、および UNIX システム) ブローカーの実行に使用するユーザー ID。この値を変更する場合は、パスワードも変更する必要があります。
これは、有効なユーザー名の構文の形式で指定できます。Windows プラットフォームでは、それは次のとおりです。
  • domain¥username
  • ¥¥server¥username
  • .¥username
  • username

Linux および UNIX システムでは、最後の形式の username だけが有効です。

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

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

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

-d SecurityDomainName
(オプション - Windows プラットフォーム、Linux、および UNIX システム) Windows プラットフォーム上のセキュリティー・ドメインの名前。
-r RefreshInterval
(オプション - Windows プラットフォーム、Linux、および UNIX システム) (必須 - z/OS) ユーザー・ネーム・サーバー がユーザーやグループの属性変更についてセキュリティー・サブシステムに問い合わせるインターバル (秒単位)。
-g AuthProtocolDataSource
(オプション) このパラメーターを使って、認証プロトコルで必要なデータ・ソースの名前を指定します。
-j
(オプション) グループおよびグループ・メンバーシップが、オペレーティング・システムから引き出されるのではなく、認証プロトコルのデータ・ソースで定義されることを示します。
-o
(オプション) グループおよびグループ・メンバーシップが、認証プロトコルのデータ・ソースで定義されるのではなく、オペレーティング・システムから引き出されることを示します。

応答

このコマンドは、以下の応答を戻します。

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

Windows プラットフォーム、Linux、および UNIX プラットフォームの場合
mqsichangeusernameserver -r 2000
z/OS の場合
F MQP1UNS,cu r=2000
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
an07210_