STRDATA サブコマンド - カップリング・ファシリティーのストラクチャー・データをフォーマットする

STRDATA サブコマンドは、カップリング・ファシリティーのストラクチャー・データをフォーマットするためのものです。ユーザーが指定するパラメーターに応じて、要約または詳細レベルの、1 つまたは複数のカップリング・ファシリティー・ストラクチャーに関する情報が表示されます。

ストラクチャーに対して二重化再構築がサポートされていると、各ストラクチャー・インスタンスに対してダンプ・ヘッダー情報に加えて二重化制御情報が戻されます。この制御情報は、二重化が現在ストラクチャーに対してアクティブかどうかに関係なく、戻されます。

STRDATA サブコマンドで生成される報告書についてさらに詳しくは、「z/OS MVS 診断: 解説書」の XES の章を参照してください。

注: XES に関連した問題を診断するためには、XESDATA および COUPLE サブコマンドを使用することもできます。

構文

    STRDATA

-------------- データ選択パラメーター -------------------

               { DETAIL     }
               { SUMMARY    }

-------- 報告書タイプ・パラメーター --------

               { ALLSTRS     }
               { STRNAME(strname,strdumpid),...   }

-------- 追加フィルター・パラメーター --------

               [ ALLDATA                  ]
               [ ARB                      ]
               [ COCLASS(coclass)         ]
               [ EMCONTROLS(emcontrols)   ]
               [ ENTRYID(entryid)         ]
               [ ENTRYNAME(entryname)     ]
               [ EVENTQS(conid)           ]
               [ LISTNUM(listnum)         ]
               [ LOCKENTRIES(lockentries) ]
               [ STGCLASS(stgclass)       ]
               [ USERCNTLS(usercntls)     ]

-------- キャッシュ指定子パラメーター --------

               [ ENTRYPOS(entrypos)     ]
               [ ORDER                  ]

-------- リスト指定子パラメーター --------

               [ ENTRYPOS(entrypos)     ]
               [ ORDER                  ]
               [ ENTRYKEY(entrykey)     ]

-------- SETDEF 定義パラメーター -------------------------
Note: You can override the following SETDEF parameters.
SETDEF サブコマンド - デフォルトを設定するを参照してください。

               [ ACTIVE | MAIN | STORAGE          ]
               [ DSNAME(dsname) | DATASET(dsname) ]
               [ FILE(ddname) | DDNAME(ddname)    ]
               [ PATH(path-name)                  ]
               [ FLAG(severity)                   ]
               [ PRINT | NOPRINT                  ]
               [ TERMINAL | NOTERMINAL            ]
               [ TEST | NOTEST                    ]

パラメーター
すべてのパラメーターを省略すると、デフォルトは SUMMARY と ALLSTRS です。
データ選択パラメーター
これらのパラメーターは報告書内のデータの範囲を制限するためのものです。これらのパラメーターを省略すると、デフォルトは SUMMARY です。
SUMMARY
指定したそれぞれの報告書について要約情報を要求します。出力される報告書は STRDATA ALL STRUCTURES SUMMARY REPORT です。それぞれのストラクチャーについて、出力フィールドは次のとおりです。
- ストラクチャー名
- ストラクチャー・タイプ
- ストラクチャー・ダンプ ID
- カップリング・ファシリティー情報
- 機能名
- カップリング・ファシリティー・ストラクチャー制御情報の要約
例えば、
COMMAND ===> STRDATA SUMMARY
DETAIL
指定したそれぞれの報告書について詳細情報を要求します。出力される報告書は STRDATA ALL STRUCTURES DETAIL REPORT です。それぞれのストラクチャーについて、出力フィールドは次のとおりです。
- ストラクチャー名
- ストラクチャー・タイプ
- ストラクチャー・ダンプ ID
- カップリング・ファシリティー情報
- 機能名
- カップリング・ファシリティー・ストラクチャー制御情報のすべて
- 割り当てられたユーザーのリスト
- 適用可能な場合、二重化制御情報には以下が含まれます。
  二重化アクティブ標識
  
  リモート機能ノード記述子 (ND) およびシステム ID (SYID)
  
  リモート・ストラクチャー ID (SID) およびストラクチャー権限 (SAU)
例えば、
COMMAND ===> STRDATA DETAIL
報告書タイプ・パラメーター
これらのパラメーターは報告書のタイプを選択するためのものです。報告書タイプ・パラメーターを省略すると、デフォルトは ALLSTRS です。
ALLSTRS
ダンプ内で見つかったすべてのカップリング・ファシリティー・ストラクチャーに関する情報を要求します。出力される報告書は STRDATA ALL STRUCTURES SUMMARY REPORT です。それぞれのストラクチャーについて、出力フィールドは次のとおりです。
- ストラクチャー名
- ストラクチャー・タイプ
- ストラクチャー・ダンプ ID
- カップリング・ファシリティー情報
- 機能名
- カップリング・ファシリティー・ストラクチャー制御情報の要約
```
COMMAND ===>  STRDATA ALLSTRS
```
STRNAME ((strname,strdumpid),(strname,strdumpid),...)
リストされたカップリング・ファシリティー・ストラクチャーに関する情報を要求します。ストラクチャーはリスト、キャッシュ、またはリストとキャッシュの任意の組み合わせが可能です。
注: ロック・ストラクチャーはダンプされません。
出力される報告書は CACHE STRUCTURE SUMMARY REPORT です。指定されたそれぞれのストラクチャー名について、出力フィールドは次のとおりです。
ストラクチャー名

ストラクチャー・タイプ

ストラクチャー・ダンプ ID

カップリング・ファシリティー情報

機能名

カップリング・ファシリティー・キャッシュ・ストラクチャー制御情報の要約
strname はストラクチャーの名前を指定します。例えば、次のとおりです。
COMMAND ===> STRDATA STRNAME((CACHE01))

注: strname にリスト・ストラクチャーを指定すると、出力される報告書は LIST STRUCTURE SUMMARY REPORT になります。
strname の終わりに総称文字としてアスタリスク (*) を使用することができ、その場合は、指定された文字を共通にもつすべてのストラクチャー名が報告書に含まれます。以下のサブコマンドは文字 ‘LIST’ で始まるすべてのストラクチャー名を指定し、報告書には、ストラクチャー LIST01、 LIST02、LIST03 などが含まれます。
COMMAND ===> STRDATA STRNAME((LIST*))
strdumpid は、ダンプ内のストラクチャーのインスタンスを指定します。ダンプ内にストラクチャーのインスタンスが複数ある理由は、ダンプの取り込み時にストラクチャーが再構築処理状態か、または二重化確立フェーズ状態の場合です。ストラクチャー・ダンプ ID が与えられないと、ダンプ内の、同じ名前をもつすべてのストラクチャーに関する情報が表示されます。 strdumpid は、次の例に示すように、16 進数で引用符なしで指定します。
COMMAND ===> STRDATA STRNAME((CACHE01,0101))
STRDATA STRNAME パラメーターは、IXLCONN マクロの STRNAME パラメーターに関連付けられています。
ALLDATA
指定されたストラクチャーに関してダンプ内で見つかったすべてのデータの表示を要求します。 ALLDATA が STRNAME とともに指定されると、指定されたストラクチャーに関するすべてのデータが表示されます。 ALLDATA が ALLSTRS とともに指定されると、ダンプ内の全ストラクチャーについて見つかった全データが表示されます。出力される報告書は次のとおりです。
- LIST STRUCTURE ALLDATA SUMMARY REPORT
- ASSOCIATED REQUEST BLOCK REPORT
- EVENT MONITOR CONTROLS REPORT
- EVENT QUEUE CONTROLS REPORT
- LIST NUMBER ENTRY POSITION SUMMARY REPORT
- LOCK ENTRIES REPORT
- USER CONTROLS REPORT
報告書の出力フィールドについては、ARB、ENTRYPOS、LOCKENTRIES、および USERCNTLS に関する出力フィールドを参照してください。キャッシュ・ストラクチャーが指定されていると、キャッシュ・ストラクチャーに関係のあるすべての報告書が表示されるはずです。
例えば、
COMMAND ===> STRDATA STRNAME((LIST02)) ALLDATA

追加データ選択パラメーター

COCLASS (ALL | coclass,coclass:coclass,...)

カップリング・ファシリティー・キャッシュ・ストラクチャーに関するキャストアウト・クラス別の情報を要求します。 coclass には 1 つのキャストアウト・クラス、クラスの範囲、または不連続クラスのリストを指定することができます。範囲を指定する場合、範囲の最初と最後のクラスはコロンで区切ってください。リストを指定する場合、リスト・メンバーはコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
CASTOUT CLASS SUMMARY REPORT

指定されたそれぞれの coclass について、出力フィールドは次のとおりです。

クラス・タイプ
クラス
クラス状況
キャストアウト・クラス制御情報

STRDATA COCLASS パラメーターは次のものと関連付けられています。

IXLCONN マクロの NUMCOCLASS パラメーター
IXLCACHE マクロの COCLASS パラメーター

例えば、

COMMAND ===>  STRDATA COCLASS(01)

STGCLASS (ALL | stgclass,stgclass:stgclass,...)

カップリング・ファシリティー・キャッシュ・ストラクチャーに関するストレージ・クラス別の情報を要求します。 stgclass には 1 つのストレージ・クラス、クラスの範囲、または不連続クラスのリストを指定することができます。範囲を指定する場合、範囲の最初と最後のクラスはコロンで区切ってください。リストを指定する場合、リスト・メンバーはコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
STORAGE CLASS SUMMARY REPORT

指定されたそれぞれのストレージ・クラスについて、出力フィールドは次のとおりです。

クラス・タイプ
クラス
クラス状況
クラス制御情報

STRDATA STGCLASS パラメーターは次のものと関連付けられています。

IXLCONN マクロの NUMSTGCLASS パラメーター
IXLCACHE マクロの STGCLASS パラメーター

例えば、

COMMAND ===>  STRDATA STGCLASS(01)

LISTNUM (ALL | listnum,listnum:listnum,...)

カップリング・ファシリティー・リスト・ストラクチャー内のリスト番号別の情報を要求します。 listnum には 1 つのリスト番号、リスト番号の範囲、または不連続リスト番号のリストを指定することができます。範囲を指定する場合、範囲の最初と最後の数値はコロンで区切ってください。リストを指定する場合、リスト・メンバーはコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
LIST NUMBER SUMMARY REPORT

指定されたそれぞれのリスト番号について、出力フィールドは次のとおりです。

リスト番号
リスト番号の状況
リスト制御情報の要約

STRDATA LISTNUM パラメーターは次のものと関連付けられています。

IXLCONN マクロの LISTHEADERS パラメーター
IXLLIST マクロの LISTNUM パラメーター

例えば、

COMMAND ===>  STRDATA LISTNUM(01)

EMCONTROLS(ALL | listnum,listnum:listnum,...)

リスト番号によって識別されるリスト・ストラクチャーに関連付けられたイベント・モニター制御 (EMC) に関する情報を要求します。 listnum には 1 つのリスト番号、リスト番号の範囲、または不連続リスト番号のリストを指定することができます。範囲を指定する場合、範囲の最初と最後の ID はコロンで区切ってください。リスト番号を指定する場合、リスト番号はコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY/DETAIL REPORT
EVENT MONITOR CONTROLS SUMMARY/DETAIL REPORT

それぞれのリスト番号について、出力フィールドは次のとおりです。

イベント・モニター制御のリスト番号
イベント・モニター制御の状況
リスト番号に関連付けられたそれぞれの EMC ごとに、以下の EMC 詳細報告書情報が表示されます。
- 接続 ID
- リスト番号
- リスト項目キー
- イベント・キューの状況
- ユーザー通知制御情報

例えば、

COMMAND ===>  STRDATA EMCONTROLS(01)

EVENTQS(ALL | conid,conid:conid,...)

リスト・ストラクチャー・コネクターに関連付けられたイベント・キュー上のイベント・モニター制御 (EMC) に関する情報を要求します。 conid には 1 つの接続 ID、接続 ID の範囲、または不連続接続 ID のリストを指定することができます。範囲を指定する場合、範囲の最初と最後の ID はコロンで区切ってください。接続 ID を指定する場合、接続 ID はコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY/DETAIL REPORT
EVENT QUEUE CONTROLS SUMMARY/DETAIL REPORT

それぞれの接続 ID について、出力フィールドは次のとおりです。

接続 ID
ダンプされた EMC の数
イベント・キュー制御の状況
イベント・キュー変換出口の状況
イベント・キューのモニター状況
イベント通知ベクトル・インデックス
キューされた EMC の数
状態変換の数
イベント・キュー上のそれぞれの EMC ごとに、
- 上述の EMCONTROLS で述べたものと同じ EMC 詳細報告書情報

例えば、

COMMAND ===>  STRDATA EVENTQS(1)

USERCNTLS (ALL | conid,conid:conid,...)

ストラクチャーのユーザーに関するユーザー接続 ID 別の情報を要求します。 conid には 1 つの接続 ID、接続 ID の範囲、または不連続接続 ID のリストを指定することができます。範囲を指定する場合、範囲の最初と最後の ID はコロンで区切ってください。リストを指定する場合、リスト・メンバーはコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
USER CONTROLS REPORT

指定されたそれぞれの接続 ID について、出力フィールドは次のとおりです。

接続 ID の状況
接続名
接続 ID
接続状況
ユーザー権限
ユーザー制御情報

例えば、

COMMAND ===>  STRDATA USERCNTLS(01)

LOCKENTRIES (ALL | lockentry,lockentry:lockentry,...)

カップリング・ファシリティーのリスト・ストラクチャーのロック・テーブル項目に関する、指定された項目別の情報を要求します。 lockentry には 1 つの項目、項目の範囲、または不連続項目のリストを指定することができます。範囲を指定する場合、範囲の最初と最後の項目はコロンで区切ってください。リストを指定する場合、リスト・メンバーはコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
LOCK ENTRIES REPORT

ロック・テーブルのそれぞれの項目について、出力フィールドは次のとおりです。

ロック項目の状況
ロック項目
所有者の接続 ID
「誰による保留」かのシステム標識

STRDATA LOCKENTRIES パラメーターは次のものと関連付けられています。

IXLCONN マクロの LOCKENTRIES パラメーター
IXLLIST マクロの LOCKINDEX パラメーター

例えば、

COMMAND ===>  STRDATA LOCKENTRIES(ALL)

ENTRYID (entryid,X'entryid',...)

カップリング・ファシリティーのリスト・ストラクチャーに関するリスト項目 ID 別の情報の表示を要求します。 entryid は 10 進数または 16 進数 (X'nnn') で指定することができます。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
LIST ENTRY IDENTIFIER SUMMARY REPORT

指定されたそれぞれの項目 ID について、出力フィールドは次のとおりです。

リスト項目 ID
リスト項目制御情報
付加属性データ
ストラクチャー逐次化標識

STRDATA ENTRYID パラメーターは、IXLLIST マクロの ENTRYID パラメーターに関連付けられています。

例えば、

COMMAND ===>  STRDATA ENTRYID(X'000000000000000100000009')

ENTRYNAME (entryname,entryname...)

カップリング・ファシリティーのリスト・ストラクチャー内のリスト項目名別、またはカップリング・ファシリティーのキャッシュ・ストラクチャー内のデータ項目名別の情報を要求します。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
ENTRY NAME SUMMARY REPORT

指定されたそれぞれの項目名について、出力フィールドは次のとおりです。

項目名
ディレクトリー情報 (キャッシュの場合) / リスト項目制御情報 (リストの場合)
付加属性データ
ストラクチャー逐次化標識

STRDATA ENTRYNAME パラメーターは次のものと関連付けられています。

IXLLIST マクロの ENTRYNAME パラメーター
IXLCACHE マクロの NAME パラメーター

例えば、

COMMAND ===>  STRDATA ENTRYNAME(ELEMENT2)

ARB

関連要求ブロック (ARB) のフォーマットを要求します。ARB には、DUMP、 CHNGDUMP、または SLIP オペレーター・コマンドの STRLIST オプションで指定された有効な範囲の全リストが入っています。リカバリー・ルーチンによってダンプが取られた場合、ARB には、IHABLDP マクロから取り出されたデータが入っています。

注: 実際のダンプ・パラメーターは、ストラクチャーの仕様と一致するように変更されているかもしれません。例えば、キャストアウト・クラス 1 から 2000 のダンプが要求された場合、1 から 10 のキャストアウト・クラスしか有効でなければ、ARB 入力は、ダンプが取られる前に変更されます。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
ASSOCIATED REQUEST BLOCK REPORT

出力フィールドは次のとおりです。

ARB 内の、要求された合計範囲数
ダンプされた最後の範囲
範囲番号
要求されたそれぞれの範囲についてダンプ・オブジェクト・タイプ。例えば、リスト番号またはロック項目。

例えば、

COMMAND ===>  STRDATA ARB

ENTRYPOS (ALL | entrypos,entrypos:entrypos,...)

特定の位置、または特定の位置範囲内にある項目に関する情報を要求します。このパラメーターは、COCLASS、STGCLASS、または LISTNUM も指定された場合のみ有効です。項目の位置は、ORDER パラメーターに基づいて、キューの先頭または末尾から数えられます。 entrypos には 1 つの位置、位置の範囲、または不連続位置のリストを指定することができます。範囲を指定する場合、範囲の最初と最後の位置はコロンで区切ってください。リストを指定する場合、リスト・メンバーはコンマで区切ってください。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
LIST NUMBER ENTRY POSITION SUMMARY REPORT

注: STGCLASS も指定されている場合、IPCS は STORAGE CLASS ENTRY POSITION SUMMARY REPORT も表示します。 STGCLASS または COCLASS が指定されていると、IPCS は、CASTOUT CLASS ENTRY POSITION SUMMARY REPORT も表示します。

指定されたそれぞれの項目について、出力フィールドは次のとおりです。

リスト番号
リスト番号の状況
リスト制御情報の要約
要求された場合、項目キー
順序標識
要求された各項目ごとに、
- 項目位置
- リスト項目制御情報
- 付加属性データ
- 逐次化標識

STRDATA ENTRYPOS パラメーターは次のものと関連付けられています。

IXLLIST マクロの LISTDIR パラメーター
IXLCACHE マクロの COCLASS および STGCLASS パラメーター

例えば、

COMMAND ===>  STRDATA LISTNUM(ALL) ENTRYPOS(2)

ORDER (HEAD | TAIL)

項目を表示する順序を指定します。 ORDER は、ENTRYPOS を指定した場合のみ指定してください。 ENTRYPOS で指定する位置番号は、キューの先頭から数えるのか、末尾から数えるのかによって異なります。

HEAD がデフォルトであり、これは、リストの先頭またはキューの先頭から探すことを指定します。ストレージ・クラスの場合、キューの先頭は参照された 最古の項目です。キャストアウト・クラスの場合、キューの先頭は変更された 最古の項目です。

TAIL は、リストの終わりまたはキューの末尾から探すことを指定します。ストレージ・クラスの場合、キューの末尾は最後に参照された 項目です。キャストアウト・クラスの場合、キューの末尾は最後に 変更された 項目です。

例えば、リスト番号 2 に 35 個の項目がある場合、キューの先頭から 30 番目の項目を特定するには、その同じ項目を表示するために、以下のどちらでも指定することができます。

COMMAND ===>  STRDATA LISTNUM(2) ENTRYPOS(30) ORDER(HEAD)

COMMAND ===>  STRDATA LISTNUM(2) ENTRYPOS(6) ORDER(TAIL)

ENTRYKEY(entrykey,entrykey...)

指定されたキーを持つリスト項目の表示か、またはリスト項目および指定されたキーに関連付けられたイベント・モニター制御 (EMC) の表示を要求します。このパラメーターは、LISTNUM 処理 (ENTRYPOS が指定されている場合) と EMCONTROLS 処理にのみ使用できます。

出力される報告書は次のとおりです。

STRDATA ALL STRUCTURES SUMMARY REPORT
LIST NUMBER ENTRYKEY ENTRY POSITION SUMMARY REPORT

出力フィールドは次のとおりです。

リスト番号
リスト番号の状況
リスト制御情報の要約
項目キー
順序標識
要求された各項目ごとに、
- 項目位置
- リスト項目制御情報
- 付加属性データ
- 逐次化標識

STRDATA ENTRYKEY パラメーターは次のものと関連付けられています。

IXLCONN マクロの LISTCNTLTYPE=ENTRY および REFOPTION=KEY パラメーター
IXLLIST マクロの ENTRYKEY パラメーター

例えば、項目位置は、項目キーに基づいた相対順です。表 1はキュー 1 であって、項目が 5 つ入ったリストです。

表 1. キューと項目の位置の例
リスト 2
キューの先頭
項目 1 キー 1 項目 2 キー 2 項目 3 キー 2 項目 4 キー 2 項目 5 キー 3
キューの末尾

リスト 2 の先頭から数えて、キー 2 に関する 2 番目と 3 番目の項目を表示するには、次のコマンドを入力します。

COMMAND ===>  STRDATA LISTNUM(2) ENTRYPOS(2,3) ENTRYKEY(02) ORDER(HEAD)

表 2は、同じキーをもつ複数の項目をどのようにして 1 つの個別のキュー、すなわち、キュー 2 と考えるかを示したものです。これにより、項目 3 を項目位置 2 として、項目 4 を項目位置 3 として取得することができます。

表 2. 別のキューと見なされる項目の例
リスト 2
項目 1 キー 1
キューの先頭
項目 2 キー 2 位置 1 項目 3 キー 2 位置 2 項目 4 キー 2 位置 3
キューの末尾
項目 5 キー 3

別の例として、例えば、

COMMAND ===>  STRDATA ENTRYKEY(02) LISTNUM(ALL) ENTRYPOS(ALL)