QUERY USER コマンド

サブセクション:

• 環境
• 構文
• キーワード
• 使用上の注意
• 類似の IMS タイプ 1 コマンド
• 出力フィールド
• QUERY USER 状況
• 戻りコード、理由コード、および完了コード
• 例

環境

以下の表には、コマンドおよびキーワードを使用することができる環境 (DB/DC、DBCTL、および DCCTL) がリストされています。

構文

A

キーワード

以下のキーワードは、QUERY USER コマンドに有効です。

NAME()

表示される 1 つ以上のユーザー (動的ユーザーまたは ISC サブプール・ユーザー) を指定します。 有効な名前は 1 から 8 文字で、ワイルドカードが指定できます。 すべてのユーザーを表示するには、NAME(*) を指定します。 デフォルト値は NAME(*) です。

SHOW()

戻されるユーザー出力フィールドを指定します。ユーザー名は、出力を作成した IMS の名前および完了コードとともに、常に戻されます。 SHOW が指定されない場合、STATUS フィルターが指定されていなければ、 ユーザー名のみが戻されます。これは、システム管理アプリケーションが、IMSplex 内で現在認識されているすべてのユーザー名 のリストを入手するための方法を提供します。

表示する情報を IMS が入手する場所 (グローバル・リソースまたはローカル・リソース) を指定するために、2 つのパラメーター GLOBAL と LOCAL が使用されます。デフォルトは GLOBAL と LOCAL の両方です。残りのパラメーターは表示される情報を指定するために使用されます。

SHOW キーワードでサポートされるパラメーターには、以下のものがあります。パラメーターの指定順は任意です。

ALL

LTERM パラメーターおよび CONV パラメーターが指定された場合に表示される出力フィールドを除き、すべての出力フィールドを返します。他のすべての出力とともに LTERM および会話情報を表示するには、 SHOW(ALL,LTERM,CONV) を指定します。

AUTOLOGON

指定されたユーザーの現行の自動ログオン情報を表示します。 この情報には、セッションを確立するために使用するノードの名前、 VTAM モード・テーブルの名前、 ノードを作成するために使用されるノード記述子の名前、および (ISC の場合) 他のシステムのハーフセッション修飾子の ID が含まれます。

CONV

ユーザーに関連付けられている会話 ID、トランザクション、および会話状況。 個々の会話は、別個のコマンド応答表示行に戻されます。SHOW(ALL) が指定された場合、会話状況は含まれません。会話情報を他のすべての出力と一緒に表示するには、SHOW(ALL,CONV) を指定します。

EMHQ

急送メッセージ・ハンドラー (EMH) キュー内のユーザー・メッセージ・キュー・カウントを表示します。 キュー・カウントは、指定されたユーザーと関連付けられている LTERM ごとのキュー・カウントの合計です。

EMHQ は、SHOW キーワードで GLOBAL パラメーターが指定された場合にのみ有効です。 GLOBAL が指定されなかった場合、EMHQ パラメーターは無視されます。

EMHQ は、コマンド・マスターによってのみ処理されます。 それ以外のすべての IMS システムは、このパラメーターを無視します。

EMHQ は、共用キュー環境で共用 EMH が使用されている場合にのみ有効です。その他の場合は、このパラメーターは無視されます。

ユーザー・リソースがリソース構造に存在する場合、 グローバル・ユーザー・リソースに関連付けられている LTERM は、EMH キューからキュー・カウントを入手するために使用されます。 その他の場合、ローカル・ユーザー・リソースに関連付けられている LTERM が使用されます。 ただし、ユーザーがコマンド・マスターにローカルに存在していない場合は、キュー・カウントは 0 になります。

GLOBAL

GLOBAL が指定されると、コマンド・マスターは、他の SHOW パラメーターの指定状況に応じてグローバル情報を表示します。 これには、共用キューとリソース構造からの情報が含まれます。

GLOBAL パラメーターは、コマンド・マスターによってのみ処理されます。他のすべての IMS システムはこのパラメーターを無視します。LOCAL が一緒に指定されなかった場合、 コマンド・マスター以外のすべての IMS システムは、コマンドを無視します。

GLOBAL は、コマンド・マスターが共用キューかシスプレックス端末管理 (またはその両方) を使用している場合にのみ適用されます。コマンド・マスターが共用キューまたはシスプレックス端末管理を使用していない場合、GLOBAL は適用されません。この環境で LOCAL も指定されている場合、GLOBAL は無視されます。 その他の場合、コマンド・マスターはコマンドをリジェクトします。

共用キューが使用可能であり、グローバル・キュー・カウントが要求された場合、コマンド・マスターは適切なキュー・カウントを判別するよう CQS に要求します。これには MSGQ および EMHQ の両方が含まれます。

シスプレックス端末管理が使用可能な場合、コマンド・マスターは適切なグローバル状況を判別するよう RM に要求します。

GLOBAL と LOCAL の両方を指定した場合 (これがデフォルトです)、コマンド・マスターはグローバル情報とローカル情報を別々に作成します。グローバル情報は 1 つの出力行 (または出力行セット) として表示され、ローカル情報は別の出力行 (または出力行セット) として表示されます。

ID

ISC ノードのもう一方のハーフセッション修飾子名を表示します。

LOCAL

LOCAL が指定された場合、すべての IMS システムは、コマンド・マスターも含め、他の指定されている SHOW パラメーターに従ってローカル情報を表示します。これには、コマンドを処理する IMS にローカルな情報が含まれます。

LOCAL パラメーターは、コマンド・マスターを含むすべての IMS システムによって処理されます。

LOCAL は、共用キューまたはシスプレックス端末管理が使用されているかどうかに関わらず、どの環境にも適用されます。

GLOBAL と LOCAL の両方を指定した場合 (これがデフォルトです)、コマンド・マスターはグローバル情報とローカル情報を別々に作成します。グローバル情報は 1 つの出力行 (または出力行セット) として表示され、ローカル情報は別の出力行 (または出力行セット) として表示されます。

LTERM

ユーザーに関連付けられている論理端末 (LTERM) 名があれば、それを表示します。ユーザーには、0 個以上の論理端末が関連付けられている場合があります。 ユーザーに関連付けられているそれぞれの LTERM は、別々のコマンド応答行に返されます。

SHOW(ALL) が指定された場合、LTERM 状況は含まれません。 論理端末情報を他のすべての出力と一緒に表示するには、SHOW(ALL,LTERM) を指定します。

NODE

ユーザーが関連付けられている動的ノードまたは ISC ノードを表示します。

OWNER

リソース構造内のユーザー・リソースの所有者を表示します。 これは、シスプレックス端末管理が使用可能で、コマンド・マスターのみで処理されている場合にのみ適用されます。 他のすべての IMS システムはこのパラメーターを無視します。

所有者は、ユーザーを所有している IMS システムの IMSID (または XRF システムの RSENAME) です。 IMS システムがユーザー・リソースを所有するのは、そのリソースがアクティブである (ユーザーがログオンしている) 場合、または IMS システムがそのリソースの重要な状況を保守している場合です。

PRESET

ユーザーの事前設定宛先名を表示します。ユーザーは、/SET コマンドの後に 事前設定宛先モードになっています。 事前設定宛先名は、トランザクション名または論理端末 (LTERM) 名です。 このユーザーから入力されるすべてのメッセージは、事前設定宛先のトランザクションまたは LTERM に送信されます。

QCNT

ユーザーのメッセージ・キュー・カウントを表示します。キュー・カウントは、指定されたユーザーと関連付けられている LTERM ごとのキュー・カウントの合計です。

このコマンドで戻されるローカル・キュー・カウントの値は、このコマンドが実行された IMS システムによって処理されているメッセージを表します。共用キュー環境では、キューの評価のためにローカル・キュー・カウントを使用しないでください。 このコマンドで戻されるグローバル・キュー・カウントは、共用キュー構造上の現行のメッセージ・キュー・カウントを表します。

LOCAL パラメーターも SHOW キーワードで指定されている場合、 コマンド・マスターを含む、コマンドを処理するすべての IMS システムは、 ローカル・キュー・カウントを表示します。 これは、共用メッセージ・キューが使用可能であるかどうかに関係なく有効です。

GLOBAL パラメーターも SHOW キーワードで指定されていて、 共用メッセージ・キューが使用可能である場合、コマンド・マスターには 共用メッセージ・キュー (MSGQ) でのグローバル・キュー・カウントが表示されます。 ユーザー・リソースがリソース構造に存在する場合、グローバル・ユーザー・リソースに関連付けられている関連付けられている LTERM は、共用キューからキュー・カウントを入手するために使用されます。 その他の場合、ローカル・ユーザー・リソースに関連付けられている LTERM が使用されます。 ただし、ユーザーがコマンド・マスターにローカルに存在していない場合は、キュー・カウントは 0 になります。

ローカル・キュー・カウントとグローバル・キュー・カウントは、別々の出力フィールドとして表示されます。

RECOVERY

ユーザーの状況リカバリー・モード (SRM) とリカバリー・レベルを表示します。 エンド・ユーザー有効状況は、会話、高速機能、全機能応答モード、STSN (設定およびテスト・シーケンス番号) のいずれかの状況です。

SRM は、ユーザー・サインオフ、セッション、IMS の終了直後にエンド・ユーザー有効状況 (存在する場合) がリカバリーされる場所を判別します。 出力はユーザーの SRM を、GLOBAL (シスプレックス端末管理がリソース構造内で状況をリカバリーします)、 LOCAL (IMS がローカル側で状況をリカバリーし、 これは特定の IMS に対する類似性を示します)、NONE (状況は破棄されます) のいずれかとして表示します。

リカバリー・レベルは、どのエンド・ユーザー有効状況 (存在する場合) をリカバリーするかを決定します (SRM が GLOBAL または LOCAL の場合)。 出力には、会話状況がリカバリーされたか (RCVYCONV)、高速機能状況がリカバリーされたか (RCVYFP)、 全機能応答モードがリカバリーされたか (RCVYRESP)、それとも STSN 状況がリカバリーされたか (RCVYSTSN) が表示されます。

STATUS

ユーザーのローカル状況またはグローバル状況を戻します。戻される可能性のある状況のリストと意味については、QUERY USER 状況を参照してください。

USERID

ユーザーをノードにサインオンするために使用された RACF® ユーザー ID。

VERSION

ユーザー・リソースの RM バージョン番号を表示します。これは、ユーザーに割り当てられたバージョン番号です。 割り当ては MVS™ によって行われ、リソースがリソース構造で作成または更新される場合、RM によって保守されます。 VERSION は、シスプレックス端末管理が使用可能な場合にのみ適用されます。VERSION は、シスプレックス端末管理が使用可能でなければ無視されます。

STATUS()

指定されたユーザー状況の少なくとも 1 つを持つユーザーを表示用に選択します。 状況は、シスプレックス端末管理 (STM) が使用可能な場合、ローカルまたはグローバルに存在します。

STATUS フィルターは、シスプレックス端末管理環境と非シスプレックス端末管理環境の両方で有効です。 シスプレックス端末管理環境では、選択された状況はローカルに存在するか、グローバルに存在するか、またはその両方に存在します。 シスプレックス端末管理が 使用可能でない場合、状況はローカルにのみ存在します。

SHOW(LOCAL) が指定されると、 IMS はローカル・システム内で該当する状況にあるユーザーのみを選択します。 コマンドは、コマンド・マスターを含むすべての IMS システムによって処理されます。

SHOW(GLOBAL) が指定され、シスプレックス端末管理が使用可能な場合、 IMS はリソース構造内で該当する状況にあるユーザーのみを選択します。 コマンドは、コマンド・マスターによってのみ処理されます。SHOW(GLOBAL) が指定され、シスプレックス端末管理が使用可能でない場合、 コマンドはリジェクトされます。

SHOW(GLOBAL,LOCAL) が指定されると (これがデフォルトです)、 IMS は、ローカルで、またはリソース構造内で、該当する状況にあるユーザーを選択します (シスプレックス端末管理が使用可能な場合)。 コマンドは、すべての IMS システムによって処理されます。 コマンド・マスターは、グローバル情報とローカル情報の両方を処理します。

STATUS フィルターを指定した場合に戻される出力には、SHOW(STATUS) が指定されていなくても、ユーザーの状況が含まれます。

対応する状況のユーザーを選択するために使用できるフィルターを判別するには、 QUERY USER 状況を参照してください。

使用上の注意

QUERY USER コマンドは、OM API を介してのみ指定することができます。

QUERY USER コマンドは、XRF 代替システムで発行されますが、 SHOW(GLOBAL) はサポートされません。ローカル情報のみが表示できます。

QUERY USER コマンドの処理は、 IMS シスプレックス端末管理が使用可能であるかどうかにより異なります。

• IMS シスプレックス端末管理が使用不可に設定されている場合、各システムに対して、処理はローカル側で行われます。 type-1 コマンドと type-2 コマンドの結果は同様になります。
• IMS シスプレックス端末管理が使用可能に設定されている場合、type-1 コマンドと type-2 コマンドによる処理は、ローカル情報を表示する際に同様になります。 ただし、グローバル情報の表示方法については異なります。
• IMS シスプレックス端末管理を使用可能に設定して、type-1 /DISPLAY コマンドを実行すると、コマンド・マスターによって、リソース構造またはローカル・システムのいずれかから情報が表示されますが、両方から情報が表示されることはありません。 表示されているリソースがシステムによって所有されていない場合、またはコマンド・マスターによって所有されている場合、コマンド・マスターによってグローバル・リソースが表示されます。 しかし、リソースがコマンド・マスター以外のシステムによって所有されている場合、コマンド・マスターによってローカル・リソースのみが表示され、リソースを所有するそのシステムによってグローバル・リソースが表示されます。
• IMS シスプレックス端末管理を使用可能に設定して、type-2 QUERY コマンドを実行すると、リソースが所有されているかどうかに関係なく、グローバル・リソース情報を表示するシステムはコマンド・マスターのみになります。 さらに、コマンド・マスターによってローカル・リソース情報も表示されます。 コマンドを処理するその他のすべての IMS システムは、ローカル・リソース情報のみを表示します。 この手法により、IMSplex 上のすべての情報をより柔軟性を持って表示することができます。

SHOW キーワードは、コマンドを処理する IMS システムと、表示する情報を決定します。

• SHOW(GLOBAL) が指定されると、コマンド・マスターはグローバル情報を表示します。 これには、共用キューが使用可能な場合はグローバル・キュー・カウントが含まれ、 シスプレックス端末管理が使用可能である (DFSDCxxx PROCLIB メンバーで STM=YES と定義されている) 場合は リソース構造からの状況が含まれます。 これは、ユーザーが特定の IMS システムでアクティブであるかどうかに関わらず当てはまります。OM がコマンドの経路指定先にするそれ以外のすべての IMSシステムは、GLOBAL パラメーターを戻りコード X'00000004' および理由コード X'00001000' で無視します。
• SHOW(LOCAL) が指定された場合、OM がコマンドの経路指定先にする各 IMS システムは (コマンド・マスターも含め)、コマンドを処理し、各システムにローカルな情報を表示します。
• GLOBAL と LOCAL の両方を指定した場合 (これがデフォルトです)、コマンド・マスターはグローバル情報とローカル情報の両方を表示し、OM がコマンドの経路指定先にする他のすべての IMS システムはローカル情報を表示します。

類似の IMS タイプ 1 コマンド

以下の表は、各種の QUERY USERコマンドと、類似の機能を実行するタイプ 1 IMS コマンドを示しています。

出力フィールド

QUERY USER 状況

以下の表は、表示される可能性があるユーザー状況を示しています。表の各列は、以下のとおりです。

Status

表示されるユーザー状況。

STATUS パラメーター

指定した状況のユーザーを選択する STATUS() フィルター。

有効範囲

状況の有効範囲。GBL は、状況をグローバルとすることができ (STM が使用可能な場合、それはリソース構造内に存在します)、STT ショート・ラベルとともに返されることを示します。LCL は、状況をローカルとすることができ、LSTT ショート・ラベルとともに返されることを示します。

意味

状況の簡略説明を提供します。

戻りコード、理由コード、および完了コード

IMS 戻りコードと理由コードは、QUERY USER コマンドによって OM に戻されます。QUERY USER コマンドの結果として返される可能性のある OM 戻りコードと理由コードは、OM API を介して入力されるすべてのコマンドに共通する標準コードです。

以下の表は、QUERY USER コマンドの戻りコードと理由コード、およびそれぞれの簡略説明を示しています。

以下の表には、完了コードの説明が記載されています。このコマンドの処理に固有のエラーは、完了コードとして戻されます。完了コードは個々のリソースに対する各アクションごとに戻されます。