mqsichangeusernameserver コマンド

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

  • Windows 2000、Windows XP
  • UNIX プラットフォーム
  • z/OS

目的

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

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

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

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

構文

Windows プラットフォームおよび UNIX プラットフォームの場合

z/OS

同義語: cu

パラメーター

-a ServicePassword
(オプション - Windows プラットフォームおよび UNIX プラットフォーム) ServiceUserID のパスワード。UNIXでは、-a は Windows プラットフォームとの互換性を保つのに必要ですが、ServiceUserID に関連して使用されるわけではありません。
-i ServiceUserID
(オプション - Windows プラットフォームおよび UNIX プラットフォーム) ブローカーの実行に使用するユーザー ID。この値を変更する場合は、パスワードも変更する必要があります。
これは、任意の有効なユーザー名構文の形式で指定できます。 Windows プラットフォームでは、それは次のとおりです。
  • domain¥username
  • ¥¥server¥username
  • .¥username
  • username

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

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

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

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

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

応答

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

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

Windows プラットフォームおよび UNIX プラットフォームの場合

mqsichangeusernameserver -r 2000
z/OS の場合
F MQP1UNS,cu r=2000

関連概念
ユーザー・ネーム・サーバー

関連タスク
ユーザー・ネーム・サーバーの変更

関連資料
構文の設定
mqsicreateusernameserver コマンド
mqsideleteusernameserver コマンド