VERBEXIT GRSTRACE サブコマンド - グローバル・リソース逐次化データをフォーマットする

VERBEXIT サブコマンドの GRSTRACE、QCBTRACE、または Q 動詞名は、グローバル・リソース逐次化のための主要制御ブロックからの診断データをフォーマットしたいときに指定します。

構文

  VERBEXIT GRSTRACE [ 'parameter [,parameter]...' ]

parameter は次のとおりです。

     Data Selection Parameters:

                [DETAIL]
                [SUMMARY]
                
     Time format Parameters:

                [TIME(LOCAL|GMT|UTC)] 

     Additional Filter Parameters:

                [START(mm/dd/yy,hh.mm.ss.dddddd)]
                [STOP(mm/dd/yy,hh.mm.ss.dddddd)]
                [SYSNAME(sysname)]                            
                [QNAME(qname)]                                
                [RNAME(rname)]                                
                [STEP] [ SYSTEM] [ SYSTEMS]
                [JOBNAME(jobname)]                            
                [ASID(asid)]                                  
                [TCB(tcb)]                                    
                [RESERVE]
                [CONTENTION]   

     SETDEF-Defined Parameters:
        Note: You can override the following SETDEF parameters.         
                                                                                    
                [DSNAME(dsname) | DATASET(dsname) ]                
                [FILE(ddname) | DDNAME(ddname)    ]                
                [PATH(path-name)     ]                             
                [FLAG(severity)]                            
                [PRINT | NOPRINT]                             
                [TERMINAL | NOTERMINAL]                       
                [TEST | NOTEST]

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

詳細な GRSTRACE 報告書を表示します。詳細報告書は、要約報告書が表示するすべての重要な ENQ コンテキスト情報に加えて、ENQ 診断データを含みます。

SUMMARY

要約の GRSTRACE 報告書を表示します。要約報告書は、関連するすべてのコンテキスト情報 (QName、 RName、 Sysname、 Scope、 Jobname、 Asid、 Tcb、 Disposition、所有権状況、および待ち時間と許可時間など) を含みます。 SUMMARY がデフォルトです。
時刻形式パラメーター
TIME(LOCAL|GMT|UTC)
GRSTRACE 報告書に使用する時刻形式を指定します。
- LOCAL: ENQ に関連するすべての時間は現地時間にフォーマットされます。
- GMT: ENQ に関連するすべての時間は GMT 標準時にフォーマットされます。
- UTC: ENQ に関連するすべての時間は UTC 標準時にフォーマットされます。これは正確なストア・クロック・タイム・スタンプです。
追加フィルター・パラメーター
これらのパラメーターは報告書内のデータの範囲を制限するためのものです。データ選択パラメーターが選択されない場合、デフォルトは NO FILTERING です。リソースを表示するには、リソース・チェーンにおいて少なくとも 1 つのリクエスターが、すべてのフィルター・オプションに一致しなければなりません。ワイルドカード値は、SYSNAME フィルター、JOBNAME フィルター、QNAME フィルター、および RNAME フィルターに許可されています。 * (アスタリスク) はゼロ文字以上に、? (クエスチョン・マーク) は 1 文字のみに一致するものとして使用します。例についてはここを参照してください。
START(mm/dd/yy,hh.mm.ss.dddddd)
この時点、またはこれ以降に発生する要求で、ENQ リソースの表示に使用される日付と時刻を指定します。時刻形式は、TIME キーワードで指定される時刻形式に一致しなければなりません。 START を指定しない場合、IPCS は最も古い ENQ 要求から開始します。日付と時刻を mm/dd/yy,hh.mm.ss.dddddd 形式で指定してください。
注: 日付と時刻の指定には、以下の規則が適用されます。
月と日は 1 桁または 2 桁で指定することができる。

日付と時刻はコンマで区切る。

時刻には、現地時間、GMT、または UTC が使用できる。デフォルトおよび TIME(Local) パラメーターが指定された場合には現地時間が使用され、Time(GMT) パラメーターまたは Time(UTC) パラメーターが指定された場合にはそれぞれ、GMT 標準時、UTC 標準時が使用される。

時間、分、および秒は 1 桁または 2 桁で指定することができる。

時刻は、右側のどの地点からでも切り捨てることができる。

時刻は完全に省くことができる。その場合、デフォルトは 00:00:00.000000 (午前 0 時) になる。
STOP(mm/dd/yy,hh.mm.ss.dddddd)

この時点、またはこれ以前に発生した要求で、ENQ リソースの表示に使用される日付と時刻を指定します。時刻形式は、TIME キーワードで指定される時刻形式に一致しなければなりません。 STOP を指定しない場合、IPCS は最新の ENQ 要求で終了します。
日付と時刻の指定方法については、START パラメーターを参照してください。

SYSNAME(sysname)

指定された規定のシステム名で、すべての ENQ リソースを表示します。 GRS=STAR では、他のシステムからのリソース要求が、ローカル・ストレージに維持されないことに注意してください。したがって、別のシステム名を指定したクエリーは、GRSDATA からのみデータを受け取り、GRSTRACE からは受け取らない場合があります。

QNAME(qname)

指定された QNAME (大分類名) ですべての ENQ リソースを表示します。

RNAME(rname)

指定された RNAME (小分類名) ですべての ENQ リソースを表示します。

[STEP] [ SYSTEM] [ SYSTEMS]

STEP、SYSTEM、または SYSTEMS の有効範囲ですべての ENQ リソースを表示します。

JOBNAME(jobname)

指定されたジョブ名に関連付けられたすべての ENQ リソースを表示します。

ASID(asid)

指定されたアドレス・スペース ID に関連付けられたすべての ENQ リソースを表示します。

TCB(tcb)

指定されたタスクに関連付けられたすべての ENQ リソースを表示します。

RESERVE

グローバル ENQ に変換されていない RESERVE 要求のみを表示します。

CONTENTION

ENQ 競合にある ENQ リソースのみを表示します。デバイス RESERVE 競合は考慮されていません。
例: 以下を持つすべてのリソース要求に一致します。
- SYS で始まり、ゼロ文字以上の後に R、その後厳密に 2 文字が続いて F で終わる QNAME (例: SYSZRACF)
- RNAME が SOMESPECIFICRNAME
- SCOPE=SYSTEMS
- DB2® で始まる JOBNAME
- アクション
```
	IP VERBX GRSTRACE ‘QNAME(SYS*R??F) RNAME(SOMESPECIFICRNAME) 
    SYSTEMS JOBNAME(DB2*)’      
```
- 結果
  GRSTRACE 出力の例については、「z/OS MVS 診断: 解説書」のグローバル・リソース逐次化コンポーネントの記述を参照してください。