MVS 診断: ツールと保守援助プログラム

z/OS
򔻐򗗠򙳰
MVS 診断: ツールと保守援助プログラム
GA88-8561-09
(英文原典：GA22-7589-12)
z/OS
򔻐򗗠򙳰
MVS 診断: ツールと保守援助プログラム
GA88-8561-09
(英文原典：GA22-7589-12)
お願い
本書および本書で紹介する製品をご使用になる前に、 B-1 ページの『特記事項』に記載されている情報をお読みください。
本書は GA88-8561-08 (英文原典 GA22-7589-11) の改訂版です。
本書は、z/OS (5694-A01) のバージョン 1 リリース 9、および新しい版で明記されていない限り、これ以降のすべて
のリリースおよびモディフィケーションに適用されます。
お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示さ
れたりする場合があります。
原典：
GA22–7589–12
z/OS
MVS Diagnosis:
Tools and Service Aids
発行：
日本アイ・ビー・エム株式会社
担当：
ナショナル・ランゲージ・サポート
第13版第1刷 2008.9
© Copyright International Business Machines Corporation 1988, 2008. All rights reserved.
目次
図
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
表. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
本書について . . . .
本書の対象読者 . . .
その他の関連資料 . .
Web 上での情報更新
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xvii
. xvii
. xvii
. xviii
変更の要約 . . . . . . . . . . . . . . . . . . . . . . . . . . xix
第 1 章 ツールと保守援助プログラムの選択
ツールと保守援助プログラムを選択する方法 .
使用できるツールと保守援助プログラム . .
ダンプ . . . . . . . . . . . . . .
トレース . . . . . . . . . . . . .
保守援助プログラム . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
第 2 章 SVC ダンプ . . . . . . . . . . . . . . . . . . . . .
SVC ダンプのデータ・セット管理の計画 . . . . . . . . . . . . . .
自動割り振りダンプ・データ・セットの使用 . . . . . . . . . . . .
事前割り振りダンプ・データ・セットの使用 . . . . . . . . . . . .
SVC ダンプ・データ・セットの選択 . . . . . . . . . . . . . .
自動割り振りダンプ・データ・セットの検出 . . . . . . . . . . .
システムからの通信 . . . . . . . . . . . . . . . . . . . .
SYS1.DUMPxx データ・セットの指定 . . . . . . . . . . . . . .
SYS1.DUMPxx データ・セットの制御 . . . . . . . . . . . . . .
SVC ダンプの獲得 . . . . . . . . . . . . . . . . . . . . . .
SVC ダンプ用のマクロを発行する . . . . . . . . . . . . . . .
オペレーターの活動 . . . . . . . . . . . . . . . . . . . .
ダンプ・データ・セットを使用可能にする . . . . . . . . . . . .
現行の SVC ダンプ・オプションと状況の判別 . . . . . . . . . .
SVC ダンプの検出 . . . . . . . . . . . . . . . . . . . . .
事前割り振りデータ・セットまたは SYS1.DUMPxx データ・セットの印刷、
表示、コピー、およびクリア . . . . . . . . . . . . . . . . .
SVC ダンプの内容 . . . . . . . . . . . . . . . . . . . . . .
SVC ダンプ内容のカスタマイズ . . . . . . . . . . . . . . . .
SVC ダンプの調整 . . . . . . . . . . . . . . . . . . . . . .
要約 SVC ダンプの分析 . . . . . . . . . . . . . . . . . . . .
SVC 項目 SDUMPX の SUMDUMP 出力 . . . . . . . . . . . .
分岐入力 SDUMPX 用の SUMDUMP 出力 . . . . . . . . . . . .
使用不能要約ダンプの分析 . . . . . . . . . . . . . . . . . .
中断要約ダンプの分析. . . . . . . . . . . . . . . . . . . .
SVC ダンプの分析 . . . . . . . . . . . . . . . . . . . . . .
ダンプのソースの指定. . . . . . . . . . . . . . . . . . . .
SVC ダンプ・ヘッダーのフォーマット設定 . . . . . . . . . . . .
ダンプ表題を調べる . . . . . . . . . . . . . . . . . . . .
発生イベント・トークン、ダンプの時刻とタイプの表示 . . . . . . .
エラー情報の検出 . . . . . . . . . . . . . . . . . . . . .
TCB 構造体の分析 . . . . . . . . . . . . . . . . . . . . .
© Copyright IBM Corp. 1988, 2008
.
.
.
.
.
.
1-1
1-1
1-3
1-3
1-5
1-6
. 2-1
. 2-2
. 2-2
. 2-7
. 2-10
. 2-11
. 2-11
. 2-11
. 2-12
. 2-13
. 2-14
. 2-15
. 2-18
. 2-19
. 2-20
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-23
2-24
2-25
2-37
2-38
2-39
2-40
2-41
2-41
2-42
2-43
2-44
2-44
2-46
2-47
2-49
iii
LOGREC バッファーのテスト . . . . . . .
システム・トレースの検査 . . . . . . . .
レジスターを調べる . . . . . . . . . .
SVC ダンプ分析に関するその他の役立つ報告書
SDUMPX 4K SQA バッファーの読み取り . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
第 3 章 トランザクション・ダンプ . . . . . . . . . .
トランザクション・ダンプのデータ・セットの計画 . . . .
トランザクション・ダンプのデータ・セット管理の計画 .
事前割り振りダンプ・データ・セットの使用 . . . . . .
自動割り振りダンプ・データ・セットの使用 . . . . . .
トランザクション・ダンプの獲得 . . . . . . . . . . .
ダンプ・データ・セットの印刷、表示、コピー、およびクリア
トランザクション・ダンプの内容 . . . . . . . . . . .
トランザクション・ダンプ内容のカスタマイズ . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-51
2-54
2-54
2-56
2-57
.
.
.
.
.
.
.
.
.
3-1
3-2
3-2
3-2
3-2
3-4
3-5
3-6
3-6
第 4 章 スタンドアロン・ダンプ. . . . . . . . . . . . . . . . . . 4-1
スタンドアロン・ダンプの計画 . . . . . . . . . . . . . . . . . . . 4-2
スタンドアロン・ダンプを DASD またはテープのいずれにとるべきか . . . 4-2
z/OS の新規のバージョンをダンプするためにスタンドアロン・ダンプ・プロ
グラムの現行のバージョンを使用できるか . . . . . . . . . . . . . 4-7
スタンドアロン・ダンプ・プログラムの作成 . . . . . . . . . . . . . . 4-8
AMDSADMP マクロからの MNOTES . . . . . . . . . . . . . . . 4-8
AMDSADMP マクロのコーディング . . . . . . . . . . . . . . . 4-13
AMDSADDD ユーティリティーの使用 . . . . . . . . . . . . . . 4-28
スタンドアロン・ダンプ・プログラムの生成 . . . . . . . . . . . . 4-34
2 段階生成 . . . . . . . . . . . . . . . . . . . . . . . . . 4-38
スタンドアロン・ダンプ・プログラムの実行 . . . . . . . . . . . . . 4-42
手順 A: スタンドアロン・ダンプの初期設定と実行 . . . . . . . . . . 4-43
手順 B: スタンドアロン・ダンプの再始動 . . . . . . . . . . . . . 4-48
手順 C: スタンドアロン・ダンプの再 IPL . . . . . . . . . . . . . 4-49
手順 D: スタンドアロン・ダンプ・プログラムのダンプ . . . . . . . . 4-49
シスプレックス内でのスタンドアロン・ダンプ・プログラムの実行 . . . . 4-50
スタンドアロン・ダンプを高速に採取 . . . . . . . . . . . . . . . . 4-52
オペレーターによる処置の最小化 . . . . . . . . . . . . . . . . 4-52
部分的スタンドアロン・ダンプの採取 . . . . . . . . . . . . . . . 4-52
スタンドアロン・ダンプ出力のコピー、表示、および印刷 . . . . . . . . 4-53
ダンプをデータ・セットにコピーする . . . . . . . . . . . . . . . 4-54
スタンドアロン・ダンプ出力の表示. . . . . . . . . . . . . . . . 4-57
スタンドアロン・ダンプ出力の印刷. . . . . . . . . . . . . . . . 4-58
メッセージ出力 . . . . . . . . . . . . . . . . . . . . . . . . 4-59
3480、3490、または 3590 表示装置上のスタンドアロン・ダンプ・メッセー
ジ . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
スタンドアロン・ダンプ出力の分析. . . . . . . . . . . . . . . . . 4-60
初期データの収集 . . . . . . . . . . . . . . . . . . . . . . 4-60
使用可能待機の分析 . . . . . . . . . . . . . . . . . . . . . 4-64
使用不能待ち状態の分析 . . . . . . . . . . . . . . . . . . . . 4-68
使用可能ループの分析. . . . . . . . . . . . . . . . . . . . . 4-69
使用不能ループの分析. . . . . . . . . . . . . . . . . . . . . 4-70
SLIP 作業域内の SLIP 問題データ . . . . . . . . . . . . . . . . 4-70
第 1 レベル割り込みハンドラーが保管する問題データ . . . . . . . . 4-71
iv
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 5 章 ABEND ダンプ . . . . . . . . . . . .
ABEND ダンプの一覧表 . . . . . . . . . . . .
ABEND ダンプの獲得 . . . . . . . . . . . . .
ダンプのデータ・セット . . . . . . . . . . .
ABEND ダンプを獲得する処理 . . . . . . . . .
ダンプの印刷と表示 . . . . . . . . . . . . . .
ABEND ダンプの内容. . . . . . . . . . . . .
現行の ABEND ダンプ・オプション . . . . . .
ABEND ダンプ内の要約ダンプのデフォルトの内容 .
ABEND ダンプ内容のカスタマイズ. . . . . . . .
SYSABEND ダンプ内容のカスタマイズ . . . . .
SYSMDUMP ダンプ内容のカスタマイズ . . . . .
SYSUDUMP ダンプ内容のカスタマイズ . . . . .
ABEND ダンプの分析. . . . . . . . . . . . .
分析手順. . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 5-1
. 5-2
. 5-4
. 5-4
. 5-6
. 5-9
. 5-10
. 5-11
. 5-16
. 5-18
. 5-20
. 5-22
. 5-23
. 5-25
. 5-26
第 6 章 SNAP ダンプ. . . . . . . . . . . .
SNAP ダンプの獲得 . . . . . . . . . . . . .
SNAP ダンプの内容のカスタマイズ . . . . . . .
インストール・システム出口によるカスタマイズ .
SNAP または SNAPX マクロによるカスタマイズ .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
6-1
6-1
6-5
6-5
6-5
第 7 章 ダンプ・グラブ・バッグ. . . . . .
ストレージ・オーバーレイに関する問題データ .
損傷区域の分析 . . . . . . . . . . .
一般的な不良アドレス . . . . . . . . .
リンケージ・スタックから得られる問題データ .
モジュールの問題データ . . . . . . . . .
処理モード . . . . . . . . . . . . .
リカバリー作業域から得られる問題データ . .
ACR の問題データ . . . . . . . . . . .
前処理フェーズのデータ . . . . . . . .
IPCS によって獲得されるデータ . . . . .
マシン・チェックの問題データ . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
7-1
7-1
7-1
7-2
7-3
7-5
7-5
7-6
7-6
7-6
7-7
7-7
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
第 8 章 システム・トレース . . . . . . . . . . . . . . . . . . . 8-1
システム・トレースのカスタマイズ . . . . . . . . . . . . . . . . . 8-1
システム・トレース・テーブルのサイズの拡大 . . . . . . . . . . . . 8-1
分岐命令のトレース . . . . . . . . . . . . . . . . . . . . . . 8-2
システム・トレース・データをダンプで受けとる . . . . . . . . . . . . 8-3
ダンプ内のシステム・トレース・データのフォーマット設定 . . . . . . . . 8-3
システム・トレース出力の読み方 . . . . . . . . . . . . . . . . . . 8-4
ダンプ内のシステム・トレースの例 . . . . . . . . . . . . . . . . 8-4
システム・トレース項目 ID の要約 . . . . . . . . . . . . . . . . 8-5
ACR トレース項目 . . . . . . . . . . . . . . . . . . . . . . 8-7
ALTR トレース項目 . . . . . . . . . . . . . . . . . . . . . . 8-9
BR トレース項目 . . . . . . . . . . . . . . . . . . . . . . 8-10
BSG、PC、PR、PT、PTI、SSAR、および SSIR トレース項目 . . . . . . 8-11
MODE および MOBR トレース項目 . . . . . . . . . . . . . . . 8-13
DSP、SRB、SSRB、および WAIT トレース項目 . . . . . . . . . . . 8-15
CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、および XSCH トレース項目 8-16
CALL、CLKC、EMS、EXT、I/O、MCH、RST、および SS トレース項目
8-19
目次
v
SUSP トレース項目 . . . . . . . .
PGM、SPER および SPR2 トレース項目.
RCVY トレース項目 . . . . . . . .
SVC、SVCE、および SVCR トレース項目
SSRV トレース項目 . . . . . . . .
TIME トレース項目 . . . . . . . .
USRn トレース項目 . . . . . . . .
|
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
第 9 章 マスター・トレース . . . . . . . . . . . . .
マスター・トレースとハードコピー・ログ . . . . . . . .
マスター・トレースのカスタマイズ . . . . . . . . . . .
マスター・トレースの要求 . . . . . . . . . . . . . .
マスター・トレースの受取り . . . . . . . . . . . . .
マスター・トレース・データの読み方 . . . . . . . . . .
ダンプ内でフォーマット設定されたマスター・トレース出力 .
ストレージ内のマスター・トレース・テーブル . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
第 10 章 汎用トレース機能 (GTF). . . . . . . . . . . . . . . .
GTF と IPCS . . . . . . . . . . . . . . . . . . . . . . . .
GTF と GTRACE マクロ . . . . . . . . . . . . . . . . . .
GTF と索引付き VTOC 処理 . . . . . . . . . . . . . . . . .
IBM デフォルトによる GTF の使用 . . . . . . . . . . . . . . .
GTF トレース・オプションの IBM 提供 parmlib メンバー . . . . . .
IBM 提供のカタログ式プロシージャー . . . . . . . . . . . . .
GTF のカスタマイズ . . . . . . . . . . . . . . . . . . . . .
GTF トレース・オプションの定義 . . . . . . . . . . . . . . .
カタログ式プロシージャーの設定 . . . . . . . . . . . . . . .
GTF の必要記憶容量の決定 . . . . . . . . . . . . . . . . .
GTF の開始 . . . . . . . . . . . . . . . . . . . . . . . .
GTF を呼び出すための START コマンドの使用 . . . . . . . . .
システム・プロンプト指示による GTF トレース・オプションの指定また
は変更 . . . . . . . . . . . . . . . . . . . . . . . .
GTF の開始例 . . . . . . . . . . . . . . . . . . . . . .
VTAM リモート・ネットワーク活動をトレースするための GTF の開始
GTF の停止 . . . . . . . . . . . . . . . . . . . . . . . .
GTF 停止の例 . . . . . . . . . . . . . . . . . . . . . .
GTF トレース・オプション . . . . . . . . . . . . . . . . . .
GTF オプションの組み合わせ . . . . . . . . . . . . . . . .
一連のサンプル・プロンプト指示の例 . . . . . . . . . . . . .
GTF トレースの受け取り . . . . . . . . . . . . . . . . . . .
GTF トレース出力の結合、抽出、およびマージ . . . . . . . . . .
トレース出力のマージ . . . . . . . . . . . . . . . . . . .
GTF 出力の読み方 . . . . . . . . . . . . . . . . . . . . .
定様式の GTF トレース出力 . . . . . . . . . . . . . . . . . .
トレース・レコード ID . . . . . . . . . . . . . . . . . . .
定様式 GTF トレース出力の例 . . . . . . . . . . . . . . . .
イベントに関する定様式トレース・レコード . . . . . . . . . . . .
タイム・スタンプ・レコード . . . . . . . . . . . . . . . . .
ソース索引レコード . . . . . . . . . . . . . . . . . . . .
消失イベント・レコード . . . . . . . . . . . . . . . . . .
CCW トレース・レコード . . . . . . . . . . . . . . . . . .
CSCH および HSCH トレース・レコード . . . . . . . . . . . .
vi
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
8-21
8-23
8-24
8-29
8-31
8-40
8-41
.
.
.
.
.
.
.
.
9-1
9-1
9-2
9-2
9-3
9-4
9-4
9-5
. 10-1
. 10-2
. 10-2
. 10-2
. 10-3
. 10-3
. 10-4
. 10-5
. 10-5
. 10-6
. 10-12
. 10-14
. 10-14
. 10-16
. 10-17
10-21
. 10-22
. 10-23
. 10-24
. 10-30
. 10-37
. 10-40
. 10-41
. 10-43
. 10-44
. 10-46
. 10-46
. 10-48
. 10-50
. 10-50
. 10-50
. 10-51
. 10-52
. 10-54
DSP および SDSP トレース・レコード . . . . . . . . . . . . . . 10-55
EOS、CS、IO、および PCI トレース・レコード . . . . . . . . . . 10-57
EXT トレース・レコード . . . . . . . . . . . . . . . . . . . 10-59
FRR トレース・レコード . . . . . . . . . . . . . . . . . . . 10-61
HEXFORMAT、SUBSYS、および SYSTEM トレース・レコード . . . . 10-63
IOX トレース・レコード . . . . . . . . . . . . . . . . . . . 10-64
LSR トレース・レコード . . . . . . . . . . . . . . . . . . . 10-66
MSCH トレース・レコード . . . . . . . . . . . . . . . . . . 10-67
PGM および PI トレース・レコード . . . . . . . . . . . . . . . 10-69
RNIO トレース・レコード . . . . . . . . . . . . . . . . . . 10-70
RSCH トレース・レコード . . . . . . . . . . . . . . . . . . 10-71
SLIP トレース・レコード . . . . . . . . . . . . . . . . . . . 10-72
SLIP 標準トレース・レコード . . . . . . . . . . . . . . . . . 10-73
SLIP 標準/ユーザー・トレース・レコード . . . . . . . . . . . . . 10-75
SLIP ユーザー・トレース・レコード . . . . . . . . . . . . . . . 10-76
SLIP デバッグ・トレース・レコード . . . . . . . . . . . . . . . 10-77
SRB トレース・レコード . . . . . . . . . . . . . . . . . . . 10-78
SRM トレース・レコード . . . . . . . . . . . . . . . . . . . 10-79
SSCH トレース・レコード . . . . . . . . . . . . . . . . . . 10-80
STAE トレース・レコード . . . . . . . . . . . . . . . . . . 10-82
SVC および SVCR トレース・レコード . . . . . . . . . . . . . 10-83
USR トレース・レコード . . . . . . . . . . . . . . . . . . . 10-85
不定様式 USR トレース・レコード . . . . . . . . . . . . . . . 10-86
定様式 USR トレース・レコード . . . . . . . . . . . . . . . . 10-86
VSAM 用の USRF9 トレース・レコード . . . . . . . . . . . . . 10-87
VTAM 用の USRFD トレース・レコード . . . . . . . . . . . . . 10-88
BSAM、QSAM、BPAM、および BDAM 用の USRFE トレース・レコード 10-88
オープン/クローズ/EOV 異常終了用の USRFF トレース・レコード
10-90
ユーザー要求作業域用の USRFF トレース・レコード . . . . . . . . 10-90
XSCH トレース・レコード . . . . . . . . . . . . . . . . . . 10-91
USR トレース・レコード用のイベント ID (EID) . . . . . . . . . . 10-92
USR トレース・レコード用のフォーマット ID (FID) . . . . . . . . . 10-93
不定形式の GTF トレース出力 . . . . . . . . . . . . . . . . . . 10-94
制御レコード . . . . . . . . . . . . . . . . . . . . . . . 10-95
不定様式の消失イベント・レコード . . . . . . . . . . . . . . . 10-96
ユーザー・データ・レコード . . . . . . . . . . . . . . . . . . 10-97
システム・データ・レコード . . . . . . . . . . . . . . . . . . 10-99
イベントの不定様式トレース・レコード . . . . . . . . . . . . . 10-100
第 11 章 コンポーネント・トレース . . . . . . . . . . . . . . .
コンポーネント・トレースの計画 . . . . . . . . . . . . . . . .
いくつかのコンポーネントに関する CTncccxx parmlib メンバーの作成
コンポーネント・トレースのトレース・オプションの選択 . . . . . .
トレース・レコードの収集場所の決定 . . . . . . . . . . . . .
コンポーネント・トレースの獲得 . . . . . . . . . . . . . . . .
アドレス・スペースまたはデータ・スペース・トレース・バッファーに対
するコンポーネント・トレースの要求 . . . . . . . . . . . .
トレース・データ・セットへのコンポーネント・トレース・データ書き込
みの要求 . . . . . . . . . . . . . . . . . . . . . . .
parmlib メンバーの作成 . . . . . . . . . . . . . . . . . . .
シスプレックス内のシステムに関するコンポーネント・トレースの要求
コンポーネント・トレースの検査 . . . . . . . . . . . . . . .
. 11-1
. 11-3
11-3
. 11-9
. 11-11
. 11-12
. 11-12
. 11-16
. 11-20
11-22
. 11-25
目次
vii
書き出しプログラムが活動状態であることの検査 . . .
コンポーネント・トレース・データの表示 . . . . . . .
SYSAPPC コンポーネント・トレース . . . . . . . .
SYSAPPC トレースの要求. . . . . . . . . . . .
SYSAPPC トレースのフォーマット設定. . . . . . .
SYSAPPC トレースからの出力 . . . . . . . . . .
FMH-5 トレース・データ . . . . . . . . . . . .
SYSAXR コンポーネント・トレース . . . . . . . . .
SYSAXR トレースの要求 . . . . . . . . . . . .
SYSAXR トレースのフォーマット設定 . . . . . . .
SYSAXR 変数トレースからの出力. . . . . . . . .
SYSDLF コンポーネント・トレース . . . . . . . . .
SYSDLF トレースの要求 . . . . . . . . . . . .
SYSDLF トレースのフォーマット設定 . . . . . . .
SYSDLF トレースからの出力 . . . . . . . . . .
SYSDSOM コンポーネント・トレース . . . . . . . .
SYSDSOM トレースの要求 . . . . . . . . . . .
SYSDSOM トレースのフォーマット設定 . . . . . .
SYSDSOM トレースからの出力. . . . . . . . . .
SYSGRS コンポーネント・トレース . . . . . . . . .
SYSGRS トレースの要求 . . . . . . . . . . . .
SYSGRS トレースのフォーマット設定 . . . . . . .
SYSGRS トレースからの出力 . . . . . . . . . .
CTRACE COMP(SYSGRS) TALLY サブコマンドの出力 .
SYSHZS コンポーネント・トレース . . . . . . . . .
SYSHZS トレースの要求 . . . . . . . . . . . .
SYSHZS トレースのフォーマット設定 . . . . . . .
SYSHZS トレースからの出力 . . . . . . . . . .
SYSIEFAL コンポーネント・トレース . . . . . . . .
SYSIEFAL トレースの要求 . . . . . . . . . . .
SYSIEFAL トレースのフォーマット設定 . . . . . .
SYSIEFAL トレースからの出力 . . . . . . . . . .
CTRACE COMP(SYSIEFAL) FULL サブコマンドの出力.
SYSIOS コンポーネント・トレース . . . . . . . . .
SYSIOS トレースの要求 . . . . . . . . . . . .
SYSIOS トレースのフォーマット設定 . . . . . . .
CTRACE COMP(SYSIOS) サブコマンドの出力 . . . .
SYSJES コンポーネント・トレース . . . . . . . . .
SYSJES トレースの要求 . . . . . . . . . . . .
SYSJES トレースのフォーマット設定 . . . . . . .
SYSJES トレースからの出力 . . . . . . . . . . .
SYSjes2 コンポーネント・トレース . . . . . . . . .
SYSjes2 トレースの要求 . . . . . . . . . . . .
SYSjes2 サブレベル・トレース情報のフォーマット設定 .
SYSjes2 トレースからの出力 . . . . . . . . . . .
SYSLLA コンポーネント・トレース . . . . . . . . .
SYSLLA トレースの要求 . . . . . . . . . . . .
SYSLLA トレースのフォーマット設定 . . . . . . .
SYSLOGR コンポーネント・トレース . . . . . . . .
システム・ロガー情報のダンプの入手 . . . . . . .
SYSLOGR トレースの要求 . . . . . . . . . . .
SYSLOGR トレースのフォーマット設定 . . . . . .
|
|
|
|
viii
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 11-28
. 11-28
. 11-31
. 11-31
. 11-36
. 11-40
. 11-42
. 11-47
. 11-48
. 11-50
. 11-50
. 11-51
. 11-51
. 11-52
. 11-52
. 11-53
. 11-53
. 11-54
. 11-54
. 11-55
. 11-56
. 11-61
. 11-61
. 11-61
. 11-62
. 11-63
. 11-65
. 11-65
. 11-67
. 11-67
. 11-72
. 11-72
. 11-72
. 11-73
. 11-75
. 11-78
. 11-78
. 11-80
. 11-82
. 11-86
. 11-88
. 11-93
. 11-94
. 11-94
. 11-94
. 11-96
. 11-97
. 11-97
. 11-97
. 11-98
. . . . . . . 11-101
. . . . . . . 11-104
SYSLOGR トレースからの出力 . . . . . . . . . . . . . .
SYSOMVS コンポーネント・トレース . . . . . . . . . . . . .
SYSOMVS トレースの要求 . . . . . . . . . . . . . . . .
SYSOMVS トレースのフォーマット設定 . . . . . . . . . . .
SYSOMVS トレースからの出力 . . . . . . . . . . . . . .
CTRACE COMP(SYSOMVS) SUMMARY サブコマンドの出力 . . .
SCCOUNTS オプションを使用した SYSOMVS トレースからの出力
SYSOPS コンポーネント・トレース. . . . . . . . . . . . . .
SYSOPS トレースの要求 . . . . . . . . . . . . . . . . .
SYSOPS トレースのフォーマット設定 . . . . . . . . . . . .
SYSOPS トレースからの出力 . . . . . . . . . . . . . . .
CTRACE COMP(SYSOPS) FULL サブコマンドの出力 . . . . . .
SYSRRS コンポーネント・トレース . . . . . . . . . . . . .
SYSRRS トレースの要求 . . . . . . . . . . . . . . . . .
SYSRRS トレースのフォーマット設定 . . . . . . . . . . . .
SYSRRS トレースからの出力 . . . . . . . . . . . . . . .
SYSRSM コンポーネント・トレース . . . . . . . . . . . . .
SYSRSM トレースの要求 . . . . . . . . . . . . . . . .
SYSRSM トレースのフォーマット設定 . . . . . . . . . . .
SYSRSM トレースからの出力 . . . . . . . . . . . . . . .
SYSSPI コンポーネント・トレース . . . . . . . . . . . . . .
SYSSPI トレースの要求 . . . . . . . . . . . . . . . . .
SYSSPI トレースのフォーマット設定 . . . . . . . . . . . .
SYSTTRC トランザクション・トレース . . . . . . . . . . . .
SYSVLF コンポーネント・トレース . . . . . . . . . . . . .
SYSVLF トレースの要求 . . . . . . . . . . . . . . . . .
SYSVLF トレースのフォーマット設定 . . . . . . . . . . . .
SYSVLF トレースからの出力 . . . . . . . . . . . . . . .
SYSWLM コンポーネント・トレース . . . . . . . . . . . . .
SYSWLM トレースの要求 . . . . . . . . . . . . . . . .
SYSWLM トレースのフォーマット設定 . . . . . . . . . . .
SYSWLM トレースからの出力. . . . . . . . . . . . . . .
CTRACE COMP(SYSWLM) FULL サブコマンドの出力 . . . . .
SYSXCF コンポーネント・トレース . . . . . . . . . . . . .
SYSXCF トレースの要求 . . . . . . . . . . . . . . . . .
SYSXCF トレースのフォーマット設定 . . . . . . . . . . . .
SYSXCF トレースからの出力 . . . . . . . . . . . . . . .
SYSXES コンポーネント・トレース . . . . . . . . . . . . .
SYSXES トレースの要求 . . . . . . . . . . . . . . . . .
SYSXES トレースのフォーマット設定 . . . . . . . . . . . .
SYSXES トレースからの出力 . . . . . . . . . . . . . . .
第 12 章 トランザクション・トレース . . . . . . . . . .
トランザクション・トレースの作動方法 . . . . . . . . . .
トランザクション・トレースのコマンド . . . . . . . . . .
TRACE TT コマンド . . . . . . . . . . . . . . . .
DISPLAY TRACE,TT . . . . . . . . . . . . . . . .
トランザクション・トレース出力を表示するための IPCS の使用 .
IPCS CTRACE COMP(SYSTTRC) の例 . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
11-105
11-105
11-106
11-109
11-111
11-116
11-117
11-118
11-118
11-121
11-122
11-122
11-123
11-124
11-128
11-129
11-132
11-133
11-149
11-149
11-151
11-151
11-152
11-152
11-152
11-153
11-154
11-154
11-156
11-157
11-157
11-158
11-158
11-159
11-159
11-162
11-163
11-164
11-166
11-168
11-170
.
.
.
.
.
.
.
12-1
12-1
12-2
12-2
12-4
12-5
12-5
第 13 章 GETMAIN、 FREEMAIN、 STORAGE (GFS) トレース. . . . . 13-1
GFS トレースの開始および停止 . . . . . . . . . . . . . . . . . . 13-1
目次
ix
GFS トレース・データの受取 . . . . . . . . . . . . . . . . . . . 13-3
定様式の GFS トレース出力 . . . . . . . . . . . . . . . . . . . 13-4
不定様式 GFS トレース出力 . . . . . . . . . . . . . . . . . . . 13-5
第 14 章 Logrec エラー・レコードの記録 . . . . . . . . . . . .
ソフトウェアおよびハードウェア情報の収集 . . . . . . . . . . . .
適切な Logrec 記録メディアの選択 . . . . . . . . . . . . . . . .
Logrec データ・セットの初期設定および再初期設定 . . . . . . . . .
Logrec データ・セットの初期設定 . . . . . . . . . . . . . . .
Logrec データ・セットの再初期設定 . . . . . . . . . . . . . .
Logrec ログ・ストリームの定義 . . . . . . . . . . . . . . . . .
エラー記録の内容 . . . . . . . . . . . . . . . . . . . . . .
Logrec データ・セットのヘッダー・レコード . . . . . . . . . . .
Logrec データ・セットのタイム・スタンプ・レコード. . . . . . . .
Logrec エラー・レコードのタイプ . . . . . . . . . . . . . . .
Logrec データ・セットからの情報の入手 . . . . . . . . . . . . .
EREP の使用 . . . . . . . . . . . . . . . . . . . . . .
Logrec ログ・ストリームからのレコードの入手 . . . . . . . . . . .
システム・ロガー・サービスを使用して Logrec ログ・ストリームからレ
コードの入手 . . . . . . . . . . . . . . . . . . . . . .
EREP を使用して Logrec ログ・ストリームからレコードの入手 . . .
Logrec 記録制御バッファーからの情報の入手 . . . . . . . . . . .
Logrec バッファーのフォーマット設定 . . . . . . . . . . . . .
Logrec および WTO 記録制御バッファーの検出 . . . . . . . . .
Logrec 記録制御バッファーの読み方 . . . . . . . . . . . . . .
ソフトウェア・レコードの解釈 . . . . . . . . . . . . . . . . .
ソフトウェア・レコードに関する詳細編集報告書 . . . . . . . . .
. 14-1
. 14-1
. 14-2
. 14-3
. 14-3
. 14-4
. 14-5
. 14-8
. 14-9
. 14-9
. 14-10
. 14-11
. 14-12
. 14-15
.
.
.
.
.
.
.
.
14-15
14-15
14-22
14-23
14-23
14-23
14-24
14-24
第 15 章 AMBLIST . . . . . . . . . . . . . . . . . . . . . . 15-1
AMBLIST 出力の入手 . . . . . . . . . . . . . . . . . . . . . . 15-2
JCL ステートメントの指定 . . . . . . . . . . . . . . . . . . . 15-2
AMBLIST 処理の制御 . . . . . . . . . . . . . . . . . . . . . 15-2
AMBLIST を実行する例 . . . . . . . . . . . . . . . . . . . . 15-7
オブジェクト・モジュールの内容のリスト . . . . . . . . . . . . . 15-7
ロード・モジュールまたはプログラム・オブジェクト内の CSECT をマップ
する . . . . . . . . . . . . . . . . . . . . . . . . . . 15-9
CSECT 内の実行可能コードの修正のトレース . . . . . . . . . . . 15-13
リンク・パック域内のモジュールと DAT-on 中核の内容をリストする
15-14
z/OS UNIX ファイル・サポートの例 . . . . . . . . . . . . . . . 15-16
AMBLIST 出力の読み方 . . . . . . . . . . . . . . . . . . . . 15-17
モジュールの要約 . . . . . . . . . . . . . . . . . . . . . . 15-17
LISTOBJ 出力 . . . . . . . . . . . . . . . . . . . . . . . 15-23
LISTLOAD OUTPUT=MODLIST 出力 . . . . . . . . . . . . . . 15-32
LISTLOAD OUTPUT=XREF 出力 . . . . . . . . . . . . . . . . 15-49
LISTLOAD OUTPUT=MAP . . . . . . . . . . . . . . . . . . 15-55
LISTLOAD OUTPUT=XREF 出力 (ロード・モジュールとプログラム・オ
ブジェクト・バージョン 1 との比較). . . . . . . . . . . . . . 15-56
LISTLOAD OUTPUT=BOTH 出力 . . . . . . . . . . . . . . . . 15-59
LISTIDR 出力 . . . . . . . . . . . . . . . . . . . . . . . 15-62
LISTLPA 出力 . . . . . . . . . . . . . . . . . . . . . . . 15-65
|
|
第 16 章 SPZAP . . . . . . . . . . . . . . . . . . . . . . . 16-1
x
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
|
|
|
|
|
|
|
|
|
SPZAP の計画 . . . . . . . . . . . . . . . . . . . . . .
データの検査と修正 . . . . . . . . . . . . . . . . . . . .
ロード・モジュールまたはプログラム・オブジェクトの検査および修正
データ・レコードの検査と修正 . . . . . . . . . . . . . . .
システム状況索引 (SSI) の更新 . . . . . . . . . . . . . . . .
SPZAP の実行 . . . . . . . . . . . . . . . . . . . . . .
SPZAP を実行するために JCL と制御ステートメントを使用する . .
. . 16-1
. . 16-2
16-3
. . 16-12
. . 16-16
. . 16-17
. . 16-19
第 17 章 AMATERSE . . . . . . . . .
AMATERSE の計画 . . . . . . . . . .
AMATERSE の起動 . . . . . . . . . .
EXEC ステートメントのパラメーター . . .
DD ステートメントについての追加情報 . .
戻りコード . . . . . . . . . . . . .
問題プログラムから AMATERSE を起動する .
制約事項. . . . . . . . . . . . . . .
割り振りの考慮事項 . . . . . . . . . .
スペースの考慮事項 . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
第 18 章 ダンプの抑制 . . . . . . . . . . . . . . . . . . .
DAE を使用してダンプを抑制. . . . . . . . . . . . . . . . .
ダンプ抑制の実行 . . . . . . . . . . . . . . . . . . . .
DAE ダンプ抑制の計画 . . . . . . . . . . . . . . . . . .
DAE データ・セットのアクセス . . . . . . . . . . . . . . .
DAE の停止、開始、および変更 . . . . . . . . . . . . . .
シスプレックス内の DAE 処理の変更 . . . . . . . . . . . .
ダンプを抑制するために SLIP コマンドを使用する . . . . . . . .
ダンプを抑制するために ABEND マクロを使用する . . . . . . . .
ダンプを抑制するためにインストール・システム出口ルーチンを使用する
ダンプが抑制される理由の判別 . . . . . . . . . . . . . . . .
.
.
.
.
.
. 18-1
. 18-1
. 18-2
. 18-6
. 18-9
. 18-12
. 18-12
. 18-12
. 18-13
18-13
. 18-14
第 19 章 メッセージ . . . . . . . .
メッセージの生成 . . . . . . . . .
メッセージの受取り . . . . . . . .
コンソール . . . . . . . . . . .
症状ダンプの受取り . . . . . . .
診断を目的としたメッセージ処理の計画 .
メッセージ位置の制御. . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
17-1
17-1
17-1
17-2
17-2
17-3
17-3
17-4
17-5
17-5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
19-1
19-1
19-2
19-2
19-3
19-4
19-4
付録. アクセシビリティー . . . . . . . . . . . . .
支援機能の使用 . . . . . . . . . . . . . . . . .
ユーザー・インターフェースのキーボード・ナビゲーション.
z/OS 情報 . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
A-1
A-1
A-1
A-1
特記事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
プログラミング・インターフェース情報 . . . . . . . . . . . . . . . B-2
商標 . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
索引
. . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1
目次
xi
xii
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
図
2-1.
2-2.
2-3.
2-4.
2-5.
2-6.
2-7.
2-8.
2-9.
2-10.
2-11.
3-1.
4-1.
4-2.
4-3.
4-4.
4-5.
8-1.
10-1.
10-2.
10-3.
10-4.
10-5.
10-6.
10-7.
11-1.
11-2.
11-3.
11-4.
11-5.
11-6.
11-7.
11-8.
11-9.
11-10.
13-1.
14-1.
14-2.
15-1.
15-2.
15-3.
15-4.
15-5.
15-6.
15-7.
15-8.
自動的に割り振られたダンプ・データ・セットのデフォルトの名前パターン . . . . . . . 2-5
STATUS WORKSHEET サブコマンドの出力例 - ダンプの表題 . . . . . . . . . . . . 2-45
STATUS SYSTEM サブコマンドからの出力例 . . . . . . . . . . . . . . . . . . 2-46
STATUS FAILDATA 報告書の検索引き数の要約 . . . . . . . . . . . . . . . . . 2-47
STATUS FAILDATA 報告書のシステム・モード情報. . . . . . . . . . . . . . . . 2-48
STATUS FAILDATA 報告書のエラー情報の時刻 . . . . . . . . . . . . . . . . . 2-49
SUMMARY TCBERROR 報告書の例 . . . . . . . . . . . . . . . . . . . . . . 2-50
VERBEXIT LOGDATA サブコマンドからの出力例 . . . . . . . . . . . . . . . . 2-52
IPCS サブコマンド SYSTRACE からの出力の例 . . . . . . . . . . . . . . . . . 2-54
STATUS REGISTERS 報告書の例 . . . . . . . . . . . . . . . . . . . . . . . 2-55
z/Architecture モードで実行した STATUS REGISTERS 報告書の例 . . . . . . . . . . 2-56
自動的に割り振られたダンプ・データ・セットの SPFUSER の名前パターン . . . . . . . 3-4
AMDSADMP マクロ命令のフォーマット . . . . . . . . . . . . . . . . . . . . 4-13
スタンドアロン・ダンプ・プログラムからのコンソール出力サンプル. . . . . . . . . . 4-22
AMDSADDD を使用してダンプ・データ・セットを割り振り初期設定する . . . . . . . . 4-32
AMDSADDD を使用して既存のダンプ・データ・セットをクリアする . . . . . . . . . 4-33
AMDSADDD を使用してダンプ・データ・セットを再割り振りする . . . . . . . . . . 4-33
SVC ダンプ内のシステム・トレースの例 . . . . . . . . . . . . . . . . . . . . 8-5
IBM 提供の GTF カタログ式プロシージャー . . . . . . . . . . . . . . . . . . 10-4
GTF 必要記憶容量 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-13
GTF トレース・オプションおよび関連トレース・レコード ID . . . . . . . . . . . . 10-45
不定形式制御レコード . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-95
不定様式の消失イベント・レコード . . . . . . . . . . . . . . . . . . . . . . 10-96
不定様式ユーザー・トレース・レコードのフォーマット . . . . . . . . . . . . . . 10-98
不定様式システム・トレース・レコード・フォーマットのヘッダー . . . . . . . . . . 10-99
SYSAPPC コンポーネント・トレース・オプションの階層 . . . . . . . . . . . . . 11-33
CTRACE COMP(SYSOMVS) でフォーマット設定された SYSOMVS コンポーネント・トレ
ース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-112
SY1 トレース・フロー: パート 1 . . . . . . . . . . . . . . . . . . . . . . 11-114
SY1 トレース・フロー: パート 2 . . . . . . . . . . . . . . . . . . . . . . 11-114
SY2 トレース・フロー: パート 1 . . . . . . . . . . . . . . . . . . . . . . 11-115
SY2 トレース・フロー: パート 2 . . . . . . . . . . . . . . . . . . . . . . 11-116
制御ブロック・トレースの出力 . . . . . . . . . . . . . . . . . . . . . . . 11-116
SYSCALL の発生回数を表示する SCCOUNT 機能 . . . . . . . . . . . . . . . . 11-117
機能コードの発生回数を表示する SCCOUNT 機能 . . . . . . . . . . . . . . . . 11-117
SYSXES SUB トレースの構造 . . . . . . . . . . . . . . . . . . . . . . . 11-165
GFS トレース出力のレイアウト . . . . . . . . . . . . . . . . . . . . . . . 13-5
Logrec エラー記録の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . 14-1
ログ・ストリーム SUBSYS データ・セットの仕様 . . . . . . . . . . . . . . . . 14-15
リンケージ・エディターが処理するロード・モジュールのモジュールの要約例 . . . . . . 15-17
バインダーが処理するプログラム・オブジェクトのモジュールの要約例 . . . . . . . . 15-18
オブジェクト・モジュール付きの LISTOBJ 出力例 . . . . . . . . . . . . . . . . 15-23
XSD レコード付きの LISTOBJ 出力例 . . . . . . . . . . . . . . . . . . . . 15-23
GOFF レコード付きの LISTOBJ 出力例 . . . . . . . . . . . . . . . . . . . . 15-24
GOFF に関する LISTOBJ フォーマット . . . . . . . . . . . . . . . . . . . . 15-26
プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力
例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-32
オーバーレイ構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST の出力例
15-39
© Copyright IBM Corp. 1988, 2008
xiii
15-9.
15-10.
15-11.
15-12.
15-13.
15-14.
| 15-15.
15-16.
15-17.
15-18.
16-1.
16-2.
16-3.
16-4.
16-5.
16-6.
16-7.
16-8.
| 17-1.
| 17-2.
xiv
通常の (オーバーレイでない) 構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST
の出力例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-42
PDSE (プログラム・オブジェクトのバージョン 1) に関する LISTLOAD
OUTPUT=MODLIST 出力の例 . . . . . . . . . . . . . . . . . . . . . . . . 15-43
B_PRV および B_TEXT クラス名のプログラム・オブジェクトに関する LISTLOAD
OUTPUT=XREF の出力例 . . . . . . . . . . . . . . . . . . . . . . . . . 15-50
LISTLOAD OUTPUT=XREF のセグメント・マップ・テーブルのサンプル . . . . . . . 15-55
ロード・モジュールの LISTLOAD OUTPUT=XREF の出力例 . . . . . . . . . . . . 15-56
プログラム・オブジェクトの LISTLOAD OUTPUT=XREF の出力例. . . . . . . . . . 15-57
PDSE 用の LISTLOAD OUTPUT=BOTH についての出力例 . . . . . . . . . . . . . 15-59
リンケージ・エディターまたはバインダーが処理したロード・モジュールについての
LISTIDR 出力例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-62
バインダーが処理したプログラム・オブジェクトについての LISTIDR 出力例 . . . . . . 15-63
LISTLPA 出力例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-65
複数の制御セクションを示すアセンブリー・リストの例 . . . . . . . . . . . . . . 16-12
ロード・モジュール・ディレクトリー項目内の SSI バイト . . . . . . . . . . . . . 16-16
システム状況索引フィールド内のフラグ・バイト . . . . . . . . . . . . . . . . . 16-17
SPZAP の動的呼び出しのサンプル・アセンブラー・コード . . . . . . . . . . . . . 16-22
フォーマット設定された 16 進ダンプの例 . . . . . . . . . . . . . . . . . . . 16-36
変換されたダンプの例 . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-36
PDSE プログラム・オブジェクト・モジュールについてフォーマット設定された 16 進ダン
プの例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-38
PDSE データ・ライブラリーの変換されたダンプの例 . . . . . . . . . . . . . . . 16-39
AMATERSE JCL の例 . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2
AMATERSE のパラメーター . . . . . . . . . . . . . . . . . . . . . . . . . 17-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
表
1-1.
1-2.
1-3.
1-4.
1-5.
1-6.
2-1.
2-2.
2-3.
2-4.
3-1.
3-2.
4-1.
4-2.
8-1.
10-1.
10-2.
10-3.
10-4.
10-5.
11-1.
11-2.
15-1.
ダンプの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
トレースの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
保守援助プログラムの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
ダンプの説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
トレースの説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
保守援助プログラムの説明 . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
SYS1.SAMPLIB にあるサンプルのオペレーター DUMP コマンド・メンバー . . . . . . . 2-17
SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ . . . . . . . . . . 2-26
要約ダンプによる SVC ダンプ内容のカスタマイズ . . . . . . . . . . . . . . . . 2-32
オペレーター・コマンドを使用して SVC ダンプの内容をカスタマイズする . . . . . . . 2-35
SDATA パラメーターによるトランザクション・ダンプの内容のカスタマイズ . . . . . . . 3-7
オペレーター・コマンドを使用してトランザクション・ダンプの内容をカスタマイズする
3-11
AMDSAOSG が使用する DDNAMES とデフォルト値 . . . . . . . . . . . . . . . 4-35
AMDSAOSG 戻りコード . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
システム・トレース項目のフォーマットの説明への参照 . . . . . . . . . . . . . . . 8-5
GTF オプションの組み合わせ . . . . . . . . . . . . . . . . . . . . . . . . 10-30
GTF トレース・オプションおよび対応するプロンプト・キーワード . . . . . . . . . . 10-31
選択された TRACE オプションに対応する CCW のデフォルト . . . . . . . . . . . 10-33
イベント ID とそれによって表されるイベントのタイプ . . . . . . . . . . . . . . 10-37
CCW エラー・コード . . . . . . . . . . . . . . . . . . . . . . . . . . 10-105
SYSAPPC コンポーネント・トレースの FMH-5 トレース項目 . . . . . . . . . . . . 11-43
SYSLOGR コンポーネント・トレース要求の要約. . . . . . . . . . . . . . . . . 11-97
プログラム・オブジェクトとロード・モジュール属性 . . . . . . . . . . . . . . . 15-19
© Copyright IBM Corp. 1988, 2008
xv
xvi
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
本書について
本書では、MVS™ で生じる問題について診断する際に使用する IBM® が提供するツ
ールと保守援助プログラムについて説明しています。この版は、z/OS® (5694-A01)
をサポートしています。
まず、 1-1 ページの『第 1 章 ツールと保守援助プログラムの選択』では、ユーザ
ーの目的に沿ったツールと保守援助プログラムの選択方法についての指針を説明し
ます。また、使用できるすべてのツールと保守援助プログラムの概要も説明しま
す。
以降の各章では、それぞれのツールと保守援助プログラムについて説明します。各
章の内容は変わりますが、次の項目についてはそれぞれのツールと保守援助プログ
ラムごとに説明します。
v カスタマイズと計画情報
v ツールと保守援助プログラムの開始と停止
v ツールまたは保守援助プログラムの出力の受け取り、フォーマット設定、および
読み取り
各章の冒頭には、その章で説明するツールと保守援助プログラムの特徴を示す簡単
なコメントがあります。
本書の対象読者
本書はオペレーティング・システムの実行中に生じるソフトウェア問題を診断する
担当者を対象としています。通常はインストール・システムのシステム・プログラ
マーです。また、プログラムをテストしているアプリケーション・プログラマーも
対象になります。
本書の前提条件は次のとおりです。
v 基本的なシステム概念とシステム・サービスの使用法を理解している
v アセンブラー言語をコーディングし、アセンブラーとリンケージ・エディター出
力を読み取ることができる
v バッチ・ジョブとカタログ式プロシージャーの JCL ステートメントをコーディン
グできる
v メッセージ・ログ、ダンプ、および対話式問題制御システム (IPCS) などの通常
使用される診断タスクと援助機能を理解している
v 問題報告データベースの検索方法を理解している
v IBM に問題報告する手法を理解している
その他の関連資料
本書では、必要に応じて、他の資料中の情報を参照する場合があります。他の資料
を参照する場合は、略式の資料名を使用します。z/OS を構成する全プロダクトに関
する資料の正式の資料名および資料番号については、「z/OS 情報ロードマップ」を
参照してください。
© Copyright IBM Corp. 1988, 2008
xvii
Web 上での情報更新
z/OS についての最新更新情報は、次のサイトから PTF カバー・レターと APAR
文書で入手できます。
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/ZIDOCMST/CCONTENTS.
この資料は毎週更新され、資料に対する変更が z/OS 関連の出版物に反映される前
にここにリストされます。
xviii
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
変更の要約
変更の要約
GA88-8561-09 (英文原典: GA22-7589-12)
z/OS バージョン 1 リリース 9
2008 年 4 月に更新
本書には、z/OS バージョン 1 リリース 9 をサポートする z/OS MVS 診断: ツール
と保守援助プログラム、GA88-8561-08 (英文原典: GA22-7589-11) に記載されていた
情報も含まれています。
変更情報
v
17-4 ページの『制約事項』では、AMATERSE が拡張区分データ・セット
(PDSE) をサポートするように変更されました。
本書には、用語、細かな修正、および編集上の変更が含まれています。本文または
図表に対して技術的な変更または追加が行われている場合には、その個所の左側に
縦線を引いて示してあります。
変更の要約
GA88-8561-08 (英文原典: GA22-7589-11)
z/OS バージョン 1 リリース 9
本書には、z/OS バージョン 1 リリース 8 をサポートする z/OS MVS 診断: ツール
と保守援助プログラム、GA88-8561-07 (英文原典: GA22-7589-10) に記載されていた
情報も含まれています。
新規情報
v
2-1 ページの『第 2 章 SVC ダンプ』で、サンプル DUMP コマンド parmlib メ
ンバーが、SYS1.SAMPLIB にあります。
v
8-1 ページの『第 8 章 システム・トレース』に、新しい SSRV 項目 ID:
ENQ、DEQ および SYSCALL があります。
v
15-1 ページの『第 15 章 AMBLIST』に、 LISTLOAD の更新があります。
v
2-1 ページの『第 2 章 SVC ダンプ』で、DAE レコードの経時が 60 日 (以前は
180 日) になりました。
v
8-1 ページの『第 8 章 システム・トレース』には、TRACE ST オペレーター・
コマンドに関する以下の新情報があります。
– TRACE ST,BUFSIZE コマンドで、システム・トレース・テーブルの合計サイ
ズを変更できます。
– 分岐トレースとモード・トレースの指定が分離されています。
v
17-1 ページの『第 17 章 AMATERSE』は、診断データ・セットの圧縮イメージ
を作成する保守援助プログラムです。データ・セットのコピーを別のサイトに送
信する場合、AMATERSE を使用して圧縮し、補完的な解凍サービスを使用して
受信サイトで同様のデータ・セットを作成することができます。
v 新しいコンポーネント・トレースが説明されています。 11-47 ページの
『SYSAXR コンポーネント・トレース』を参照してください。
© Copyright IBM Corp. 1988, 2008
xix
変更情報
本書には、用語、細かな修正、および編集上の変更が含まれています。本文または
図表に対して技術的な変更または追加が行われている場合には、その個所の左側に
縦線を引いて示してあります。
変更の要約
GA88-8561-07 (英文原典: GA22-7589-10)
z/OS バージョン 1 リリース 8
本書には、z/OS バージョン 1 リリース 7 をサポートする z/OS MVS 診断: ツール
と保守援助プログラム、GA88-8561-06 (英文原典: GA22-7589-09) に記載されていた
情報も含まれています。
新規情報
v AMDSADMP マクロからの新しい MNOTE。 4-59 ページの『メッセージ出力』
を参照してください。
変更情報
本書には、用語、細かな修正、および編集上の変更が含まれています。本文または
図表に対して技術的な変更または追加が行われている場合には、その個所の左側に
縦線を引いて示してあります。
変更の要約
GA88-8561-06 (英文原典: GA22-7589-09)
z/OS バージョン 1 リリース 7
2006 年 4 月に更新
本書には、z/OS バージョン 1 リリース 7 をサポートする z/OS MVS 診断: ツール
と保守援助プログラム、GA22-7589-08 (英文のみ) に記載されていた情報も含まれて
います。
変更情報
v
4-1 ページの『第 4 章 スタンドアロン・ダンプ』には、新規情報と変更情報が
記載されています。
本書には、整合性や検索の容易性を高めるための、用語、細かな修正、および編集
上の変更が含まれています。
変更の要約
GA22-7589-08 (英文のみ)
z/OS バージョン 1 リリース 7
本書には、z/OS バージョン 1 リリース 6 をサポートする z/OS MVS 診断: ツール
と保守援助プログラム、GA88-8561-05 (英文原典: GA22-7589-07) に記載されていた
情報も含まれています。
新規情報
v
xx
3-2 ページの『トランザクション・ダンプのデータ・セット管理の計画』につい
て、新規情報が追加されています。
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
v ダンプをデータ・セットにコピーする推奨方式が変更されました。 4-6 ページの
『ダンプをデータ・セットにコピーするために IEBGENER または COPYDUMP
サブコマンドを使用すべきか』を参照してください。
v
8-1 ページの『第 8 章 システム・トレース』に、トレース項目を作成する CP
を指定する新規フィールドが新たに追加されました。
v
10-52 ページの『CCW トレース・レコード』には、変更間接アドレス・ワード機
能についての新規情報が追加されました。
v
10-105 ページの『CCW エラー・コード』が追加されました。
v 以下についての新規勧告が使用できます。
–
11-98 ページの『システム・ロガー情報のダンプの入手』
–
11-101 ページの『SYSLOGR トレースの要求』
v 新しい例、 11-116 ページの『制御ブロック・トレース』が追加されました。
v
14-24 ページの『ソフトウェア・レコードに関する詳細編集報告書』には、新し
い情報が記載されています。
変更情報
v
10-4 ページの『IBM 提供のカタログ式プロシージャー』には、更新情報があり
ます。
v
10-6 ページの『カタログ式プロシージャーの設定』には、更新情報があります。
v 更新された GTF トレース・オプションおよび対応するプロンプト・キーワード
が使用可能になりました。 10-31 ページの表 10-2 を参照してください。
v
10-48 ページの『定様式 GTF トレース出力の例』には、更新情報があります。
v 以下のトレース・レコードが更新されています。
–
10-71 ページの『RSCH トレース・レコード』
–
10-91 ページの『XSCH トレース・レコード』
–
10-67 ページの『MSCH トレース・レコード』
v OpenEdition に対する参照が、z/OS UNIX システム・サービスまたは z/OS UNIX
で置き換えられました。
本書には、整合性や検索の容易性を高めるための、用語、細かな修正、および編集
上の変更が含まれています。
変更の要約
xxi
xxii
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 1 章 ツールと保守援助プログラムの選択
このトピックでは、MVS が診断のために提供しているツールと保守援助プログラム
を紹介します。本書では、ツールにはダンプとトレースを含み、保守援助プログラ
ムには診断のためのその他の機能が含まれます。たとえば、
v SVC ダンプとシステム・トレースはツールです。
v Logrec データ・セットと AMBLIST は保守援助プログラムです。
主要トピック
主要なトピックは 2 つあります。
v 『ツールと保守援助プログラムを選択する方法』 - この項目では、問題のタイプ
をリストし、それらを該当する保守援助プログラムまたは該当ツールと対応させ
ます。このトピックを使用して、特定の問題用に必要なツールまたは保守援助プ
ログラムを選択してください。
v
1-3 ページの『使用できるツールと保守援助プログラム』 - この項目では、各ツ
ールと保守援助プログラムについて、診断用にいつ使用するかを含め説明してい
ます。使用できるツールと保守援助プログラムの概要を知りたい場合、または特
定のツールまたは保守援助プログラムを使用するのに適した時を知りたい場合に
このトピックを使用します。
ツールと保守援助プログラムを選択する方法
ここでは、問題または必要性が生じた状況に応じて、ツールまたは保守援助プログ
ラムを選択するための基準を記載します。以下の 3 つの表があります。
v ダンプの選択、表 1-1
v トレースの選択、 1-2 ページの表 1-2
v 保守援助プログラムの選択、 1-2 ページの表 1-3
これらの表には、問題または必要性が生じた状況、それに対応するツールまたは保
守援助プログラム、およびそれらを詳細に説明しているトピックまたは資料を示し
ます。(ツールと保守援助プログラムについての詳しい情報のほとんどは本書に記載
されています。) ツールまたは保守援助プログラムを素早く検出するためにこの表
を使用してください。
表 1-1. ダンプの選択
問題または必要性が生じた状況
使用するダンプのタイプ
許可プログラムまたは問題プログラムの異常終了
ABEND ダンプ
詳細は 5-1 ページの『第 5 章 ABEND ダンプ』を参
照。
問題プログラムの実行中のテスト
SNAP ダンプ
詳細は 6-1 ページの『第 6 章 SNAP ダンプ』を参照。
システムが処理を停止した場合、またはスローダウンまた スタンドアロン・ダンプ
はループによりオペレーターがシステムを停止した場合の
詳細は 4-1 ページの『第 4 章 スタンドアロン・ダン
システム問題
プ』を参照。
© Copyright IBM Corp. 1988, 2008
1-1
ツールと保守援助プログラムの選択
表 1-1. ダンプの選択 (続き)
問題または必要性が生じた状況
使用するダンプのタイプ
システムが処理を続行する時のシステムの問題
SVC ダンプ
詳細は 2-1 ページの『第 2 章 SVC ダンプ』を参照。
表 1-2. トレースの選択
問題または必要性が生じた状況
使用するトレースのタイプ
システムの問題: 診断にはコンポーネントのイベントの検 コンポーネント・トレース
査が必要
詳細は 11-1 ページの『第 11 章 コンポーネント・トレ
ース』を参照。
システムの問題: 診断には 1 つか 2 つのシステム・イベ 汎用トレース機能 (GTF) トレース
ントの詳細な検査が必要
詳細は 10-1 ページの『第 10 章 汎用トレース機能
(GTF)』を参照。
システムまたは許可プログラムの問題: 診断にはダンプと マスター・トレース
関連するメッセージが必要
詳細は 9-1 ページの『第 9 章 マスター・トレース』を
参照。
システムの問題: 診断にはさまざまなシステム・イベント システム・トレース
の検査が必要
詳細は 8-1 ページの『第 8 章 システム・トレース』を
参照。
システムまたは問題プログラム: 診断には仮想記憶域の割 GETMAIN、FREEMAIN、STORAGE (GFS) トレース
り振り情報が必要
詳細は 13-1 ページの『第 13 章 GETMAIN、
FREEMAIN、 STORAGE (GFS) トレース』を参照。
表 1-3. 保守援助プログラムの選択
問題または必要性が生じた状況
使用する保守援助プログラムのタイプ
システムまたはハードウェア障害: 診断用の開始点が必要 Logrec データ・セット
か、または診断に発生順のシステムまたはハードウェア・
詳細は 14-1 ページの『第 14 章 Logrec エラー・レコー
イベントの概要が必要な場合。
ドの記録』を参照。
ロード・モジュールおよびプログラム・オブジェクトまた AMBLIST
はシステムのモジュールでの問題の内容についての情報。
詳細は 15-1 ページの『第 15 章 AMBLIST』を参照。
診断には、プログラム・エラーの固定、SLIP トラップ一 SPZAP
致の挿入、またはコンポーネント・トレースを開始するた
詳細は 16-1 ページの『第 16 章 SPZAP』を参照。
めにプログラムの変更などのプログラムの動的変更が必
要。
|
|
|
|
診断資料を別のサイトへ送信するために圧縮し、受信サイ AMATERSE
トで同様のデータ・セットを作成することが必要。
詳細は、 17-1 ページの『第 17 章 AMATERSE』を参
照。
重複または不要のダンプ除去が必要。
DAE
詳細は、 18-1 ページの『第 18 章 ダンプの抑制』を参
照。
1-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ツールと保守援助プログラムの選択
表 1-3. 保守援助プログラムの選択 (続き)
問題または必要性が生じた状況
使用する保守援助プログラムのタイプ
診断にはプログラム実行中に、問題データを取得するため SLIP
のトラップが必要。
詳細は「z/OS MVS システム・コマンド」を参照。
診断にはダンプまたはトレースなどの問題データのフォー IPCS
マット設定出力が必要。
詳細は「z/OS MVS IPCS ユーザーズ・ガイド」を参照。
使用できるツールと保守援助プログラム
この項目では、ツールと保守援助プログラムの概要をさらに詳しく説明します。表
には、各ツールまたは保守援助プログラムの簡単な説明、使用する理由、およびツ
ールまたは保守援助プログラムを詳細に説明しているトピックまたは資料の参照が
続きます。(ツールと保守援助プログラムについての詳しい情報のほとんどは本書に
記載されています。) ツールと保守援助プログラムは 3 つの表に記載されていま
す。
v ダンプの説明、表 1-4。
v トレースの説明、 1-5 ページの表 1-5。
v 保守援助プログラムの説明、 1-6 ページの表 1-6。
以下の表では、ダンプ、トレース、または保守援助プログラムが使用頻度順にリス
トされています。
ダンプ
表 1-4. ダンプの説明
ダンプのタイプ
説明
ABEND ダンプ
許可プログラムまたは問題プログラムが訂正不能エラーで終了した場合に ABEND ダ
ンプを使用します。これらのダンプには次のものが出力されます。
v ダンプを要求したプログラムの仮想記憶域。
v プログラムに関連したシステム・データ。
システムは 3 種類の ABEND ダンプ (SYSABEND、SYSMDUMP、および
SYSUDUMP) を生成します。それぞれが別のエリアをダンプします。問題を診断する
のに必要なエリアを与えるダンプを選択してください。各ダンプについての IBM が提
供しているデフォルトの値は次のとおりです。
v SYSABEND ダンプ - 最大の ABEND ダンプで、障害を起こしたプログラムの要約
ダンプと、そのプログラムの処理を解析するのに役立つその他のエリアが含まれま
す。
v SYSMDUMP ダンプ - 障害を起こしたプログラムの要約ダンプと、障害を起こした
タスクのいくつかのシステム・データを含んでいます。SYSMDUMP ダンプだけ
が、IPCS を使用してフォーマット設定することができる ABEND ダンプです。
v SYSUDUMP ダンプ - ABEND ダンプの最小のものであり、障害を起こしたプログ
ラムについてのデータとエリアのみを含みます。
参照: 詳細は、 5-1 ページの『第 5 章 ABEND ダンプ』を参照してください。
第 1 章 ツールと保守援助プログラムの選択
1-3
ツールと保守援助プログラムの選択
表 1-4. ダンプの説明 (続き)
ダンプのタイプ
説明
SNAP ダンプ
問題プログラムをテストする時に SNAP ダンプを使用します。SNAP ダンプは、プロ
グラムが、実行中にシステムにダンプを要求した場合に、仮想記憶域の 1 つまたは複
数のエリアを表示します。一連の SNAP ダンプを使用して、プログラマーが計算の中
間ステップを調べるために 1 つまたは複数のフィールドを繰り返してダンプさせ、プ
ログラムの処理を示すための異なる段階におけるエリアを示すことができます。SNAP
ダンプは事前にフォーマット設定されており、IPCS を使用してそれらをフォーマット
設定することはできません。
SNAP ダンプは、異常終了中ではなくプログラム実行中に書き出されることに注意して
ください。
参照: 詳細は、 6-1 ページの『第 6 章 SNAP ダンプ』を参照してください。
スタンドアロン・ダンプ
次の場合にスタンドアロン・ダンプを使用します。
v システムが処理を停止した。
v 待ち状態コードがある、または待ち状態コードなしで、システムが待ち状態に入っ
た。
v システムが命令ループに入った。
v システムの処理が遅い。
これらのダンプは、障害を起こしたシステムまたはスタンドアロン・ダンプ・プログラ
ムが占める中央記憶装置およびいくつかのページアウトされた仮想記憶域を示します。
スタンドアロン・ダンプは IPCS を使用して解析することができます。
参照: 詳細は、 4-1 ページの『第 4 章 スタンドアロン・ダンプ』を参照してくださ
い。
SVC ダンプ
SVC ダンプは 2 つの異なる方法で使用することができます。
v 一般に、予期していないシステム・エラーが生じたがシステムは処理を継続できる場
合に、システム・コンポーネントは SVC ダンプを要求します。
v 許可プログラムまたはオペレーターが、問題を解決するために診断データが必要な場
合にも、SVC ダンプを要求することができます。
SVC ダンプは要約ダンプ、制御ブロックとその他のシステム・コードを含みますが、
ダンプされる正確なエリアはダンプがマクロ、コマンド、または SLIP トラップのいず
れによって要求されたかによって異なります。SVC ダンプは IPCS を使用して解析す
ることができます。
参照: 詳細は、 2-1 ページの『第 2 章 SVC ダンプ』を参照してください。
1-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ツールと保守援助プログラムの選択
トレース
表 1-5. トレースの説明
トレース
説明
コンポーネント・トレース
IBM サポートに MVS コンポーネントの問題を報告するためにトレース・データが必
要な場合に、コンポーネント・トレースを使用します。コンポーネント・トレースは
MVS コンポーネント内の処理を示します。通常は、問題を再生中にコンポーネント・
トレースを使用します。
インストール・システムでは、IBM サポートからの指示に従って、コンポーネントに
ついてどのイベントをトレースするかを制御します。
参照: 詳細は、 11-1 ページの『第 11 章 コンポーネント・トレース』を参照してくだ
さい。
GFS トレース
GFS トレースを使用して、GETMAIN、FREEMAIN、および STORAGE マクロから仮
想記憶域へ出された要求についての情報を収集します。
参照: 詳細は、 13-1 ページの『第 13 章 GETMAIN、 FREEMAIN、 STORAGE (GFS)
トレース』を参照してください。
GTF トレース
GTF トレースを使用して、システム稼動時間内に発生したイベント間のシステム処理
を示します。どのイベントをトレースするかは、インストール・システムで制御しま
す。
GTF トレースはシステム・トレースよりも多くのリソースとプロセッサー時間を使用
します。問題に十分通じていて、ユーザー・システムの問題を診断するために必要な 1
つまたは 2 つのイベントを正確に指摘することができる場合に、GTF を使用してくだ
さい。GTF はバッファーばかりではなく外部データ・セットについても実行すること
ができます。
参照: 詳細は、 10-1 ページの『第 10 章 汎用トレース機能 (GTF)』を参照してくださ
い。
マスター・トレース
マスター・トレースを使用してマスター・コンソールとのメッセージのやり取りを出力
します。マスター・トレースは、最新の発行メッセージのログを提供するので役立ちま
す。これらは、ユーザーの問題にとって、ダンプとともに示されたメッセージよりも適
切な場合があります。
参照: 詳細は、 9-1 ページの『第 9 章 マスター・トレース』を参照してください。
システム・トレース
システム・トレースを使用して、システム処理中に発生したイベントを通してシステム
がどう処理しているかを調べます。システム・トレースは初期設定時に活動化され、通
常はそのまま実行します。多くのシステム・イベントを、最小の詳細とともに記録しま
す。分岐トレース以外のイベント・トレースは、事前に決めておきます。
このトレースは GTF トレースよりも必要リソースが少なく、より迅速です。
参照: 詳細は、 8-1 ページの『第 8 章 システム・トレース』を参照してください。
第 1 章 ツールと保守援助プログラムの選択
1-5
ツールと保守援助プログラムの選択
保守援助プログラム
表 1-6. 保守援助プログラムの説明
|
|
|
|
保守援助プログラム
説明
AMATERSE
AMATERSE 保守援助プログラムを使用して、診断データ・セットの圧縮イメージを作
成します。圧縮イメージは資料を保持しつつ使用スペースは少ないので、たとえば
IBM サポートへ資料を送る場合など、あるサイトから別のサイトへ資料を送信する準
備をするのに役立ちます。
AMBLIST
ロード・モジュールとプログラム・オブジェクトの内容についての情報が必要な場合、
またはシステムのモジュールに関連した問題がある場合は、AMBLIST を使用してくだ
さい。AMBLIST は、システム内のモジュールについてのさまざまなデータを提供する
プログラムです。たとえば、ロード・モジュールのリスト、ロード・モジュールまたは
プログラム・オブジェクト内の CSECT のマップ、CSECT 内の修正のリスト、LPA
(link pack area) 内のモジュールのマップ、および DAT-on 中核の内容のマップです。
参照: 詳細は、 15-1 ページの『第 15 章 AMBLIST』を参照してください。
共通ストレージ・トレース
共通ストレージ・トレースを使用して、CSA、ECSA、SQA、および ESQA 内のスト
レージの獲得または解放の要求に関するデータをトレースします。この機能は、膨大な
量の共通ストレージを使用している、またはストレージを解放せず終了しているジョブ
またはアドレス・スペースを識別するのに役立ちます。
RMF™ または IPCS VERBEXIT VSMDATA サブコマンドを使用して、共通ストレー
ジ・トレース・データを表示します。
参照:
v 共通ストレージ・トレースを要求する場合の詳細は、「z/OS MVS 初期設定およびチ
ューニング ガイド」を参照してください。
v IPCS VERBEXIT VSMDATA サブコマンドについての情報は、「z/OS MVS 診断:
解説書 」を参照してください。
ダンプ分析重複回避機能 (DAE) を使用して、重複または不要なダンプを除去します。
この結果システム・リソースを節約し、システム・パフォーマンスを向上させることが
できます。
DAE
参照: 詳細は、 18-1 ページの『第 18 章 ダンプの抑制』を参照してください。
ダンプ、トレース、およびその他のデータをフォーマット設定し解析する場合は、
IPCS を使用します。IPCS は、問題を診断する助けとなる報告書を生成します。SNAP
および SYSABEND および SYSUDUMP ABEND ダンプなどのいくつかのダンプは、
事前設定されており、IPCS を使用してフォーマット設定することはできません。
IPCS
参照: 詳細は、z/OS MVS IPCS ユーザーズ・ガイドを参照してください。
Logrec データ・セット
問題判別の開始点として Logrec データ・セットを使用します。システムはハードウェ
ア・エラー、選択したソフトウェア・エラー、および選択したシステム条件を Logrec
データ・セット内に記録します。Logrec 情報を使用すると、問題を探す場所について
の情報が得られ、障害についての症状データが提供され、エラーが発生した時の命令が
示されます。
参照: 詳細は、 14-1 ページの『第 14 章 Logrec エラー・レコードの記録』を参照して
ください。
1-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ツールと保守援助プログラムの選択
表 1-6. 保守援助プログラムの説明 (続き)
保守援助プログラム
説明
シリアル・ライン・インター 保守容易性レベル識別処理 (SLIP) を使用して、問題データを取得するようにトラップ
ネット・プロトコル (SLIP) を設定します。SLIP は、プログラム・イベント記録 (PER) またはエラー・イベントを
代行受信します。トラップと一致するイベントが発生した場合、SLIP は、ユーザーが
トラップ
指定した問題判別処理を実行します。
v ダンプの要求あるいは抑制。
v トレースまたは Logrec データ・セット・レコードの書き出し。
v リカバリー・ルーチンに制御を与える。
v システムを待ち状態にする。
参照: 詳細については、z/OS MVS システム・コマンド 内の SLIP コマンドを参照し
てください。
SPZAP
SPZAP 保守援助プログラムを使用して、プログラムとデータ・セットを動的に更新ま
たは保守します。問題判別の場合は、次の目的で SPZAP を使用することができます。
v ロード・モジュール、または区分データ・セット (PDS) 内のメンバーのいくつかの
命令を置換してプログラム・エラーを修正します。
v プログラム内に正しくない命令を挿入して、強制的に ABEND を行ったり、または
SLIP トラップ作業を行います。
v ロード・モジュール内の命令を変更して、コンポーネント・トレースを開始します。
v 直接アクセス装置上のデータを直接に置換して、ボリューム目録 (VTOC) を再構成
したり、または入出力 (I/O) エラーまたはプログラム・エラーで損害を負ったデー
タ・レコードを再構成します。
参照: 詳細は、 16-1 ページの『第 16 章 SPZAP』を参照してください。
第 1 章 ツールと保守援助プログラムの選択
1-7
ツールと保守援助プログラムの選択
1-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 2 章 SVC ダンプ
SVC ダンプは、エラーが発生した時点の、システムの仮想記憶域の内容を示しま
す。予測されないエラーが発生すると、一般にシステム・コンポーネントはリカバ
リー・ルーチンからダンプを要求します。ただし、問題の解決に診断ダンプ・デー
タが必要な場合に、許可プログラムまたはオペレーターが SVC ダンプを要求する
こともできます。
SVC ダンプは、その要求方法によって次の 2 つのタイプに分かれます。要求され
たダンプのタイプによって、その内容が決まります。
v 非同期 SVC ダンプ (スケジュールされた SVC ダンプ)
SVC ダンプ・マクロの呼び出しでは、システムが命令を発行するかまたは呼び出
し側がパラメーターの組み合わせを使用します。SVC ダンプは、1 組のデータ・
スペースにダンプ・データすべてをキャプチャーし、その後、データ・スペース
からダンプ・データ・セットにダンプ・データを書き込みます。ダンプのキャプ
チャー・フェーズの完了後、システムは別の SVC ダンプを使用できます。非同
期の SVC ダンプでは、要約ダンプ・データが最初にキャプチャーされ、診断に
非常に役立ちます。
v 同期 SVC ダンプ
要求側の SVC ダンプ・マクロ呼び出しによって現行タスクのもとでダンプを入
手するための命令が発行されます。ダンプ・データが 1 組のデータ・スペースに
いったんキャプチャーされるとシステムは要求側に制御を戻します。SVC ダンプ
処理は、その後、データ・スペースからダンプ・データ・セットにダンプ・デー
タを書き込みます。ダンプのキャプチャー・フェーズの完了後、システムは別の
SVC ダンプを使用できます。同期 SVC ダンプでは、要約ダンプ・データが最後
にキャプチャーされます。
各 SVC ダンプには、要求すると要約ダンプも含まれます。使用不能ルーチン、ロ
ックされたルーチン、または SRB モードのルーチンから要求されたダンプは、
SVC ダンプが即時に処理することができないので、システムの活動によって多くの
有益な診断情報が上書きされてしまいます。要約ダンプには、要求を出した時点に
取られた、選択したデータ・エリアのコピーが示されます。また、要約ダンプを指
定する際に、1 つのオプションを指定するだけで、多くの事前定義されたデータ・
エリアもダンプすることができます。この要約ダンプ・データは、SVC ダンプと一
緒に混在することはありません、というのは要約ダンプは発生順になっていないか
らです。その代わりに、要約ダンプで選択した各データ・エリアは別々にフォーマ
ット設定され識別されます。これらのことにより、要約ダンプ・データを要求する
ことをお勧めします。
主要トピック
ここでは、システム・プログラマーが SVC ダンプと SVC ダンプ処理について知
っておいたほうがよい情報を記載しています。
v 2-2 ページの『自動割り振りダンプ・データ・セットの使用』
v 2-7 ページの『事前割り振りダンプ・データ・セットの使用』
v 2-10 ページの『SVC ダンプ・データ・セットの選択』
© Copyright IBM Corp. 1988, 2008
2-1
SVC ダンプ
v 2-13 ページの『SVC ダンプの獲得』
v 2-23 ページの『事前割り振りデータ・セットまたは SYS1.DUMPxx データ・セ
ットの印刷、表示、コピー、およびクリア』
v 2-24 ページの『SVC ダンプの内容』
v 2-38 ページの『要約 SVC ダンプの分析』
v 2-42 ページの『SVC ダンプの分析』
参照 SVC ダンプを入手するために SDUMP または SDUMPX マクロのプログラミ
ングを行うプログラマーに必要な次のような情報については、「z/OS MVS
Programming: Authorized Assembler Services Guide 」を参照してください。
v いつ SVC ダンプを要求するかを決定する
v MVS が生成する SVC ダンプのタイプを理解する
v SVC ダンプの特定のタイプを取り扱うアプリケーション・プログラムを設計する
v ダンプを含むデータ・セットを識別する
v ダンプの内容を定義する
v ダンプ分析重複回避機能 (DAE) を使用して、重複した SVC ダンプを抑制する
SVC ダンプのデータ・セット管理の計画
SVC ダンプ処理は、システムが必要に応じて自動的に割り振ったダンプ・データ・
セット、またはユーザーが手作業で事前割り振りしたダンプ・データ・セットに、
データを保管します。可能な限り、自動的に割り振られたダンプ・データ・セット
を使用することをお勧めします。ダンプを出力するのに必要なだけのスペースが割
り振られます。ダンプは、システムが定義したブロック・サイズで出力されるた
め、出力時間が減少します。SMS 拡張属性 (圧縮およびストライピングなど) を使
用すると、さらに必要スペースと出力時間を減少できます。
IBM は、SVC ダンプのダンプ・データ・セットとして、拡張形式の順次データ・
セットを使用することをお勧めします。理由については、 2-10 ページの『SVC ダン
プ・データ・セットの選択』を参照してください。
事前割り振りダンプ・データ・セットは、システムが自動的にデータ・セットを割
り振ることができない場合に、バックアップとしてのみ使用してください。そうし
ないと、ダンプが切り捨てられ、エラー診断が難しくなります。
自動割り振りダンプ・データ・セットの使用
SVC ダンプ処理は、システムがダンプを DASD に書き出す時点に、ダンプ・デー
タ・セットの自動割り振りをサポートします。自動的に割り振られたダンプは、シ
ステムが決めたブロック・サイズを使用して書き込まれます。ダンプ・データ・セ
ットは、DUMPDS ADD コマンドに定義した VOLSER または SMS クラスによっ
ては、SMS 管理対象または非 SMS 管理対象として割り振ることができます。シス
テムがダンプをキャプチャーする時は、ユーザーが指定したリソースから正しいサ
イズのデータ・セットを割り振ります。拡張形式の順次データ・セットの DFSMS™
サポートについては 2-10 ページの『SVC ダンプ・データ・セットの選択』 を参照
してください。拡張形式の順次データ・セットを使用すると、ダンプの最大サイズ
が、非 SMS 管理データ・セットに使用可能なサイズを超えることがあります。
自動割り振りが失敗すると、事前割り振りされたダンプ・データ・セットが使用さ
れます。使用できる事前割り振り SYS1.DUMPnn データ・セットがない場合は、
2-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
IEA793A メッセージが発行され、ダンプは仮想記憶域内に残ります。SVC ダンプ
は、自動割り振りと事前割り振りダンプ・データ・セットへの書き込みの両方を、
完了するまでまたは、オペレーターの介入または IEA793A メッセージで管理して
いる CHNGDUMP MSGTIME パラメーターの満了によってキャプチャーされたダ
ンプが削除されるまで周期的に再試行します。MSGTIME 値を 0 に設定すると、シ
ステムはメッセージを出力せずに採取したダンプをすぐに削除します。
自動割り振りダンプ・データ・セットの命名
インストール・システムでは、自動割り振り機能が作成したデータ・セットの名前
の制御を行い、要求に従ってダンプ・データ・セットで使用する名前パターンを選
択することができます。名前はインストール・システムが DUMPDS コマンドで提
供するパターンを通じて判別されます。記号のセットが使用できるので、ユーザー
は自動的に割り振るダンプ・データ・セットの名前に次の種類の情報を含めること
ができます。
v システム名
v シスプレックス名
v ジョブ名
v ローカルと GMT の時刻と日付
v シーケンス番号
通常の MVS データ・セット名の標準で使用できる任意の名前を生成するように名
前パターンを指定することができます。唯一の要件は、各自動割り振りダンプ・デ
ータ・セットが固有の名前を持つことを保証するために、シーケンス番号記号を含
めることです。
SVC ダンプ・データ・セットの自動割り振りの使用
自動割り振りを使用可能または使用不能にするコマンド指示は、 COMMNDxx
parmlib メンバーに指定して IPL 時に有効にすることも、 IPL 後の任意の時点でオ
ペレーター・コンソールから指定して、動的に自動割り振り設定値を修正すること
もできます。DUMPDS コマンドは、次のような柔軟性があります。
v ダンプ・データ・セットの自動割り振りを活動化する
v 割り振りリソースの追加と削除
v 自動割り振りを SMS ストレージまたは非 SMS 管理ストレージに向ける
v ダンプ・データ・セットの自動割り振りを非活動化する
v ダンプ・データ・セットの自動割り振りを再活動化する
v ダンプ・データ・セットの命名規則を変更する
次の手順で自動割り振りをセットアップしてください。
v 割り振り権限を設定する
v データ・セットの名前パターンを設定する
v データ・セットを保管するためのリソースを定義する
v 自動割り振りを活動化する
これらの SVC ダンプ・データ・セットの自動割り振りがアクティブになると、
DASD ボリュームへの割り振りは、DUMPDS ADD コマンドによって割り振られた
最初のリソースから始めて、行われます。そのボリュームへの割り振りがそれ以上
正常に行われなくなった場合には、次のリソースが使用されます。
SVC ダンプ・データ・セットは、SMS 管理対象でも非 SMS 管理対象でも構いま
せん。 DUMPDS ADD コマンドが SMS クラスを定義した場合には、割り振り
第 2 章 SVC ダンプ
2-3
SVC ダンプ
は、まず、これらのクラスを ACS ルーチンに渡して SVC ダンプ・データ・セッ
トを SMS 管理対象として割り振ろうとします。この割り振りが何らかの理由で正
常に行われない場合、または SMS クラスが定義されていない場合には、このデー
タ・セット割り振りは DUMPDS ADD コマンドに定義した DASD ボリュームを使
用し、SVC ダンプ・データ・セットは非 SMS 管理対象として割り振られます。
非 SMS 管理対象として割り振られる SVC ダンプ・データ・セットは、単一ボリ
ュームでなければなりません。この場合、複数のエクステントをもつことができま
すが、複数のボリュームにまたがることはできません。非 SMS 管理対象 DASD
は、ストライピングをサポートしません。SMS 管理対象として割り振られる SVC
ダンプ・データ・セットは、ストライピングされたデータ・セットとして割り振ら
れた場合だけ、マルチボリュームにできます。ストライピングは、SMS クラスに定
義しなければならない属性です。ストライピングと圧縮 (別の SMS 属性) を使用し
て、事前割り振りまたは非 SMS 管理データ・セットで可能なデータ・セットより
も大きなデータ・セットを割り振ることができます。
注: 目的とするデータ・セットにストレージ・クラスが割り当てられるようにする
ために、このデータ・セットを SMS 管理対象にルーティングするように、自
動クラス選択 (ACS) ルーチンを更新する必要があります。
割り振り権限をセットアップする: ダンプ・データ・セットを自動的に割り振るた
めに、 DUMPSRV アドレス・スペースには新規データ・セットを割り振るための
権限が必要です。次の手順に従ってください。
1. DUMPSRV アドレス・スペースとユーザー ID を関連させる。
RACF® STARTED 一般リソース・クラス、または RACF 開始プロシージャー・
テーブル ICHRIN03 を使用して、DUMPSRV とユーザー ID を関連付けます。
2. DUMPSRV ユーザー ID に、次のトピックに示す命名規則を使用して新規ダン
プ・データ・セットを作成するための許可を与えてください。
SYS1 の高位修飾子を指定すると、データ・セットは グループ・データ・セッ
トであると見なされます。そのグループ内の DUMPSRV ユーザー ID に、
CREATE グループ権限を割り当てることができます。
参照
v RACF STARTED 一般リソース・クラスおよび RACF 開始プロシージャー・テ
ーブルについては、「z/OS Security Server RACF システム・プログラマーのガイ
ド」を参照してください。
v RACF STARTED 一般リソース・クラスの使用法と新規データ・セット作成の制
御については、「z/OS Security Server RACF セキュリティー管理者のガイド」を
参照してください。
名前パターンの設定: ダンプ・データ・セットの名前パターンの設定は、
DUMPDS NAME= コマンドによって行われます。名前は標準データ・セット命名規
則に従い、修飾子間の区切り文字として使用するピリオドを含め最大 44 文字で
す。詳細については、「z/OS DFSMS データ・セットの使用法」を参照してくださ
い。ダンプ・データ・セットに意味のある名前を使用できるように、ダンプ・デー
タが仮想記憶域にキャプチャーされた時に解決されるいくつかの記号があります。
2-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
使用できる記号の完全なリストは、「z/OS MVS システム・コマンド」内の
DUMPDS NAME= の説明を参照してください。
ダンプ・データ・セット名のパターンを決定する場合は、ダンプ・データ・セット
に対して機能する、インストール・システムにあるすべての自動化ツールを考慮し
てください。また、自動割り振り機能でも、固有のデータ・セット名を保証するた
めに、ユーザーのデータ・セット名のパターンに &SEQ. シーケンス番号記号を含
める必要があります。シーケンス番号を使用しないと、システムは名前パターンを
IEE855I メッセージを出して拒否し、直前の名前パターンが有効になります。
デフォルトで、システムは SYS1.DUMP.D&DATE..T&TIME..&SYSNAME..S&SEQ;
という名前パターンを使用します。
デフォルトの名前パターンを次に説明します。
SYS1 . DUMP . D &DATE. . T &TIME. . &SYSNAME. . S &SEQ.
─┬── │ ─┬── │ │ ──┬─── │ │ ──┬─── │ ───┬───── │ │ ──┬──
│ ┌┘ │ │ │ │
│ │
│
│
│
│ │
│
│ │ ┌─┘ │ │ │
│ │
│
│
│
│ │
│
│ │ │ ┌──┘ │
│
│ │
│
│
│
│ │
│
│ │ │ │┌───┘
│
│ │
│
│
│
│ │
│
│ │ │ ││ ┌────┘
│ │
│
│
│
│ │
│
│ │ │ ││ │
┌─────┘ │
│
│
│
│ │
│
│ │ │ ││ │
│┌──────┘
│
│
│
│ │
│
│ │ │ ││ │
││ ┌───────┘
│
│
│ │
│
│ │ │ ││ │
││ │
┌────────┘
│
│ │
│
│ │ │ ││ │
││ │
│
┌─────────┘
│ │
│
│ │ │ ││ │
││ │
│
│
┌────────────┘ │
│
│ │ │ ││ │
││ │
│
│
│┌─────────────┘
│
│ │ │ ││ │ ││ │
│
│
││ ┌──────────────┘
│ │ │ ││ │ ││ │
│
│
││ │
SYS1.DUMP.D930428.T110113.SYSTEM1.S00000
図 2-1. 自動的に割り振られたダンプ・データ・セットのデフォルトの名前パターン
注: デフォルトのデータ・セットは高位修飾子の SYS1 で始まりますが、この規則
はユーザーのシステムで命名されたデータ・セットの要件にはなりません。
記号は、日付、時刻、およびシーケンス数値に分解され、MVS データ・セット名の
規則に従うよう英字が前に付きます。また、記号は、アンパーサンド (&) で始ま
り、ピリオド (.) で終了し、修飾子が終了する場合は二重ピリオドを持つ名前パタ
ーンになります。1 つのピリオドが記号を終了し、2 番目は生成されたデータ・セ
ット名の修飾子間の区切り文字として働きます。
ダンプ・データ・セットのリソースの定義: 割り振りが活動状態の場合は、 SVC
ダンプ・データ・セットは、それらを保管するリソースが定義されるとすぐに自動
的に割り振ることができます。名前パターンを変更しない場合は、システムのデフ
ォルト値が使用されます。 2-4 ページの『名前パターンの設定』を参照してくださ
い。DUMPDS ADD,VOL=volser (DASD ボリュームの場合) と、 DUMPDS
ADD,SMS=class (SMS クラスの場合) コマンドを使用してダンプ・データ・セッ
ト・リソースを定義することができます。DUMPDS DEL,VOL=volser と DUMPDS
DEL,SMS=class コマンドを使用してリソースを除去することができます。自動割り
振りは DASD ボリュームより先に SMS クラスに向けられます。
第 2 章 SVC ダンプ
2-5
SVC ダンプ
自動割り振りが非活動状態の場合は、ダンプは事前割り振りされた SYS1.DUMPxx
データ・セットに書き出されます。ただし、自動割り振りの非活動化は、リソース
定義の損失を招くことはありません。そのため、自動割り振りが再活動化される
と、すべての直前のリソースはそのまま自動割り振りダンプ・データ・セットを受
け取るために使用できます。同様に、最後の割り振りリソースを除去しても自動割
り振りが非活動状態になることはありません。ただし、最後の割り振りリソースを
効果的に 除去すると、機能が「オフにされ、」すべての定義リソースがいっぱいで
あるかのようになります。両方の場合に、システムは IEA799I メッセージで応答
し、ダンプは事前割り振り SYS1.DUMPxx データ・セットが存在すればそこに書き
出します。それ以外の場合はダンプは、以下の条件までキャプチャーされます。
v 書き出すための場所を作成する
v CHNGDUMP MSGTIME パラメーターで設定された時間制限が満了する
v オペレーターがダンプを削除する
自動割り振りの活動化: デフォルトでは、自動割り振りはシステムを IPL したあ
とで非活動状態になります。ただし、COMMNDxx parmlib メンバーに DUMPDS
NAME= コマンド、任意の DUMPDS ADD コマンド、および DUMPDS
ALLOC=ACTIVE コマンドに追加して、 IPL の間に自動割り振りを活動化すること
ができます。
ALLOC=INACTIVE を使用して自動割り振りをオフにした場合は、 DUMPDS
ALLOC=ACTIVE オペレーター・コマンドを入力して、それを再活動化することが
できます。
ダンプ状況の検査: ダンプ状況を検査するために、 DISPLAY DUMP,STATUS コ
マンドを発行することができます。たとえば、システム・パラメーターとして
DUMP=NO を指定して SYSTEM1 を IPL した後で、どのダンプも要求せずまたど
の DUMPDS コマンドまたは CHNGDUMP コマンドも指定しない場合は、
DISPLAY DUMP,STATUS コマンドの結果として次の出力が予測できます。
IEE852I 10.56.03 SYS1.DUMP STATUS
SYS1.DUMP DATA SETS AVAILABLE=000 AND FULL=000
CAPTURED DUMPS=0000, SPACE USED=00000000M, SPACE FREE=00000500M
AUTOMATIC ALLOCATION IS: INACTIVE
NO SMS CLASSES DEFINED
NO DASD VOLUMES DEFINED
NAME=SYS1.DUMP.D&DATE..T&TIME..&SYSNAME..S&SEQ.
EXAMPLE=SYS1.DUMP.D930324.T105603.SYSTEM1.S00000
自動割り振り機能を設定するために、次のステップが実行されると想定します。
1. DUMPDS コマンドを使用して、ユーザーのインストール・システム・データ・
セット名のパターンをセットアップする。
DUMPDS NAME=&SYSNAME..&JOBNAME..Y&YR4.M&MON..D&DAY.T&HR.&MIN..S&SEQ.
注: このステップは、 2-5 ページの図 2-1 に示すデフォルトの名前パターンを
使用しない場合にのみ必要です。
2. 自動割り振り機能で使用する可能性があるダンプ・データ・セット・リソースを
追加します。
DUMPDS ADD,VOL=(SCRTH1,HSM111)
DUMPDS ADD,SMS=(DUMPDA)
3. DUMPDS コマンドを使用して、自動ダンプ・データ・セット割り振りを活動化
します。
2-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
DUMPDS ALLOC=ACTIVE
注: これらのステップは、 IPL 後にオペレーター・コンソールから DUMPDS コマ
ンドを使用して実行することができます。またそのコマンドを COMMNDxx
parmlib メンバーに置き、CMD=xx を使用して IEASYSxx parmlib メンバーか
らそのメンバーをポイントして、IPL 時の早い時期に実行することができま
す。
COMMNDxx は、 IEASYSxx parmlib メンバーに DUMP=NO を指定して、 IPL 中
に取られるダンプが SYS1.DUMPxx データ・セットに書き出されるのを防ぐ必要が
ある場合に使用することもできます。
1 から 3 ステップに示された DUMPDS コマンドを発行後は、要求しているダンプ
状況は次のようになります。
SYSTEM1 IEE852I 12.34.18 SYS1.DUMP STATUS 886
SYS1.DUMP DATA SETS AVAILABLE=000 AND FULL=000
CAPTURED DUMPS=0000, SPACE USED=00000000M, SPACE FREE=00000500M
AUTOMATIC ALLOCATION IS: ACTIVE
AVAILABLE SMS CLASSES: DUMPDA
AVAILABLE DASD VOLUMES: SCRTH1,HSM111
NAME=&SYSNAME..&JOBNAME..Y&YR4.M&MON..D&DAY.T&HR.&MIN..S&SEQ.
EXAMPLE=SYSTEM1.#MASTER#.Y1994M01.D26T1634.S00000
自動割り振りダンプ・データ・セットの管理
ダンプ・データ・セットの自動割り振りは、 DUMPDS コマンドで管理します。該
当するコマンドを COMMNDxx parmlib メンバーに指定すると、その機能は IPL 時
に設定されます。
DISPLAY DUMP コマンドは、現行の IPL 中に自動的に割り振られた最後の 100
個のデータ・セットについての情報を表示することができます。標準的なダンプ在
庫管理は、シスプレックス・ダンプ登録簿を使用して実行すべきです。シスプレッ
クス・ダンプ登録簿は、システム IPL に作成されたすべてのカタログおよび追加さ
れたダンプ・データ・セットへのアクセスを提供します。ユーザーとシスプレック
ス・ダンプ登録簿についての詳細は、「z/OS MVS IPCS ユーザーズ・ガイド」を参
照してください。
インストール・システムでは、ダンプ・データ・セットの自動割り振りで使用でき
るボリューム (非 SMS) またはクラス (SMS) を制限することによって、ダンプ・
データ・セットに割り振られるスペースを管理する必要があります。「z/OS MVS
システム・コマンド」には、DUMPDS ADD、DEL、および ALLOC=ACTIVE の各
コマンドの構文の説明があります。
SMS については、「z/OS DFSMS Storage Administration Reference」を参照してくだ
さい。
事前割り振りダンプ・データ・セットの使用
事前割り振りダンプ・データ・セットは、自動割り振りのバックアップ方法として
使用してください。事前割り振りダンプ・データ・セットは、自動的に割り振られ
たダンプ・データ・セットと同様に、後刻の検討と分析のために SVC ダンプ情報
を保持しますが、自動的に割り振られたダンプ・データ・セットにはないサイズの
第 2 章 SVC ダンプ
2-7
SVC ダンプ
制限とパフォーマンス上の制限があります。このセクションでは、SVC ダンプ用の
事前割り振りデータ・セットのセットアップ方法について説明します。次の項目が
あります。
v 『2 次エクステントを持つ SYS1.DUMPxx データ・セットの割り振り』
v 2-11 ページの『SYS1.DUMPxx データ・セットの指定』
v 2-12 ページの『SYS1.DUMPxx データ・セットの制御』
2 次エクステントを持つ SYS1.DUMPxx データ・セットの割り振り
次の要件で SYS1.DUMPxx データ・セットを割り振ります。
v データ・セットを SYS1.DUMPxx と名付けます。xx は 10 進数 00 から 99 で
す。
v 4160 バイトのトラック・サイズを持つデバイスを選択します。システムはダンプ
を 4160 バイトのブロック・レコードで書き出します。
v 最初のレコードとしてファイル終わり (EOF) レコードで初期設定します。
v ダンプ要求の前にデータ・セットを割り振ります。割り振り要件は次のとおりで
す。
– UNIT: 直接アクセス装置上の永続常駐ボリューム。
– DISP: データ・セットをカタログする (CATLG)。SHR を指定しないでくださ
い。
– VOLUME: 1 ボリューム上にのみデータ・セットを置きます。ダンプ・デー
タ・セットをページ・データ・セットと同じボリューム上に割り振ると、ダン
プされたアドレス・スペースのページは、ページ・データ・セットから読み取
られ、ダンプ・データ・セットに書き込まれるので、ダンプ中の競合問題を引
き起こすことがあります。
– SPACE: インストール・システムではダンプ・データ・セットを含むことを想
定したページ・データ・セットのサイズを考慮する必要があります。データ・
セットは、CHNGDUMP コマンドの MAXSPACE パラメーター、 VIO ペー
ジ、およびページング可能専用ストレージ・ページで定義されたデータ量を保
管できる十分な大きさが必要です。
SVC ダンプ処理は、大きなダンプ・データ・セットが以前に割り振られた
DASD 量と比較して大きすぎる場合に、 2 次エクステントを指定できるよう
にしてサービスを向上させています。インストール・システムで 2 次エクス
テントを指定し、ダンプ・データ・セットの拡張ができるように十分なスペー
スをボリュームに残して、ダンプが切り捨てられるのを防ぐことができます。
SPACE キーワードに CONTIG を指定すると、より迅速にデータ・セットの読
み取りと書き込みができるようになります。 1 次エクステントで十分なスペ
ースを要求して、予測される最小の SVC ダンプを保存できるようにしてくだ
さい。2 次エクステントで十分なスペースを要求して、 1 次と 2 次エクステ
ントで最大の SVC ダンプを保存できるようにしてください。データ・セット
の最大サイズは、65,535 トラックです。3390 の場合、これは 4369 シリンダ
ーにあたり、2.8 GB のデータを保持できます。 実際のダンプの大きさは、シ
ステムがダンプを書き出した時に有効なダンプ・オプションによります。
|
|
最大のダンプ・サイズの見積もりは次のように行います。
2-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
Bytes of SDATA options + bytes in largest region size = Result1
Result1 * number of address spaces in dump
= Result2
PLPA * 20%
= Result3
Bytes of requested data space storage
= Result4
Result2 + Result3 + Result4
= Bytes in SVC dump
ここで、
- Result1、Result2、Result3、Result 4: 中間結果
- SDATA options: 2-24 ページの『SVC ダンプの内容』を参照
- PLPA: ページング可能リンク・パック域 (LPA)
最小ダンプのサイズは、 SDUMPX マクロのデフォルトのオプションを使用して
ください。最大ダンプと最小ダンプの差は 2 次エクステントのサイズになりま
す。
例: ストレージの最大量の計算
|
たとえば、上記の計算で 3390 DASD で必要なストレージの最大量を計算する
場合は、 SVC ダンプに必要なレコードの量は 43200 キロバイトになりま
す。1 トラックに 11 レコード、1 シリンダーに 15 トラックです。このサイ
ズのデータ・セットを割り振るために必要なシリンダー数を決定する場合は、
次の手順に従います。
v 43200 キロバイトのストレージでは、 10800 SVC ダンプ・レコード
(43200/4 キロバイト/レコード) が必要です。
|
|
v 1 トラックあたり 11 レコードの場合は、 982 (10800/11 レコード) トラッ
クが必要です。
|
|
v したがって、データ・セットでは 66 シリンダー (982/15 トラック/シリン
ダー) が割り振りに必要です。
注: 要求したダンプ・データを受け取れない場合は、ダンプ・データ・セッ
トのサイズを増加させてください。システム・メッセージ IEA911E を
受けとります。
|
|
|
システムは、各 SYS1.DUMPxx データ・セットにダンプを 1 つだけ書き込みま
す。CLEAR キーワードを指定した DUMPDS コマンドを使用して、データ・セッ
トをクリアすると、そのデータ・セットを別のダンプで使用することができます。
参照
v SDUMPX マクロのデフォルトのダンプ・オプションについての情報は、「z/OS
MVS Programming: Authorized Assembler Services Reference LLA-SDU」を参照し
てください。
v DUMPDS コマンドの使用法についての情報は、「z/OS MVS システム・コマン
ド」を参照してください。
第 2 章 SVC ダンプ
2-9
SVC ダンプ
SVC ダンプ・データ・セットの選択
IBM は、SVC ダンプのダンプ・データ・セットとして、拡張形式の順次データ・
セットを使用することをお勧めします。拡張形式の順次データ・セットとは、次の
とおりです。
v 順次データ・セットより大きい容量を持つ
v ストライピングをサポートする
v 圧縮をサポートする
より大きい容量
ある種のダンプ・データ・セットは、システムが生成する他のデータ・セットと比
較して非常に大きいものです。拡張順次データ・セットは、最大の SVC ダンプを
128 ギガバイトまで保持することができます。
ストライピングをサポートする
ストライピングはデータ・セットのセクション、つまりストライプ をマルチボリュ
ームにわたって広げ、使用できる場合は、これらのボリュームへの独立パスを使用
します。マルチボリュームと独立パスは、ダンプ入出力が実動入出力と競合する時
間を減らすことによって、データ・セットの順次読み取りと書き込みを速めます。
ストライプの数と使用するボリュームの数を一致させることをお勧めします。MVS
のデータ管理では、各レコードが 1 つのボリューム上に存在するかのように、任意
のレコードに対するランダム・アクセスが可能になるため、この組み合わせによっ
て最も良いパフォーマンスが得られます。このことは、ダンプの IPCS 分析を行う
際に特に役立ちます。データ・セットのロード時の時間の節約は、小さなものです
が、ボリューム終了処理数を減らすことには効果があります。
ストライプ・データ・セットでは、最後のボリュームがストライプを受け取ると、
次のストライプは最初のボリューム、2 番目のボリューム、 3 番目のボリューム、
という順で置かれ、最後のボリュームまで到達すると、最初のボリュームに戻りま
す。
使用するストライプが 6 ダースを超える場合、ストライプの追加ごとのパフォーマ
ンス上の利点は、それより前のストライプを追加したときに得られるパフォーマン
ス上の利点より劣ります。これは、元のデータ・セット定義の話であることに留意
してください。既存のストライプ・データ・セットにはストライプを追加できませ
ん。事前に計画が必要です。より高速の処理を使用すると、比較的高価なデータ・
スペース記憶装置からより安価な DASD へ、ダンプ・データをより速く移動させる
ことができます。
圧縮のサポート
圧縮によりダンプ・データ・セットはより少ない DASD スペースですむようになり
ます。圧縮を使用する前に、次の点を考慮してください。
v 圧縮と圧縮解除は DASD のより効果的な処理サイクルと相殺関係にあります。
ハードウェア圧縮を使用できない場合は、処理サイクルの数は著しく高くなりま
す。
2-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
DSNTYPE=LARGE の使用 z/OS V1R7 以降のリリースでは、DSNTYPE=LARGE
データ・セットの処理に関係するシステムが、その使用前に V1R7 にマイグレーシ
ョンされている場合、DSNTYPE=LARGE を使用する順次データ・セットを SVC
ダンプに使用できます。前のリリースを使用した分析が必要な場合は、z/OS V1R7
を使用して、前のリリースでサポートされるデータ・セットにダンプを転記しま
す。
自動割り振りダンプ・データ・セットの検出
DISPLAY DUMP,TITLE オペレーター・コマンドの AUTODSN= パラメーターを使
用すると、この IPL の間に自動的に割り振られた最新のダンプ・データ・セットを
最大 100 までリストすることができます。自動的に割り振られた最新の 100 デー
タ・セットの前のものについては、何の情報も保存されません。たとえば、最新の
5 つの自動割り振りダンプ・データ・セットの表題を見たい場合は、次のように発
行することができます。
DISPLAY DUMP,TITLE,AUTODSN=5
DISPLAY DUMP コマンドの使用法についての詳細は、「z/OS MVS システム・コ
マンド」の DISPLAY DUMP を参照してください。
システムからの通信
システムは、2 つのメッセージを使用して、ダンプ・データ・セットの自動割り振
りについて通信します。
v IEA611I は、完全または部分ダンプが自動割り振りダンプ・データ・セットに取
られた時に発行されます。IEA611I は、通知メッセージなので強調表示されませ
ん。
v IEA799I は、自動割り振りが失敗した時にキャプチャー・ダンプごとに 1 回発行
されます。理由テキストが別の場合以外は、同じダンプ・データ・セットを割り
振る自動割り振りの次の試みが失敗しても、このメッセージが再発行されること
はありません。
SYS1.DUMPxx データ・セットの指定
SYS1.DUMPxx データ・セットの計画をする場合、そのデータ・セットにしばしば
機密データ (ユーザーまたはインストール・システム機密情報、ログオン・パスワ
ード、暗号化鍵など) が含まれることがあるので注意してください。. RACF を使用
してこれらのデータ・セットを保護し、それらへのアクセスを制限してください。
インストール・システムでは SYS1.DUMPxx データ・セットを 2 つの方法で指定
することができます。
v COMMNDxx parmlib メンバーを通じて DUMPDS オペレーター・コマンドを使
用することをお勧めします。COMMNDxx parmlib メンバー内で DUMPDS ADD
コマンドを使用して、ダンプ・データ・セットとのすべての対話が DUMPDS コ
マンドを通じて行われるようにしてください。
第 2 章 SVC ダンプ
2-11
SVC ダンプ
例: SYS1.DUMP ダンプ・データ・セットの追加
SYS1.DUMP05 データ・セットを指定する場合は、次のように入力します。
COM=’DUMPDS ADD,DSN=05’
v システムの初期設定中に、 IEASYSxx parmlib メンバーの DUMP パラメーター
に指定します。
IEASYSxx parmlib メンバーに DUMP=NO を指定します。指定しないと、
COMMNDxx parmlib メンバーが処理される前に、使用できるすべてのデータ・
セットが割り振られます。
データ・セットは直接アクセス装置上にのみ置かれます。1 つのインストール・シ
ステムにおける最大の SYS1.DUMPxx データ・セット数は、100 です。直接アクセ
ス・データ・セットは永続常駐ボリューム上に置かれる必要があり、そのデータ・
セットは割り振られ、カタログされなければなりません。これらのダンプ・デー
タ・セットを複数のシステムで共有することはできません。
すべてのダンプ・データ・セットを同じパックに置かないようにしてください。パ
ックは、必要に応じて、ダンプ・データ・セットが 2 次エクステント・スペースを
割り振ることができる十分なストレージを含むようにしてください。
参照
v IEACMDxx と IEASYSxx parmlib メンバーについての情報は、「z/OS MVS 初期
設定およびチューニング 解説書」を参照してください。
v DUMPDS コマンドの使用法についての情報は、「z/OS MVS システム・コマン
ド」を参照してください。
SYS1.DUMPxx データ・セットの制御
システムの初期設定後に、これらのデータ・セットを変更し制御するために次の手
順に従ってください。
v ダンプを SYS1.DUMPxx データ・セットから別のデータ・セットにコピーしま
す。次に、SYS1.DUMPxx を別のダンプに使用できるようにするために、それを
クリアします。 IPCS を使用して、以下のトピックに説明されているように、コ
ピーしたダンプをフォーマット設定し、表示または印刷できます。
v DUMPDS オペレーター・コマンドを使用して、次のことを行います。
– SVC ダンプ用に直接アクセス装置に SYS1.DUMPxx データ・セットをさらに
追加する。
– SVC ダンプ用の SYS1.DUMPxx データ・セットを削除する。
– 最初のレコードとして EOF マークを書き込み、ダンプを含む SYS1.DUMPxx
データ・セットをクリアする。EOF マークが最初のレコードとしてあると、そ
のデータ・セットを別のダンプで使用することができます。
DUMPDS オペレーター・コマンドでデータ・セットの追加、削除、またはクリア
を行う場合は、再 IPL は不要です。
2-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
v ダンプを取り消す場合は IEA793A システム・メッセージに REPLY コマンドを
使用します。
v ダンプを別のデータ・セットにコピーする場合は、ダンプ後出口ルーチンを使用
します。IEAVTSEL は SVC ダンプのダンプ後出口ルーチン名のリストで、ダン
プ処理が終了した時に制御を与えられるインストール・システム出口ルーチンの
モジュール名をリストしています。
参照
v IEAVTSEL ダンプ後出口名リストについての詳細は、「z/OS MVS 導入システム
出口」を参照してください。
v IPCS COPYDUMP サブコマンドについては、「z/OS MVS IPCS コマンド」を参
照してください。
v DUMPDS と REPLY オペレーター・コマンドについては、「z/OS MVS システ
ム・コマンド」を参照してください。
SVC ダンプの獲得
SVC ダンプは、許可プログラム内で SDUMP または SDUMPX マクロを発行する
か、DUMP コマンドまたは SLIP コマンドを入力して、または IEASLPxx parmlib
メンバー内の SLIP コマンドを使用して獲得することができます。
SVC ダンプは、SDUMP または SDUMPX マクロの DCB パラメーターに指定され
る SYS1.DUMPxx、または自動的に割り振られる SVC ダンプ・データ・セットに
書き込まれます。SYS1.DUMPxx データ・セットが使用できない場合は、ダンプは
キャプチャーされ、システムはオペレーターに SYS1.DUMPxx データ・セットを用
意するように指示します。オペレーターは、SVC ダンプが処理される現行オプショ
ンと SVC ダンプの状況を判別することもできます。
注: キャプチャーすることができる SVC ダンプの数の限界は MAXSPACE 値に依
存します。
1. インストール済み環境で、参考にできるヒストリーがまだない場合は、最大
データ・セット・サイズを決定する際のヘルプに 2-8 ページの『2 次エクス
テントを持つ SYS1.DUMPxx データ・セットの割り振り』 を参照してくだ
さい。複数のデータ・セット・サイズを使用して、MAXSPACE 値を決定し
てください。
2. また、MAXSPACE 値によって表される追加負荷に対応できるように、影響
を受けるシステムのページング・リソースを増やす必要があります。 3. マルチボリューム割り振りをできるようにするには、拡張順次 SDUMP デ
ータ・セットの自動割り振りについての SMS 仕様を使用してください。少
なくとも、大規模ダンプ (たとえば、3GB より大) を可能にするのに必要な
サポートを考慮してください。さらに、圧縮サポートも使用可能化すること
を考慮してください。
MAXSPACE 値の設定について詳しくは、CHNGDUMP コマンドを参照してく
ださい。
シスプレックスでは、問題データのすべてを収集するために、複数のシステムから
のダンプが必要になる場合があります。これらのダンプは同時に要求する必要があ
第 2 章 SVC ダンプ
2-13
SVC ダンプ
ります。これらの複数ダンプを要求するために、問題に関係する可能性があるすべ
てのシステムについて、次の処理を行ってください。
v REMOTE パラメーターを指定して DUMP コマンドを入力する。
v REMOTE パラメーターを指定して SDUMPX マクロを発行する。
v 共用 SYS1.PARMLIB 内または各システムの parmlib 内の IEASLPxx parmlib メ
ンバーに SLIP トラップを作成する。どのシステムが最初に問題を起こすかを予
測することはできないので、ROUTE オペレーター・コマンドを使用して、類似
のすべてのシステムでトラップを活動化します。各トラップには、REMOTE パラ
メーターを指定して、関連する可能性のあるその他のすべてのシステムをダンプ
できるようにします。
これらの要求をセットアップする助けとして、コマンドとマクロにワイルドカード
を含めることができます。シスプレックス内のシステムについてと、関連作業用の
ジョブについてのパターンを形成する名前を、インストール・システムで指定する
場合は、ワイルドカードの * と ? を使用して名前を指定することができます。た
とえば、名前 TRANS? をジョブ名 TRANS1、 TRANS2、および TRANS3 に使用
し、名前 TRANS* を TRANS1、TRANS12、および TRANS123 に使用します。
このセクションでは、次の順でこれらの項目のそれぞれを説明します。
v 『SVC ダンプ用のマクロを発行する』
v 2-15 ページの『オペレーターの活動』
v 2-18 ページの『ダンプ・データ・セットを使用可能にする』
v 2-19 ページの『現行の SVC ダンプ・オプションと状況の判別』
v 2-20 ページの『SVC ダンプの検出』
SVC ダンプ用のマクロを発行する
許可プログラム内で SVC ダンプを要求するには、SDUMP または SDUMPX マク
ロを使用します。システムはダンプを SYS1.DUMPxx データ・セットまたはマクロ
で指定されたユーザー提供のデータ・セットに書き出します。
例: デフォルトの内容のダンプ
2-24 ページの『SVC ダンプの内容』内にリストされたデフォルトの内容を
SYS1.DUMPxx データ・セットにダンプする場合は、次のように指定します。
SDUMPX
ダンプをユーザー提供の SVC ダンプ・データ・セットに書き出す場合は、プログ
ラムでそのデータ・セットのデータ制御ブロック (DCB) を提供し、SDUMP または
SDUMPX マクロを発行する前に DCB をオープンし、ダンプが書き出された後で
DCB をクローズします。同期ダンプの場合は、システムが制御を要求側に戻した時
にクローズするようにします。スケジュール・ダンプの場合は、ECB がポストされ
た時または SRB がスケジュールされた時にクローズするようにします。
2-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
例: 同期ダンプの要求
DCB アドレスがレジスター 3 にあるデータ・セットに同期ダンプを書き出す
場合は、次のように指定します。
SDUMPX DCB=(3)
参照
スケジュールされた SVC ダンプと同期 SVC ダンプを要求する場合の情報は、
「z/OS MVS Programming: Authorized Assembler Services Guide」を参照してくださ
い。
オペレーターの活動
マスター権限を持つコンソールから、オペレーターは次のいずれかのコマンドを入
力することができます。
v DUMP オペレーター・コマンド。
例: DUMP コマンドの使用
以下のオペレーター・コマンドは、次のような SVC ダンプを書き出しま
す。
– SYS1.DUMPxx データ・セットに
– “MYDUMP1 5-9-88” という表題で
– 2-24 ページの『SVC ダンプの内容』にリストされたデフォルトの内容で
– ジョブ名 MYJOB1 について
DUMP COMM=(MYDUMP1 5-9-88)
システムは次のメッセージで応答します。
* 23 IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND
オペレーターに応答を依頼します。
REPLY 23,JOBNAME=MYJOB1
オペレーターが IEE094D に REPLY 23,U と応答すると、システムは、マスタ
ー・スケジューラー・アドレス・スペースである現行のアドレス・スペースをダ
ンプします。別のダンプを獲得するためには、オペレーターは応答で、ASID、
JOBNAME、または TSONAME パラメーターを使用する必要があります。
スケジュール SVC ダンプを作成するために、DUMPDS コマンドを使用します。
v STDUMP、SVCD、SYNCSVCD、または TRDUMP の ACTION オプションを指
定した SLIP オペレーター・コマンド。
第 2 章 SVC ダンプ
2-15
SVC ダンプ
例: SLIP コマンドの使用
以下のオペレーター・コマンドは、次のような SVC ダンプを書き出しま
す。
– SYS1.DUMPxx データ・セットに
– MYJOB1 という名前のジョブ内で、プログラム・チェック割り込みが生
じた時
– 2-24 ページの『SVC ダンプの内容』にリストされたデフォルトの内容で
SLIP SET,ACTION=SVCD,ERRTYP=PROG,JOBNAME=MYJOB1,END
SLIP コマンドはスケジュール SVC ダンプを生成します。
IEASLPxx parmlib メンバーでのオペレーター・コマンド
インストール・システムでは IEASLPxx parmlib メンバー内に SLIP オペレータ
ー・コマンドを置いて SVC ダンプを生成することができます。コマンドが必要な
場合に、オペレーターは必要な SLIP コマンドを含む IEASLPxx メンバーを動的に
設定することができます。別の IEASLPxx メンバーに、別のタイプの SLIP トラッ
プを要求する SLIP コマンドを置くことができます。
参照
v DUMP と SLIP オペレーター・コマンドについては、「z/OS MVS システム・コ
マンド」を参照してください。
v IEASLPxx メンバーについては、「z/OS MVS 初期設定およびチューニング 解説
書」を参照してください。
IEADMCxx parmlib メンバーでのオペレーター・コマンド
IEADMCxx を使用して、parmlib メンバーを通じて DUMP ダンプ・パラメーター
を指定することができます。IEADMCxx を使用して、オペレーターは DUMP コマ
ンドを発行することによりダンプ・データの収集を指定することができます。この
ためには、 parmlib メンバー名とすべてのシンボリック置換変数を指定します。
z/OS リリース 2 以降、多くのサンプル DUMP コマンド parmlib メンバーが、
SYS1.SAMPLIB にあります。それらはお客様のシステム固有の要件 (システム名、
アドレス・スペース名など) に従ってさらに修正を加えるための基本として使用し
ても構いません。さらに、お客様のシステム環境により名前が異なっている場合が
あるため、置換変数を使用して対応するようにしてあります。ですから、これらの
メンバーを利用するためには、修正をして parmlib 連結内のデータ・セットに保存
することが必要です。
|
|
|
|
|
|
|
注: この置換変数の長さは、ある特定の場合に使用される値には十分ではありませ
ん。 たとえば、IEADMCAS 内の &job は、4 文字またはそれ以下のジョブ名
にのみ適応します。 たとえば、parmlib メンバーにコピーした後、&job を
&thisjob のような 8 文字までに適応する長い変数に変更します。
以下の表に、z/OS R2 が SYS1.SAMPLIB で提供しているサンプルのダンプ・コマ
ンドを要約してあります。
2-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
表 2-1. SYS1.SAMPLIB にあるサンプルのオペレーター DUMP コマンド・メンバー
|
メンバー名
疑いのある
問題領域
IEADMCAR
APPC
APPC トランザクション環境 (RRS
を含む)
IEADMCAS
共用磁気テープ
影響のあるジョブを持つ Allocation
Autoswitch と XCF
IEADMCCA
カタログ
Catalog アドレス・スペースと関連領
域
IEADMCCN
コンソール
CONSOLE アドレス・スペースとそ
の IEEMCSn データ・スペース
IEADMCCP
CP/SM
SYSPLEX 内の全システム上の
CICSplex SM 環境。これには、
CAS、CMAS、および EYU アドレ
ス・スペースが含まれます。
Y
IEADMCD2
DB2® 分散トラン
ザクション
DB2/RRS 環境
Y
IEADMCJ2
JES2
現在のシステムおよび指定システム
上の JES2/XCF 環境
IEADMCLC
ロガー/CICS
システム・ロガー、RLS、および
CICS®
IEADMCLG
ロガー/GRS
SYSPLEX 内のすべてのシステム上
のシステム・ロガーと GRS
IEADMCLS
一般的なロガー問
題
SYSPLEX 内のすべてのシステム上
の指定された構造に加えて、ロガ
ー、XCF、ALLOC、CATALOG、
GRS、 DFHSM、および SMS。
IEADMCLX
ロガー/XCF
SYSPLEX 内のすべてのシステム上
のシステム・ロガーと XCF
Y
IEADMCRL
RRS
SYSPLEX 内のすべてのシステム上
の RRS とシステム・ロガー
Y
IEADMCRR
RRS
RRS とそのデータ・スペース
™
ダンプされる領域
使用される
シンボル
使用されるリモー
ト・オプション
&job
Y
&SYSTM
Y
Y
&STRNAME
&STRNAME2
IEADMCSQ
IMS
IMS 共用キュー環境 (IMS 制御領
域、CL/I SAS 領域、DBRC 領域、
および共用キューに接続されたすべ
ての CQS アドレス・スペース)
IEADMCTA
TCP/IP
指定のアプリケーションと一緒に
TCP/IP
&tcp &appl
IEADMCTC
TCP/IP
Comm Server アドレス・スペースと
一緒に TCP/IP
&tcp
IEADMCTI
TCP/IP
TCP/IP とそのデータ・スペース
&tcp
IEADMCTO
TCP/IP
TCP/IP と OMVS
&tcp
Y
Y
®
IEADMCVC
Comm Server
TCPIP と VTAM データ・スペース &tcp &net
と一緒に、VTAM と TCP/IP
IEADMCVG
VTAM GR
VTAM 総称リソース環境と、その
CF ストラクチャー
Y
第 2 章 SVC ダンプ
2-17
SVC ダンプ
表 2-1. SYS1.SAMPLIB にあるサンプルのオペレーター DUMP コマンド・メンバー (続き)
メンバー名
疑いのある
問題領域
IEADMCVT
Comm Server
VTAM と TCP/IP (アドレス・スペ
ースのみ)
&tcp &net
IEADMCVV
VTAM
VTAM とその VIT データ・スペー
ス
&net
IEADMCWL
WLM
SYSPLEX 内のすべてのシステム上
の WLM
IEADMCWS
Web サーバー
OMVS を持った HTTP Web サー
バー
IEADMCWT
Web サーバー
HTTP Web サーバーと TCP/IP
IEADMCXI
IRLM
XCF と IRLM
IEADMCX1
IRLM
SYSPLEX 内のすべてのシステム上
の XCF と IRLM
ダンプされる領域
使用される
シンボル
使用されるリモー
ト・オプション
Y
Y
注:
1. シンボリック・パラメーターを含む parmlib メンバーを指定する場合、SYMDEF
キーワードでそのシンボルと置換値を指定する必要があります。
2. 「使用されるリモート・オプション」欄に「Y」を指定した行で記述したダン
プ・コマンドは、複数システムでダンプが出力されることになります。
ダンプ・データ・セットを使用可能にする
SVC ダンプは、SDUMP または SDUMPX マクロの DCB パラメーターで指定した
SYS1.DUMPxx 、または自動的に割り振られる SVC ダンプ・データ・セットに取
られます。ダンプがキャプチャーされたが、使用できるダンプ・データ・セットが
ない場合に、SVC ダンプ処理はメッセージ IEA793A を出します。SYS1.DUMPxx
データ・セットが使用できない場合は、オペレーターには、D を応答してキャプチ
ャーされたダンプを削除するか、または SVC ダンプ処理で別のダンプ・データ・
セットを使用可能にするオプションがあります。別のダンプ・データ・セットを使
用できるようにする場合は、オペレーターは DUMPDS コマンドを使用します。
例: DUMPDS コマンドの使用
ダンプ・データ・セットを SVC ダンプで使用するために DUMPDS コマンド
を使用します。
システム・メッセージ:
* 16 IEA793A NO SVC DUMP DATA SETS AVAILABLE FOR DUMPID=dumpid FOR JOB (*MASTER*).
* 16 IEA793A USE THE DUMPDS COMMAND OR REPLY D TO DELETE THE CAPTURED DUMP
オペレーター応答:
DUMPDS ADD,DSN=02
2-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
参照
v DUMPDS コマンドについての情報は、「z/OS MVS システム・コマンド」を参照
してください。
v メッセージ IEA793A についての情報は、「z/OS MVS システム・メッセージ 第
6 巻 (GOS-IEA)」を参照してください。
現行の SVC ダンプ・オプションと状況の判別
オペレーターは現行のダンプ・オプションと、SVC ダンプを含む SYS1.DUMPxx
データ・セットを判別することができます。
ダンプ・モードとオプション
SVC ダンプと SYSABEND、SYSMDUMP、および SYSUDUMP ダンプについてダ
ンプ・モードと有効なオプションを入手するためには、DISPLAY DUMP オペレー
ター・コマンドを使用します。システムはメッセージ IEE857I でモードとオプショ
ンを表示します。
参照
v ダンプ・モードについての詳細は、「z/OS MVS システム・コマンド」の
『DISPLAY』を参照してください。
v IEE857I についての詳細は、「z/OS MVS システム・メッセージ 第 7 巻
(IEB-IEE)」を参照してください。
例: モードとオプションの判別
モードとオプションを問い合わせる場合は、次のように指定します。
DISPLAY DUMP,OPTIONS
リストされているオプションが必要としているものではない場合は、CHNGDUMP
オペレーター・コマンドを使用してそれらを変更してください。
SYS1.DUMPxx データ・セットの状況
DISPLAY DUMP オペレーター・コマンドを使用して直接アクセス装置上のすべて
の定義済み SYS1.DUMPxx データ・セットの状況を入手することができます。シス
テムはメッセージ IEE852I または IEE856I 内に状況を表示します。メッセージは満
杯のデータ・セットと使用可能なデータ・セットを示します。
例: 状況の判別
SYS1.DUMPxx データ・セットの状況を問い合わせる場合は、次のように入力
してください。
DISPLAY DUMP,STATUS
第 2 章 SVC ダンプ
2-19
SVC ダンプ
参照
v CHNGDUMP と DISPLAY コマンドについては、z/OS MVS システム・コマンド
を参照してください。
v これらのメッセージの説明については、LookAt を使用するか、「MVS System
Messages」を参照してください。
SVC ダンプの検出
オペレーターは特定の問題の SVC ダンプについて、現行 SYS1.DUMPxx データ・
セットを検索することができます。ダンプの検索は、表題と時刻を使用するかまた
はダンプ症状を使用します。オペレーターは、仮想記憶域にキャプチャーされたが
データ・セットには書き出されていないダンプを検出することもできます。
SVC ダンプの表題と時刻
下記のいずれかを使用して、SVC ダンプの表題と時刻を入手することができます。
v DISPLAY DUMP オペレーター・コマンド。システムはメッセージ IEE853I 内に
表題と時刻を表示します。
例: DISPLAY を使用して表題と時刻を検出する
いずれの自動割り振りダンプ・データ・セットも表示せずに、
SYS1.DUMP08 と SYS1.DUMP23 内のダンプの表題と時刻を調べる場合
は、次のように入力します。
DISPLAY DUMP,TITLE,DSN=(08,23)
最新の自動割り振りダンプ・データ・セットの表題と、すべての事前割り振
りダンプ・データ・セットの表題を表示する場合は、次のように入力しま
す。
DISPLAY DUMP,TITLE
または
DISPLAY DUMP,TITLE,DSN=ALL
最新の 5 つの割り振り済みダンプ・データ・セットの表題を表示する場合
は、次のように入力します。
DISPLAY DUMP,TITLE,AUTODSN=5
すべてのキャプチャーされたダンプのダンプ表題を調べる場合は、次のよう
に入力します。
DISPLAY DUMP,TITLE,DUMPID=ALL
v TSO/E ユーザーが端末で入力した IPCS SYSDSCAN コマンド。IPCS は端末に
表題と時刻を表示します。
2-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
例: IPCS を使用して表題と時刻を検出する
SYS1.DUMP08 と SYS1.DUMP23 内のダンプの表題を調べる場合は、次の
IPCS コマンドを入力します。
SYSDSCAN 08
SYSDSCAN 23
参照
SYSDSCAN についての情報は、「z/OS MVS IPCS コマンド 」を参照してくださ
い。
コマンドが空または未定義の場合に、データ・セットがリストされると、その表題
がない理由を通知するメッセージをシステムが発行します。
SVC ダンプからの症状
DISPLAY DUMP オペレーター・コマンドを使用して、直接アクセス装置上の
SYS1.DUMPxx データ・セット内の SVC ダンプからの症状または仮想記憶域にキ
ャプチャーされた SVC ダンプからの症状を入手することができます。システムは
次の症状をメッセージ IEE854I 内に表示します。
v 表題がない理由を通知する、ダンプ表題またはメッセージ
v シーケンス番号、プロセッサー ID、障害を起こしたタスクの ASID とタイム・
スタンプで構成されるエラー ID
v システム異常終了コード
v ユーザー異常終了コード
v 理由コード
v モジュール名
v 障害を起こした CSECT 名
v エラーを起こした時点でのプログラム状況ワード (PSW)
v システム診断作業域 (SDWA) 内の割り込み長さコード
v SDWA 内の割り込みコード
v SDWA 内の変換例外アドレス
v SDWA 内の障害を起こしたプログラムのアドレス
v SDWA 内のリカバリー・ルーチンのアドレス
v エラーを起こした時刻に SDWA 内に保管されたレジスター
第 2 章 SVC ダンプ
2-21
SVC ダンプ
例: 症状の表示
いずれの自動割り振りダンプ・データ・セットも表示せずに、 SYS1.DUMP03
データ・セット内のダンプからの症状を調べる場合は、次のように入力しま
す。
DISPLAY DUMP,ERRDATA,DSN=03
最新の自動割り振りダンプ・データ・セットとすべての事前割り振りダンプ・
データ・セットからの症状を調べる場合は、次のように入力します。
DISPLAY DUMP,ERRDATA
または
DISPLAY DUMP,ERRDATA,DSN=ALL
最新の 5 つの割り振り済みダンプ・データ・セットからの症状を調べる場合
は、次のように入力します。
DISPLAY DUMP,ERRDATA,AUTODSN=5
DUMPID=005 で識別されるキャプチャー・データからの症状を調べる場合
は、次のように入力します。
DISPLAY DUMP,ERRDATA,DUMPID=005
例: DISPLAY,DUMP ERRDATA コマンドからの出力
DISPLAY DUMP,ERRDATA コマンドを使用すると、ダンプをフォーマット設
定せずに、あるいはシステム・ログを読み取らずにダンプについての基本情報
を検索することができます。メッセージ IEE854I は、エラー発生時の PSW、
システム異常終了コードおよび理由コード、および関連するモジュールと
CSECT を含むエラー・データ情報を表示します。
d d,errdata
IEE854I 13.01.25 SYS1.DUMP ERRDATA 745
SYS1.DUMP DATA SETS AVAILABLE=001 AND FULL=001
CAPTURED DUMPS=0000, SPACE USED=00000000M, SPACE FREE=00000500M
DUMP00 TITLE=ABDUMP ERROR,COMPON=ABDUMP,COMPID=5752-SCDMP,
ISSUER=IEAVTABD
DUMP TAKEN TIME=13.01.02 DATE=09/27/1996
ERRORID=SEQ00010 CPU0000 ASID0010 TIME=13.00.55
SYSTEM ABEND CODE=0C1 REASON CODE=00000001
MODULE=IGC0101C CSECT=IEAVTABD
PSW AT TIME OF ERROR=070C0000 823FE0F6 ILC=2 INT=01
TRANSLATION EXCEPTION ADDR=008E1094
ABENDING PROGRAM ADDR=******** RECOVERY ROUTINE=ADRECOV
GPR 0-3 00000000 7F6EBAE4 023FFFF6 023F2BFF
GPR 4-7 008FD088 023FEFF7 823FDFF8 7F6EC090
GPR 8-11 00000048 7F6EC938 7F6EBA68 7F6EBA68
GPR12-15 7F6EB538 7F6EB538 00000000 00000000
NO DUMP DATA AVAILABLE FOR THE FOLLOWING EMPTY SYS1.DUMP DATA SETS: 01
2-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
参照
DISPLAY オペレーター・コマンドについては、「z/OS MVS システム・コマンド」
を参照してください。
事前割り振りデータ・セットまたは SYS1.DUMPxx データ・セットの印
刷、表示、コピー、およびクリア
SVC ダンプは作成時には不定様式です。IPCS を使用してダンプをフォーマット設
定し、そのあとでダンプを端末装置で表示するか印刷することができます。
ダンプを永続データ・セットにコピーしたら、DUMPDS オペレーター・コマンドで
そのデータ・セットをクリアしてください。別のダンプ用にそのデータ・セットが
使用できるようになります。その後 IPCS を使用してそのコピーを表示してくださ
い。
テープに書き出されたダンプをコピーできるので、IPCS を使用してより効果的にダ
ンプを表示することができます。
第 2 章 SVC ダンプ
2-23
SVC ダンプ
例: SVC ダンプ・データ・セットの印刷、コピー、および消去のための JCL
事前割り振りデータ・セットまたは SYS1.DUMPxx データ・セットの場合、
この JCL は次のことを行います。
v SYS1.DUMP00 データ・セット内の SVC ダンプを使用します。IPCSDUMP
DD ステートメントがこのデータ・セットを識別します。
v SYS1.DUMP00 データ・セットから DUMPOUT DD ステートメントで識別
するデータ・セットにダンプをコピーします。この例を使用する場合は、
DUMPOUT DD ステートメントを変更して、必要な位置の DSNAME を指
定するようにしてください。
v SYS1.DUMP00 データ・セットをクリアし、新しいダンプでそれが使用でき
るようにします。
v DELETE(DDIR) ステートメントで IPCS ダンプ登録簿を削除します。この
ステートメントは、登録簿 ID 内のバッチ・ジョブの USERID を使用しま
す。
v BLSCDDIR ステートメントを使用してダンプ登録簿を割り振ります。デフ
ォルトはボリューム VSAM01 です。例では VSAM11 を示しています。必
要なボリュームでデフォルトのボリュームを指定変更します。
v LIST 0 で IPCS サブコマンドを使用してダンプをフォーマット設定しま
す。この例を使用する場合は、LIST 0 コマンドを必要な IPCS サブコマン
ドまたは CLIST で置き換えます。CLIST については、z/OS MVS IPCS ユ
ーザーズ・ガイド を参照してください。
//IPCSJOB JOB
//IPCS
EXEC PGM=IKJEFT01,DYNAMNBR=75,REGION=1500K
//SYSPROC DD
DSN=SYS1.SBLSCLI0,DISP=SHR
//IPCSDUMP DD
DSN=SYS1.DUMP00,DISP=SHR
//DUMPOUT DD
DSN=GDG.DATA.SET(+1),DISP=SHR
//SYSUDUMP DD
SYSOUT=*
//IPCSTOC DD
SYSOUT=*
//IPCSPRNT DD
SYSOUT=*
//SYSTSPRT DD
SYSOUT=*
//SYSTSIN DD
*
DELETE(DDIR) PURGE CLUSTER
BLSCDDIR VOLUME(VSAM11)
IPCS NOPARM
SETDEF DD(IPCSDUMP) LIST NOCONFIRM
LIST 0
COPYDUMP INFILE(IPCSDUMP) OUTFILE(DUMPOUT) CLEAR NOPRINT NOCONFIRM
END
/*
SVC ダンプの内容
ABEND ダンプとは異なり、SVC ダンプにはシステム初期設定時にダンプ・オプシ
ョン・リストを設定する parmlib メンバーがありません。IBM 提供の IEACMD00
parmlib メンバーには、CHNGDUMP オペレーター・コマンドが含まれています。
このコマンドはローカル・システム・キュー・エリア (LSQA) とトレース・データ
(TRT) を、SDUMP マクロまたは SDUMPX マクロまたは DUMP オペレーター・
2-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
コマンドが要求するすべての SVC ダンプに追加し、SLIP オペレーター・コマンド
が要求する SVC ダンプには追加しません。
SVC ダンプ内のエリアの内容はダンプのタイプによります。
v スケジュール SVC ダンプ: ダンプ内の現行のタスク制御ブロック (TCB) と要求
ブロック (RB) は、障害を起こしたタスクではなくダンプ・タスクについてのも
のです。ダンプ内のその他のアドレス・スペースについては、TCB と RB はダ
ンプ・タスクについてのものです。
v 同期 SVC ダンプ: ダンプ内の現行の TCB と RB は障害を起こしたタスクのも
のです。
参照
SVC ダンプからのフォーマット設定された IPCS 出力の例は、「z/OS MVS IPCS
コマンド」を参照してください。
SVC ダンプ内容のカスタマイズ
SVC ダンプの内容をカスタマイズして、ユーザーのインストール・システムの要件
に合わせることができます。たとえば、ダンプするエリアを追加する、ダンプ・サ
イズを減らす、またはハイパースペースをダンプしたい場合が考えられます。ほと
んどの場合は、SVC ダンプの内容または要約ダンプの内容を、SDUMP マクロまた
は SDUMPX マクロの SDATA パラメーター、あるいはオペレーター・コマンドで
カスタマイズします。
ダンプ・サイズの削減
通常のデフォルトの値を持たないより小さいダンプを入手する場合は、SDUMP ま
たは SDUMPX マクロの SDATA パラメーターに NODEFAULTS オプションを指
定します。NODEFAULTS オプションを指定すると、ダンプには次のものが含まれ
ます。
v IPCS がダンプ分析で必要とする特定のデフォルトのシステム・エリア
v SDUMP マクロまたは SDUMPX マクロで要求されたエリア
ハイパースペース
SVC ダンプにはハイパースペースは含まれません。SVC ダンプにハイパースペー
スを含める場合は、ユーザーがプログラムを作成して、データをハイパースペース
からダンプするアドレス・スペース・ストレージにコピーする必要があります。
エリアの追加
要求したダンプに必要なすべてのエリアが含まれない場合は、エリアを追加するた
めに下記の方法の 1 つを参照してください。
v 『SDATA パラメーターを使用して内容をカスタマイズする』
v 2-31 ページの『SVC ダンプ内の要約ダンプの内容』
v 2-34 ページの『オペレーター・コマンドで内容をカスタマイズする』
SDATA パラメーターを使用して内容をカスタマイズする
IBM 提供のデフォルトの内容とカスタマイズで使用できる内容についての詳しい情
報は 2-26 ページの表 2-2 で説明します。この表では、ダンプ内のエリアを指定す
第 2 章 SVC ダンプ
2-25
SVC ダンプ
るパラメーターごとに英字順に表示します。ダンプを要求する前に、潜在的なエラ
ーを診断するためにどのエリアを使用するかを決定してください。表内でそのエリ
アを検出します。ダンプの下の欄の記号は、そのダンプでエリアを獲得するための
方法を示します。記号の意味は次のとおりです。
C
ダンプを要求したコマンドで使用できる
D
IBM 提供のデフォルトの内容
M
ダンプを要求するマクロで使用できる
P
ダンプ・オプションを制御する parmlib メンバーで使用できる
X
ダンプ・タイプのオプションを変更する CHNGDUMP オペレーター・コマ
ンドで使用できる
ブランク
無記号はエリアが獲得できないことを示す
注: システム・オペレーター・コマンドとアセンブラー・マクロが、表内のパラメ
ーターを使用してダンプ内容を指定します。
表内の記号の順序は重要ではありません。
表 2-2. SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ
ACTION=
SDATA
パラメーター・
オプション
ダンプ内容
ACTION=
パラメーター
を指定した
SDUMP
TRDUMP
ACTION=
コマンド
パラメーター SLIP
ACTION=
TRDUMP
ACTION=
TRDUMP
ACTION=
マクロ
コマンド
コマンド
DUMP
コマンド
SLIP
コマンド
SLIP
パラメーター
コマンド
SDUMPX
パラメーター
コマンドの
コマンドの
コマンドの
コマンドの
SVCDUMPRGN=
パラメーター SVC ダンプ SVC ダンプ SVC ダンプ YES
ALLNUC
DAT オンと DAT
オフの中核
M C X
X
ALLPSA
すべてのプロセッ
サー用の接頭部保
管域 (PSA)
D M X
D
COUPLE
システム間結合内
のデータ
M C X
X
を指定した
SLIP
C
C
C
D C
C
C
C
C
C
D C
C
C
注: COUPLE を
SDUMP マクロで
指定することはで
きません。ただ
し、SDUMPX マ
クロに指定するこ
とはできます。
CSA
共通サービス・エ
リア (CSA) (サブ
プール
227、228、
231、241)
M C X
DEFAULTS
デフォルトのエリ
ア
M X
2-26
D
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
表 2-2. SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ (続き)
ACTION=
パラメーター
SDATA
パラメーター・
オプション
GRSQ
ACTION=
TRDUMP
を指定した
ACTION=
ACTION=
ACTION=
SDUMP
マクロ
パラメーター SLIP
コマンド
を指定した
コマンド
TRDUMP
コマンド
TRDUMP
コマンド
ACTION=
パラメーター
コマンド
DUMP
SLIP
SLIP
SLIP
コマンド
SDUMPX
コマンドの
コマンドの
コマンドの
コマンドの
SVCDUMPRGN=
ダンプ内容
パラメーター
パラメーター SVC ダンプ SVC ダンプ SVC ダンプ YES
ダンプされるタス
クのグローバル・
リソース逐次化制
御ブロック
v グローバル・キ
ュー制御ブロッ
M C X
X
C
C
C
X
D C
C
C
ク
v ローカル・キュ
ー制御ブロック
IO
ダンプされるタス D
クの入出力監視プ
ログラム (IOS) 制
御ブロック
v EXCPD
v UCB
LPA
活動リンク・パッ
ク域 (LPA): モジ
ュール名と内容
LSQA
アドレス・スペー D M C X
スに割り振られた
ローカル・システ
ム・キュー域
(LSQA) (サブプー
ル 203 - 205、
213 - 215、 223 225、 229、230、
233 - 235、 249、
253 - 255)
D X
D C
C
C
M C X
NOALL
ALLPSA なし
M X
X
C
C
C
NOALLPSA
ALLPSA なし
M X
X
C
D C
D C
NODEFAULTS
v IPCS ダンプ分
析で必要な最小
のデフォルト・
エリア
v SDUMP マクロ
または
SDUMPX マク
ロで要求された
エリア
M
NOPSA
PSA なし
C
NOSQA
SQA なし
M C X
X
C
D C
D C
NOSUM
SUM なし
M C X
X
C
D C
D C
第 2 章 SVC ダンプ
2-27
SVC ダンプ
表 2-2. SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ (続き)
ACTION=
パラメーター
SDATA
パラメーター・
オプション
ダンプ内容
を指定した
ACTION=
ACTION=
ACTION=
SDUMP
マクロ
パラメーター SLIP
コマンド
を指定した
TRDUMP
コマンド
TRDUMP
コマンド
ACTION=
パラメーター
コマンド
DUMP
SLIP
SLIP
SLIP
コマンド
SDUMPX
コマンドの
コマンドの
コマンドの
コマンドの
SVCDUMPRGN=
パラメーター
パラメーター SVC ダンプ SVC ダンプ SVC ダンプ YES
制御プログラム中 M C X
核の読み取り/書き
込み部分 (すなわ
ち、DAT-on 中核
の表示ページ保護
エリアのみ)、次の
ものを含みます。
v CVT
v LSQA
NUC
ACTION=
TRDUMP
コマンド
X
D C
C
C
D X
D C
C
C
X
D C
C
C
v PSA
v SQA
PSA
エラー発生時のプ
ロセッサーまたは
ダンプ時のプロセ
ッサーの、接頭部
保管域 (PSA)
RGN
ダンプされる各ア M C X
ドレス・スペース
の専用エリア内に
割り振られたペー
ジ。サブプール 0
- 127、 129 132、 203 - 205、
213 - 215、 223 225、229、230、
236、237、244、
249、251 - 255 を
含む。 また、2
GB アドレス部分
より上に割り振ら
れた適格ストレー
ジ。
SERVERS
IEASDUMP によ
って追加されたエ
リア。SERVERS
出口
M C X
SQA
割り振られたシス
テム・キュー・エ
リア (SQA) (すな
わち、サブプール
226、239、
245、247、248)
D M C X
D X
D C
C
C
SUM
要約ダンプ ( 2-31
ページの『SVC
ダンプ内の要約ダ
ンプの内容』を参
照)
D M C X
D X
D C
C
C
2-28
D M C X
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
C
SVC ダンプ
表 2-2. SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ (続き)
ACTION=
パラメーター
SDATA
パラメーター・
オプション
ダンプ内容
ACTION=
TRDUMP
を指定した
ACTION=
ACTION=
ACTION=
SDUMP
マクロ
パラメーター SLIP
コマンド
を指定した
コマンド
TRDUMP
コマンド
TRDUMP
コマンド
ACTION=
パラメーター
コマンド
DUMP
SLIP
SLIP
SLIP
コマンド
SDUMPX
コマンドの
コマンドの
コマンドの
コマンドの
SVCDUMPRGN=
パラメーター
パラメーター SVC ダンプ SVC ダンプ SVC ダンプ YES
SWA
スケジューラー作 M C X
業域 (SWA) (すな
わち、サブプール
236 と 237)
D X
C
C
C
TRT
使用できるシステ
ム・トレース、汎
用トレース機能
(GTF) トレース、
およびマスター・
トレース
D M C X
D X
D C
D C
D C
デフォルトのシ
ステム・データ
使用できる場合は
命令アドレス・ト
レース
D
D
D
D
D
第 2 章 SVC ダンプ
2-29
SVC ダンプ
表 2-2. SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ (続き)
ACTION=
パラメーター
SDATA
パラメーター・
オプション
デフォルトのシ
ステム・データ
ACTION=
TRDUMP
を指定した
ACTION=
ACTION=
ACTION=
SDUMP
マクロ
パラメーター SLIP
コマンド
を指定した
コマンド
TRDUMP
コマンド
TRDUMP
コマンド
ACTION=
パラメーター
コマンド
DUMP
SLIP
SLIP
SLIP
コマンド
SDUMPX
コマンドの
コマンドの
コマンドの
コマンドの
SVCDUMPRGN=
ダンプ内容
パラメーター
パラメーター SVC ダンプ SVC ダンプ SVC ダンプ YES
中核マップとシス
テム制御ブロッ
ク。下記のものを
含みます。
v ダンプされる各
アドレス・スペ
D
ースの ASCB
v ASVT
v 各アドレス・ス
ペース用の許可
テーブル
v CVT、CVT 接
頭部、および 2
次 CVT (SCVT)
v 各アドレス・ス
ペース用のエン
トリー・テーブ
ル
v GDA
v ダンプされる各
アドレス・スペ
ースの JSAB
v リンケージ・ス
タック
v 各アドレス・ス
ペース用のリン
v
v
v
v
ケージ・テーブ
ル
PCCA および
PCCA ベクト
ル・テーブル
TOT
TRVT
UCB
デフォルトのシ
ステム・データ
DFP の 3.1.0 以降 D
のリリースがイン
ストールされてい
る場合は、DFP 問
題データ
D
D
デフォルトのシ
ステム・データ
ダンプされるタス
ク、およびそのす
べてのサブタスク
のプログラム・デ
ータに使用される
ストレージ
D
D
2-30
D
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
D
D
SVC ダンプ
表 2-2. SDATA パラメーターを使用した SVC ダンプの内容のカスタマイズ (続き)
ACTION=
パラメーター
ACTION=
TRDUMP
を指定した
ACTION=
ACTION=
ACTION=
SDUMP
マクロ
パラメーター SLIP
コマンド
を指定した
TRDUMP
コマンド
TRDUMP
コマンド
ACTION=
パラメーター
コマンド
DUMP
SLIP
SLIP
SLIP
コマンド
SDUMPX
コマンドの
コマンドの
コマンドの
コマンドの
SVCDUMPRGN=
ダンプ内容
パラメーター
パラメーター SVC ダンプ SVC ダンプ SVC ダンプ YES
デフォルトのシ
ステム・データ
ストレージ: エラ
ーが発生した時点
での PSW 内のア
ドレスの 4 キロ
バイト前と 4 キ
ロバイト後
D
デフォルトのシ
ステム・データ
SUBTASKS: ダン
プしようとしてい
るタスクのストレ
ージと、そのサブ
タスクのすべてに
ついてのプログラ
ム・データ
SDATA
パラメーター・
オプション
D
コマンド
D
SVC ダンプ内の要約ダンプの内容
2 つの理由で要約ダンプを要求します。
1. SUM または SUMDUMP パラメーターは、1 つのパラメーターを指定した、多
くの有益で、事前定義されたエリアを要求します。
2. 使用不能、ロックされた、または SRB モードのプログラムからの要求について
は、システムはただちにダンプを書き出すことはありません。そのため、システ
ムの活動が、非常に重要な診断データを破壊してしまう場合があります。SUM
または SUMDUMP が指定されると、要求の出された時点での選択データ・エリ
アのコピーを保管し、その後書き出す時に SVC ダンプにそのエリアを含めま
す。
SDUMP または SDUMPX マクロ・パラメーターを使用して、異なるタイプの要約
ダンプを要求します。次のようにします。
v 使用不能時の要約ダンプ。この要約ダンプはスケジュールされたダンプ要求側に
制御を戻す前に、迅速で頻繁な変更の対象となったデータを保管します。このダ
ンプについてはシステムが使用不能なので、ダンプにはページインされている
か、または DREF ストレージにあるデータのみが含まれます。使用不能時の要約
ダンプを入手する場合は、 BRANCH=YES と SUSPEND=NO を SDUMP マクロ
または SDUMPX マクロに指定します。
v 停止時の要約ダンプ。この要約ダンプも、スケジュールされたダンプ要求側に制
御を戻す前に、迅速で頻繁な変更の対象となったデータを保管します。ただし、
このダンプでは、ページング可能データを保管することができます。停止時の要
約ダンプ・データを入手する場合は、下記の作業を行います。
– SDUMP または SDUMPX マクロでは、BRANCH=YES と SUSPEND=YES を
指定してください。
第 2 章 SVC ダンプ
2-31
SVC ダンプ
– SDUMPX マクロの場合は、SUMLSTL パラメーターを指定したスケジュール
化されたダンプについて BRANCH=NO を指定します。
v 使用可能時の要約ダンプ。この要約ダンプは揮発性のシステム情報を含みませ
ん。システムは、ダンプ要求側に制御を戻す前に、この要約ダンプを書き出しま
す。要約情報は、ダンプされる各アドレス・スペースについて保管されます。使
用可能な要約ダンプを入手するためには、下記の手順に従います。
– SDUMP または SDUMPX マクロでは、BRANCH=NO を指定します。
– SLIP オペレーター・コマンドでは、SDATA パラメーターを指定しないか、ま
たは SDATA パラメーターで SUM を指定します。
– DUMP オペレーター・コマンドでは、SDATA パラメーターを指定しないか、
または SDATA パラメーターで SUM を指定します。このダンプには、シス
テムが問題を検出した時点にシステムが作成したデータは含みません。たとえ
ば、このダンプはシステム診断作業域 (SDWA) を含みません。
次の表では、S はエリアがそのダンプ・タイプの要約ダンプに含まれることを示し
ます。
表 2-3. 要約ダンプによる SVC ダンプ内容のカスタマイズ
ダンプ内容の要約
使用不可時の
要約ダンプ
停止時の
要約ダンプ
ダンプ・タスクのアドレス・スペース用のアドレス・スペース
ID (ASID) レコード
使用可能時の
要約ダンプ
S
下記のものを含む、障害を起こしたタスク用の制御ブロック
v タスク・モード・ダンプ要求側について
S
– アドレス・スペース制御ブロック (ASCB)
– 要求ブロック (RB)
– タスク制御ブロック (TCB) と関連するリカバリー終了管理
2 作業域 (RTM2WA) がポイントするシステム診断作業域
(SDWA)
– TCB
– 拡張状況ブロック (XSB)
v サービス要求ブロック (SRB) モード・ダンプ要求側について
– ASCB
– 延期 SRB 保管域 (SSRB)
– ダンプで使用する SDWA
– XSB
S
リカバリー終了マネージャー (RTM) 用の制御ブロック
S
v ダンプされたアドレス・スペース内のすべての TCB と関連
する RTM2WA
v ダンプ要求側の TCB と関連した RTM2WA
仮想記憶間状況レコードおよび、ダンプ要求側が仮想記憶間ロー S
カル (CML) ロックを保持している場合は、ローカル・ロックが
保持されているアドレス・スペースについての ASCB のアドレ
ス
2-32
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
S
S
SVC ダンプ
表 2-3. 要約ダンプによる SVC ダンプ内容のカスタマイズ (続き)
ダンプ内容の要約
使用不可時の
要約ダンプ
停止時の
要約ダンプ
使用可能時の
要約ダンプ
AMDDATA がマップするダンプ・ヘッダー
S
S
S
AMDDATA マッピングについては、z/OS MVS Data Areas, Vol
1 (ABEP-DALT) を参照してください。
現行プロセッサー用の機能リカバリー・ルーチン (FRR) スタッ S
ク
ホーム・アドレス・スペース用または、CML が保管されている S
場合は、ローカル・ロックが保管されているアドレス・スペース
用の割り込みハンドラー保管域 (IHSA)
S
各活動状態プロセッサー用の論理連絡域 (LCCA)
S
S
各活動状態のプロセッサーについての物理構成連絡域 (PCCA)
S
S
プログラム呼び出しリンク・スタック・エレメント (PCLINK)
スタック・エレメント
S
AR モード呼び出し側が要求するダンプでは、LCCA には AR
モード制御ブロックが含まれます
v PSASEL がポイントする
v ダンプ内の IHSA と関連する XSB がポイントする
S
v SRB モード・ダンプ要求側についての SSRB と XSB がポイ
ントする
S
S
v 延期された作業単位と関連する
S
各活動状態プロセッサーについての接頭部保管域 (PSA)
S
レジスターの内容の保管域
S
S
システム・ルーチンの障害と関連した SDWA
S
ストレージ: ストレージ範囲と SDUMP または SDUMPX マク
ロ内のパラメーターで要求される ASID
S
ストレージ: 4 キロバイト前と 4 キロバイト後。
S
S
S
v プログラム状況ワード (PSW) 内のアドレス
v ダンプ内に示される IHSA に保管されたレジスター内のすべ
ての有効な固有アドレス
v ダンプ内に示される SDWA に保管されたレジスター内のす
べての有効な固有アドレス
v 外部旧 PSW、プログラム・チェック旧 PSW、入出力旧
PSW、および活動状態の各プロセッサーの PSA に保管される
再始動旧 PSW の命令カウンター値
ストレージ: 4 キロバイト前と 4 キロバイト後。
S
v ダンプ内に示される SDWA に保管されたレジスター内のす
べての有効な固有アドレス
v ダンプ要求側のレジスター保管域のレジスターのすべての有
効な固有アドレス
v ダンプ内の全 SDWA 内の PSW 内のすべての有効な固有ア
ドレス
第 2 章 SVC ダンプ
2-33
SVC ダンプ
表 2-3. 要約ダンプによる SVC ダンプ内容のカスタマイズ (続き)
使用不可時の
要約ダンプ
ダンプ内容の要約
停止時の
要約ダンプ
ストレージ: 4 キロバイト前と 4 キロバイト後。
使用可能時の
要約ダンプ
S
v ダンプ内に示される RTM2WA 内の PSW のすべての有効な
固有アドレス
v ダンプ内に示される RTM2WA に保管されたレジスター内の
すべての有効な固有アドレス
ストレージ: PSWREGS パラメーターを SDUMP または
SDUMPX マクロに指定する場合は、下記のアドレスの 4 キロ
バイト前と 4 キロバイト後。
v PSWREGS パラメーターに指定した PSW 内のアドレス
v PSWREGS パラメーターに指定した汎用レジスター内のアド
レス
S
S
S
S
S
S
ダンプされたストレージは、SDUMP または SDUMPX マクロ
を発行するプログラムの 1 次または 2 次アドレス・スペースか
らのものです。PSWREGS パラメーターに指定する制御レジス
ターは、1 次または 2 次アドレス・スペースを判別するために
使用します。
アクセス・レジスターも提供され、その PSW が AR ASC モー
ドを示している場合は、そのアクセス・レジスターはデータを位
置付けるためにも使用されます。
監視プログラム制御ブロック:
v 現行リンケージ・スタック
v 1 次アドレス・スペース番号 (PASN) アクセス・リスト
v 作業単位アクセス・リスト
ベクトル機構制御ブロック: グローバル、CPU、およびローカル S
作業域 / 保管域ベクトル・テーブル (WSAVTG、WSAVTC、お
よび WSAVTL ) およびそのテーブル内のアドレスでポイントさ
れる作業域 / 保管域
ダンプ内の IHSA と関連する XSB
S
S
参照
上記の表にリストされる制御ブロックについての情報は下記を参照してください。
v z/OS MVS Data Areas, Vol 1 (ABEP-DALT)
v z/OS MVS Data Areas, Vol 2 (DCCB-ITZYRETC)
v z/OS MVS Data Areas, Vol 3 (IVT-RCWK)
v z/OS MVS Data Areas, Vol 4 (RD-SRRA)
v z/OS MVS Data Areas, Vol 5 (SSAG-XTLST)
オペレーター・コマンドで内容をカスタマイズする
SVC ダンプのダンプ・オプション・リストは、 2-35 ページの表 2-4 に示されるす
べての方法で、 DUMP オペレーター・コマンドによりカスタマイズすることがで
きます。
2-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
注: SLIP オペレーター・コマンドが要求する SVC ダンプの内容は、 SLIP オペレ
ーター・コマンドによってのみ制御できます。IEACMD00 parmlib メンバーま
たは CHNGDUMP コマンドに影響されることはありません。
ダンプ内の中核域
ダンプ・オプションは、ダンプ内に出力される中核部分を制御することができま
す。ときには診断で中核すべてを解析する必要が生じる場合があります。インスト
ール・システムでダンプからすべての中核域を削除することができます。IBM 提供
のデフォルトの値を使用する場合は、
v ACTION=SVCD を指定した SLIP オペレーター・コマンドについての SVC ダン
プは読み取り/書き込み DAT-on 中核を含みます。
v SDUMP または SDUMPX マクロについての SVC ダンプは中核マップと特定の
制御ブロックを含みます。
中核を変更していない場合は、インストール・システムは、すべてのダンプで使用
できる DAT-off 中核の 1 つのコピーを取得する必要があります。この中核を入手
するためには、SDATA=ALLNUC を指定し、その他の SDATA オプションを指定し
ないで DUMP オペレーター・コマンドを入力します。中核は、IPL と IPL 間で変
更されないので、1 つのダンプを繰り返し使用することができます。
DAT、動的アドレス変換は、仮想記憶域を使用するためのハードウェア機能です。
中核の DAT オン部分では、アドレスは仮想記憶域内です。中核の DAT オフ部分
では、アドレスは中央記憶装置内です。
表 2-4. オペレーター・コマンドを使用して SVC ダンプの内容をカスタマイズする
カスタマイズ
効果
例
SDUMP または SDUMPX マクロで
SDATA=NODEFAULTS を使用する
変更が生じる時: ダンプ要求時
ダンプ内のデフォルトのデータの量を
最小にするためには、プログラムで次
のコーディングを行います。
変更内容: 現在有効な次の SDATA
のデフォルト・オプションを除く
SDUMPX SDATA=NODEFAULTS
v ALLPSA
v SQA
v SUMDUMP
v IO
v IEACMD00 parmlib メンバーまたは
コンソールを通じて入力したすべて
の CHNGDUMP オペレーター・コ
マンドから
排除は要求するダンプについてのみ適
用されます。
特定のデフォルトのシステム・エリア
は排除されないことに注意してくださ
い。これらのエリアは IPCS ダンプ分
析に必要です。
CHNGDUMP オペレーター・コマン
ドは NODEFAULTS オプションを指
定変更することができます。
第 2 章 SVC ダンプ
2-35
SVC ダンプ
表 2-4. オペレーター・コマンドを使用して SVC ダンプの内容をカスタマイズする (続き)
カスタマイズ
効果
例
IEACMD00 parmlib メンバー内の
CHNGDUMP オペレーター・コマン
ドを置き換える
ローカル・システム・キュー・エリア
(LSQA) とトレース・データを保持し
変更内容: このコマンドは、SDUMP
ながら SDUMP または SDUMPX マ
または SDUMPX マクロと DUMP オ クロと DUMP オペレーター・コマン
ペレーター・コマンド用の SVC ダン ド用のすべての SVC ダンプに、リン
プの IBM 提供のダンプ・オプション ク・パック域 (LPA) を追加する場合
を設定します。リストについては
は、IEACMD00 に次のコマンドを追
2-24 ページの『SVC ダンプの内容』 加してください。
を参照してください。
CHNGDUMP SET,SDUMP=(LPA)
変更が生じる時: システム初期設定時
変更が生じる時: コマンドが処理され
SDUMP パラメーターを指定した
CHNGDUMP オペレーター・コマン るとすぐ
ドをマスター権限を持つコンソールで
変更内容:
入力します
ADD モードの場合: CHNGDUMP オ
プションは、現行の SVC ダンプ・オ
プション・リストと、ダンプを要求す
るマクロまたはオペレーター・コマン
ドに指定するすべてのオプションに追
加されます。オプションは、別の
CHNGDUMP SDUMPX コマンドが入
力されるまで、SDUMP または
SDUMPX マクロと DUMP オペレー
ター・コマンドのすべての SVC ダン
プに追加されます。
OVER モードの場合: CHNGDUMP
オプションは、現行の SVC ダンプ・
オプション・リストに追加されます。
システムは、ダンプを要求するマクロ
またはオペレーター・コマンドで指定
したすべてのオプションを無視しま
す。オプションは CHNGDUMP
SDUMP,ADD オペレーター・コマン
ドが入力されるまで SDUMP または
SDUMPX マクロと DUMP オペレー
ター・コマンドのすべての SVC ダン
プを指定変更します。
DEL オプションの場合: CHNGDUMP
オプションは SVC ダンプ・オプショ
ン・リストから削除されます。
別の CHNGDUMP SDUMP で変更す
るまで、SDUMP または SDUMPX マ
クロと DUMP オペレーター・コマン
ドの SVC ダンプに LPA を追加する
場合は、次のように入力します。
CHNGDUMP SET,SDUMP=(LPA)
CHNGDUMP SDUMPX オプション・
リストをすべての SVC ダンプに追加
する場合は、次のように入力します。
CHNGDUMP SET,SDUMP,ADD
CHNGDUMP SDUMPX オプション・
リストを指定したすべての SVC ダン
プを指定変更する場合は、次のように
入力します。
CHNGDUMP SET,SDUMP,OVER
SDUMPX オプション・リストから
LPA を除去する場合は、次のように
SDUMPX を指定した CHNGDUMP
オペレーター・コマンドが複数回入力 入力します。
されると、効果は累積されます。
CHNGDUMP DEL,SDUMP=(LPA)
2-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
表 2-4. オペレーター・コマンドを使用して SVC ダンプの内容をカスタマイズする (続き)
カスタマイズ
効果
オペレーター・コマンド・パラメータ 変更が生じる時: ダンプ要求時
ーを使用する
変更内容: DUMP オペレーター・コ
DUMP オペレーター・コマンドのパ マンド・パラメーター・オプションは
ラメーターは、要求しているダンプの ダンプ・オプション・リストに追加さ
れますが、要求しているダンプについ
内容を指定します。
てのみ適用されます。
例
この SVC ダンプに ALLNUC を追加
する場合は、次のように入力します。
DUMP COMM=(MYDUMP1 5-9-88)
システムが次のようなメッセージを発
行します。
* 23 IEE094D SPECIFY OPERAND(S)
FOR DUMP COMMAND
次のように応答します。
REPLY 23,JOBNAME=MYJOB1,
SDATA=(ALLNUC),END
SVC ダンプの調整
サーバーでは、クライアント以外のアドレス・スペースやデータ・スペースにクラ
イアント関連のデータが保持される場合があり、そのようなデータはダンプに出力
されません。このような理由から、調整した SVC ダンプ出口を作成することによ
り、サーバー・コードで SVC ダンプの内容を修正し、追加の問題判別データを提
供できるようになっています。この機能により、要求側は、実際には不明または動
的な可能性のある、関連するサーバー・アドレス、データ・スペース、およびスト
レージ域を指定せずにダンプ要求を指定することができます。
サーバー・コードの提供者は、モジュール IEAVTSXT を修正せずにこのような
SVC ダンプ出口を作成できます。 CSVDYNEX マクロは、出口ロード・モジュー
ルを識別し、IEASDUMP.SERVER リソースと関連付けます。この出口は、現行のダ
ンプ要求をスキャンして、データをダンプに追加する必要があるかどうかを判別す
ることができます。データは、該当する SDMSE_OUTPUT エリアでそれを識別する
ことによって、ダンプに追加されます。詳細については、「z/OS MVS Programming:
Authorized Assembler Services Guide」の『IEASDUMP.SERVER Dynamic Exit
Processing』を参照してください。
調整した SVC ダンプ出口は、特定の順序では呼び出されません。現在の要求が出
口に確実に渡されるように、ダンプ要求は出口の呼び出し間で更新されます。出口
がデータをダンプに追加すると、それぞれの出口は、それ以上変更が行われなくな
るまで、再度呼び出されます。追加の処理が必要であるため、デフォルトでは、調
整した SVC ダンプ出口は SDUMPX マクロ要求の制御を受けません。終了処理が
行われるようにするには、SDUMPX マクロで SDATA=SERVERS を指定する必要
があります。
SDATA=SERVERS は、すべてのオペレーター Dump 要求と SLIP SVC ダンプ要求
で有効です。
第 2 章 SVC ダンプ
2-37
SVC ダンプ
要約 SVC ダンプの分析
SDUMP または SDUMPX マクロの SUMDUMP または SUM オプションを使用す
ると、SVC ダンプで要約ダンプを採取します。要約ダンプには、2 つのタイプの情
報が採取されます。1 つ目は、記憶域に対する索引データです。この索引データ
は、IPCS VERBX SUMDUMP コマンドでフォーマット設定できます。採取される
2 番目のタイプの情報は、記憶域そのものです。要約ダンプ処理で取り込まれる記
憶域は、SUMDUMP オプション (IPCS LIST 00003000 SUMDUMP など) を指定す
ることにより、IPCS を使用して表示できます。ダンプの通常部分を調べる前に、
SUMDUMP 出力を調べるようにお勧めします。 SUMDUMP オプションは、
SDUMP に SDUMPX 分岐項目と SVC 項目の別の出力を提供します。たとえば、
SDUMPX への分岐項目に含まれるデータは、PSA、LCCA、および PCCA 制御ブロ
ックで、SDUMPX への SVC 項目に記録されるデータには RTM2WA 制御ブロッ
クが含まれます。IPCS VERBX SUMDUMP コマンドを使用してフォーマット設定
された場合、各要約ダンプの索引レコードは、“----tttt---- range-start range-end
range-asid range-attributes” の形式で表示されます。 range-attributes には INCOMP
の値が含まれており、これは、指定した範囲で表されている領域の一部またはすべ
てがダンプの中にない場合があることを意味します。
サンプル: IPCS VERBX SUMDUMP コマンドの形式
以下は、IPCS VERBX SUMDUMP コマンドを使用した場合のサンプル・フォ
ーマットです。
STORAGE TYPE
RANGE START
RANGE END
ASID ATTRIBUTES
REGISTER AREA-0135F000
01363FFF 001E (COMMON)
REGISTER AREA-- 00000001_7F5AD000 00000001_7F5B0FFF 001E
要約ダンプは、IPCS VERBEXIT SUMDUMP サブコマンドでフォーマット設定する
ことができ、どの要約を含んでいるかを説明する索引があります。要約ダンプは
DUMP コマンドで取られるダンプについては作成されません。SDUMP または
SDUMPX マクロで作成されるダンプのみが要約ダンプを含みます。
注: SVC ダンプ処理の間に、システムはいくつかのタスクを要求されたアドレス・
スペース内でタスク・ディスパッチング不能にします。ダンプ内のタスク・デ
ィスパッチング不能なタスクは、問題の生じた時にはタスク・ディスパッチン
グ可能であった場合もあります。
2-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
例: IPCS VERBX SUMDUMP コマンド
以下のサンプルは、IPCS VERBX SUMDUMP コマンドを使用した場合の要約
ダンプの一部です。
STORAGE TYPE
SUMLSTA RANGE -SUMLSTA RANGE -SUMLSTA RANGE -PSA -----------PCCA ----------LCCA ----------LCCX ----------INT HANDLER DUCT
I.H. LINKAGE STK
REGISTER AREA -REGISTER AREA -REGISTER AREA -REGISTER AREA --
RANGE START
023BCD70
017E8000
01F9B000
02166000
00000000
00F43008
00F82000
021C7000
02232FC0
02262000
0000E000
00FC4000
00000001_7F5AD000
7FFFE000
RANGE END
023BCD7F
017E8FFF
01F9CFFF
02167FFF
00001FFF
00F4324F
00F82A47
021C771F
02232FFF
0226202F
00010FFF
00FC6FFF
00000001_7F5B0FFF
7FFFEFFF
ASID
001E
0001
0001
0001
001E
001E
001E
001E
001E
001E
001E
001E
001E
001E
ATTRIBUTES
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
(COMMON)
上記に示す記憶域を調査するには、以下のようにしてリスト・コマンドを起動
します。
IPCS LIST 00FC4000. SUMDUMP LEN(256) DISPLAY
****************************** TOP OF DATA ***********************************
LIST 00FC4000 ASID(X’001E’) SUMDUMP LENGTH(X’0100’)
AREA
ASID(X’001E’) SUMDUMP ADDRESS(FC4000.) KEY(00)
00FC4000. 7F6BFFD0 7F6BFFD0 02259010 00000000 |",.}",.}........|
00FC4010. 0225D000 02259010 00000004 00000001 |..}.............|
00FC4020. 00000000 00FC3E10 00000000 00000000 |................|
00FC4030. 00000000 00000000 00000000 00800000 |................|
00FC4040. 06102000 00000000 00000000 00000000 |................|
00FC4050 LENGTH(X’10’)==>All bytes contain X’00’
00FC4060. 00000000 02247CB8 00000000 00000000 |......@.........|
00FC4070. 02258040 0000164E 00008000 00000000 |... ...+........|
00FC4080 LENGTH(X’80’)==>All bytes contain X’00’
****************************** END OF DATA ***********************************
参照
レコード ID 値については、z/OS MVS Data Areas, Vol 4 (RD-SRRA) の SMDLR
と SMDXR 制御ブロックを参照してください。
SVC 項目 SDUMPX の SUMDUMP 出力
SVC 項目で、領域、LSQA、中核、および LPA などのオプションがダンプ・パラ
メーターに指定されていない場合、要約ダンプ内に採取された記憶域には SVC ダ
ンプの残りで使用できない情報を含むことができます。
ダンプされる各アドレス・スペースについて、ASID 付きの要約ダンプの索引レコ
ードが、アドレス・スペースで最後に作成されたタスクのジョブ名とステップ名と
ともに出力されます。SUMDUMP 出力には、ダンプされるアドレス・スペース内の
タスクについての RTM2 作業域が含まれます。RTM2WA 内のフィールドの多く
は、価値のあるデバッグ情報を提供します。
第 2 章 SVC ダンプ
2-39
SVC ダンプ
要約ダンプ・データは、次の順序でダンプされます。
1. アドレス・スペースに関する ASID レコードがダンプされます。
2. SUMLIST/SUMLSTA/SUMLSTL/SUMLIST64 範囲および PSWREGS、パラメータ
ー・リストおよびデータ ID、データが次にダンプされます。これらには、問題
をデバッグする際に役立つ情報が含まれ、注意して調べる必要があります。
3. このアドレス・スペース内のすべての TCB がポイントする RTM2 作業域がす
べてダンプされます。
4. アドレス範囲テーブルは、RTM2WA がポイントする次の範囲を含んで作成され
ます。
v エラー発生時の PSW の前 4K と後ろ 4K (RTM2NXT1)
v エラー発生時の各レジスターの前 4K と後ろ 4K (RTM2EREG)
重複ストレージは、ダンプされるストレージの合計を減らすためにこのアドレス
範囲テーブルからは除去されます。
分岐入力 SDUMPX 用の SUMDUMP 出力
SDUMP への分岐入力については、2 つのタイプの要約ダンプがあります。
v 使用不能時の要約ダンプ - 中断のために使用不能状態になったシステムで要約ダ
ンプを実行します。すなわち、要約ダンプの作成時に、ダンプする全データがペ
ージインされていなければならないことを意味します。
v 使用停止時の要約ダンプ - 2 つの部分で取られます。最初の部分は使用不能時の
要約ダンプと似ていて、グローバル・システム制御ブロックのいくつかをダンプ
します。2 番目の部分は割り込みが可能なシステムで実行されます。これは現在
ページアウトされているが、SVC ダンプ処理を要求したリカバリー・ルーチンが
修正しようとしている、データをダンプすることができます。
SVC ダンプへの分岐入り口についての SUMDUMP 出力は、ダンプの残り部分の同
じアドレスにあるデータとは一致しないことがあります。この理由は、プロセッサ
ーが中断のため使用不能である間に、SUMDUMP が SVC ダンプ入り口で取られる
ためです。別のシステム活動がダンプが完了する前に生じるので、ダンプの他のシ
ステム・データはしばしば変わります。 SUMDUMP 出力には、データを入手した
アドレス・スペースの ASID を含むヘッダーが続きます。
SDUMPX で使用不能または中断の要約ダンプをとるのを妨げる、次の条件が起きる
場合があります。
v システムが実ストレージ・バッファー (RSB) を逐次化するために必要なロックを
入手することができない。
v システムはストレージ・キューを修正する処理の途中であり、RSB に対する要求
を満足させることができない。
v RSB で使用できるフレームがない。
v SVC ダンプが RSB の逐次化を保持している間にエラーを検出する。
v 重大なフレームの不足のため、システムが RSB のページをスチールする。
v SVC ダンプ・タイマーの使用不能中断出口ルーチンが、 SVC ダンプが障害を起
こし RSB を解放したと判別する。
2-40
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
使用不能要約ダンプの分析
使用不能要約ダンプの場合は、レコードは次の順序でダンプされます。
1. 中断要約ダンプが要求されたが入手できなかった場合は、システムは使用不能
要約ダンプを入手しようとします。この場合は、その旨のエラー・レコードが
書き出されます。システムで中断要約ダンプと使用不能要約ダンプを入手でき
ない場合は、ダンプで使用できる要約データはありません。
2. ホーム、1 次、2 次、および CML (CML ロックが保持されている場合) であ
る ASID を指定する XMEM ASID レコードが書き出されます。
3. SUMLIST/SUMLSTA/SUMLSTL/SUMLIST64 アドレス範囲と PSWREGS データ
がダンプされます。
4. 各プロセッサーごとに PSA、PCCA、LCCA、および LCCX がダンプされま
す。
5. 現行の PCLINK スタック (PSASEL がポイントする) がダンプされます (存在
する場合)。
6. これがダンプを求める SLIP 要求 (ACTION=SVCD) の場合は、 SLIP レジスタ
ー/PSW エリア (SUMDUMP パラメーター・リスト SDURGPSA がポイントす
る) がダンプされます。
次のアドレス範囲がアドレス範囲テーブルに追加されます。
v SLIP トラップ時点の PSW アドレス前後の 4K。
v SLIP トラップ時点のレジスター内の各アドレス前後の 4K。
重複ストレージは、ダンプ・データ・セットに書き出されるデータ量の合計を
減らすためにこのアドレス範囲テーブルからは除去されます。
1 次または 2 次 ASID が異なる場合は、上記のアドレス範囲が両方の ASID
のテーブルに追加されます。
7. IHSA が、関連する XSB スタックと PCLINK スタックとともにダンプされま
す。IHSA からの PSW とレジスター・アドレスが範囲テーブルに追加されま
す。この結果、各アドレスの回りの 4K のストレージがダンプされることにな
ります。
8. 存在する場合は、呼び出し側の SDWA がダンプされます。SDWA からの
PSW とレジスター・アドレスが範囲テーブルに追加されます。この結果、各ア
ドレスの回りの 4K のストレージがダンプされることになります。
9. アドレス範囲テーブル内のアドレスがダンプされます。
10. スーパー FRR スタックがダンプされます。
11. グローバル、ローカル、および CPU 作業保管域 (WSA) ベクトル・テーブル
がダンプされます。これらの WSA ベクトル・テーブルのそれぞれによってポ
イントされる保管域もダンプされます。
12. 入出力旧 PSW のアドレス部分のいずれかの側の 4K ストレージ、プログラ
ム・チェック旧 PSW、外部旧 PSW、および、すべてのプロセッサー用の PSA
に保管された再始動旧 PSW が、ダンプされます。
中断要約ダンプの分析
中断要約ダンプの場合は、レコードは次の順序でダンプされます。
第 2 章 SVC ダンプ
2-41
SVC ダンプ
1. ASID: PSA、PCCA、LCCA レコード、 IHSA、XSB、および PCLINK スタック
は、使用不能要約ダンプのステップ 2、4、および 5 でダンプされたのと同じ方
法で、使用不能システムですべてダンプされます。
この時点では、SRB は DUMPSRV アドレス・スペースにスケジュールされ、現
行の作業単位 (SDUMP の呼び出し側) は STOP サービスを使用して延期されま
す。この時点でダンプされるデータは、システムが使用可能なので、ページイン
する必要はありません。仮想記憶間機能を使用して、呼び出し側のアドレス・ス
ペースでデータをアクセスできるようにします。
2. SUMLIST/SUMLSTA/SUMLSTL/SUMLIST64 アドレス範囲と PSWREGS データ
がダンプされます。
3. 呼び出し側の ASCB がダンプされます。
4. 延期された作業単位 (SVC ダンプの呼び出し側) がダンプされます。これは
TCB または SSRB のいずれかです。関連する PCLINK スタックもダンプされ
ます。
5. TCB モードの呼び出し側では、呼び出し側の SDWA がダンプされます。
SDWA からの PSW とレジスター・アドレスが範囲テーブルに追加されます。
この結果、各アドレスの回りの 4K のストレージがダンプされることになりま
す。この TCB がポイントするすべての RTM2 作業域とすべての関連する
SDWA のダンプされます。
SRB モードの呼び出し側の場合は、SDWA がダンプされます。SDWA からの
PSW とレジスター・アドレスが範囲テーブルに追加されます。この結果、各ア
ドレスの回りの 4K のストレージがダンプされることになります。また、呼び出
し側のレジスター保管域が範囲テーブルとダンプされるストレージに追加されま
す。
重複ストレージは、ダンプされるストレージの合計を減らすためにこのアドレス
範囲テーブルからは除去されます。
6. DUMPSRV アドレス・スペース内の仮想バッファーにすべてのストレージが保
管されたあとで、RESET サービスを用いて呼び出し側の作業単位をリセットし
ます。この結果 SVC ダンプは完了し、呼び出し側に戻ります。SVC ダンプ処
理が、ダンプするアドレス・スペース内で完了すると、SVC ダンプで割り込ま
れた時にそのアドレス・スペースで行われていた処理が再開されます。ダンプの
残りは、その後 DUMPSRV アドレス・スペースからスケジュールされます。
SVC ダンプの分析
このセクションでは、IPCS を使用して SVC ダンプを分析する方法を説明します。
下記のいずれかの理由で SVC ダンプを分析することがあります。
v IPCS STATUS FAILDATA サブコマンドからのダンプ出力に、診断しようとして
いる異常終了についてのデータが含まれていなかった。
v 問題に、複数の異常終了が含まれている。
v ダンプは取られたが、異常終了関連情報を含んでいない。
このセクションでは、SVC ダンプの分析用の手順を順番に、下記の項目について説
明します。
v 2-44 ページの『SVC ダンプ・ヘッダーのフォーマット設定』
2-42
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
v
v
v
v
v
v
v
v
v
2-44 ページの『ダンプ表題を調べる』
2-46 ページの『発生イベント・トークン、ダンプの時刻とタイプの表示』
2-47 ページの『エラー情報の検出』
2-49 ページの『TCB 構造体の分析』
2-51 ページの『LOGREC バッファーのテスト』
2-54 ページの『システム・トレースの検査』
2-54 ページの『レジスターを調べる』
2-56 ページの『SVC ダンプ分析に関するその他の役立つ報告書』
2-57 ページの『SDUMPX 4K SQA バッファーの読み取り』
ダンプのソースの指定
ダンプを分析する最初のステップは、IPCS がフォーマット設定するダンプのソース
を指定することです。IPCS ダイアログ機能でオプション 0 (DEFAULTS) を選択
し、 “Source” 行で SVC ダンプ・データ・セットの名前を指定します。
------------------------- IPCS Default Values --------------------------------COMMAND ===> 0
You may change any of the defaults listed below.
If you change the Source default, IPCS will display the current default
Address Space for the new source and will ignore any data entered in
the Address Space field.
Source
Address
Message
Message
Display
==> DSN(’D46IPCS.SVC.CSVLLA.DUMP002’)
Space ==>
Ignored if Source is changed.
Routing ==> NOPRINT TERMINAL
Control ==> FLAG(WARNING)
Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL
Press ENTER to update defaults.
Use the END command to exit without an update.
新しいソース名前を登録する場合は、Enter キーを押してください。それから PF3
を押して画面を終了してください。
SETDEF サブコマンドを使用して、ソースを指定することもできます。前の例のダ
ンプの場合は、次のように入力してください。
SETDEF DSNAME(’D46IPCS.SVC.CSVLLA.DUMP002’)
IPCS は、ユーザーが最初のサブコマンドを入力するか、フォーマット設定または分
析を実行する IPCS ダイアログ・オプションを入力するまでダンプの初期設定を行
いません。その時点で、IPCS はメッセージ BLS18160D を発行し、IPCS が要約ダ
ンプ・データを使用するかどうかを尋ねてきます。要約ダンプ・データは、障害が
発生した時刻に最も近くキャプチャーされたデータなので、SVC ダンプとして使用
されます。IPCS で要約ダンプ・データを使用しない場合は、同じ位置で後でキャプ
チャーされた別のデータが使用できればそれが表示されます。 そのようなデータ
は、障害が発生した時点のこれらの記憶場所にある実際のデータを表すとは限られ
ません。
第 2 章 SVC ダンプ
2-43
SVC ダンプ
SVC ダンプ・ヘッダーのフォーマット設定
SVC ダンプ・ヘッダーには、次の情報が含まれます。
v SDWA または SLIP データ
v ダンプ表題、エラー ID、およびダンプ時刻
v ダンプの要求者
この情報は、SVC ダンプのタイプを説明し、ダンプが CONSOLE ダンプであるか
または SLIP コマンドで起きたダンプであるかをユーザーに通知します。これらの
ダンプを別々に分析することができます。
次の IPCS サブコマンドを使用して SVC ダンプのヘッダーのデータをフォーマッ
ト設定することができます。
LIST TITLE
STATUS FAILDATA
STATUS REGISTERS
STATUS WORKSHEET
次のセクションでは、これらの IPCS サブコマンド (または、使用できる場合は
IPCS ダイアログ・オプション) を使用して、必要な情報を入手する方法の例を示し
ます。
ダンプ表題を調べる
ダンプ表題では、コンポーネント名、コンポーネント ID、およびモジュール名をユ
ーザーに通知します。次の IPCS サブコマンドを使用して、ダンプ表題を検出する
ことができます。
LIST TITLE
STATUS WORKSHEET
IPCS ダイアログ機能のオプション 2.3 を使用して、STATUS WORKSHEET 報告
書を入手することができます。まず基本オプション (primary option) メニューから
オプション 2 (ANALYSIS) を選択してください。
-------------------- z/OS 01.02.00 IPCS PRIMARY OPTION MENU ---------------OPTION ===> 2
0DEFAULTS
1BROWSE
2ANALYSIS
3SUBMIT
4COMMAND
5UTILITY
6DUMPS
TTUTORIAL
XEXIT
-
Specify default dump and options
Browse dump data set
Analyze dump contents
Submit problem analysis job to batch
Enter subcommand, CLIST or REXX exec
Perform utility functions
Manage dump inventory
Learn how to use the IPCS dialog
Terminate using log and list defaults
********************
* USERID - IPCSU1
* DATE
- 84/06/08
* JULIAN - 84.160
* TIME
- 16:43
* PREFIX - IPCSU1
* TERMINAL - 3278
* PF KEYS - 24
********************
Enter END command to end the IPCS dialog.
それから、ダンプ内容の分析 (analysis of dump contents) メニューからオプション
3 (WORKSHEET) を選択します。
2-44
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
-------------------- IPCS MVS ANALYSIS OF DUMP CONTENTS --------------------OPTION ===> 3
To display information, specify the corresponding option number.
1SYMPTOMS
2STATUS
3WORKSHEET
4SUMMARY
5CONTENTION
6COMPONENT
7TRACE
8STRDATA
-
Symptoms
System environment summary
System environment worksheet
Address spaces and tasks
Resource contention
MVS component data
Trace formatting
Coupling Facility structure data
*****************
* USERID - IPCSU1
* DATE
- 84/06/08
* JULIAN - 84.160
* TIME
- 16:44
* PREFIX - IPCSU1
* TERMINAL- 3278
* PF KEYS - 24
******************
Enter END command to terminate MVS dump analysis.
IPCS は図 2-2 のものと類似した情報を持つ新しい画面を表示します。ダンプの表題
は、STATUS WORKSHEET 報告書の上部にラベルが付けられます。ダンプの表題
は “Compon=Program Manager Library-Lookaside, Compid=SC1CJ,
Issuer=CSVLLBLD.” となります。
参照
ダンプの表題の説明は、「z/OS MVS 診断: 解説書」を参照してください。
IPCS OUTPUT STREAM ------------------------------------------ LINE 0 COL
COMMAND ===>
SCROLL ===
****************************** TOP OF DATA ****************************
MVS Diagnostic Worksheet
Dump Title: COMPON=PROGRAM MANAGER LIBRARY-LOOKASIDE,COMPID=SC1CJ,
ISSUER=CSVLLBLD
CPU Model 2064 Version FF Serial no. 131512 Address 01
Date: 02/15/2001 Time: 20:33:34.680912 Local
Original dump dataset: SYS1.DUMP06
Information at time of entry to SVCDUMP:
HASID 001B
PASID 001B
SASID 001B
PSW 070C1000 8001AE5A
CML ASCB address 00000000 Trace Table Control Header address 7FFE3000
Dump ID: 001
Error ID: Seq 00019 CPU 0041 ASID X’001E’ Time 20:33:33.5
図 2-2. STATUS WORKSHEET サブコマンドの出力例 - ダンプの表題
STATUS WORKSHEET は、エラー ID も表示します。 図 2-2 では、ダンプ ID は
001、エラー ID がシーケンス番号 00051、ASID=X'001B'、そしてプロセッサー
0000 です。このダンプ ID を使用して SYSLOG と LOGREC レコード内のメッセ
ージとダンプを突き合わせます。
第 2 章 SVC ダンプ
2-45
SVC ダンプ
発生イベント・トークン、ダンプの時刻とタイプの表示
IPCS サブコマンド STATUS SYSTEM は、次のものを識別します。
v ダンプの時刻
v ダンプを要求するプログラム
v 単一システム上の問題またはシスプレックス内のいくつかのシステム上の問題に
ついて、要求された 1 つまたは複数の SVC ダンプと関連する発生イベント・ト
ークン。
IPCS ダイアログ機能は STATUS SYSTEM 用のメニュー・オプションがありませ
ん。その代わりにサブコマンドを入力してください。
図 2-3 は STATUS SYSTEM 報告書の例です。スケジュールされた SVC ダンプの
場合は、次のものでダンプを識別します。
Program Producing Dump: SVCDUMP
Program Requesting Dump: IEAVTSDT
SLIP または DUMP オペレーター・コマンドが要求するダンプは、常にスケジュー
ルされた SVC ダンプです。
同期 SVC ダンプの場合は、次のものでダンプを識別します。
Program Producing Dump: SVCDUMP
Program Requesting Dump: cccccccc
ここで、cccccccc は次のうちの 1 つです。
v システムが問題を検出した時に実行していたプログラムの名前
v 障害を起こしたタスクをシステムが判別できない場合は、SVCDUMP
SYSMDUMP ABEND ダンプは、常に同期 SVC ダンプです。
SYSTEM STATUS:
Nucleus member name: IEANUC01
I/O configuration data:
IODF data set name: SYS0.IODF43
IODF configuration ID: CONGIG00
EDT ID: 00
Sysplex name: SYSPL1
TIME OF DAY CLOCK: B566EA85 A0750707 02/15/2001 20:33:34.680912 local
TIME OF DAY CLOCK: B567202A 89750707 02/16/2001 00:33:34.680912 GMT
Program Producing Dump: SVCDUMP
Program Requesting Dump: IEAVTSDT
Incident token: SYSPL1 S4
06/23/1993 12:43:54.697367 GMT
図 2-3. STATUS SYSTEM サブコマンドからの出力例
SVC ダンプの SYSTEM STATUS には発生イベント・トークンが含まれます。ダン
プの要求は、発生イベント・トークンまたは発生イベント・トークンを提供するダ
ンプを要求するシステムを指定します。発生イベント・トークンは、次のもので構
成されます。
v シスプレックスの名前
v 複数のダンプを要求するシステムの名前
v グリニッジ標準時 (GMT) 表示の日付
v GMT 表示の時刻
2-46
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
エラー情報の検出
IPCS サブコマンドの STATUS FAILDATA を使用して、障害を起こした特定の命
令を探し出し、ソフトウェア障害と関連した SVC ダンプ内のすべてのデータをフ
ォーマット設定することができます。この報告書では、障害に関係した CSECT、コ
ンポーネント ID、およびエラー発生時の PSW アドレスについての情報が示されま
す。
注: SLIP ダンプまたは CONSOLE ダンプの場合は、STATUS FAILDATA の代わ
りに SUMMARY FORMAT または VERBEXIT LOGDATA を使用します。
IPCS 基本オプション (primary option) メニューからオプション 4 (COMMAND) を
選択して、次のコマンドを入力してください。
------------------------- IPCS Subcommand Entry ------------------------------Enter a free-form IPCS subcommand, CLIST, or REXX exec invocation below:
===> STATUS FAILDATA
PF キーを使用して報告書の画面の上下移動をしてください。次のセクションでは報
告書の各部について説明します。
異常終了コードと理由コードを識別する
ヘッディング “SEARCH ARGUMENT ABSTRACT” の下に、異常終了コードと、も
しあれば、異常終了理由コードが検出できます。
.
.
.
SEARCH ARGUMENT ABSTRACT
PIDS/5752SC1CJ RIDS/CSVLLCRE#L RIDS/CSVLLBLD AB/S0FF0 REGS/09560 REGS/ 06026
RIDS/CSVLLBLD#R
Symptom
------PIDS/5752SC1CJ
RIDS/CSVLLCRE#L
RIDS/CSVLLBLD
AB/S0FF0
REGS/09560
REGS/06026
RIDS/CSVLLBLD#R
Description
----------Program id: 5752SC1CJ
Load module name: CSVLLCRE
Csect name: CSVLLBLD
System abend code: 0FF0
Register/PSW difference for R09: 560
Register/PSW difference for R06: 026
Recovery routine csect name: CSVLLBLD
.
.
.
図 2-4. STATUS FAILDATA 報告書の検索引き数の要約
図 2-4 では、異常終了コードは X'FF0' で理由コードはありません。異常終了コード
と理由コードの説明については、「z/OS MVS システム・コード」を参照してくだ
さい。
次の IPCS 報告書も、異常終了コードと理由コードを提供します。
VERBEXIT LOGDATA
STATUS WORKSHEET
VERBEXIT SYMPTOMS
第 2 章 SVC ダンプ
2-47
SVC ダンプ
システム・モードの検出
“SEARCH ARGUMENT ABSTRACT“ セクションの下に、エラー発生時のシステ
ム・モードについての説明をする情報が記載されています。
..
.
Home ASID: 001B
PKM: 8000
Primary ASID: 001B
AX: 0001
Secondary ASID: 001B
EAX: 0000
RTM was entered because a task requested ABEND via SVC 13.
The error occurred while: an SRB was in control.
No locks were held.
No super bits were set.
..
.
図 2-5. STATUS FAILDATA 報告書のシステム・モード情報
“The error occurred...” で始まる行は、障害が SRB または TCB のいずれかで発生
したかどうかを通知します。 図 2-5 の例では、SRB が制御を持っている間にエラ
ーが発生し、ヘッディング SEARCH ARGUMENT ABSTRACT ( 2-47 ページの図
2-4 を参照) の下を調べて CSECT 名とロード・モジュール名を検出する必要がある
ことを意味しています。これは異常終了が発生したモジュールです。
SRB サービス・ルーチンが制御を持っている間であれば、ヘッディング SEARCH
ARGUMENT ABSTRACT セクションで CSECT 名とロード・モジュール名を探し
てください。これが障害を起こしたモジュールです。
SUMMARY FORMAT サブコマンドからの出力の場合は、異常終了したプログラム
の RB を探してください。その RB には、ゼロ以外の RTPSW1 フィールドがあり
ます。
SLIP オペレーター・コマンドが要求したダンプでは、STATUS CPU REGISTERS
サブコマンドを使用して問題が生じた時点のデータを調べてください。
TCB が制御を持っている時にエラーが発生した場合は、IPCS サブコマンドの
SUMMARY TCBERROR を使用してダンプをフォーマット設定して、障害を起こし
た TCB を検出することができます。 2-49 ページの『TCB 構造体の分析』を参照し
てください。
障害を起こした命令を識別する
STATUS FAILDATA 報告書を使用すると、障害を起こした命令を正確に検出するこ
ともできます。この報告書には、エラー発生時の PSW アドレスと、障害を起こし
た命令テキストが提供されます。この画面のテキストは、常に障害を起こした命令
テキストであるとは限らないことに注意してください。ダンプが取られた場所を
PSW がポイントし、エラーが発生した場所ではないことがあります。
2-49 ページの図 2-6 では、エラー発生時の PSW は X'11E6A3C' であり、命令長は
4 バイトです。それで、障害を起こした命令アドレスは X'11E6A38' となります。
障害を起こした命令は 927670FB です。
2-48
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
.
.
.
OTHER SERVICEABILITY INFORMATION
Recovery Routine Label:
Date Assembled:
Module Level:
Subfunction:
CSVLEBLD
00245
HBB7705
LIBRARY-LOOKASIDE
Time of Error Information
PSW: 070C0000 811E6A3C
Instruction length: 04
Interrupt code: 0004
Failing instruction text: E0009276 70FB5030 70F8D7F7
Registers 0-7
GR: 0002A017 00FBE800
AR: 00000000 00000000
Registers 8-15
GR: 012221A8 811E69F8
AR: 00000000 00000000
00000000 00000076
00000000 00000000
00000C60 00FBE600 0002A016 00000017
00000000 00000000 00000000 00000000
00000001 30000000
00000000 00000000
00FD82C8 811CAD90 011E69D0 011E69D0
00000000 00000000 00005F60 00000000
.
.
.
図 2-6. STATUS FAILDATA 報告書のエラー情報の時刻
この報告書に表示される障害を起こした命令テキストは、常に 12 バイトで、PSW
アドレスの前後 6 バイトです。この例では、障害を起こした命令 927670FB は、レ
ジスター 7 + X'FB' で指定される位置に X'76' を移す命令 MVI です。
エラー発生時のレジスター 7 は、上の Registers 0-7 の下に示され、X'00000017'
を含んでいます。行われようとした移動はストレージ位置 X'112' へのものです。ス
トレージの最初の 512 バイトはハードウェア保護されています。許可なしでそのエ
リアに保管しようとするすべてのソフトウェア・プログラムは、保護例外エラーと
記憶保護例外エラーを受け取ります。
参照 マシン言語の命令コード、オペランド、および割り込みコードについては、
「z/Architecture 解説書」を参照してください。
異常終了したモジュールと障害を起こした命令のオフセットを検出する場合は、
WHERE コマンドを使用します。WHERE は、障害を起こした PSW がポイントす
るモジュールまたは CSECT を識別することができます。
TCB 構造体の分析
エラー発生時に TCB が制御を持っていた場合は、IPCS サブコマンドの
SUMMARY TCBERROR を使用して TCB 情報を探し障害を起こしたコンポーネン
トを検出してください。SUMMARY TCBERROR は、障害を起こしたアドレス・ス
ペースについての制御ブロックを要約します。(制御ブロック内のすべてのフィール
ドを調べる場合は、SUMMARY FORMAT を使用してください。) 各 TCB の完了
コード (フィールド CMP) をスキャンして、正しい TCB を検出してください。こ
の報告書は最新のものから古いものへと RB を表示します。
2-50 ページの図 2-7 は、SUMMARY TCBERROR 出力の例です。この例では、ア
ドレス 008E9A18 の TCB が完了コード X'0C1' を持っています。この TCB のも
とでエラーが発生しました。障害を起こした TCB を識別したら、障害を起こした
プログラムまで RB チェーンをたどることができます。
第 2 章 SVC ダンプ
2-49
SVC ダンプ
.
.
.
NAME..... IEFSD060
PRB: 008FFED0
WLIC..... 00020006
LINK..... 008FFA10
CDE: 00C534A0
NAME..... IEESB605
ENTPT.... 00DA6308
FLCE.... 00C534A0
OPSW..... 070C2000 00DC766A
ENTPT.... 00DC7000
TCB: 008FF0D0
CMP...... 00000000 PKF...... 80
LMP......
TSFLG.... 00
STAB..... 008FD210 NDSP.....
JSCB..... 008FF4FC BITS..... 00000000 DAR......
RTWA..... 00000000 FBYT1.... 00
Task non-dispatchability flags from TCBFLGS4:
Top RB is in a wait
Task non-dispatchability flags from TCBFLGS5:
Secondary non-dispatchability indicator
Task non-dispatchability flags from TCBNDSP2:
SVC Dump is executing for another task
PRB: 008E9F20
WLIC..... 00020001 FLCDE.... 00C4CA38 OPSW.....
LINK..... 018FF0D0
CDE: 00C4CA38
NAME..... IEFIIC
ENTPT.... 00DA6000
図 2-7. SUMMARY TCBERROR 報告書の例 (1/2)
2-50
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
FF
00002000
00
DSP...... FF
070C1000
00DAC66E
SVC ダンプ
TCB: 008E9A18
CMP...... 940C1000
TSFLG.... 20
JSCB..... 008FF33C
RTWA..... 7FFE3090
80
008FD180
00000000
08
LMP...... FF
NDSP..... 00000000
DAR...... 01
DSP...... FF
SVRB: 008FD7A8
WLIC..... 00020000
LINK..... 008FD638
FLCDE.... 00000000
OPSW..... 070C1000
82569B38
PRB: 008E9750
WLIC..... 00020033
LINK..... 008FD638
FLCDE.... 14000000
OPSW..... 070C1000
80CE9AEE
SVRB: 008FD638
WLIC..... 0002000C
LINK..... 008FD4C8
FLCDE.... 00000000
OPSW..... 070C1000
825E9768
SVRB: 008FD4C8
WLIC..... 00020001
LINK..... 008FD358
FLCDE.... 00000000
OPSW..... 070C0000
00C47D52
SVRB: 008FD358
WLIC..... 00020053
LINK..... 008FF4D8
FLCDE.... 00000000
OPSW..... 075C0000
00D64EOC
PRB: 008FF4D8
WLIC..... 00020014
LINK..... 008E9A18
FLCDE.... 008FF3D8
OPSW..... 078D0000
00006EF2
CDE: 008FF3D8
NAME..... SMFWT
PKF......
STAB.....
BITS.....
FBYT1....
ENTPT.... 00006EB0
図 2-7. SUMMARY TCBERROR 報告書の例 (2/2)
この例では、最新の RB は、アドレス 008FD7A8 にある SVRB です。これは
SVC ダンプの RB です。ESTAE の RB は 008E9750 の PRB です。ESTAE は
SVC 33 を発行します。リカバリー終了マネージャー (RTM) の RB は、008FD638
の SVRB です。RTM は SVC C を発行して ESTAE をタスク生成します。X'0C1'
異常終了が 008FD4C8 の SVRB のもとで発生しました。最後の割り込みは、旧
PSW フィールド (OPSW) 内に示されるアドレスの 1 です。チェーン内の次の RB
は、SVC X'53' (SMFWTM) が発行されたことを示します。これは X'0C1' が発生し
たコードです。
スケジュールされたダンプの場合は、異常終了した TCB は通常、ゼロ以外の完了
コードをスキャンして検出することができます。コードがない場合は、システム・
トレースで異常終了をスキャンします。トレースは各項目について ASID 番号と
TCB アドレスを識別します。 2-54 ページの『システム・トレースの検査』を参照し
てください。
STATUS または STATUS REGS サブコマンドを使用して、データ・セット名と
SVC モジュール名要求側のモジュール名を検出します。
LOGREC バッファーのテスト
IPCS サブコマンド VERBEXIT LOGDATA を使用してダンプ内の LOGREC バッ
ファーを調べてください。この報告書では STATUS FAILDATA 報告書に含まれる
情報の多くを繰り返しますが、複数のエラー・イベントがソフトウェア障害を引き
起こした時を識別するのに役立ちます。
第 2 章 SVC ダンプ
2-51
SVC ダンプ
図 2-8 に示す例では、複数のエラーが LOGREC バッファー内にどのように現れる
かを示しています。異常終了 X'0D5' は最初の異常終了で、X'058' は 2 番目のもの
です。VERBEXIT LOGDATA 報告書で、複数のエラーについて、同じアドレス・ス
ペース内のものか関連アドレス・スペースのものかまた SVC ダンプと一致してい
るかまたはそれ以前のものかを調べてください。
TYPE:
SCP:
SOFTWARE RECORD
(PROGRAM INTERRUPT)
VS 2 REL 3
REPORT:
MODEL:
SERIAL:
SOFTWARE EDIT REPORT
DAY.YEAR
REPORT DATE: 235.91
ERROR DATE: 126.91
3090
HH:MM:SS.TH
272804
TIME: 13:27:59.86
JOBNAME: LSCMSTR
ERRORID: SEQ=01196
CPU=0042
ASID=000C
TIME=13:27:59.6
SEARCH ARGUMENT ABSTRACT
PIDS/####SC1C5 RIDS/NUCLEUS#L RIDS/IEAVEDS0 AB/S00D5 PRCS/00000021 REGS/0F120
RIDS/IEAVEDSR#R
SYMPTOM
------PIDS/####SC1C5
RIDS/NUCLEUS#L
RIDS/IEAVEDS0
AB/S00D5
PRCS/00000021
REGS/0F120
RIDS/IEAVEDSR#R
DESCRIPTION
----------PROGRAM ID: ####SC1C5
LOAD MODULE NAME: NUCLEUS
CSECT NAME: IEAVEDS0
SYSTEM ABEND CODE: 00D5
ABEND REASON CODE: 00000021
REGISTER/PSW DIFFERENCE FOR R0F: 120
RECOVERY ROUTINE CSECT NAME: IEAVEDSR
OTHER SERVICEABILITY INFORMATION
RECOVERY ROUTINE LABEL:
DATE ASSEMBLED:
MODULE LEVEL:
SUBFUNCTION:
IEAVEDSR
08/23/89
UY41669
DISPATCHER
TIME OF ERROR INFORMATION
PSW: 440C0000 80FEFC56
INSTRUCTION LENGTH: 04
INTERRUPT CODE: 0021
FAILING INSTRUCTION TEXT: 1008B777 1008B225 000007FE
TRANSLATION EXCEPTION IDENTIFICATION: 00000041
REGISTERS 0-7
GR: 00000041 00F9A0C0 00000000 00000000 00000000 008DE188 008E8C78 00000001
REGISTERS 8-15
GR: 00F97280 0103AB6A 00FF1B08 008DE188 0000000C 000C0041 80FF6510 00FEFB36
HOME ASID: 000C
PKM: 8000
PRIMARY ASID: 000C
AX: 0001
SECONDARY ASID: 000C
RTM WAS ENTERED BECAUSE OF A PROGRAM CHECK INTERRUPT.
THE ERROR OCCURRED WHILE A LOCKED OR DISABLED ROUTINE WAS IN CONTROL.
NO LOCKS WERE HELD.
SUPER BITS SET: PSADISP - DISPATCHER
図 2-8. VERBEXIT LOGDATA サブコマンドからの出力例 (1/2)
2-52
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
.
.
.
TYPE:
SCP:
SOFTWARE RECORD
(SVC 13)
VS 2 REL 3
REPORT:
MODEL:
SERIAL:
JOBNAME: LSCMSTR
ERRORID: SEQ=01197
CPU=0000
SOFTWARE EDIT REPORT
DAY.YEAR
REPORT DAT 235.91
ERROR DAT 126.91
3090
HH:MM:SS.TH
272804
TIM 13:27:59.94
ASID=000C
TIME=13:27:59.6
SEARCH ARGUMENT ABSTRACT
AB/S0058
SYMPTOM
------AB/S0058
DESCRIPTION
----------SYSTEM ABEND CODE: 0058
SERVICEABILITY INFORMATION NOT PROVIDED BY THE RECOVERY ROUTINE
PROGRAM ID
LOAD MODULE NAME
CSECT NAME
RECOVERY ROUTINE CSECT NAME
RECOVERY ROUTINE LABEL
DATE ASSEMBLED
MODULE LEVEL
SUBFUNCTION
TIME OF ERROR INFORMATION
PSW: 470C8000 00FDC266
INSTRUCTION LENGTH: 02
INTERRUPT CODE: 000D
FAILING INSTRUCTION TEXT: 00000000 0A0D0A06 00000000
REGISTERS 0-7
GR: 00A5D7A8 80058000 00000041 022DC780
REGISTERS 8-15
GR: 026E0160 00000000 8001AC96 0001BC96
HOME ASID: 000C
PKM: 8000
PRIMARY ASID: 000C
AX: 0001
008EDF00 008FBC7C 00F86A00 026E01F0
00000000 000188F0 8001B194 00000020
SECONDARY ASID: 000C
RTM WAS ENTERED BECAUSE AN SVC WAS ISSUED IN AN IMPROPER MODE.
THE ERROR OCCURRED WHILE AN ENABLED RB WAS IN CONTROL.
NO LOCKS WERE HELD.
NO SUPER BITS WERE SET.
図 2-8. VERBEXIT LOGDATA サブコマンドからの出力例 (2/2)
VERBEXIT LOGDATA 報告書を表示する場合は、ソフトウェア・レコードを表示す
るためにハードウェア・レコードをスキップしてください。最初のソフトウェア・
レコードを検索してください。
フィールド “ERRORID=” は、ソフトウェア障害についてのエラー ID を示してい
ます。エラー ID は、シーケンス番号、ASID、および異常終了時刻で構成されま
す。この ID と別の報告書からのエラー ID をマッチングすれば、分析しているも
のとこれが同じ異常終了であるか、それとも異なる異常終了であるかを知ることが
できます。詳細については、 14-24 ページの『ソフトウェア・レコードの解釈』を
参照してください。
第 2 章 SVC ダンプ
2-53
SVC ダンプ
システム・トレースの検査
システム・トレース・テーブルでは、エラーを引き起こしたシステム内のイベント
を説明します。トレース・テーブルは、PSW が障害を起こした命令をポイントして
いない場合に役立ち、異常終了の前のイベントのシーケンスを示すためにも役立ち
ます。
IPCS オプションの 2.7.4 はシステム・トレースをフォーマット設定します。報告書
は長いものです。IBM は、報告書の終わりまで画面移動させ、それから異常終了に
ついてのトレース項目を検出するために戻ることをお勧めします。コマンド行に M
をタイプし、F8 を押して報告書の最下位に画面移動させてください。
異常終了についての項目を検出したら、ダンプが取られた PSW から開始して、テ
ーブル内のイベントをトラッキングし、障害を起こした命令がコード内のどこであ
るかを検出します。
システム・トレース報告書は、重要なまたは意味のある項目にアスタリスクを付け
ます。図 2-9 の “IDENT CD/D” 列の “*SVC D” は、プログラムがダンプを取った
場所を示す PSW を識別します。 SVC D の前には 3 つの PGM (プログラム・チ
ェック) 項目があります。PGM 001 の隣にはアスタリスクがあり、プログラム・チ
ェックが未解決であることを示します。次の項目 RCVY PROG は、いくつか後の
項目で SVC D を発行したために障害を起こしたリカバリー・プログラムを識別し
ます。 8-1 ページの『第 8 章 システム・トレース』を参照して、システム・トレ
ース・テーブル内の意味のある項目を認識してください。
PR
ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS-
UNIQUE-1 UNIQUE-2 UNIQUE-3
UNIQUE-4 UNIQUE-5 UNIQUE-6
0094
0094
0094
0094
0094
0094
0094
0094
0094
0001
0054
0054
0094
0094
0094
0054
DSP
070C0000 81EA7000 00000000 00000000
SVC
78 070C0000 81EA7048 00000002 00000278
SVCR
78 070C0000 81EA7048 00000000 00000278
PGM
010 070C0000 81EA704A 00040010 03300D8C
PGM
011 070C0000 81EA704A 00040011 03300D8C
SVC
77 070C2000 81EA7088 81EA7000 00000000
SVCR
77 070C2000 81EA7088 00000000 00000000
*PGM
001 070C0000 83300FAA 00020001 03300D8C
*RCVY PROG
940C1000 00000001
I/O
1A2 070E0000 00000000 0080000E 060246C0
SRB
070C0000 810537E0 00000054 00F3C9F8
SSRV 12D
810B9CEE 00AF7D18 000C0000
SSRV 12D
810B9D0E 00AF7D18 000B0000
DSP
070C0000 810BF664 00000000 00000000
*SVC
D 070C0000 810BF666 00000040 00000000
SSRV
10F
00000000 00F83E80 00AD7300
.
.
.
01
01
01
01
01
01
01
01
01
02
02
01
01
01
01
01
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00000000
00AD7300
00AF7D18
00AF7D18
00AF7D18
00AF7D18
00000000
0000800C
00000000
03300D88
00050000
40000000
00000000
0C000001
00F3CA40
00000000
00000000
40000000
40000000
00AC5040
図 2-9. IPCS サブコマンド SYSTRACE からの出力の例
レジスターを調べる
IPCS サブコマンド STATUS REGISTERS を使用して TCB と RB 用のレジスター
を表示します。SUMMARY REGS は、別のフォーマットで同じ情報を示します。
2-54
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
この報告書は PSW、ASID およびレジスター値を、STATUS FAILDATA 報告書と
同じ形式で識別しますが、STATUS REGISTERS には制御レジスター値も示されま
す。
CPU STATUS:
PSW=070C1000 80FE5CFC (RUNNING IN PRIMARY, KEY 0, AMODE 31, DAT ON)
DISABLED FOR PER
ASID(X’001B’) 00FE5CFC. IEANUC01.IEAVESVC+05FC IN READ ONLY NUCLEUS
ASCB27 at F3FA00, JOB(LLA), for the home ASID
ASXB27 at 9FDF00 for the home ASID. No block is dispatched
HOME ASID: 001B PRIMARY ASID: 001B SECONDARY ASID: 001B
GPR VALUES
0-3 80000000
4-7 009F8E88
8-11 00000000
12-15 7FFE0000
80FF0000
009FD358
80FE579C
00006730
009FF5A0
80FE5CD6
009FD418
00FE6200
00FC4E88
00F3FA00
7FFFE2C0
80014910
ACCESS REGISTER VALUES
0-3 7FFEA5CC 00000000
4-7 00000000 00000000
8-11 00000000 00000000
12-15 00000000 00000000
00000000
00000000
00000000
00005F60
00000000
00000000
00000000
8210532A
007CCDC0
FE000000
00000000
DF880C71
8000001B
00A2007F
00000000
7FFE7008
ALET TRANSLATION
AR 00
Not translatable
AR 14
Not translatable
AR 15
Not translatable
CONTROL REGISTER VALUES
0-3 5EB1EE40 00A2007F
4-7 0001001B 00C506C0
8-11 00000000 00000000
12-15 0082E07B 00A2007F
図 2-10. STATUS REGISTERS 報告書の例
図 2-10 の出力例では、PSW 内のアドレスが X'0FE5CFC' であり、ASID が
X'1B'、また障害を起こした命令が中核内のモジュール IEANUC01 の CSECT
IEAVESVC のオフセット X'5FC' に置かれていることを示します。これでダンプを
ブラウズし、特定の障害命令を調べることができます。またレジスターについての
情報を使用して、PSW 内のアドレスが障害を起こした命令をポイントしていない場
合も、エラーについて詳しく調べることができます。
この報告書は PSW、ASID およびレジスター値を、STATUS FAILDATA 報告書と
同じ形式で識別しますが、STATUS REGISTERS には制御レジスター値も示されま
す。
第 2 章 SVC ダンプ
2-55
SVC ダンプ
CPU STATUS:
PSW=070C4000 00FC5C96
(Running in AR, key 0, AMODE 24, DAT ON)
DISABLED FOR PER
ASID(X’001E’) FC5C96. STRUCTURE(Cvt)+D6 IN READ/WRITE NUCLEUS
ASID(X’001E’) FC5C96. IEANUC01.IEAVCVT+0116 IN READ/WRITE NUCLEUS
ASID(X’001E’) FC5C96. STRUCTURE(Dcb)+0152 IN READ/WRITE NUCLEUS
ASID(X’001E’) FC5C96. STRUCTURE(Dcb)+015A IN READ/WRITE NUCLEUS
ASCB30 at F90B80, JOB(ORANGE), for the home ASID
ASXB30 at 6FDE90 and TCB30D at 6E7A68 for the home ASID
HOME ASID: 001E PRIMARY ASID: 001E SECONDARY ASID: 001E
General purpose register values
0-1 00000000_00000020 00000000_84058000
2-3 00000000_00000000 00000001_00004000
4-5 00000000_01F9B9A8 00000000_01F9B9A8
6-7 00000000_00000000 00000000_01F9BE10
8-9 00000000_00000000 00000000_FFFFFFFC
10-11 00000000_00000000 00000000_00FDAC58
12-13 00000000_01560410 00000000_01F9BB08
14-15 00000000_8155E5A8 00000000_0000003C
Access register values
0-3 00000000 00000000 00000000 00000000
4-7 00000000 00000000 00000000 00000000
8-11 00000000 00000000 00000000 00000000
12-15 00000000 00000000 00000000 00000000
Control register values
Left halves of all registers contain zeros
0-3 5F29EE40 0374C007 008D0A40 00C0001E
4-7 0000001E 02A30780 FE000000 0374C007
8-11 00020000 00000000 00000000 00000000
12-15 0294EE43 0374C007 DF882A2F 7F5CD4B0
図 2-11. z/Architecture モードで実行した STATUS REGISTERS 報告書の例
SVC ダンプ分析に関するその他の役立つ報告書
SVC ダンプ・データをさらに収集する場合は、次のコマンドのいずれかを使用しま
す。
2-56
IPCS サブコマンド
報告書内の情報
STATUS CPU REGISTERS DATA
CONTENTION
異常終了、現行 ASID、およびタスクについ
てのデータ。
SUMMARY FORMAT
TCB と現行 ASID 内の全フィールド。
TCBEXIT IEAVTFMT 21C.%
現行 FRR スタック。
LPAMAP
活動状態の LPA と PLPA 内の入り口点。
VERBEXIT NUCMAP
ダンプが取られた時点の中核内のモジュー
ル・マップ。
VERBEXIT SUMDUMP
SDUMPX マクロの SUMDUMP オプション
でダンプされるデータ。
VERBEXIT MTRACE
マスター・トレース・テーブル。
VERBEXIT SYMPTOMS
使用できる場合は 1 次または 2 次症状。
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SVC ダンプ
注: VERBEXIT SYMPTOMS サブコマンドは SVC ダンプ分析の最後に使用してく
ださい。その他のサブコマンドでダンプ・ヘッダー・レコードに症状を追加す
ることができます。この結果、 VERBEXIT SYMPTOMS はダンプから使用で
きるすべての症状を提供します。
SDUMPX 4K SQA バッファーの読み取り
次の SVC ダンプは、SDUMPX 4K システム・キュー・エリア (SQA) バッファー
内の問題データを含んでいます。
v SLIP オペレーター・コマンドで要求した SVC ダンプ
v ダンプ表題の説明で示された場合、別の SVC ダンプ。
v BUFFER=YES パラメーターを指定した SDUMP または SDUMPX マクロで要求
した SVC ダンプ。
バッファーを入手する場合は、次の IPCS サブコマンドを使用してください。
LIST 0 DOMAIN(SDUMPBUFFER) LENGTH(4096)
以下のテーブルでは、SQA バッファー内のフィールドを説明します。診断で使用で
きます。
オフセット
長さ
内容
0(0)
4
文字、TYPE
4(4)
4
RTM/SLIP 処理環境標識:
X'00000001': RTM1
X'00000002': RTM2
X'00000003': MEMTERM
X'00000004': PER
8(8)
4
文字、CPU
12(C)
4
論理プロセッサー ID (CPUID)
16(10)
4
文字、REGS
20(14)
64
イベントの発生時刻の汎用レジスター 0 から 15
84(54)
4
文字、PSW
88(58)
8
イベントが発生した時点のプログラム状況ワード (PSW)
96(60)
4
文字、PASD
100(64)
2
イベントが発生した時点の 1 次アドレス・スペース ID (ASID)
102 (66)
4
文字、SASD
106(6A)
2
イベントが発生した時点の 2 次 ASID
108(6C)
4
文字、ARS
112(70)
64
イベントが発生した時点のアクセス・レジスター 0 から 15
176(B0)
4
文字、G64H
180(B4)
64
イベントの発生時刻の汎用レジスター 0 から 15 の高位半分 第 2 章 SVC ダンプ
2-57
SVC ダンプ
オフセット
長さ
内容
244(F4)
可変
バッファーのオフセット 4 にある RTM/SLIP 処理環境標識で示される、次
の 1 つ。
v オフセット 4 が 1 (RTM1) の場合は、システム診断作業域 (SDWA)。
v オフセット 4 が 2 (RTM2) の場合は、リカバリー終了管理機能 2
(RTM2) 作業域 (RTM2WA)。
v オフセット 4 が 3 (MEMTERM) の場合は、アドレス・スペース制御ブ
ロック (ASCB)。
v オフセット 4 が 4 (PER) の場合は PER 割り込みコード。
2-58
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 3 章 トランザクション・ダンプ
トランザクション・ダンプは、エラーが発生した時点でのアドレス・スペースの仮
想記憶域を表します。一般に、アプリケーションは、予期しないエラーが発生する
と、リカバリー・ルーチンでダンプを要求します。
トランザクション・ダンプは、以下のように要求されます。
v 同期トランザクション・ダンプ
リクエスターの IEATDUMP マクロに呼び出すことによって現行タスクのもとで
ダンプを入手するための命令が発行されます。ダンプ・データがダンプ・デー
タ・セットに書き込まれると、アプリケーションは制御をリクエスターに戻し、
使用可能になります。
各トランザクション・ダンプには、要求すると要約ダンプも含まれます。要約ダン
プには、要求を出した時点に取られた、選択したデータ・エリアのコピーが示され
ます。また、要約ダンプを指定する際に、1 つのオプションを指定するだけで、多
くの事前定義されたデータ・エリアもダンプすることができます。この要約ダン
プ・データは、トランザクション・ダンプと一緒に混在することはありません、と
いうのは要約ダンプはほとんどの場合発生順になっていないからです。その代わり
に、要約ダンプで選択した各データ・エリアは別々にフォーマット設定され識別さ
れます。これらのことにより、要約ダンプ・データを要求することをお勧めしま
す。
主要トピック
ここでは、システム・プログラマーがトランザクション・ダンプとトランザクショ
ン・ダンプ処理について知っておく必要のある情報を記載しています。
v 3-2 ページの『自動割り振りダンプ・データ・セットの使用』
v 3-4 ページの『トランザクション・ダンプの獲得』
v 3-5 ページの『ダンプ・データ・セットの印刷、表示、コピー、およびクリア』
v 3-6 ページの『トランザクション・ダンプの内容』
参照
トランザクション・ダンプを入手するために、IEATDUMP マクロのプログラミング
を行うプログラマーが必要な情報については、「z/OS MVS Programming: Authorized
Assembler Services Guide」を参照してください。
v いつトランザクション・ダンプを要求するかを決定する
v MVS が生成するトランザクション・ダンプのタイプを理解する
v トランザクション・ダンプの特定のタイプを取り扱うアプリケーション・プログ
ラムを設計する
v ダンプを含むデータ・セットを識別する
v ダンプの内容を定義する
v ダンプ分析重複回避機能 (DAE) を使用して、重複したトランザクション・ダン
プを抑止する
© Copyright IBM Corp. 1988, 2008
3-1
トランザクション・ダンプ
トランザクション・ダンプのデータ・セットの計画
トランザクション・ダンプ処理は、ユーザーが手作業で事前割り振りしたダンプ・
データ・セット、またはシステムが必要に応じて自動的に割り振ったダンプ・デー
タ・セットに、データを保管します。
トランザクション・ダンプのデータ・セット管理の計画
IBM は、トランザクション・ダンプのダンプ・データ・セットとして、拡張形式の
順次データ・セットを使用することをお勧めします。拡張形式の順次データ・セッ
トとは、次のとおりです。
v 順次データ・セットより大きい容量を持つ
v ストライピングをサポートする
v 圧縮をサポートする
拡張形式の順次データ・セットの追加情報については、 2-10 ページの『SVC ダン
プ・データ・セットの選択』を参照してください。
DSNTYPE=LARGE の使用 z/OS V1R7 以降のリリースでは、DSNTYPE=LARGE
データ・セットの処理に関係するシステムが、その使用前に V1R7 にマイグレーシ
ョンされている場合、DSNTYPE=LARGE を使用する順次データ・セットをトラン
ザクション・ダンプに使用できます。前のリリースを使用した分析が必要な場合
は、z/OS V1R7 を使用して、前のリリースでサポートされるデータ・セットにダン
プを転記します。
事前割り振りダンプ・データ・セットの使用
事前割り振りデータ・セットを要求するには、全ダンプを書き込むことができる十
分なスペースを 1 つ以上のエクステントに持っているデータ・セットを示す
DDNAME パラメーターを指定します。 DDNAME には、ダンプのサイズについて
2GB のサイズ制限はありません。指定したデータ・セットが十分大きくない場合
は、部分ダンプがとられます。
自動割り振りダンプ・データ・セットの使用
トランザクション・ダンプ処理は、システムがダンプを DASD に書き出す時点での
ダンプ・データ・セットの自動割り振りをサポートします。ダンプは、汎用リソー
ス SYSALLDA から割り振られます。システムは、ダンプを書き出すとき、正しい
サイズのデータ・セットを割り振ります。ダンプのサイズには、最大 2GB の制限
があります。自動割り振りは、マルチボリュームにわたったり、ストライプ化され
ることはありません。自動割り振りができない場合には、メッセージ IEA820I を発
行して、ダンプを削除します。
自動割り振りダンプ・データ・セットの命名
アプリケーションは、自動割り振り機能が作成したデータ・セットの名前の制御を
行い、ニーズに従ってダンプ・データ・セットで使用する名前パターンを選択する
ことができます。名前はインストール・システムが IEATDUMP マクロの DSN(AD)
キーワードで指定するパターンによって決められます。記号のセットが使用できる
ので、ユーザーは自動的に割り振るダンプ・データ・セットの名前に次の種類の情
報を含めることができます。
v システム名
3-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
トランザクション・ダンプ
v シスプレックス名
v ジョブ名
v ローカルと GMT の時刻と日付
通常の MVS データ・セット名の標準で使用できる任意の名前を生成するように名
前パターンを指定することができます。データ・セット名の標準については、
「z/OS DFSMS データ・セットの使用法」のデータ・セット名の説明を参照してく
ださい。
割り振り権限をセットアップする: ダンプ・データ・セットを自動的に割り振るた
めに、呼び出し元のアドレス・スペースまたは DUMPSRV アドレス・スペース (あ
るいはその両方) には新規データ・セットを割り振るための権限が必要です。次の
手順に従ってください。
1. 呼び出し元のアドレス・スペースまたは DUMPSRV アドレス・スペース (ある
いはその両方) をユーザー ID に関連付ける。
RACF 第 2 版リリース 1 をインストールしている場合は、STARTED 一般リソ
ース・クラスを使用して呼び出し元または DUMPSRV をユーザー ID に関連付
けてください。このステップでは、RACF 開始プロシージャー・テーブル
ICHRIN03 は、一般項目を持っている必要があります。
それ以前の版の RACF の場合は、RACF 開始プロシージャー・テーブル
ICHRIN03 を使用してください。
2. 次のトピックの命名規則を使用して新規ダンプ・データ・セットを作成するため
の許可を、呼び出し元のユーザー ID または DUMPSRV ユーザー ID に与えて
ください。
SYS1 の高位修飾子を指定すると、データ・セットは グループ・データ・セッ
トであると見なされます。そのグループ内の呼び出し元のユーザー ID に、
CREATE グループ権限を割り当てることができます。
参照
次の資料を参照してください。
v RACF 開始プロシージャー・テーブルについての情報は、「z/OS Security Server
RACF システム・プログラマーのガイド」を参照してください。
v STARTED 一般リソース・クラスの使用法と新規データ・セットの作成の制御に
ついての情報は、「z/OS Security Server RACF セキュリティー管理者のガイド」
を参照してください。
名前パターンの設定: ダンプ・データ・セットの名前パターンの設定は、DSN(AD)
キーワードによって行われます。名前は標準 MVS 命名規則に従い、修飾子間の区
切り文字として使用するピリオドを含め最大 44 文字です。ダンプ・データ・セッ
トに意味のある名前を使用できるように、ダンプ・データが仮想記憶域にキャプチ
ャーされた時に解決されるいくつかの記号があります。使用できる記号の完全なリ
ストは、「z/OS MVS システム・コマンド」内の DUMPDS NAME= の説明を参照
してください。データ・セット名の標準については、「z/OS DFSMS データ・セッ
トの使用法」のデータ・セット名の説明を参照してください。
注: &SEQ. シンボルは、TDUMP ではサポートされません。
第 3 章 トランザクション・ダンプ
3-3
トランザクション・ダンプ
ダンプ・データ・セット名のパターンを決定する場合は、ダンプ・データ・セット
に対して機能する、インストール・システムにあるすべての自動化ツールを考慮し
てください。
SPFUSER 名前パターンを次に説明します。
APPL . TDUMP . D &DATE. . T &TIME. . &SYSNAME. . &JOBNAME.
─┬── │ ──┬── │ │ ──┬─── │ │ ──┬─── │ ───┬───── │ ────┬────
│ ┌─┘
│
│ │
│
│ │
│
│
│
│
│
│ │ ┌───┘
│ │
│
│ │
│
│
│
│
│
│ │ │ ┌─────┘ │
│
│ │
│
│
│
│
│
│ │ │ │┌───────┘
│
│ │
│
│
│
│
│
│ │ │ ││
┌────────┘
│ │
│
│
│
│
│
│ │ │ ││
│ ┌───────────┘ │
│
│
│
│
│
│ │ │ ││
│ │┌─────────────┘
│
│
│
│
│
│ │ │ ││
│ ││ ┌───────────────┘
│
│
│
│
│ │ │ ││
│ ││ │
┌─────────────────┘
│
│
│
│ │ │ ││
│ ││ │
│
┌───────────────────┘
│
│
│ │ │ ││
│ ││ │
│
│
┌───────────────────────┘
│
│ │ │ ││
│ ││ │
│
│
│
┌──────────────────────────┘
│ │ │ ││
│ ││ │
│
│
│
│
│ │ │ ││
│ ││ │
│
│
│
│
APPL.TDUMP.D970526.T110113.SYSTEM1.SPFUSER
図 3-1. 自動的に割り振られたダンプ・データ・セットの SPFUSER の名前パターン
記号は、日付、および時刻に分解され、MVS データ・セット名の規則に従うように
英字が前に付くことに注意してください。また、記号は、アンパーサンド (&) で始
まり、ピリオド (.) で終了し、修飾子が終了する場合は二重ピリオドを持つ名前パ
ターンになります。1 つのピリオドが記号を終了し、2 番目は生成されたデータ・
セット名の修飾子間の区切り文字として働きます。
ダンプ・データ・セットの自動割り振りは、高位修飾子 (HLQ) について ISPF
DSLIST で管理します。
システムからの通信
システムは、以下の 2 つのメッセージを使用して、ダンプ・データ・セットの自動
割り振りについて通信します。
v IEA822I は、全体または部分ダンプが取られた時に発行されます。IEA822I は、
通知メッセージなので強調表示されません。
v IEA820I は、ダンプを取ることができないか割り振りができないときに、トラン
ザクション・ダンプごとに 1 回発行されます。IEA820I は、通知メッセージなの
で強調表示されません。
トランザクション・ダンプの獲得
許可プログラムまたは非許可プログラムで IEATDUMP マクロを発行することによ
ってトランザクション・ダンプを取ってください。
ユーザー作成のデータ・スペースに書き込まれたダンプの場合、データ・スペース
STOKEN および起点は、IEATDUMP マクロで識別されます。データ・セットへの
ダンプは、IEATDUMP マクロの DDNAME またはダンプ・データ・セット名パラ
メーターに指定します。
3-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
トランザクション・ダンプ
シスプレックスでは、問題データのすべてを収集するために、許可アプリケーショ
ンは、複数のアドレス・スペースからのダンプが必要になります。これらのダンプ
は同時に要求される必要があります。これらの複数のダンプを要求するためには、
その問題に関係する他のアドレス・スペースを指定した REMOTE パラメーターを
指定して IEATDUMP マクロを発行してください。これらの要求をセットアップす
る助けとして、パラメーターにワイルドカードを含めることができます。シスプレ
ックス内のシステムについてと、関連作業用のジョブについてのパターンを形成す
る名前を、インストール・システムで指定する場合は、ワイルドカードの * と ?
を使用して名前を指定することができます。たとえば、名前 TRANS? をジョブ名
TRANS1、TRANS2、および TRANS3 に使用し、名前 TRANS* を TRANS1、
TRANS12、および TRANS123 に使用します。
注: トランザクション・ダンプが REMOTE パラメーターを使用してリリース 4 よ
り前のシステムの 1 つまたは複数のアドレス・スペースのダンプを取る場合、
結果は、DSN パラメーターで指定されたデータ・セット名に 1 つまたは複数
のトランザクション・ダンプが書き込まれるのではなく、要求されたデータが
含まれている単一の SVC ダンプとなります。DISPLAY DUMP,STATUS コマ
ンドを発行してこの SVC ダンプの名前を判別してください。
ダンプ・データ・セットの印刷、表示、コピー、およびクリア
トランザクション・ダンプは作成時には不定様式です。IPCS を使用してダンプをフ
ォーマット設定し、そのあとでダンプを端末装置で表示するか印刷することができ
ます。
第 3 章 トランザクション・ダンプ
3-5
トランザクション・ダンプ
例: ダンプ・データ・セットの印刷、コピー、およびクリアのための JCL
事前割り振りデータ・セットまたはダンプ・データ・セットの場合、この JCL
は次のことを行います。
v APPL.TDUMP00 データ・セットでトランザクション・ダンプを使用しま
す。IPCSTDMP DD ステートメントがこのデータ・セットを識別します。
v DELETE(DDIR) ステートメントで IPCS ダンプ登録簿を削除します。この
ステートメントは、登録簿 ID 内のバッチ・ジョブの USERID を使用しま
す。
v BLSCDDIR ステートメントを使用してダンプ登録簿を割り振ります。デフ
ォルトはボリューム VSAM01 です。例では VSAM11 を示しています。必
要なボリュームでデフォルトのボリュームを指定変更します。
v LIST 0 で IPCS サブコマンドを使用してダンプをフォーマット設定しま
す。この例を使用する場合は、LIST 0 コマンドを必要な IPCS サブコマン
ドまたは CLIST で置き換えます。CLIST については、z/OS MVS IPCS ユ
ーザーズ・ガイド を参照してください。
//IPCSJOB JOB
//IPCS
EXEC PGM=IKJEFT01,DYNAMNBR=75,REGION=1500K
//SYSPROC DD
DSN=SYS1.SBLSCLI0,DISP=SHR
//IPCSTDMP DD
DSN=APPL.TDUMP00,DISP=SHR
//SYSUDUMP DD
SYSOUT=*
//IPCSTOC DD
SYSOUT=*
//IPCSPRNT DD
SYSOUT=*
//SYSTSPRT DD
SYSOUT=*
//SYSTSIN DD
*
DELETE(DDIR) PURGE CLUSTER
BLSCDDIR VOLUME(VSAM11)
IPCS NOPARM
SETDEF DD(IPCSTDMP) LIST NOCONFIRM
LIST 0
END
/*
トランザクション・ダンプの内容
トランザクション・ダンプは、システムの初期設定時にダンプ・オプション・リス
トを設定するために parmlib メンバー IEADMR00 を共用します。IBM 提供の
IEADMR00 parmlib メンバーは、ダンプ・オプション NUC、SQA、LSQA、
SWA、TRT、RGN、および SUM を指定します。
参照
トランザクション・ダンプからのフォーマット設定された IPCS 出力の例は、
「z/OS MVS IPCS コマンド」を参照してください。
トランザクション・ダンプ内容のカスタマイズ
トランザクション・ダンプの内容をカスタマイズして、ユーザーのインストール・
システムの要件に合わせることができます。たとえば、ダンプするエリアを追加す
る、ダンプ・サイズを減らす、またはハイパースペースをダンプしたい場合が考え
3-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
トランザクション・ダンプ
られます。ほとんどの場合は、トランザクション・ダンプの内容または要約ダンプ
の内容を、IEATDUMP マクロの SDATA パラメーターによってカスタマイズしま
す。
ハイパースペース
トランザクション・ダンプにはハイパースペースは含まれません。トランザクショ
ン・ダンプに ハイパースペースを含める場合は、ユーザーがプログラムを作成し
て、データをハイパースペースからダンプするアドレス・スペース・ストレージに
コピーする必要があります。
エリアの追加
要求したダンプに必要なすべてのエリアが含まれない場合は、エリアを追加するた
めに下記の方法の 1 つを参照してください。
v 『SDATA パラメーターを使用して内容をカスタマイズする』
v 3-9 ページの『トランザクション・ダンプ内の要約ダンプの内容』
SDATA パラメーターを使用して内容をカスタマイズする
IBM 提供のデフォルトの内容とカスタマイズで使用できる内容についての詳しい情
報は 表 3-1 で説明します。この表では、ダンプ内のエリアを指定するパラメーター
ごとに英字順に表示します。ダンプを要求する前に、潜在的なエラーを診断するた
めにどのエリアを使用するかを決定してください。表内でそのエリアを検出しま
す。ダンプの下の欄の記号は、そのダンプでエリアを獲得するための方法を示しま
す。記号の意味は次のとおりです。
D
IBM 提供のデフォルトの値の内容
M
ダンプを要求するマクロで使用できる
P
ダンプ・オプションを制御する parmlib メンバーで使用できる
X
ダンプ・タイプのオプションを変更する CHNGDUMP オペレーター・コマ
ンドで使用できる
ブランク
無記号はエリアが獲得できないことを示す
注: システム・オペレーター・コマンドとアセンブラー・マクロが、表内のパラメ
ーターを使用してダンプ内容を指定します。
表内の記号の順序は重要ではありません。
表 3-1. SDATA パラメーターによるトランザクション・ダンプの内容のカスタマイズ
SDATA
パラメーター・
オプション
ダンプ内容
IEATDUMP マクロの
トランザクション・
ダンプ
ALLNUC
DAT オンと DAT オフの中核
M P X
CSA
共通サービス・エリア (CSA) (サブプール 227、228、 M P X
231、241)
DEFS
デフォルト・エリア LSQA、 NUC、 PSA、 RGN、
SQA、 SUM、 SWA、 TRT
M
ALL
CSA、 GRSQ、 LPA、 NUC、 RGN、 SQA、
SUM、 SWA、 TRT
X
第 3 章 トランザクション・ダンプ
3-7
トランザクション・ダンプ
表 3-1. SDATA パラメーターによるトランザクション・ダンプの内容のカスタマイズ (続き)
SDATA
パラメーター・
オプション
ダンプ内容
IEATDUMP マクロの
トランザクション・
ダンプ
GRSQ
ダンプされるタスクのグローバル・リソース逐次化制
御ブロック
v グローバル・キュー制御ブロック
v ローカル・キュー制御ブロック
M P X
IO
ダンプされるタスクの入出力監視プログラム (IOS) 制 D
御ブロック
v EXCPD
v UCB
LPA
活動リンク・パック域 (LPA): モジュール名と内容
LSQA
アドレス・スペースに割り振られたローカル・システ D M P X
ム・キュー域 (LSQA) (サブプール 203 - 205、 213 215、 223 - 225、 229、230、 233 - 235、 249、
253 - 255)
NUC
制御プログラム中核の読み取り/書き込み部分 (すなわ
ち、DAT-on 中核の表示ページ保護エリアのみ)、次の
ものを含みます。
v CVT
v LSQA
v PSA
v SQA
M P X
PSA
エラー発生時のプロセッサーまたはダンプ時のプロセ
ッサーの、接頭部保管域 (PSA)
D M P
RGN
ダンプされる各アドレス・スペースの専用エリア内に
割り振られたページ。サブプール 0 - 127、 129 132、 203 - 205、 213 - 215、 223 - 225、 229、
230、 236、 237、 244、 249、 251 - 255 を含む。
また、2 GB アドレス部分より上に割り振られた適格
ストレージ。
M P X
SQA
割り振られたシステム・キュー・エリア (SQA) (すな
わち、サブプール 226、239、245、247、248)
D M P X
SUM
要約ダンプ ( 3-9 ページの『トランザクション・ダン
プ内の要約ダンプの内容』を参照)
D M P X
SWA
スケジューラー作業域 (SWA) (すなわち、サブプール
236 と 237)
M P X
TRT
使用できるシステム・トレース、汎用トレース機能
(GTF) トレース、およびマスター・トレース
D M P X
デフォルトのシステム・データ
使用できる場合は命令アドレス・トレース
D
3-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
M P X
トランザクション・ダンプ
表 3-1. SDATA パラメーターによるトランザクション・ダンプの内容のカスタマイズ (続き)
SDATA
パラメーター・
オプション
ダンプ内容
IEATDUMP マクロの
トランザクション・
ダンプ
デフォルトのシステム・データ
中核マップとシステム制御ブロック。下記のものを含
みます。
v ダンプされる各アドレス・スペースの ASCB
v ASVT
v 各アドレス・スペース用の許可テーブル
v CVT、CVT 接頭部、および 2 次 CVT (SCVT)
v 各アドレス・スペース用のエントリー・テーブル
v GDA
v ダンプされる各アドレス・スペースの JSAB
v リンケージ・スタック
v 各アドレス・スペース用のリンケージ・テーブル
v PCCA および PCCA ベクトル・テーブル
v TOT
v TRVT
v UCB
D
デフォルトのシステム・データ
DFP の 3.1.0 以降のリリースがインストールされてい D
る場合は、DFP 問題データ
デフォルトのシステム・データ
ダンプされるタスク、およびそのすべてのサブタスク
のプログラム・データに使用されるストレージ
D
デフォルトのシステム・データ
ストレージ: エラーが発生した時点での PSW 内のア
ドレスの 4 キロバイト前と 4 キロバイト後
D
トランザクション・ダンプ内の要約ダンプの内容
以下の理由で要約ダンプを要求します。
v SUM パラメーターは、1 つのパラメーターで多くの役に立つ事前定義されたエリ
アを要求します。
要約ダンプには揮発性のシステム情報は含まれません。システムは、ダンプ要求側
に制御を戻す前に、この要約ダンプを書き出します。要約情報は、ダンプされる各
アドレス・スペースについて保管されます。
要約ダンプによるトランザクション・ダンプの内容のカスタマイズ:
内容は、次のとおりです。
要約ダンプの
1. ダンプ・タスクのアドレス・スペース用のアドレス・スペース ID (ASID) レコ
ード
2. リカバリー終了マネージャー (RTM) 用の制御ブロック
v ダンプされたアドレス・スペース内のすべての TCB と関連する RTM2WA
3. AMDDATA がマップするダンプ・ヘッダー
AMDDATA マッピングについては、z/OS MVS Data Areas, Vol 1 (ABEP-DALT)
を参照してください。
4. 4 キロバイト前と 4 キロバイト後。
v ダンプ内に示される RTM2WA 内の PSW のすべての有効な固有アドレス
第 3 章 トランザクション・ダンプ
3-9
トランザクション・ダンプ
v ダンプ内に示される RTM2WA に保管されたレジスター内のすべての有効な
固有アドレス
5. 監視プログラム制御ブロック:
v 現行リンケージ・スタック
v 1 次アドレス・スペース番号 (PASN) アクセス・リスト
v 作業単位アクセス・リスト
参照
上記の表にリストされる制御ブロックについての情報は下記を参照してください。
v z/OS MVS Data Areas, Vol 1 (ABEP-DALT)
v z/OS MVS Data Areas, Vol 2 (DCCB-ITZYRETC)
v z/OS MVS Data Areas, Vol 3 (IVT-RCWK)
v z/OS MVS Data Areas, Vol 4 (RD-SRRA)
v z/OS MVS Data Areas, Vol 5 (SSAG-XTLST)
オペレーター・コマンドで内容をカスタマイズする
トランザクション・ダンプのダンプ・オプション・リストは、 3-11 ページの表 3-2
に示されるすべての方法で、CHNGDUMP オペレーター・コマンドによりカスタマ
イズすることができます。
ダンプ内の中核域
ダンプ・オプションは、ダンプ内に出力される中核部分を制御することができま
す。ときには診断で中核すべてを解析する必要が生じる場合があります。インスト
ール・システムでダンプからすべての中核域を削除することができます。IBM 提供
のデフォルトを使用した場合、IEATDUMP マクロの場合のトランザクション・ダン
プには、中核マップと特定の制御ブロックが含まれます。
中核を変更していない場合は、インストール・システムはすべてのダンプ (SVC ダ
ンプ、SYSMDUMP、およびトランザクション・ダンプ) で使用できる DAT-off 中
核の 1 つのコピーを取得する必要があります。この中核を入手するためには、
SDATA=ALLNUC を指定し、その他の SDATA オプションを指定しないで DUMP
オペレーター・コマンドを入力します。中核は、IPL と IPL 間で変更されないの
で、1 つのダンプを繰り返し使用することができます。
DAT、動的アドレス変換は、仮想記憶域を使用するためのハードウェア機能です。
中核の DAT オン部分では、アドレスは仮想記憶域内です。中核の DAT オフ部分
では、アドレスは中央記憶装置内です。
3-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
トランザクション・ダンプ
表 3-2. オペレーター・コマンドを使用してトランザクション・ダンプの内容をカスタマイズする
カスタマイズ
効果
例
IEADMR00 parmlib メンバーの更新
変更が生じる時: システム初期設定時
ローカル・システム・キュー・エリア
(LSQA) およびトレース・データを保
持しながら、IEATDUMP マクロと
SDATA の場合のすべてのトランザク
ション・ダンプにリンク・パック域
(LPA) を追加するためには、
IEADMR00 の 1 行を次のように変更
します。
変更内容: このコマンドは、
IEATDUMP マクロと SDATA 用のト
ランザクション・ダンプのダンプ・オ
プションを設定します。リストについ
ては、 3-6 ページの『トランザクショ
ン・ダンプの内容』を参照してくださ
い。
parmlib メンバー IEACMD00 に
CHNGDUMP オペレーター・コマン
ドの追加
変更が生じる時: システム初期設定時
変更内容: このコマンドは、
IEATDUMP マクロと SYSMDUMPS
用のトランザクション・ダンプのダン
プ・オプションを設定します。リスト
については、 3-6 ページの『トランザ
クション・ダンプの内容』を参照して
ください。
SDATA=(LSQA,TRT,LPA)
ローカル・システム・キュー・エリア
(LSQA) とトレース・データを保持し
ながら、IEATDUMP マクロおよび
SYSMDUMP の場合のすべてのトラン
ザクション・ダンプにリンク・パック
域 (LPA) を追加するためには、次の
コマンドを IEACMD00 に追加しま
す。
CHNGDUMP SET,SYSMDUMP=(LPA)
第 3 章 トランザクション・ダンプ
3-11
トランザクション・ダンプ
表 3-2. オペレーター・コマンドを使用してトランザクション・ダンプの内容をカスタマイズする (続き)
カスタマイズ
効果
変更が生じる時: コマンドが処理され
SYSMDUMP パラメーターを指定し
た CHNGDUMP オペレーター・コマ るとすぐ
ンド をマスター権限を持つコンソー
変更内容:
ルで入力します。
ADD モードの場合: CHNGDUMP オ
プションは、現行のトランザクショ
ン・ダンプ・オプション・リストと、
ダンプを要求するマクロまたはオペレ
ーター・コマンドに指定するすべての
オプションに追加されます。オプショ
ンは、別の CHNGDUMP
SYSMDUMP オペレーター・コマンド
が入力されるまで、IEATDUMP マク
ロおよび SYSMDUMP の場合のすべ
てのトランザクション・ダンプに追加
されます。
OVER モードの場合: CHNGDUMP
オプションは、現行のトランザクショ
ン・ダンプ・オプション・リストに追
加されます。システムは、ダンプを要
求するマクロまたはオペレーター・コ
マンドで指定したすべてのオプション
を無視します。オプションは、
CHNGDUMP SYSMDUMP,ADD オペ
レーター・コマンドが入力されるま
で、IEATDUMP マクロおよび
SYSMDUMP の場合のすべてのトラン
ザクション・ダンプをオーバーライド
します。
例
別の CHNGDUMP SYSMDUMP で変
更するまで、IEATDUMP マクロおよ
び SYSMDUMP の場合のすべてのト
ランザクション・ダンプに LPA を追
加するためには、次のように入力しま
す。
CHNGDUMP SET,SYSMDUMP=(LPA)
CHNGDUMP IEATDUMP オプショ
ン・リストをすべてのトランザクショ
ン・ダンプに追加する場合は、次のよ
うに入力します。
CHNGDUMP SET,SYSMDUMP,ADD
CHNGDUMP IEATDUMP オプショ
ン・リストをもつすべてのトランザク
ション・ダンプをオーバーライドする
場合は、次のように入力します。
CHNGDUMP SET,SYSMDUMP,OVER
DEL オプションの場合: CHNGDUMP
オプションはトランザクション・ダン IEATDUMP オプション・リストから
プ・オプション・リストから削除され LPA を除去する場合は、次のように
入力します。
ます。
IEATDUMP を指定した複数の
CHNGDUMP オペレーター・コマン
ドを入力すると、効果は累積されま
す。
3-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
CHNGDUMP DEL,SYSMDUMP=(LPA)
第 4 章 スタンドアロン・ダンプ
スタンドアロン・ダンプ・プログラムは、次のいずれかのストレージのスタンドア
ロン・ダンプを作成します。
v 障害を起こしたシステム。
v 障害を起こしたスタンドアロン・ダンプ・プログラム。
スタンドアロン・ダンプ・プログラムが自分のダンプをとった ― 自己ダンプ
―、またはオペレーターが別のスタンドアロン・ダンプ・プログラムをロードし
て、障害を起こしたスタンドアロン・ダンプ・プログラムをダンプした。
スタンドアロン・ダンプ・プログラムとスタンドアロン・ダンプが一緒になって、
スタンドアロン・ダンプ保守援助プログラムを形成します。スタンドアロンという
用語は、ダンプが通常のシステム操作とは切り離して実行され、システムが通常操
作の状態になくともよいことを意味します。
スタンドアロン・ダンプ・プログラムは、中央記憶装置およびテープ装置または直
接アクセス記憶装置 (DASD) 上のページアウト仮想記憶域の部分の、高速で不定様
式のダンプを作成します。ユーザーが作成するスタンドアロン・ダンプ・プログラ
ムは、そこから IPL 可能なストレージ・デバイス上に置く必要があります。
障害を起こした症状が、待ち状態コードを持つ待ち状態、無処理の待ち状態、命令
ループ、またはスローな処理の場合は、スタンドアロン・ダンプを作成してくださ
い。
ストレージをダンプするスタンドアロン・プログラムを作成してください。
AMDSADMP マクロを使用して、下記のものを作成してください。
v DASD にあるスタンドアロン・ダンプ・プログラムで、出力をテープ・ボリュー
ムまたは DASD ダンプ・データ・セットに出す。
v テープ にあるスタンドアロン・ダンプ・プログラムで、出力をテープ・ボリュー
ムまたは DASD ダンプ・データ・セットに出す。
スタンドアロン・ダンプは、システム障害またはスタンドアロン・ダンプ・プログ
ラム障害を問題判別するために必要な情報を提供します。
さまざまなバージョンのスタンドアロン・ダンプ・プログラムを作成して、さまざ
まなタイプとストレージ量のダンプを作成できます。さまざまなバージョンを作成
するには、マクロのキーワードの値を変えていくつかの AMDSADMP マクロをコー
ディングしてください。
ここでは、スタンドアロン・ダンプの使用法を説明する次の項目を記載していま
す。
v 4-2 ページの『スタンドアロン・ダンプの計画』
v 4-8 ページの『スタンドアロン・ダンプ・プログラムの作成』
v 4-42 ページの『スタンドアロン・ダンプ・プログラムの実行』
v 4-50 ページの『シスプレックス内でのスタンドアロン・ダンプ・プログラムの実
行』
v 4-53 ページの『スタンドアロン・ダンプ出力のコピー、表示、および印刷』
© Copyright IBM Corp. 1988, 2008
4-1
スタンドアロン・ダンプ
v
v
4-59 ページの『メッセージ出力』
4-60 ページの『スタンドアロン・ダンプ出力の分析』
スタンドアロン・ダンプの計画
スタンドアロン・ダンプの計画をするときは、いくつかの決定をする必要がありま
す。これらの決定事項のほとんどは、スタンドアロン・ダンプ・プログラムを作成
する場合に、AMDSADMP マクロをコーディングする時か、マクロをアセンブルす
る時か、または IPCS ダイアログに SADMP オプションを使用する時のいずれかで
行うものです。いくつかの典型的な問題は、次のとおりです。
スタンドアロン・ダンプを DASD またはテープのいずれにとるべきか
スタンドアロン・ダンプ用の出力装置を選択する場合は、オペレーターの介入の必
要性、必要なオペレーター介入の量、およびシステムが使用できない時間の量を考
慮してください。
DASD にダンプすることによって、スタンドアロン・ダンプ処理中のオペレーター
の介入度合いを減らすことができます。DASD からスタンドアロン・ダンプ・プロ
グラムを IPL するための自動化パッケージ・セットを使用すると、スタンドアロ
ン・ダンプをリモート側から実行することができます。テープにダンプする場合
は、テープが IBM 仮想テープ・サーバー (VTS) 内にない限り、オペレーターはテ
ープの取り付けや取り換えなど、ダンプの別の側面を取り扱うことが求められま
す。
スタンドアロン・ダンプの取得中はシステムは使用不能です。システムが使用不能
である時間は、ダンプのサイズによります。
詳細については、 4-26 ページの『DASD データ・セットへのダンプ』を参照してく
ださい。
DASD にダンプをとる場合の必要なスペースはどのくらいか
単一ボリューム DASD ダンプ・データ・セットの最大サイズは、データ・セットの
タイプによって異なります。
v 従来型順次データ・セットは、65,535 トラックにスパンすることができ、およそ
3 GB を保持します。
v 拡張フォーマット・データ・セットは、z/OS V1R6 以降のリリースでサポートさ
れます。拡張フォーマット順次データ・セットは、16,777,215 ブロックを保持す
ることができます。最大ブロック・サイズ (29120 バイト) を使用した場合は、お
よそ 488 GB が収まります。拡張フォーマット順次データ・セットに対しては、
ストライピングまたは圧縮オプションを使用できません。データ・セットが作成
される時点で DFSMS にスペースの予約を要求するには、保証フリー・スペー
ス・オプションを使用する必要があります。
v ラージ・フォーマット・データ・セットは、z/OS V1R7 以降のリリースでサポー
トされます。ラージ・フォーマット (DSNTYPE=LARGE) データ・セットは、
16,777,215 トラックにスパンすることができます。最大ブロック・サイズ (29120
バイト) を使用した場合は、およそ 768 GB が収まります。
4-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
単一ボリュームに割り振りたいスペースより多くのスペースを必要とする場合は、
同じ装置タイプの 32 ボリュームまでスパンできるマルチボリューム DASD ダン
プ・データ・セットを定義することができます。
単一ボリューム DASD ダンプ・データ・セットまたはマルチボリューム DASD ダ
ンプ・データ・セットを割り振って、初期設定するには、IPCS ダイアログに、
AMDSADDD REXX™ ユーティリティーまたは SADMP ダンプ・データ・セット・
ユーティリティーを使用します。これにより、データ・セットは、初期設定が実行
されたシステムと、同じ装置番号を使用して同じデータ・セットにアクセスできる
他のシステムが使用できるように準備されます。詳しくは、以下を参照してくださ
い。
v
4-28 ページの『AMDSADDD ユーティリティーの使用』
v 「z/OS MVS IPCS ユーザーズ・ガイド」内の IPCS ダイアログの SADMP オプ
ション
マルチボリュームの DASD ダンプ・データ・セットを使用する場合、最初のボリュ
ーム装置番号を指定します。他のボリュームは、データ・セットが初期設定された
時点でそのなかに置かれた情報を使用して、スタンドアロン・ダンプによって位置
指定されます。スタンドアロン・ダンプは、全ボリュームを同時並行的に出力する
ことになります。スタンドアロン・ダンプがデータ・セットの全ボリュームにアク
セスできないか、または初期設定中に無効な制御情報をデータ・セットから読み取
った場合は、そのデータ・セットはリジェクトされます。
ダンプ・データ・セットに十分大きなスペースを割り振っていない場合、スタンド
アロン・ダンプ・プログラムはオペレーターに別の DASD ダンプ・データ・セット
またはテープ・ボリュームにダンプをし続けるかどうかのプロンプト指示を出しま
す。スタンドアロン・ダンプがサポートされる任意のデバイスにダンプを継続する
ことができますが、磁気テープ装置を選択した場合には、マルチボリュームを必要
とする場合であっても、そのダンプが完了するまで磁気テープ装置を使用する必要
があります。
全部のスタンドアロン・ダンプを実行するために、複数のダンプ・データ・セット
を割り当てることをお勧めします。
複数のダンプ・データ・セットにダンプできるか
スタンドアロン・ダンプを使用すると、複数のダンプ・データ・セットにダンプす
ることができます。 AMDSADMP マクロに DDSPROMPT=YES キーワードをコー
ディングすると、ランタイム・ダンプ・データ・セット・プロンプト指示が可能な
スタンドアロン・ダンプ・プログラムを生成することができます。
スタンドアロン・ダンプ・プログラムを開始すると、オペレーターに出力装置を要
求するメッセージ AMD001A が出されます。DASD 装置を指定して、ランタイム・
ダンプ・データ・セット・プロンプト指示がアクティブである場合には、オペレー
ターにダンプ・データ・セット名を要求するメッセージ AMD002A が出されます。
ダンプ・データ・セットが出力装置上で正しく割り振られ、初期設定されると、ス
タンドアロン・ダンプ・プログラムは、指定したダンプ・データ・セット名を使用
します。ダンプ・データ・セットがいっぱいであることを示すメッセージ AMD099I
が出された場合、再度メッセージ AMD001A (および多分 AMD002A も) に返答す
ることによって、オペレーターはスタンドアロン・ダンプがサポートする任意の
第 4 章 スタンドアロン・ダンプ
4-3
スタンドアロン・ダンプ
DASD ダンプ・データ・セットまたは磁気テープ装置にダンプをし続けることがで
きます。ダンプが完了すると、ダンプを取っていた間使用された装置またはダン
プ・データ・セット (またはその両方) のすべてを示すメッセージ AMD104I が出
されます。
AMDSADMP マクロに DDSPROMPT=NO をコーディングすると、ランタイム・ダ
ンプ・データ・セット・プロンプト指示を行わないスタンドアロン・ダンプ・プロ
グラムが生成されます。この場合、メッセージ AMD001A に DASD 装置を返答す
ると、スタンドアロン・ダンプ・プログラムは出力ダンプ・データ・セットの名前
を SYS1.SADMP と想定します。
注:
1. スタンドアロン・ダンプ・データ・セットを割り振って初期設定するには、
AMDSADDD REXX または IPCS SADMP ダンプ・データ・セット・ユーティ
リティーを使用します。
2. 指定した装置上で、スタンドアロン・ダンプ・プログラムがダンプ・データ・セ
ットを見付けなれなければならないことを知っている必要があります。 したが
って、スタンドアロン・ダンプ用のダンプ・データ・セットがマイグレーション
済みの状態に置かれたり、異なるボリュームにマイグレーションされることのな
いように、必要なデータ・セット管理ステップを取ることが必須になります。ま
た、ダンプ・データ・セットは、未使用のスペースを解放する可能性のあるスペ
ース管理処理を避ける必要があります。
3. スタンドアロン・ダンプがサポートする任意のデバイスにダンプを継続すること
ができますが、磁気テープ装置を選択した場合には、複数テープ・ボリュームを
必要とする場合であっても、そのダンプが完了するまで磁気テープ装置を使用す
る必要があります。
詳細については 以下のトピックを参照してください。
v ダンプ・データ・セット処理については、 4-13 ページの『AMDSADMP マクロの
構文』の DDSPROMPT キーワードの説明を参照してください。
v IPCS で複数ダンプ・データ・セットを使用する方法については、 4-56 ページの
『複数ダンプ・データ・セットからのコピー』を参照してください。
v DASD における SADMP データ・セットの作成、消去、および再割り振りに関連
したタスクを実行するための詳しい情報については、「z/OS MVS IPCS ユーザー
ズ・ガイド」内の IPCS ダイアログの SADMP オプション を参照してくださ
い。
DASD ダンプ・データ・セットに付けられる名前は
スタンドアロン・ダンプ用のダンプ・データ・セットは、任意の正しい MVS デー
タ・セット名であれば構いませんが、スタンドアロン・ダンプには生成時と実行時
の両方でチェックされる次の 2 つの要件があります。
v データ・セット名は 44 文字以下であること
v データ・セット名には、データ・セット修飾子の一部または全体として、テキス
ト ’SADMP’ を含んでいること
さらに、生成プロセスは出力装置またはダンプ・データ・セット名では割り振りを
行わないため、OUTPUT= キーワードに指定したデータ・セット名が、AMDSADDD
REXX または IPCS SADMP データ・セット・ユーティリティーによって割り振ら
4-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
れたダンプ・データ・セット名と完全に一致するようにする必要があります。ダン
プ・データ・セット名を指定する際に、従わなければならないその他いくつかの規
則は以下のとおりです。
v 指定するデータ・セット名は、完全修飾 (引用符なしで) にすること
v ダンプ・データ・セット名の英字は、大文字で指定すること
ダンプすべきシステムの量はどれくらいか
決まっていません。状況によって、障害を診断するために必要な情報量が決まりま
す。2 つの AMDSADMP マクロをアセンブルすることをお勧めします。1 つは
MINASID(ALL) オプションを使用し、別の 1 つは MINASID(PHYSIN) オプション
を使用してください。遭遇する状況に応じて、どの AMDSADMP マクロを使用して
スタンドアロン・ダンプ・プログラムを作成するかを選択できます。 1 つのバージ
ョンだけのスタンドアロン・ダンプ・プログラムの作成を選択する場合は、
MINASID(ALL) を指定する必要があります。
すべてのアドレス・スペースが必要な場合、特にハング、使用可能待機、およびパ
フォーマンスの問題などの場合は、MINASID(ALL) を指定してください。
MINASID(ALL) オプションは、ダンプが取られた時点のシステムのさらに詳しいイ
メージを提供します。ただし、このオプションを指定するとスタンドアロン・ダン
プ・プログラムの実行時間が長くなり、DASD にダンプしている場合は、ダンプ・
データ・セットに必要な DASD スペースが増加します。
コード化された待機、ループ、およびスピン・ループを含む障害の場合は、
MINASID(PHYSIN) を指定してください。MINASID(PHYSIN) オプションはスタン
ドアロン・ダンプ・プログラムの全体の実行時間を減らしますが、システムの全体
像を提供しないので、必要な診断情報が欠落する危険性が増加します。このオプシ
ョンはアドレス・スペースで物理的にスワップされたものだけをダンプするので、
ダンプではいくつかの仮想記憶域は除外されています。 MINASID(ALL) を選択し
た場合は、AMD108I メッセージの発行時に外部割り込みを使用してダンプ処理を手
動で終了させることにより、MINASID(PHYSIN) とほとんど同じ結果を得ることが
できます。
ダンプしたいストレージの量を制御するために DUMP キーワードを使用すること
もできます。詳細については、 4-21 ページの『追加記憶域を要求するために DUMP
キーワードを使用する』を参照してください。
参照
AMD108I メッセージの詳細については、「z/OS MVS システム・メッセージ 第 1
巻 (ABA-AOM)」を参照してください。
ダンプ調整オプションを指定する時期はいつか
スタンドアロン・ダンプにダンプ・オプションを指定する最も柔軟性のある方法
は、AMDSADMP マクロの DUMP キーワードにダンプしたいエリアを指定し、さ
らにダンプを要求するオペレーターが追加のオプションを指定できるようにするこ
とです。オペレーターに追加のダンプ調整オプションをプロンプト指示する場合
は、AMDSADMP マクロに PROMPT を指定します。
第 4 章 スタンドアロン・ダンプ
4-5
スタンドアロン・ダンプ
ほとんどのケースでは、ダンプ処理を単純化するために、AMDSADMP マクロでご
使用のシステム環境固有のダンプ・オプションをすべて定義し、PROMPT キーワー
ドを指定しないことをお勧めします。
詳細については、 4-21 ページの『追加記憶域を要求するために DUMP キーワード
を使用する』を参照してください。
スタンドアロン・ダンプ・プログラムが、要求するセキュリティーの
タイプはなにか
スタンドアロン・ダンプ・プログラムは、いったん DASD 常駐ボリュームに正しく
作成されると、SYS1.PAGEDUMP.Vvolser データ・セット内に置かれます。スタン
ドアロン・ダンプ・プログラムが使用可能で、正しく処理されるようにするため
に、そのデータ・セットを削除したり、別のボリュームやパックに移動しないでく
ださい。 SYS1.PAGEDUMP.Vvolser 内のスタンドアロン・ダンプ・プログラムを保
護するために、パスワードを使用するか、または RACF などのセキュリティー・プ
ロダクトを使用してください。データ・セットを保護していなければ、無許可のユ
ーザーが SYS1.PAGEDUMP.Vvolser 内のデータを読み取ることができます。また、
スタンドアロン・ダンプ・マクロ、モジュール、および出力ダンプ・データ・セッ
トが無許可で修正されないように保護することを考慮してください。
データ・セットの保護に関する詳細は、「z/OS Security Server RACF セキュリティ
ー管理者のガイド」を参照してください。
ダンプをデータ・セットにコピーするために IEBGENER または
COPYDUMP サブコマンドを使用すべきか
お勧めする方式は、IPCS COPYDUMP です。IPCS COPYDUMP は、ダンプ・ディ
レクトリーを使用しなくても実行できます。 IPCS セッションを開始するときに、
ダンプ・ディレクトリーが必要になるまでダンプ・ディレクトリーにアクセスする
のを遅らすよう IPCS に伝えるには DEFER オプションを使用します。 z/OS V1R7
以上では、IPCS COPYDUMP には、複数ボリューム SADMP にあるレコードをマ
ージし、SADMP で使用されている優先順位付けされた順序を再キャプチャーし
て、最も大事なデータを最初にダンプ・データ・セットに入れる機能があります。
SADMP が正常に完了することができる場合は、IEBGENER および同様の複写プロ
グラムは、IPCS が処理できる論理的に完全なダンプ・データ・セットを生成できま
す。ただし、IPCS のパフォーマンス、特に IPCS ダンプの初期設定は、さらにボリ
ュームが SADMP データ・セットに追加されるにつれて劣化します。
スタンドアロン・ダンプ・プログラムを実行すると何がダンプされる
か
デフォルトのダンプは中央記憶装置の全エリアと中央記憶装置に戻されない仮想記
憶域のいくつかのエリアを含みます。スタンドアロン・ダンプ・プログラムの出力
には次のものが含まれます。
v 接頭部保管域 (PSA)
v 中核と拡張中核
v システム・キュー・エリア (SQA) と拡張 SQA
v 共通サービス・エリア (CSA) と拡張 CSA
4-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
v 指定した MINASID オプション (PHYSIN または ALL) に基づく適格アドレス・
スペースのサブプール 203-205、213-215、229、230、236、237、247、 248、およ
び 249
v ローカル・システム・キュー域と、指定した MINASID オプション (PHYSIN ま
たは ALL) に基づいた適合アドレス・スペース用の拡張 LSQA
v オペレーターが指定したダンプの表題。それ以外の場合はダンプに表題はつきま
せん。
v プロセッサーごとのプロセッサー STORE STATUS 情報
v 主記憶域のアドレス 0 から上部の中央記憶装置 (オフラインのストレージ・エレ
メントのために欠落するブロックがある場合があります)
v 命令アドレス・トレースが作成する命令トレース・データ
v DUMP キーワードで選択するかまたは実行時にオペレーターが選択する、仮想記
憶域。
v 通常は、抑制されたメッセージを含む、ダンプ・プログラムが発行するすべての
コンソール・メッセージからなるメッセージ・ログ。(スタンドアロン・ダンプ・
メッセージ・ログをフォーマット設定または印刷する場合は、VERBEXIT
SADMPMSG サブコマンドまたは IPCS ダイアログ機能の SADMPMSG オプシ
ョンを使用します。)
v 指定した MINASID オプションに基づく適格アドレス・スペース (PHYSIN また
は ALL)
v ダンプ内のゼロ・ページを要約しているダンプ・レコード
v 全汎用トレース機能 (GTF) アドレス・スペース
v GRS アドレス・スペースのサブプール 127
v GRS アドレス・スペースの ISG で始まる名前をもつデータ・スペース
v DUMPSRV データ・スペースのすべて
v 全システム間カップリング・ファシリティー (XCF) アドレス・スペース
v XCF データ・スペースのすべて
v XES 接続をもつアドレス・スペースの XES 関連データ・スペース
このリストは、スタンドアロン・ダンプ処理の順序を暗黙指定するものではないこ
とに注意してください。スタンドアロン・ダンプ処理では、いくつかの異なるメッ
セージが発行されてダンプの進ちょくを示します。
v 実際のダンプ処理では、AMD005I が発行されます。
v 実際のダンプ処理および仮想ダンプ処理の両方では、AMD095I が 30 分ごとに発
行され、続いてメッセージ AMD056I で仮想記憶域のダンプが完了したことが示
され、AMD104I ではスタンドアロン・ダンプ・プログラムが使用した出力装置ま
たはダンプ・データ・セット (あるいはその両方) が示されます。
z/OS の新規のバージョンをダンプするためにスタンドアロン・ダンプ・プ
ログラムの現行のバージョンを使用できるか
ダンプする z/OS のリリースと同じリリースから生成されたスタンドアロン・ダン
プのバージョンを必ず使用してください。レベルの異なるスタンドアロン・ダンプ
では、そのダンプが対応するレベルの z/OS 以外の正常なダンプは保証されませ
第 4 章 スタンドアロン・ダンプ
4-7
スタンドアロン・ダンプ
ん。新規バージョンの z/OS が変更されて、スタンドアロン・ダンプ・プログラム
がその動作に必要な必須情報を見つけられなくなっていることがあります。
z/OS の新規バージョンにマイグレーションする際、IBM は、新しい z/OS システ
ム・データ・セットを使用して作成されたスタンドアロン・ダンプ・プログラムの
新規バージョンを生成することを強くお勧めします。詳細については、 4-40 ページ
の『マイグレーション時に 2 段階生成を使用する』を参照してください。
スタンドアロン・ダンプ・プログラムの作成
スタンドアロン・ダンプ・プログラムを作成する最初のステップは、スタンドアロ
ン・ダンプ IPL ボリューム (常駐ボリューム) として、テープまたは DASD を選
択することです。常駐ボリュームを選択したら、スタンドアロン・ダンプ・プログ
ラムを作成することができます。スタンドアロン・ダンプ・プログラムを作成する
場合は、次の手順に従います。
1. AMDSADMP マクロをコーディングします。 4-13 ページの『AMDSADMP マク
ロのコーディング』を参照してください。
2. マクロをアセンブルして、スタンドアロン・ダンプ・プログラムをロード可能形
式にして常駐ボリュームに置きます。現在稼働中のバージョンの MVS 用のスタ
ンドアロン・ダンプ・プログラムを作成する場合は、1 ステップ生成を使用する
ことをお勧めします。複数のスタンドアロン・ダンプ・プログラムを作成する場
合、および MVS の新規バージョンにマイグレーション時に新規のバージョンの
スタンドアロン・ダンプ・プログラムを作成する場合には、2 段階の生成を使用
してください。 4-34 ページの『スタンドアロン・ダンプ・プログラムの生成』
を参照してください。
AMDSADMP マクロからの MNOTES
アセンブリーの結果のリストには、MNOTES と呼ばれるエラー・メッセージが入っ
ていることがあります。このエラー・メッセージでは AMDSADMP マクロのコーデ
ィング時のエラーが説明されています。これらのメッセージのいずれかに対処する
には、マクロの仕様を調べて、アセンブリー・ステップを再度実行します。
重大度コードの意味は次のとおりです。
8
アセンブリー処理の終了
4
注意
0
通知
AMDSADMP: COMPACT=compact IS NOT ALLOWED. IT MUST BE YES OR NO.
COMPACT=YES HAS BEEN USED.
説明: COMPACT キーワードに指定した値をシステムが認識できません。IDRC がインストールされている場合は、ス
タンドアロン・ダンプ・プログラムは出力テープ用に IDRC 機能を使用します。
重大度コード: 0。
AMDSADMP: CONSOLE ADDRESS conad
IS INVALID. IT MUST BE A DEVICE NUMBER.
001F IS SUBSTITUTED.
説明: コンソール・アドレス・オペランドが、3 桁または 4 桁の 16 進数からなる有効な装置番号ではありません。
重大度コード: 0。
4-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
AMDSADMP: CONSOLE PARM NOT
DETECTED. DEFAULT (001F, 3278) WILL BE USED.
説明: コンソール・パラメーターを指定しなかったか、または連結ステートメント内に正しく指定しませんでした。お
そらく、そのパラメーターは、次に定義されたステートメントで正しく継続されませんでした。割り込みパラメーター
またはフィールドを、4 桁目から 16 桁目の間に続けてください。
z/OS MVS JCL 解説書 内の JCL ステートメントの継続 を参照してください。
重大度コード: 0。
AMDSADMP: CONSOLE TYPE contp
IS INVALID. IT MUST BE A 4 DIGIT NUMBER. 3278 HAS BEEN USED.
説明: 間違ったコンソール・タイプを指定しました。使用できるコンソールのタイプは、3277、3278、3279、または
3290 です。
重大度コード: 0。
AMDSADMP: DEFAULT OUTPUT DEVICE T0282 WILL BE USED.
説明: OUTPUT= パラメーターに、間違った装置番号を指定したか、またはなにも指定していません。
重大度コード: 0。
AMDSADMP: IPL=ipl IS INVALID.
FIRST CHARACTER MUST BE D OR T,
AND HAS BEEN REPLACED WITH A D.
説明: IPL オペランドが正しくありません。’D’ または ’T’ が前に付いていません。
重大度コード: 4。
AMDSADMP: IPL=ipl IS TOO LONG.
THE UNIT NAME WILL BE TRUNCATED.
説明: 装置名は最大 8 文字までです。
重大度コード: 4。
AMDSADMP: IPLUNIT WAS NOT SPECIFIED OR
IPL= TYPE (D OR T) WAS SPECIFIED
INCORRECTLY. UNIT WILL BE DEFAULTED TO SYSDA.
説明: IPL パラメーターは、IPL=duuu のように指定する必要があります。‘d’ は、直接アクセス装置の場合は D、テー
プの場合は T です。また、‘uuu’ は、UNIT=uuu JCL パラメーターで記述した SADMP IPL ボリュームの有効な装置
タイプまたは装置番号です。
システム・プログラマーの応答: 3 桁または 4 桁の 16 進数で装置番号を指定します。
重大度コード: 0。
AMDSADMP: MSG=msg IS INVALID. IT MUST BE ALL, ACTION,
OR ALLASIDS. MSG=ALL HAS BEEN USED.
説明: MSG オペランドが、ALL、ACTION、または ALLASIDS ではありません。
重大度コード: 0。
第 4 章 スタンドアロン・ダンプ
4-9
スタンドアロン・ダンプ
AMDSADMP: DDSPROMPT=ddsprompt IS NOT ALLOWED. IT MUST BE YES OR NO.
DDSPROMPT=YES HAS BEEN USED.
説明: DDSPROMPT オペランドが正しくありません。‘YES’ または ‘NO’ のいずれかです。DDSPROMPT=YES が想
定されています。
システム処置: SADMP プログラムはランタイム・ダンプ・データ・セット・プロンプト指示をアクティブとして生成
されます。
重大度コード: 0。
AMDSADMP: OUTPUT=output IS INCORRECT. IT MUST BE EITHER
{T|D}UNIT OR (DUNIT,DATA SET NAME).
説明: OUTPUT オペランドが間違っています。次のいずれかのフォーマットで指定する必要があります。
v ‘T’ または ‘D’ に装置番号を続ける
v ‘D’ に括弧内に指定した装置番号とデータ・セット名の対を続ける
システム処置: 使用されているフォーマットに関係なく、デフォルトの OUTPUT オペランドである T0282 を使用し
て、生成は継続します。
システム・プログラマーの応答: 出力装置は、3 桁または 4 桁の装置番号で指定しなければなりません。デフォルト値
が、希望しているものではない場合は、実行時に OUTPUT パラメーターを変更することができます。
重大度コード: 4。
AMDSADMP: OUTPUT DUMP DATA SET NAME IS INCORRECT. THE DATA SET NAME
IS GREATER THAN 44 CHARACTERS.
説明: OUPTUT=(Dunit,ddsname) が指定されましたが、データ・セット名 (ddsname) の長さが 44 文字を超えていまし
た。
システム処置: 生成は継続しますが、デフォルトのダンプ・データ・セット名は生成されません。
システム・プログラマーの応答: デフォルトのダンプ・データ・セット名が必要なときは、OUTPUT= の指定を訂正し
て、SADMP プログラムを再度生成します。
重大度コード: 4。
AMDSADMP: OUTPUT DUMP DATA SET NAME IS INCORRECT. IT MUST CONTAIN
THE TEXT ‘SADMP’.
説明: OUPTUT=(Dunit,ddsname) が指定されましたが、データ・セット名 (ddsname) にはデータ・セット修飾子の一部
または全体として、テキスト ‘SADMP’ が含まれていません。
システム処置: 生成は継続しますが、デフォルトのダンプ・データ・セット名は生成されません。
システム・プログラマーの応答: デフォルトのダンプ・データ・セット名が必要なときは、OUTPUT= の指定を訂正し
て、SADMP プログラムを再度生成します。
重大度コード: 4。
4-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
AMDSADMP: REUSEDS=reuseds IS NOT ALLOWED.
VALID SPECIFICATIONS
ARE NEVER, CHOICE, OR ALWAYS.
REUSEDS=CHOICE HAS BEEN USED.
説明: REUSEDS オペランドが、NEVER、CHOICE、ALWAYS、のいずれでもありません。
システム処置:
デフォルトの REUSEDS オペランド、CHOICE を使用して生成は継続します。
重大度コード: 0。
AMDSADMP: ULABEL=NOPURGE IS NOT
POSSIBLE FOR A TAPE RESIDENCE VOLUME.
説明: IPL 装置がテープの場合は ULABEL を NOPURGE にすることはできません。SADMP はユーザーの ULABEL
仕様を無視します。
重大度コード: 8。
AMDSADMP: keyword IS AN OBSOLETE
KEYWORD. IT IS IGNORED. SADMP
GENERATION CONTINUES.
説明: 古いキーワードが AMDSADMP マクロに指定されました。SADMP はスタンドアロン・ダンプ・プログラムを
作成するために LOADPT または TYPE キーワードが必要ではなくなりました。
システム処置: システムはキーワードを無視し処理を継続します。
システム・プログラマーの応答: この MNOTE を除去するために、示されたキーワードと関連するパラメーターを生
成 JCL から除去します。
重大度コード: 0。
AMDSADMP: ALIB=alib IS NOT VALID. THE
REQUIRED SYNTAX IS ALIB=(VOLSER,UNIT).
説明: システムは、ALIB キーワードに指定したパラメーターを認識できません。正しい構文は ALIB=(volser,unit) で
す。ここで、volser はボリューム通し番号で unit は装置の UNIT= 値です。
システム処置: システムはこのキーワードを無視し処理を継続します。2 番目のステップの JCL が間違っています。
システム・プログラマーの応答: AMDSADMP マクロに指定した構文を訂正し、JCL を再実行要求します。
重大度コード: 8。
AMDSADMP: NUCLIB=nuclib IS NOT VALID.
SYNTAX IS NUCLIB=(VOLSER,UNIT).
THE REQUIRED
説明: システムは NUCLIB キーワードに指定したパラメーターを認識できません。正しい構文は NUCLIB=(volser,unit)
です。ここで、volser はボリューム通し番号で unit は装置の UNIT= 値です。
システム処置: システムはこのキーワードを無視し処理を継続します。2 番目のステップの JCL が間違っています。
システム・プログラマーの応答: AMDSADMP マクロに指定した構文を訂正し、JCL を再実行要求します。
重大度コード: 8。
第 4 章 スタンドアロン・ダンプ
4-11
スタンドアロン・ダンプ
AMDSADMP: MODLIB=modlib IS NOT VALID. THE
REQUIRED SYNTAX IS MODLIB=(VOLSER,UNIT).
説明: システムは MODLIB キーワードに指定したパラメーターを認識できません。正しい構文は
MODLIB=(volser,unit) です。ここで、volser はボリューム通し番号で unit は装置の UNIT= 値です。
システム処置: システムはこのキーワードを無視し処理を継続します。2 番目のステップの JCL が間違っています。
システム・プログラマーの応答: AMDSADMP マクロに指定した構文を訂正し、JCL を再実行要求します。
重大度コード: 8。
AMDSADMP: LNKLIB=lnklib IS NOT VALID. THE
REQUIRED SYNTAX IS MODLIB=(VOLSER,UNIT).
説明: システムは LNKLIB キーワードに指定したパラメーターを認識できません。正しい構文は LNKLIB=(volser,unit)
です。ここで、volser はボリューム通し番号で unit は装置の UNIT= 値です。
システム処置: システムはこのキーワードを無視し処理を継続します。2 番目のステップの JCL が間違っています。
システム・プログラマーの応答: AMDSADMP マクロに指定した構文を訂正し、JCL を再実行要求します。
重大度コード: 8。
AMDSADMP: CONSOLE TYPE contp IS INVALID.
SPECIFIED FOR SYSC. IT WILL BE IGNORED.
NO VALUE MAY BE
説明: コンソール・タイプがコンソール名 SYSC に続いて指定されました。このコンソールにはコンソール・タイプを
指定できません。
システム処置: システムは指定を無視します。
システム・プログラマーの応答: なし。
重大度コード: 0。
AMDSADMP: CONSOLE ADDRESS SYSC MAY ONLY BE SPECIFIED FOR THE
FIRST CONSOLE. IT WILL BE IGNORED.
説明: コンソール名 SYSC がコンソール・リストの最初のコンソールとして指定されていません。SYSC を指定でき
るのは、最初のコンソールとしてだけです。
システム処置: システムは指定を無視します。
システム・プログラマーの応答: なし。
重大度コード: 0。
AMDSADMP: ONLY SYSTEM CONSOLE DEFINED. DEFAULT (001F,3278)
WILL ALSO BE USED.
説明: SYSC という名前のコンソールは、ただ 1 つの定義されたコンソールです。少なくとも 1 つの 3270 コンソー
ルも定義する必要があります。
システム処置: システムは、デフォルト・コンソール (001F,3278) を定義しました。
システム・プログラマーの応答: なし。
重大度コード: 0。
4-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
AMDSADMP: POSITIONAL value IGNORED.
説明: AMDSADMP マクロの最初の定位置引数に PROMPT 以外の定位置値があります。無視されました。
システム・プログラマーの応答: なし。
重大度コード: 0。
AMDSADMP マクロのコーディング
このセクションでは AMDSADMP マクロのコーディングについて、次の項目を説明
します。
v 4-21 ページの『追加記憶域を要求するために DUMP キーワードを使用する』
v 4-26 ページの『DASD データ・セットへのダンプ』
AMDSADMP マクロの構文
図 4-1 に AMDSADMP マクロ・パラメーターを示しています。
[symbol] AMDSADMP
[,IPL={Tunit|Dunit|DSYSDA}]
[,VOLSER={volser|SADUMP}]
[,ULABEL={PURGE|NOPURGE}]
[,CONSOLE=({cnum|(cnum,ctype) [,(cnum,ctype)]...|01F,3278})]
[,SYSUT={unit|SYSDA}]
[,OUTPUT={Tunit|Dunit|(Dunit,ddsname)|T0282}]
[,DUMP=(’options’)][,PROMPT]
[,MSG={ACTION|ALLASIDS|ALL}]
[,MINASID={ALL|PHYSIN}]
[,COMPACT={YES|NO}]
[,REUSEDS={CHOICE|ALWAYS|NEVER}]
[,ALIB=(volser,unit)]
[,NUCLIB=(volser,unit)]
[,MODLIB=(volser,unit)]
[,LNKLIB=(volser,unit)]
[,DDSPROMPT={YES|NO}]
図 4-1. AMDSADMP マクロ命令のフォーマット
第 4 章 スタンドアロン・ダンプ
4-13
スタンドアロン・ダンプ
Symbol
AMDSADMP マクロに指定できる任意の名前。スタンドアロン・ダンプは、こ
の記号を使用して初期設定ステップで使用するジョブ名を作成します。
AMDSADMP
マクロ名。
IPL={Tunit|Dunit|DSYSDA}
スタンドアロン・ダンプ常駐ボリュームの装置番号、装置タイプ、または非公式
名を示します。最初の文字は、ボリューム・タイプを示します。テープの場合は
T、DASD の場合は D です。スタンドアロン・ダンプは初期設定のための常駐
ボリュームを割り振るのに unit に指定された文字ストリングを UNIT= 値とし
て使用します。
装置番号は、斜線 (/) を任意指定で前に付けた、1 から 4 桁の 16 進数で構成
されます。4 桁の装置番号の前に斜線を使用すると、装置番号と装置タイプを区
別することができます。
デフォルト値は IPL=DSYSDA です。IPL=T を指定すると、スタンドアロン・
ダンプは T3400 を想定します。IPL=D を指定すると、スタンドアロン・ダンプ
は DSYSDA を想定します。
注:
1. この装置は、スタンドアロン・ダンプ処理の間に使用する作業ファイルも含
んでいます。
2. ページ・データ・セットが入っているボリュームにスタンドアロン・ダンプ
の IPL テキストを入れることはお勧めしません。スタンドアロン・ダンプを
再始動 ( 4-42 ページの『スタンドアロン・ダンプ・プログラムの実行』を参
照) すると、この場合実際のダンプ・フェーズでハングします。
VOLSER={volser|SADUMP}
システムが初期設定時の常駐ボリュームを割り振るために使用するボリューム通
し番号を示します。テープ・ボリュームを指定する場合は、NL (ラベルなし) で
なければなりません。VOLSER=SADUMP がデフォルト値です。
ULABEL={PURGE|NOPURGE}
DASD ユーザー・ラベル・ボリュームの既存のユーザー・ラベルを、スタンド
アロン・ダンプが削除するか (PURGE) または保存するか (NOPURGE) を示し
ます。NOPURGE を指定すると、スタンドアロン・ダンプ・プログラムは常駐
ボリュームのシリンダー 0 トラック 0 のユーザー・ラベルの後に、即時に書き
込まれます。ユーザー・ラベルが非常にたくさんのスペースを取り、スタンドア
ロン・ダンプ・プログラムがトラック 0 に入らない場合は、初期設定プログラ
ムはエラー・メッセージを発行し、終了します。
ULABEL=NOPURGE がデフォルト値です。
CONSOLE=({cnum|(cnum,ctype)[,(cnum,ctype)]...|01F,3278})
スタンドアロン・ダンプがダンプを取る時に使用する、スタンドアロン・ダン
プ・コンソールの装置番号と装置タイプを示します。CONSOLE=cnum を指定す
ると、スタンドアロン・ダンプは (cnum,3278) を想定します。2 から 21 のコ
ンソールを、次のようにコーディングして、指定することができます。
CONSOLE=((SYSC)|(cnum,ctype),(cnum,ctype),[,(cnum,ctype)]...)
4-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
装置番号は、斜線 (/) を任意指定で前に付けた、3 から 4 桁の 16 進数で構成
されます。4 桁の装置番号の前に斜線を使用すると、装置番号と装置タイプを区
別することができます。
3277、3278、3279、および 3290 の装置タイプを使用でき、それらは交換可能で
す。
CONSOLE=(01F,3278) がデフォルト値です。
CONSOLE=SYSC を指定できるのは最初のコンソールの場合だけです。SYSC
はハードウェア・システム・コンソールを表す定数です。
注: CONSOLE の指定は、システム・コンソールの使用可能度には影響しませ
ん。
SYSUT={unit|SYSDA}
スタンドアロン・ダンプがスタンドアロン・ダンプの初期設定間に作業ファイル
に使用する装置の UNIT= 値を指定します。装置は、グループ名 (たとえば
SYSDA)、装置タイプ (たとえば 3330)、または装置アドレス (たとえば 131) で
指定することができます。SYSUT=SYSDA がデフォルト値です。
OUTPUT={Tunit|Dunit|(Dunit,ddsname)|T0282}
コンソール通信を迂回するために、オペレーターが EXTERNAL INTERRUPT
キーを使用した場合、またはスタンドアロン・ダンプの初期設定の間にオペレー
ターがメッセージ AMD001A にヌル応答を与えた場合に、スタンドアロン・ダ
ンプがデフォルト値として使用する装置タイプ、装置番号、およびデータ・セッ
ト名を示します。OUTPUT=T0282 はデフォルトです。
装置タイプは、テープの場合 ‘T’ または DASD の場合 ‘D’ を指定します。
装置番号は、斜線 (/) を任意指定で前に付けた、3 から 4 桁の 16 進数で構成
されます。4 桁の装置番号の前に斜線を使用すると、装置番号と装置タイプを区
別することができます。
デフォルトの装置が DASD である場合、OUTPUT= パラメーターに装置とダン
プ・データ・セットの両方を指定することによって、使用するデフォルトのダン
プ・データ・セット名をセットアップすることもできます。マルチボリューム
DASD データ・セットの最初のボリュームを指定して構いません。 デフォルト
のダンプ・データ・セット名を指定する場合には、次のようにする必要がありま
す。
v 長さは 44 文字以下にする。
v データ・セット修飾子の一部または全体として、テキスト ‘SADMP’ を含め
る。
AMDSADMP 処理は、データ・セットを割り振らないし、有効な MVS デー
タ・セット名が指定されているかどうかを調べるためのチェックをしないことに
注意してください。したがって、次のことを確認してください。
v AMDSADDD REXX を使用して、OUTPUT= キーワードに指定したのと同じ
データ・セット名を割り当てて初期設定する。
v 指定するデータ・セット名は、完全修飾 (引用符なしで) にする。
v スタンドアロン・ダンプ用のダンプ・データ・セットがマイグレーション済
みの状態に置かれたり、異なるボリュームにマイグレーションされることの
ないように、必要なデータ・セット管理ステップを取る。
第 4 章 スタンドアロン・ダンプ
4-15
スタンドアロン・ダンプ
v ダンプ・データ・セット名で使用される英字は、大文字で指定する。
デフォルトの DASD 装置を使用し、ダンプ・データ・セット名を指定しない場
合には、スタンドアロン・ダンプ・プログラムは、DDSPROMPT=NO パラメー
ターも指定しない場合、デフォルトのダンプ・データ・セット名を
SYS1.SADMP と想定します。 DDSPROMPT=YES を指定した場合、スタンドア
ロン・ダンプ・プログラムは、使用するダンプ・データ・セット名を要求するプ
ロンプト指示を実行時にオペレーターに出します。
注:
1. 実行時に、メッセージ AMD001A にヌル応答をすると、スタンドアロン・
ダンプ・プログラムはデフォルトの装置またはダンプ・データ・セット名
(あるいはその両方) を使用します。
2. スタンドアロン・ダンプ・プログラムがダンプする可能性があるページ・デ
ータ・セットも含まれているボリュームに、スタンドアロン・ダンプを含め
ようとしているデータ・セットを置かないでください。スタンドアロン・ダ
ンプは、仮想ダンプ処理を行うためにページ・ボリュームを初期設定すると
き、出力ダンプ・データ・セットもこのボリューム上に存在するかどうかを
チェックします。存在する場合、スタンドアロン・ダンプ・プログラムは、
メッセージ AMD100I を出して、このボリューム上のページ・データ・セッ
トからデータを取り出しません。つまり、ダンプに、要求したデータすべて
が含まれていない場合があります。このようなデータの欠如があると、それ
以降の診断に支障が出ることがあります。
3. 出力をスタンドアロン・ダンプ常駐ボリュームに書き込むことはできませ
ん。
DUMP=’options’
ダンプしたい追加の仮想記憶域を示します。このストレージは、アドレス・スペ
ース、データ・スペース、およびアドレス・スペース内のサブプールとして説明
します。DUMP を指定しない場合は、スタンドアロン・ダンプは PROMPT を
指定しなければ任意の別のストレージをダンプすることはありません。詳細につ
いては、 4-21 ページの『追加記憶域を要求するために DUMP キーワードを使
用する』を参照してください。
PROMPT
スタンドアロン・ダンプは、ダンプする別の仮想記憶域について実行時にオペレ
ーターにプロンプト指示します。オペレーターは DUMP キーワードに指定でき
る情報と同じ情報で応答することができます。PROMPT を指定しない場合は、
スタンドアロン・ダンプは別のストレージを指定するようにオペレーターにプロ
ンプト指示しません。詳細については、 4-21 ページの『追加記憶域を要求する
ために DUMP キーワードを使用する』を参照してください。
MSG={ACTION|ALLASIDS|ALL}
コンソールに表示されるスタンドアロン・ダンプ・メッセージのタイプを示しま
す。 ACTION を指定すると、スタンドアロン・ダンプはオペレーターの応答が
必要なメッセージのみを書き出します。ALL を指定すると、スタンドアロン・
ダンプはほとんどのメッセージをコンソールに書き出します。ただし、メッセー
ジ AMD010I、AMD057I、AMD076I、AMD081I、および AMD102I はスタンド
アロン・ダンプ・メッセージ・ログにのみ表示されます。ALLASIDS を指定す
4-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
ると、スタンドアロン・ダンプ・プログラムはメッセージ AMD010I がコンソ
ールに表示される以外は、MSG=ALL が指定してあったかのように機能しま
す。ALL はデフォルト値です。
このキーワードはスタンドアロン・ダンプ・メッセージ・ログに対しては効果が
ありません。MSG=ACTION を指定していても、スタンドアロン・ダンプ仮想
ダンプ・プログラムはすべてのメッセージをダンプ内のメッセージ・ログに書き
出します。
MINASID={ALL|PHYSIN}
最小ダンプに含まれる予定のアドレス・スペースの状況を示します。PHYSIN
を指定すると、物理的にスワップインされたアドレス・スペースに関連する最小
の仮想記憶域 (LSQA と選択されたシステム・サブプール) のみをダンプしま
す。ALL を指定すると、すべてのアドレス・スペースに関連する最小の仮想記
憶域 (LSQA と選択されたシステム・サブプール) をダンプします。ALL はデ
フォルト値です。
実行時に PHYSIN を指定すると、スタンドアロン・ダンプはメッセージ
AMD082I をオペレーターのコンソールに書き込み、いくつかの仮想記憶域がダ
ンプから外されていることをオペレーターに警告します。
COMPACT={YES|NO}
COMPACT(YES) は IDRC ハードウェア機構がテープ装置上で使用できる場合
に、テープ・カートリッジに保管されるデータを圧縮します。 IDRC 機能を使
用できるが、COMPACT キーワードを指定していない場合は、デフォルト値
YES が取られ、IDRC はダンプ・データを圧縮します。それ以外の場合は、デ
ータは通常処理が行われます。
REUSEDS={CHOICE|ALWAYS|NEVER}
データ・セットが有効であるが、以前のダンプのデータを含んでいる可能性があ
ることをスタンドアロン・ダンプが判別した時に、指定した出力装置上のダン
プ・データ・セットを再利用すべきかどうかを示します。スタンドアロン・ダン
プによるこの判別は、データ・セットの最初のレコードが AMDSADDD rexx
ユーティリティーによって書き込まれたレコードに一致するかどうかをチェック
することによって行われます。ALWAYS を指定すると、スタンドアロン・ダン
プは、メッセージ AMD094I を出して、指定したダンプ・データ・セットを再
使用します。NEVER を指定するとスタンドアロン・ダンプはメッセージ
AMD093I を発行し、メッセージ AMD001A を通じて、オペレーターに出力装
置を指定するようプロンプト指示を出します。CHOICE を指定すると、スタン
ドアロン・ダンプはメッセージ AMD096A を使用して、データ・セットが再初
期設定されず、データ・セットの再利用の許可を依頼していることをオペレータ
ーに通知します。ダンプ・データ・セットの、定義、クリア、および再割り振り
についての詳しい情報は、 4-28 ページの『AMDSADDD ユーティリティーの使
用』を参照してください。
CHOICE がデフォルト値です。
ALIB=(volser,unit)
下記のシステム・データ・セットのすべてを含むボリュームのボリューム通し番
号と UNIT= 値を指定します。
v SYS1.MODGEN
v SYS1.LINKLIB
第 4 章 スタンドアロン・ダンプ
4-17
スタンドアロン・ダンプ
v SYS1.NUCLEUS
このパラメーターは、ユーザーが 2 段階の生成を使用して、スタンドアロン・
ダンプ・プログラムを生成している場合にのみ有効です。
注: NUCLIB、LNKLIB、または MODLIB パラメーターは ALIB パラメーター
で指定する、対応する値を指定変更します。
このパラメーターの使用法についての詳しい情報は、 4-40 ページの『マイグレ
ーション時に 2 段階生成を使用する』を参照してください。
NUCLIB=(volser,unit)
システム・データ・セット SYS1.NUCLEUS を含むボリュームのボリューム通
し番号と UNIT= 値を指定します。このパラメーターは、2 段階の生成を使用し
てスタンドアロン・ダンプ・プログラムを生成する場合にのみ有効です。
このパラメーターの使用法についての詳しい情報は、 4-40 ページの『マイグレ
ーション時に 2 段階生成を使用する』を参照してください。
MODLIB=(volser,unit)
システム・データ・セット SYS1.MODGEN を含むボリュームのボリューム通し
番号と UNIT= 値を指定します。このパラメーターは、2 段階の生成を使用して
スタンドアロン・ダンプ・プログラムを生成する場合にのみ有効です。
このパラメーターの使用法についての詳しい情報は、 4-40 ページの『マイグレ
ーション時に 2 段階生成を使用する』を参照してください。
LNKLIB=(volser,unit)
システム・データ・セット SYS1.LINKLIB を含むボリュームのボリューム通し
番号と UNIT= 値を指定します。このパラメーターは、2 段階の生成を使用して
スタンドアロン・ダンプ・プログラムを生成する場合にのみ有効です。
このパラメーターの使用法についての詳しい情報は、 4-40 ページの『マイグレ
ーション時に 2 段階生成を使用する』を参照してください。
DDSPROMPT={YES|NO}
DDSPROMPT=YES を指定すると、スタンドアロン・ダンプ・プログラムが、
DASD 装置にダンプするとき、出力ダンプ・データ・セットを要求するプロン
プトをオペレーターに出すことができます。DDSPROMPT=YES を指定すると、
メッセージ AMD001A に DASD 装置番号を返答した後、メッセージ
AMD002A が出され、ダンプ・データ・セット名を要求するプロンプトがオペ
レーターに出されます。
DDSPROMPT=NO は、スタンドアロン・ダンプ・プログラムが DASD 装置に
ダンプするときダンプ・データ・セット名を要求するためのプロンプト指示を出
さないことを示します。DDSPROMPT=NO を指定すると、メッセージ
AMD001A に DASD 装置番号を返答した後、スタンドアロン・ダンプ・プログ
ラムは、データ・セット SYS1.SADMP が使用されることを想定します。
DDSPROMPT=NO はデフォルトです。
DDSPROMPT= キーワード値に関係なく、OUTPUT=(Dunit,ddsname) キーワード
を指定することによって、デフォルトの装置およびダンプ・データ・セット名を
必ず使用できることに注意してください。スタンドアロン・ダンプ・プログラム
は、オペレーターがコンソール通信を迂回するために EXTERNAL INTERRUPT
4-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
キーを使用した場合、またはオペレーターがメッセージ AMD001A にヌル応答
を与えた場合に、OUTPUT= キーワードに指定したデフォルト値を使用しま
す。
AMDSADMP マクロのコーディング例
下記の例は、さまざまな種類のスタンドアロン・ダンプ・プログラムを作成するた
めの AMDSADMP マクロをコード化する方法を示しています。
例: すべてのデフォルト値を受け入れる
この例では、直接アクセス常駐ダンプ・プログラムを生成するためのパラメー
ターを明示的に指定せずに AMDSADMP マクロをコード化する方法を示しま
す。
DUMP1 AMDSADMP
デフォルト値は、次のとおりです。
IPL=DSYSDA
VOLSER=SADUMP
ULABEL=NOPURGE
CONSOLE=(01F,3278)
SYSUT=SYSDA
OUTPUT=T282
MSG=ALL
MINASID=ALL
COMPACT=YES
REUSEDS=CHOICE
DDSPROMPT=NO
例: 不定様式、テープ常駐ダンプ・プログラムの生成
この例では、IPL パラメーターでテープを常駐ボリュームとして指定し、
VOLSER パラメーターがそのテープを識別します。その他のすべてのパラメー
ターでは、デフォルト値を使用します。
AMDSADMP IPL=T3400,VOLSER=SATAPE
デフォルト値は、次のとおりです。
ULABEL=NOPURGE
CONSOLE=(01F,3278)
SYSUT=SYSDA
OUTPUT=T282
MSG=ALL
MINASID=ALL
COMPACT=YES
REUSEDS=CHOICE
DDSPROMPT=NO
第 4 章 スタンドアロン・ダンプ
4-19
スタンドアロン・ダンプ
例: DASD に出力するダンプ・プログラムの生成
この例では、OUTPUT パラメーターがスタンドアロン・ダンプの出力を装置
450 上のダンプ・データ・セット SYS1.SADMP に向け、REUSEDS パラメー
ターは、ダンプ・データ・セットを再利用するかどうかをオペレーターにプロ
ンプト指示することを指定します。
AMDSADMP OUTPUT=D450,REUSEDS=CHOICE
デフォルト値は、次のとおりです。
IPL=DSYSDA
VOLSER=SADUMP
ULABEL=NOPURGE
CONSOLE=(01F,3278)
SYSUT=SYSDA
MSG=ALL
MINASID=ALL
COMPACT=YES
DDSPROMPT=NO
例: DASD に出力するダンプ・プログラムの生成
この例で、OUTPUT パラメーターはスタンドアロン・ダンプの出力を装置
450 上のダンプ・データ・セット SADMP.DDS1 に向けます。さらに、
DDSPROMPT=YES キーワードは、実行時ダンプ・データ・セット・プロンプ
ト指示のために指定できます。
AMDSADMP OUTPUT=(D450,SADMP.DDS1),DDSPROMPT=YES
デフォルト値は、次のとおりです。
IPL=DSYSDA
VOLSER=SADUMP
ULABEL=NOPURGE
CONSOLE=(01F,3278)
SYSUT=SYSDA
MSG=ALL
MINASID=ALL
COMPACT=YES
REUSEDS=CHOICE
構築処理中のお勧めの指定は以下のとおりです。
SP(ALL) IN ASID(1,’JESXCF’)
ALSO DATASPACES OF ASID(1,’JESXCF’, ’APPC’, ’SMSVSAM’, ’CONSOLE’, ’SYSBMAS’)
ALSO PAGETABLES OF DATASPACES
JES2 を実行する場合、以下を追加してください。
ALSO SP(ALL) IN ASID(’JES2’)
お客様にインストールされた IBM、ベンダー、およびローカルで作成した製品とア
プリケーションによっては、追加のサブプールとデータ・スペースが必要となる場
合があります。
4-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
追加記憶域を要求するために DUMP キーワードを使用する
スタンドアロン・ダンプに追加の記憶域をダンプさせる場合は、2 つの方法で要求
することができます。
v AMDSADMP マクロにダンプ・オプションを指定する
4-22 ページの『ダンプ調整オプション』で説明したダンプ調整オプションを、
AMDSADMP マクロの DUMP キーワード値として、括弧内に単一引用符で囲ん
で指定します。
例:
DUMP=(’SP(5,37,18) IN ASID(’JES3’)’)
DUMP=(’RANGE(0:1000000) IN ASID(1)’)
DUMP=(’DATASPACES OF ASID(’DUMPSRV’)’)
注: DUMP オプション内で引用符を二重にしないでください。DUMP オプション
の長さは 255 文字を超えることはできません。
v 実行時に追加のダンプ・オプションを指定する
AMDSADMP マクロに PROMPT キーワードをコーディングすると、追加記憶域
をダンプするためのスタンドアロン・ダンプ・プロンプト指示をオペレーターに
出すことができます。 PROMPT をコーディングし、仮想記憶域ダンプ・プログ
ラムが制御を得ると、スタンドアロン・ダンプは次のメッセージを出します。
AMD059D ENTER ’DUMP’ OR ’SET’ WITH OPTIONS, ’LIST’ OR ’END’.
オペレーターは下記のいずれかを応答することができます。
– ダンプ・オプションを指定した DUMP。この場合は、DUMP の後ろの ‘=’ は
任意指定です。使用できるダンプ・オプションについては、 4-22 ページの『ダ
ンプ調整オプション』を参照してください。
– MINASID オプションを指定した SET。
– LIST。コンソールに、スタンドアロン・ダンプがダンプする現行の仮想記憶域
を表示します。
– END。スタンドアロン・ダンプはオペレーターにオプションについてプロンプ
ト指示するのをやめ、処理を開始します。
4-22 ページの図 4-2 では、スタンドアロン・ダンプとオペレーター間の交換例を
示します。オペレーターの応答は小文字で示されています。オペレーターは
DUMP キーワードを使用して、メッセージ AMD059D に応答することに注意し
てください。
第 4 章 スタンドアロン・ダンプ
4-21
スタンドアロン・ダンプ
AMD082I WARNING: THE MINASID SPECIFICATION HAS BEEN SET TO ’PHYSIN’.
AMD059D ENTER ’DUMP’ OR ’SET’ WITH OPTIONS, ’LIST’ OR ’END’.
dump sp(0::9) inasid(’jes2’)
AMD060I ERROR IN INPUT TEXT INDICATED BY ’*’:
DUMP SP(0::9) INASID(’JES2’)
*
AMD065A ENTER TEXT TO BE SUBSTITUTED FOR THE TEXT IN ERROR.
>
AMD060I ERROR IN INPUT TEXT INDICATED BY ’*’:
DUMP SP(0:9) INASID(’JES2’)
******
AMD065A ENTER TEXT TO BE SUBSTITUTED FOR THE TEXT IN ERROR.
> in asid
AMD082I WARNING: THE MINASID SPECIFICATION HAS BEEN SET TO ’PHYSIN’.
AMD059D ENTER ’DUMP’ OR ’SET’ WITH OPTIONS, ’LIST’ OR ’END’.
> list
AMD067I CURRENT DUMP OPTIONS:
CSA ALSO LSQA, SP(203:205,213:215,229:230,236:237,247:249) IN ASID(PHYSIN)
ALSO SP(0:9) IN ASID(’JES2’)
AMD082I WARNING: THE MINASID SPECIFICATION HAS BEEN SET TO ’PHYSIN’.
AMD059D ENTER ’DUMP’ OR ’SET’ WITH OPTIONS, ’LIST’ OR ’END’.
> end
図 4-2. スタンドアロン・ダンプ・プログラムからのコンソール出力サンプル
スタンドアロン・ダンプはメッセージ AMD059D への応答でのエラーを検出する
と、正しくない部分をアスタリスクで下線を付けて誤っている行をコンソール上
に再表示し、オペレーターに置換するテキストを入力するようプロンプト指示し
ます。ダンプ・オプションが 255 文字をこえる場合は、スタンドアロン・ダンプ
は行全体にエラーのマークを付けます。
仮想記憶ダンプ・プログラムの実行中にシステム再始動が起きると、スタンドア
ロン・ダンプがオペレーターに再度ダンプ・オプションを入力するようプロンプ
ト指示します。スタンドアロン・ダンプは、オペレーターがシステム再始動の前
に指定したダンプ・オプションを使用しません。
ダンプ調整オプション: ダンプ調整オプションは下記のいずれか 1 つまたは両方
で指定することができます。
v AMDSADMP マクロの DUMP キーワード。
v 実行時にメッセージ AMD059D にオペレーターが応答する。
次にユーザーが指定するダンプ調整オプションのリストを示します。オプションの
詳しい説明は、 4-23 ページの『ダンプ調整オプションの説明』を参照してくださ
い。
{dump-spec-list|SET MINASID{ALL|PHYSIN}|LIST|END}
dump-spec-list は、下記の 1 つまたは複数です。
v range-spec-list IN ASID(address-space-list) [ALSO...]
v DATASPACES OF domain-spec-list[ ...]
v DSP OF domain-spec-list[ ...]
v PAGETABLES OF DATASPACES
range-spec-list は下記の 1 つまたは複数です。
– SP(subpool-list)
– RANGE(address-range-list)
– LSQA
4-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
– HIGH VIRTUAL
subpool-list は下記の 1 つです。
- subpool-number TO subpool-number [,...]
- ALL
address-range-list は下記の 1 つです。
- address TO address [,...]
- ALL
address-space-list は下記の 1 つです。
– asid TO {asid|jobname|SYSKEY|PHYSIN}[,...]
– ALL
ダンプ調整オプションに値を指定する場合の指針は、下記に従ってください。
v ハイ・バーチャル は、それ自体では使用できません。追加キーワードを指定して
ください。
v address は 0 から X'7FFFFFFF' の 16 進数。
v subpool-number は 0 から 255 の 10 進数。
v asid は 0 から X'FFFF' の 16 進数。
v jobname は単一引用符で囲んだ有効なジョブ名。ジョブ名には、ワイルドカード
文字を組み込むことができます。ワイルドカード文字の説明は、トピック『ダン
プ調整オプションの説明』の ASID(’jjjj’) オプションを参照してください。
v range-spec-list は、サブプールのリスト、ストレージ範囲のリスト、あるいはその
両方です。
v domain-spec-list はアドレス・スペースのリストです。
v ‘TO’ と ‘:’ は同義語です。
v ‘DATASPACES’ と ‘DSP’ は同義語です。
DATASPACES などのキーワードは、省略形があいまいにならない場合は、右側を
切り捨てることができます。文字は大文字または小文字のいずれで入力してもかま
いません。数字、キーワード、および区切り記号の間にブランクを挿入してもかま
いません。数字内またはキーワード内にブランクを挿入することはできません。
ダンプ調整オプションの説明: このセクションでは、ダンプ調整オプションのそれ
ぞれについての説明をします。
RANGE(xxxxxxxx:yyyyyyyy,xxxxxxxx:yyyyyyyy...)
ダンプしたいストレージの 1 つまたは複数の範囲を指定します。 xxx と yyy
は 0 から X'7FFFFFFF' の 16 進アドレスです。
RANGE(ALL)
0 から X'7FFFFFFF' のすべてのストレージのダンプを指定します。
SP(ddd)
スタンドアロン・ダンプはサブプール ddd をダンプします。ddd は 0 から 255
の 10 進整数です。
SP(ddd :eee)
スタンドアロン・ダンプは、ddd から eee までのすべてのサブプールをダンプ
します。
第 4 章 スタンドアロン・ダンプ
4-23
スタンドアロン・ダンプ
SP(ddd :eee,ddd :eee,...)
スタンドアロン・ダンプは指定したサブプールの組み合わせをダンプします。
SP(ALL)
スタンドアロン・ダンプは 0 から 255 までのすべてのサブプールをダンプしま
す。
LSQA
スタンドアロン・ダンプは LSQA をダンプします。
HIGH VIRTUAL
スタンドアロン・ダンプは、2G を超えるすべての割り振り済みストレージをダ
ンプします。
ASID(xxxx :yyyy)
スタンドアロン・ダンプは、ASID が xxx で始まり yyy で終わるアドレス・ス
ペースの範囲のストレージをダンプします。 xxx と yyy は X'1' から X'FFFF'
の 16 進数です。
ASID(‘jjj’)
スタンドアロン・ダンプは、ジョブ名 jjj が識別するアドレス・スペースのスト
レージをダンプします。ジョブ名は単一引用符で囲む必要があります。
ワイルドカード文字: 複数のジョブ名を識別するためにワイルドカード文字を使
用することができます。有効なワイルドカード文字は、次のとおりです。
*
0 文字以上、最大ストリング長までを表します。アスタリスクは、スト
リングの始まりや終わりまたは中間に置くことができ、ストリングの複
数箇所に置くことができます。単一アスタリスクは、すべてのジョブ名
が一致することを示します。
?
1 文字を表します。1 つまたは複数の疑問符はストリングの始まりや終
わりまたは中間に置くことができ、ストリングの複数箇所に置くことが
できます。単一疑問符は、1 文字で構成されるすべてのジョブ名を示し
ます。
ASID(SYSKEY)
活動状態の TCB に関連している 0 から 7 の記憶キーがある場合に、スタンド
アロン・ダンプはすべてのアドレス・スペース用のストレージをダンプします。
ASID(combination)
上記の指定を任意に組み合わせることができます。有効な組み合わせの例は
ASID(2,‘IMSJOB’,SYSKEY) です。
ASID(PHYSIN)
スタンドアロン・ダンプは物理的にスワップインされたアドレス・スペースをダ
ンプします。
ASID(ALL)
スタンドアロン・ダンプはすべてのアドレス・スペースの記憶域をダンプしま
す。別の ASID 仕様と組み合わせて ASID(ALL) を指定できないことに注意し
てください。
DATASPACES OF ASID(qualifier)
DATASPACES OF ASID(qualifier) キーワードを指定すると、スタンドアロン・ダ
4-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
ンプは指定したアドレス・スペースが所有するすべてのデータ・スペースをダン
プします。すべての要求されたデータ・スペースについて、スタンドアロン・ダ
ンプは次の処置をとります。
v 中央記憶装置のダンプ中に中央記憶装置が戻すページをダンプします。
v 最初の参照ページではなく中央記憶装置に戻されないすべてのページを中央
記憶装置にコピーし、ダンプします。
PAGETABLES OF DATASPACES
PAGETABLES OF DATASPACES キーワードを指定すると、スタンドアロン・ダンプ
はすべてのデータ・スペースについてのページ・テーブルを含んでいる、ページ
アウトされた仮想記憶域をダンプします。
指定したストレージをスタンドアロン・ダンプがダンプすると、スタンドアロン・
ダンプはダンプ・オプションの各指定で指定されたすべてのアドレス・スペース内
のすべてのリストされたサブプールとアドレス範囲をダンプします。ただし、スタ
ンドアロン・ダンプはユーザーが指定したダンプ・オプションとユーザーの指定を
マージすることはしません。たとえば、スタンドアロン・ダンプでアドレス・スペ
ース A のサブプール 0 と 1、アドレス・スペース B のサブプール 0 と 1 をダ
ンプする場合は、次のように入力します。
DUMP SP(0,1) IN ASID(A,B)
スタンドアロン・ダンプでアドレス・スペース A 内のサブプール 0 とアドレス・
スペース B 内のサブプール 1 をダンプする場合は、次のように入力します。
DUMP SP(0) IN ASID(A) ALSO SP(1) IN ASID(B)
次に有効な指定の例を示します。
DUMP SP(0:7,15),RANGE(0:10000000) IN ASID(SYSKEY),ASID(8)
DU (SP(0 TO 7 OR 15),SP(255)) IN AS(‘TCAM’)
DUMP RANGE(ALL) IN ASID(1) ALSO SP(0) IN ASID(SYSKEY,8)
DU DAT OF AS(ALL)
DUMP ( SP(0:127) IN ASID(‘GENER’) ALSO SP(0) IN ASID(‘IMS’) )
DUMP LSQA IN AS(’MYJOB’,14)
DU SP(128),LS IN ASID(C,PHYSIN)
DUMP DATASPACES OF ASID(’MYJOB??’)
DUMP DATASPACES OF ASID(’MY*’)
DUMP HIGH VIRTUAL IN ASID(C)
最小限のスタンドアロン・ダンプの指定: スタンドアロン・ダンプは、特定のアド
レス・スペースに関連するデータ・スペースだけでなく、すべてのアドレス・スペ
ースの特定のシステム関連ストレージを含む最小限のダンプを生成するように設計
されています。
AMDSADMP マクロに PROMPT をコーディングし、メッセージ AMD059D に応
答することによって、または AMDSADMP マクロに DUMP キーワードをコーディ
ングすることによって、追加のストレージをダンプできます。(このトピックについ
ては、 4-21 ページの『追加記憶域を要求するために DUMP キーワードを使用す
る』を参照してください。)
最小限のダンプは、AMDSADMP マクロに MINASID キーワードを指定して要求し
ます。MINASID=ALL を指定すると、以下のダンプを取ります。
v CSA と LSQA のすべて
第 4 章 スタンドアロン・ダンプ
4-25
スタンドアロン・ダンプ
v すべてのアドレス・スペースのサブプール 203-205、213-215、229-230、236-237
および 247-249
v 全 GTF アドレス・スペース
v GRS アドレス・スペースのサブプール 127
v GRS アドレス・スペースの ISG で始まる名前をもつデータ・スペース
v DUMPSRV データ・スペースのすべて
v
全 XCF アドレス・スペース
v XCF データ・スペースのすべて
v XES 接続をもつアドレス・スペースの XES 関連データ・スペース
MINASID=PHYSIN は、同じエリアのダンプを生成しますが、ダンプされるアドレ
ス・スペースを、システムがダンプを書き出すときに物理的にスワップインされて
いるアドレス・スペースに限定します。AMDSADMP マクロに MINASID を指定し
ない場合は、デフォルト値の MINASID=ALL が想定されます。AMDSADMP マク
ロに PROMPT を指定した場合、メッセージ AMD059D に SET MINASID
(PHYSIN|ALL) で応答することもできます。
例: スタンドアロン・ダンプ時に指定する最小限ダンプ・オプション
スタンドアロン・ダンプ生成時に、物理的にスワップインされているアドレ
ス・スペースだけを含めるように最小限ダンプ・オプションを制限するには、
次のマクロを使用します。
AMDSADMP IPL=SYSDA,VOLSER=VSSA02,MINASID=PHYSIN
例: 指定する最小限ダンプ・オプション
スタンドアロン・ダンプの実行中に最小限ダンプ・オプションに物理的にスワ
ップインされているアドレス・スペースだけを含めるよう要求するには、次の
SET コマンドを使用してメッセージ AMD059D に応答してください。
SET MINASID(PHYSIN)
DASD データ・セットへのダンプ
OUTPUT パラメーターに DASD を指定すると、スタンドアロン・ダンプ・プログ
ラムの出力を次のタイプの DASD の 1 つにある事前定義されたダンプ・データ・
セットに向けることができます。
v 3380
v 3390
v 9345
注: 生成時と実行時の両方で出力装置 (DASD またはテープ) の選択を行うことがで
きます。実行時に指定した出力装置は、生成時に指定した出力装置を指定変更
します。
4-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
DASD にスタンドアロン・ダンプをとる場合は、AMDSADDD REXX または IPCS
SADMP ダンプ・データ・セット・ユーティリティーを使用してダンプ・データ・
セットを割り振り初期設定しなければなりません。
DASD ダンプ・データ・セットの割り振りについては、次の要件があります。
v ダンプ・データ・セットにはデータ・セット修飾子の一部または全体として、テ
キスト ‘SADMP’ がなければいけません。
v スタンドアロン・ダンプ・プログラムがダンプする可能性があるページ・デー
タ・セットも含まれているボリュームに、スタンドアロン・ダンプを含めようと
しているデータ・セットを入れないでください。スタンドアロン・ダンプは、仮
想ダンプ処理を行うためにページ・ボリュームを初期設定するとき、出力ダン
プ・データ・セットもこのボリューム上に存在するかどうかをチェックします。
存在する場合、スタンドアロン・ダンプ・プログラムは、メッセージ AMD100I
を出して、このボリューム上のページ・データ・セットからデータを取り出しま
せん。つまり、ダンプに、要求したデータすべてが含まれていない場合がありま
す。このようなデータの欠如があると、それ以降の診断に支障が出ることがあり
ます。
v ダンプ・データ・セットは、スタンドアロン・ダンプの IPL テキストが入ってい
る同じボリュームに定義できません。
注: データ・セットをカタログする必要はないので、システムで同じ名前を持つ
複数のダンプ・データ・セットを持つことができます。さらに、データ・セ
ットには固有の名前を付けることができるため、ボリュームごとに複数のダ
ンプ・データ・セットを持つことができます。
v 他のデータ・セットを含まないボリューム (特にシスプレックス結合データ・セ
ットを含むボリューム) にダンプ・データ・セットを定義することをお勧めしま
す。これによって、必要な場合に最大の容量を確保でき、別のシステムが他のデ
ータ・セットをアクセスする可能性をなくすことができます。
v ダンプ・データ・セットは AMDSADDD REXX または IPCS SADMP ダンプ・
データ・セット・ユーティリティーを使用して、割り振りと初期設定をする必要
があります。
v スタンドアロン・ダンプ・プログラムは使用している出力装置上のダンプ・デー
タ・セットを見付けることができなければならないため、スタンドアロン・ダン
プ用のダンプ・データ・セットがマイグレーション済みの状態に置かれたり、異
なるボリュームにマイグレーションされることのないように、必要なデータ・セ
ット管理ステップを取ることが必須になります。また、ダンプ・データ・セット
は、未使用のスペースを解放する可能性のあるスペース管理処理を避ける必要が
あります。
ダンプ・データ・セットがいっぱいになると、スタンドアロン・ダンプ・プログラ
ムはメッセージ AMD001A を使用して、別の出力装置を指定するようにオペレータ
ーにプロンプト指示をします。スタンドアロン・ダンプ・プログラムは、スタンド
アロン・ダンプがサポートする任意の装置にダンプを継続することができますが、
磁気テープ装置を選択した場合には、複数テープ・ボリュームを必要とする場合で
あっても、そのダンプが完了するまで磁気テープ装置を使用する必要があります。
第 4 章 スタンドアロン・ダンプ
4-27
スタンドアロン・ダンプ
注: 複数の DASD ダンプ・データ・セットにダンプするには、使用する各ダンプ・
データ・セットを、AMDSADDD REXX ユーティリティーまたは IPCS
SADMP ダンプ・データ・セット・ユーティリティーによって事前にフォーマ
ット設定しておくことが必要です。
AMDSADDD ユーティリティーの使用
REXX ユーティリティー AMDSADDD は、SYS1.SBLSCLI0 にあります。 このセ
クションでは、AMDSADDD REXX ユーティリティーを使用して下記のことを行う
方法を説明します。
v データ・セットの割り振りと初期設定。ダンプ・データ・セットの割り振りと初
期設定の例については、 4-32 ページの図 4-3 を参照してください。
v データ・セットのクリア (再初期設定)。ダンプ・データ・セットのクリアの例に
ついては、 4-33 ページの図 4-4 を参照してください。
v データ・セットの再割り振りと初期設定。ダンプ・データ・セットの再割り振り
と初期設定の例については、 4-33 ページの図 4-5 を参照してください。
IPCS SADMP ダンプ・データ・セット・ユーティリティーは、AMDSADDD REXX
ユーティリティーと同じ機能を実行します。詳細は、「z/OS MVS IPCS ユーザー
ズ・ガイド」内の IPCS ダイアログの SADMP オプションを参照してください。
AMDSADDD REXX ユーティリティーが割り振るデータ・セットは次の特性を持つ
必要があります。
v データ・セット名 (DSNAME) は、次のようになっていなければなりません。
– 長さが 44 文字以下であること
– データ・セット修飾子の一部または全体として、テキスト ’SADMP’ を含んで
いること
たとえば、有効なダンプ・データ・セット名は次のとおりです。
– SYS1.SADMP
– SADMP
– SYSTEMA.SADMPDDS
無効なダンプ・データ・セット名は、次のようなものです。
– SYS1.DUMP.DATASET
– SADUMP
v ブロック・サイズ (BLKSIZE) は、次のようになっている必要があります。
DASD
BLKSIZE
3380 または 9345
20800
3390
24960
注: スタンドアロン・ダンプ処理では、ブロック・サイズ 20800 で定義された
3390 DASD を使用することができます。ただし、24960 のブロック・サイズ
を使用しないと、割り振りスペースすべてを有効に使うことはできません。
AMDSADDD REXX ユーティリティーは 3390 DASD 装置を 24960 のブロ
ック・サイズを使用して割り振ります。
v 論理レコード長 (LRECL) は必ず 4160 です。
4-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
v レコード・フォーマット (RECFM) は必ず FBS です。
v データ・セットは単一エクステントで構成する必要があります。
v データ・セット編成は、PS (DSORG=PS) または非 VSAM 拡張フォーマット
(DSORG=PS-E) にできます。
v 1 ∼ 32 ボリュームのスペースを占めます。
すべての SMS 管理対象のスタンドアロン・ダンプ・データ・セットには、
GUARANTEED_SPACE 属性を持つ STORCLAS でなければなりません。
すべての DSORG=PS-E データ・セットは、次のようになっている必要がありま
す。
v SMS 管理対象である。
v 圧縮を指定しない DATACLAS を持つ。
v 連続データ転送速度にゼロを指定した STORCLAS を持つ (ストライピングの抑
制)。
SMS が割り振り要求を引き受けるには、ご使用のシステムの自動クラス選択 (ACS)
ルーチンを、それを行うように構成する必要があります。
SMS 環境の設定については、以下の資料を参照してください。
v z/OS DFSMS データ・セットの使用法
v z/OS DFSMS Storage Administration Reference
AMDSADDD REXX ユーティリティーの呼び出しの際に、ボリューム、ダンプ・デ
ータ・セット名、装置、スペース、およびカタログ後処置を指定します。マルチボ
リューム指定の場合、マルチボリューム・データ・セットが割り振られ、フォーマ
ット設定されます。すべてが同じ装置タイプを 16 ボリュームまで指定することが
できます。データ・セットに対して指定したスペース容量は各ボリューム上に割り
振られます。
特別な制御情報がマルチボリューム・データ・セットに出力されて、それによりそ
のデータ・セットが出力される時に全ボリュームを見付けることができるようにな
ります。この制御情報にはボリュームの装置番号が含まれています。この制御情報
がないか、間違っている場合、スタンドアロン・ダンプはデータ・セットを使用で
きません。マルチボリューム・データ・セットのボリュームを新しい装置番号に移
動する場合、そのデータ・セットを再初期設定して、制御情報を更新する必要があ
ります。制御情報を出力したシステムとは別の装置番号に接続されたボリュームを
持つシステムは、データ・セットを使用できません。
マルチボリューム・データ・セット使用時は、それらのデータ・セットをカタログ
に登録しておくことを強くお勧めします。これにより処理が単純化します。理由
は、カタログ式データ・セット内のダンプ・データをフォーマットおよびコピーす
るのに、容易に IPCS を使用できるからです。
注: REXX は指定したパラメーターがリストされた順序であることが必要です。パ
ラメーターを指定しないと、AMDSADDD REXX ユーティリティーがそのパラ
メーターの指定についてプロンプト指示します。
第 4 章 スタンドアロン・ダンプ
4-29
スタンドアロン・ダンプ
AMDSADDD
{DEFINE|CLEAR|REALLOC} volser{(data set name)}
(type[,[STORCLAS][,[DATACLAS][,[MGMTCLAS]]]]) [space] [YES|NO] [LARGE|BASIC]
または
AMDSADDD
{DEFINE|CLEAR|REALLOC} (volumelist){(data set name)}
(type[,[STORCLAS][,[DATACLAS][,[MGMTCLAS]]]]) [space] [YES|NO] [LARGE|BASIC]
AMDSADDD
REXX ユーティリティーの名前。
DEFINE|CLEAR|REALLOC
AMDSADDD REXX ユーティリティーが実行する機能を示します。
DEFINE
新しいダンプ・データ・セットを割り振り初期設定します。
CLEAR
既存のダンプ・データ・セットを再初期設定します。いったん
クリアすると、データ・セットを使用できるようになります。
REALLOC
既存の SYS1.SADMP ダンプ・データ・セットを削除し、それ
から同じボリューム上に新規の SYS1.SADMP ダンプ・デー
タ・セットを再割り振りし、再初期設定します。たとえば、
REALLOC を使用してダンプ・データ・セットのサイズを増や
すことができます。既存のダンプ・データ・セットが存在しな
い場合、AMDSADDD はこの機能を DEFINE 要求に変換し
て、DEFINE 処理を使用して継続します。たとえば、REALLOC
を使用してダンプ・データ・セットのサイズを増やすことがで
きます。新しい SYS1.SADMP ダンプ・データ・セットを再割
り振りし、再初期設定することが十分にできない場合 (たとえ
ば、使用できるシリンダー数以上を使用して SYS1.SADMP を
割り振ろうとする場合)、AMDSADDD は既存の SYS1.SADMP
ダンプ・データ・セットを削除しようとします。
volser{(data set name)}
ダンプ・データ・セットを割り振るボリュームの VOL=SER= 名を示します。
スタンドアロン・ダンプ常駐ボリュームまたはシステム・ページング・データ・
セットを含むボリュームを使用しないでください。
またオプションとして、ボリュームに割り振られるダンプ・データ・セット名を
定義します。データ・セット名を指定する場合、次のようにする必要がありま
す。
v 完全修飾 (引用符なしで) にすること
v 長さは 44 文字以下にすること
v データ・セット修飾子の一部または全体として、テキスト ’SADMP’ を含ん
でいること
注: データ・セット名を指定しないと、AMDSADDD ユーティリティーは指定
されたボリュームにデータ・セット SYS1.SADMP を割り振ります。
(vollist){(data set name)}
vollist は、データ・セット用に使用するコンマで区切られた volser リストで
す。マルチボリューム・データ・セットはこのボリュームのリストを使用して割
4-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
り振られます。最初のボリュームの装置番号がスタンドアロン・ダンプにデー
タ・セットを指定するのに使用されます。
ヒント: マルチボリューム・データ・セットにスタンドアロン・ダンプを取る
と、ダンプはストライピングされ、取り込みの時間が大幅に短縮されます。
(type[,[STORCLAS][,[DATACLAS][,[MGMTCLAS]]]])
type は、ダンプ・データ・セットを割り振る装置タイプを示します。有効な
DASD タイプは 3380、3390、および 9345 です。
STORCLAS
SMS ストレージ・クラス。
DATACLAS
SMS データ・クラス。
MGMTCLAS
SMS 管理クラス。
これらのクラスの追加情報については、「z/OS MVS JCL 解説書」を参照してく
ださい。
space
ダンプ・データ・セット用に割り振るシリンダー数を示します。マルチボリュー
ム・データ・セットの場合は、各ボリュームにこの数量が割り振られます。
ダンプする出力のサイズは、ユーザーのストレージ構成と、スタンドアロン・ダ
ンプのオプションを使用してそのストレージのうちのいくつをダンプするかによ
ります。ダンプ・データ・セットにどれほどのスペースをシリンダー数で割り振
るかを見積もる場合は、テープへの典型的なダンプを IPCS 処理のために
DASD にコピーしたときに消費する DASD のシリンダー数を使用します。十分
なスペースを割り振っていないと、スタンドアロン・ダンプ・プログラムはメッ
セージ AMD001A およびメッセージ AMD002A (AMDSADMP マクロに
DDSPROMPT=YES を指定した場合) を使用して、オペレーターにダンプを継続
するために別の装置または別のダンプ・データ・セット (あるいはその両方) を
指定するようプロンプト指示します。
space オプションは、CLEAR パラメーターでは不要です。ただし、space オプ
ションは、DEFINE と REALLOC パラメーターでは必須です。
YES|NO
システムがダンプ・データ・セットをカタログするかどうかを指定します。デー
タ・セットをカタログしたい場合は、YES または Y を指定します。データ・
セットをカタログしたくない場合は、NO、または N を指定します。N を指定
すると、同じ名前をもつ複数のダンプ・データ・セットを割り振ることができま
す。
カタログ・オプションは CLEAR パラメーターでは不要です。ただし、カタロ
グ・オプションは DEFINE と REALLOC パラメーターでは必須です。
LARGE|BASIC
定義するダンプ・データ・セットの DSNTYPE を示します。LARGE は、属性
が DSNTYPE=LARGE で、システムがボリューム当たり 64K トラックを超え
るスパンができる、ラージ・フォーマットのダンプ・データ・セットを要求しま
す。 BASIC は、ラージ・フォーマットのダンプ・データ・セットは必要がない
第 4 章 スタンドアロン・ダンプ
4-31
スタンドアロン・ダンプ
ことを示します。 BASIC は、ほかのオプションに応じて、従来型のダンプ・デ
ータ・セットに関連付けることも、拡張順次ダンプ・データ・セットに関連付け
ることもできます。
dsntype オプションは CLEAR パラメーターでは不要です。 dsntype は、
DEFINE パラメーターおよび REALLOC パラメーターではオプションです。指
定されなかった場合は、BASIC がデフォルトです。 REALLOC で指定する
dsntype オプションは、既存の dsntype オプションに一致する必要があります。
図 4-3 では、AMDSADDD REXX ユーティリティーを使用して、サイズが 350 シ
リンダーで SAMPLE の VOL=SER= を持つダンプ・データ・セットを割り振り初
期設定する例を示します。データ・セット名を指定しない場合、AMDSADDD ユー
ティリティーはボリューム SAMPLE にダンプ・データ・セット SYS1.SADMP を
割り振ります。
注: スタンドアロン・ダンプは AMDSADDD の処理中にはエラー・メッセージを発
行しません。ただし、スタンドアロン・ダンプは TSO/E ALLOC コマンドなど
の別のソースからオペレーターにメッセージを渡します。
------------------------- TSO COMMAND PROCESSOR ------------------ENTER TSO COMMAND, CLIST, OR REXX EXEC BELOW:
===> exec ’sys1.sblscli0(amdsaddd)’
What function do you want?
Please enter DEFINE if you want to allocate a new dump dataset
Please enter CLEAR if you want to clear an existing dump dataset
Please enter REALLOC if you want to reallocate and clear an existing
dump dataset
Please enter QUIT if you want to leave this procedure
define
Please enter VOLSER or VOLSER(dump_dataset_name)
sample
Please enter the device type for the dump dataset
Device type choices are 3380 or 3390 or 9345
3380
(An SMS STORAGE CLASS, DATA CLASS, AND MANAGEMENT CLASS
MAY ALSO BE SPECIFIED WITH THE DEVICE TYPE)
(3380,STRCLAS,DATCLAS,MGTCLAS)
Please enter the number of cylinders
350
Do you want the dump dataset to be cataloged?
Please respond Y or N
y
Specify the DSNTYPE. Reply BASIC or LARGE
BASIC
IKJ56650I TIME-11:00:00 PM. CPU-00:00:00 SERVICE-20191 SESSION-00:09:55 JUNE
14,1994
Initializing output dump dataset with a null record:
Dump dataset has been successfully initialized
Results of the DEFINE request:
Dump Dataset Name
Volume
Device Type
Allocated Amount
:
:
:
:
SYS1.SADMP
SAMPLE
3380
350
図 4-3. AMDSADDD を使用してダンプ・データ・セットを割り振り初期設定する
4-33 ページの図 4-4 では AMDSADDD REXX ユーティリティーを使用して、
VOL=SER=SAMPLE 上の既存のダンプ・データ・セット SADMP.DDS1 をクリア
(再初期設定) する例を示します。この例では、パラメーターがユーティリティーの
呼び出しの一部になっています。そのため、AMDSADDD は値の入力を求めるプロ
4-32
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
ンプトを出しません。
------------------------- TSO COMMAND PROCESSOR --------------------ENTER TSO COMMAND, CLIST, OR REXX EXEC BELOW:
===> exec exec ’sys1.sblscli0(amdsaddd)’ ’clear sample(sadmp.dds1) 3380’
IKJ56650I TIME-11:00:00 PM. CPU-00:00:00 SERVICE-20191 SESSION-00:09:55 JUNE
14,1994
Initializing output dump dataset with a null record:
Dump dataset has been successfully initialized
Results of the CLEAR request:
Dump Dataset Name
Volume
Device Type
Allocated Amount
:
:
:
:
SADMP.DDS1
SAMPLE
3380
350
***
図 4-4. AMDSADDD を使用して既存のダンプ・データ・セットをクリアする
図 4-5 は、AMDSADDD REXX ユーティリティーを使用して、VOL=SER=SMS001
上に SYSTEM1.SADMPDDS という新しいダンプ・データ・セットを割り振る例を
示しています。この例では、パラメーターがユーティリティーの呼び出しの一部に
なっています。そのため、AMDSADDD は値の入力を求めるプロンプトを出しませ
ん。
注: SMS 環境では、指定されたボリュームとは異なるボリューム上にダンプ・デー
タ・セットをカタログすることができます。ダンプ・データ・セットが異なる
ボリューム上に割り振られている場合、AMDSADDD はエラー・メッセージを
発行して終了します。図 4-5 では、ダンプ・データ・セットが指定のボリュー
ム上に割り振られなかったため、AMDSADDD はダンプ・データ・セットを削
除し、エラー・メッセージを発行して終了しています。
-----------------------TSO COMMAND PROCESSOR-----------------------===>exec exec ’sys1.sblscli0(amdsaddd)’ ‘Define SMS001(SYSTEM1.SADMPDDS) 3390 100 Y LARGE’
IKJ56650I TIME-11:00:00 PM. CPU-00:00:00 SERVICE-20191 SESSION-00:09:55
JUNE 14,1994
Error: output dump dataset not allocated on specified volume
Try using a Storage Class with Guaranteed Space
SMS001
***
---------------------------------------------------------------------
図 4-5. AMDSADDD を使用してダンプ・データ・セットを再割り振りする
以下の JCL を使用して サイズが 2653 シリンダーで VOL=SER=USRD53 にダン
プ・データ・セット SADMP.DDS2 を割り振り、再初期設定します。
注: バッチ・モードで AMDSADDD REXX ユーティリティーを呼び出す場合は、
値を入力するようにユーザーにプロンプト指示されることがないので、リスト
された順番にすべてのパラメーターを指定する必要があります。
第 4 章 スタンドアロン・ダンプ
4-33
スタンドアロン・ダンプ
例: バッチ・モードで AMDSADDD を実行する
//SAMPLE JOB ’S3031,B7100003,S=C’,’BATCH EXAMPLE’,RD=R,
//
MSGLEVEL=(1,1),CLASS=E,NOTIFY=SAMPLE,MSGCLASS=H
//STEP1
EXEC PGM=IKJEFT01,REGION=64M
//SYSTSPRT
DD SYSOUT=*
//SYSTSIN
DD *
EXEC ’SYS1.SBLSCLI0.EXEC’ ’DEFINE USRD53(SADMP.DDS2) 3380 2653 N’
/*
注: 上の例では、dsntype パラメーターが指定されていないので、基本型のデータ・
セットが割り振られます。
スタンドアロン・ダンプ・プログラムの生成
AMDSADMP マクロをコーディングして、スタンドアロン・ダンプ・プログラムを
生成できます。スタンドアロン・ダンプ・プログラムを生成する方法は 2 通りで
す。
v 1 ステップ生成
v 2 段階生成
複数のタスクを 1 つのステップで実行することができるので、スタンドアロン・ダ
ンプ・プログラムを生成するために 1 ステップ生成を使用することをお勧めしま
す。2 段階生成は次の目的の場合に役立ちます。
v 同時に複数のスタンドアロン・ダンプ・プログラムを生成する。
v MVS の新しいバージョンにマイグレーションする時に、スタンドアロン・ダン
プ・プログラムの新しいバージョンを生成する。
v 以下を行うために、異なるシステム・データベースを使用してオーバーライドす
る必要がある場合、最も単純な方法にする。
– JCL 生成のためにマクロをアセンブルする
– JCL を実行する
1 ステップ生成
1 ステップ生成では、SYSIN 制御ステートメントの入力データとしてコーディング
した AMDSADMP マクロを使用して、AMDSAOSG プログラムを単一ジョブ・ス
テップとして実行してください。
4-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
例: DDNAMES を指定変更した 1 ステップ生成
スタンドアロン・ダンプ・ユーティリティー・プログラムの AMDSAOSG
は、動的にデータ・セットを割り振り、該当するプログラムを呼び出して、1
ジョブ・ステップでスタンドアロン・ダンプ常駐ボリュームを初期設定しま
す。1 ステップ生成プログラムを実行するとは、DDNAME GENPARMS の制
御ステートメントとして 1 つの AMDSADMP マクロを使用することを示しま
す。
//SADMPGEN JOB MSGLEVEL=(1,1)
//OSG
EXEC PGM=AMDSAOSG
//SYSLIB
DD
DSN=SYS1.MACLIB,DISP=SHR
//
DD DSN=SYS1.MODGEN,DISP=SHR
//GENPRINT DD DSN=SADMP.LIST,DISP=OLD
//GENPARMS DD *
AMDSADMP IPL=DSYSDA,VOLSER=SPOOL2,
CONSOLE=(1A0,3277)
END
/*
X
表 4-1 (関連した注を後ろに示します) では DDNAMES AMDSAOSG の使用法と、
DDNAMES のデフォルト値を示します。
表 4-1. AMDSAOSG が使用する DDNAMES とデフォルト値
DD 名
デフォルト値
使用法
DPLTEXT
DSN=SYS1.NUCLEUS(AMDSADPL),DISP=SHR
AMDSABLD の入力。
DVITEXT
DSN=SYS1.NUCLEUS(AMDSADVI),DISP=SHR
AMDSABLD の入力。
GENPARMS
事前割り振りが必要。
AMDSAOSG の入力で、アセン
ブラーに渡される。
GENPRINT
SYSOUT=A
AMDSAOSG からの出力リス
ト。
IPITEXT
DSN=SYS1.NUCLEUS(AMDSAIPI),DISP=SHR
AMDSABLD の入力。
IPLDEV
DSN=SYS1.PAGEDUMP.Vvolser,UNIT=iplunit,
VOL=(PRIVATE,SER=iplser),
スタンドアロン・ダンプ・プロ
グラム、AMDSABLD からの出
力。ICKDSF は VOL キーワー
ドを使用して、常駐ボリューム
を説明する。
DISP=OLD,DCB=(BLKSIZE=12288,RECFM=U, DSORG=PS),
LABEL=(,NL)
テープ IPL ボリューム。
DISP=(NEW,KEEP),DCB=(LRECL=4096,BLKSIZE=4096,
RECFM=F,DSORG=PS),SPACE=(4096,(1095),,CONTIG),
LABEL=EXPDT=99366
DASD IPL ボリューム。
DASD 用の DSN=SYS1.NUCLEUS(AMDSAIPD),DISP=SHR
AMDSABLD の入力。
IPLTEXT
テープ用の DSN=SYS1.NUCLEUS(AMDSAIPT),DISP=SHR。
PGETEXT
DSN=SYS1.NUCLEUS(AMDSAPGE),DISP=SHR
AMDSABLD の入力。
SYSPRINT
事前割り振りは禁止。
呼び出されたプログラムからの
一時リスト。
第 4 章 スタンドアロン・ダンプ
4-35
スタンドアロン・ダンプ
表 4-1. AMDSAOSG が使用する DDNAMES とデフォルト値 (続き)
DD 名
デフォルト値
使用法
SYSPUNCH
DSN=&OBJ,UNIT=SYSDA,SPACE=(80,(250,50))
アセンブラーから AMDSABLD
に渡されるオブジェクト・モジ
ュール。
SYSTERM
なし
アセンブリー・メッセージ。
SYSUT1
UNIT=SYSDA,SPACE=(1700,(400,50))
アセンブラーの作業ファイル。
TRK0TEXT
DSN=&TRK0TEXT,UNIT=iplunit, VOL=SER=iplser,SPACE=(4096,
(2,1))
AMDSABLD から ICKDSF への
シリンダー 0、トラック 0 の
IPL テキスト。
注:
1. ジョブ・ステップに GENPARMS DDNAME を必ず指定してください。
2. ジョブ・ステップの SYSPRINT と SYSIN DD ステートメントに指定すること
はできません。
3. GENPARMS では、UNIT= と VOLSER= の値を AMDSADMP マクロ・ステー
トメントに指定することができます。
例: DASD へのスタンドアロン・ダンプの 1 ステップ生成
この JCL は SADMPM のボリューム通し番号を使用して DASD 222 からスタンドアロン・ダンプ
を生成します。出力は DASD 450 上のデータ・セット SYS1.SADMP に向けられます。スタンドア
ロン・ダンプはその装置が使用可能かどうかを実行時に判別します。装置 450 のダンプ・データ・セ
ットが使用できない場合は、オペレーターは別のデータ・セットを指定するようプロンプト指示され
ます。オペレーターはアドレス 041、042、0A0、3E0、または 3E1 のいずれかのコンソールで実行キ
ーを押すことができます。ダンプには、ダンプ時に物理的にスワップインされていた、これらのアド
レス・スペースのデフォルトのストレージ範囲を含みます。さらに、ASID 1 と JES2 アドレス・ス
ペース内のすべてのアドレス・スペースがダンプされます。スタンドアロン・ダンプは DUMPSRV
アドレス・スペースが作成したデータ・スペースもダンプします。
//SADMPGEN JOB MSGLEVEL=(1,1)
//OSG
EXEC PGM=AMDSAOSG
//SYSLIB DD
SYS1.MACLIB,DISP=SHR
//
DD
SYS1.MODGEN,DISP=SHR
//GENPARMS DD
*
SADXMP3 AMDSADMP CONSOLE=((041,3277),(042,3277),(0A0,3277),
(3E0,3277),(3E1,3277)),
DUMP=’SP(ALL) IN ASID(1,’JES2’) ALSO DATASPACES
OF ASID(’DUMPSRV’)’,
IPL=D222,
MINASID=PHYSIN,
OUTPUT=D450,
REUSEDS=NEVER,
PROMPT,
VOLSER=SADMPM
END
/*
4-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
X
X
X
X
X
X
X
X
X
スタンドアロン・ダンプ
AMDSAOSG からの出力には、生成時に指定した情報を含む、スタンドアロン・ダ
ンプ共通通信テーブル (CCT) と装置およびダンプ・オプション (DDO) 制御ブロッ
クのリストが含まれます。出力の残りの部分にはスタンドアロン・ダンプと、装置
ユーティリティー ICKDSF (常駐ボリュームが直接アクセス装置の場合に) の両方か
らのメッセージが含まれます (メッセージ AMD064I を含む)。 AMDSAOSG がメ
ッセージ AMD064I 内に戻すコードは次のとおりです。
表 4-2. AMDSAOSG 戻りコード
戻りコード
説明
0
常駐ボリュームは初期設定された
4
常駐ボリュームは AMDSADMP アセンブリー中に発行されたエラ
ー、または警告のため初期設定されなかった。
8
常駐ボリュームは初期設定されなかった。GENPRINT はオープンさ
れなかった。
参照
AMD064I についての詳細は、「z/OS MVS システム・メッセージ 第 1 巻
(ABA-AOM)」を参照してください。
1 ステップ生成を使用する際の考慮事項
1 ステップ生成を使用してスタンドアロン・ダンプ・プログラムを生成する場合
は、次の手順に従ってください。
v SYSLIB DDNAME が SYS1.MODGEN と SYS1.MACLIB を連結していることを
確認してください。スタンドアロン・ダンプ・プログラムを生成する前に、ユー
ザーのインストール・システムに SYS1.MODGEN データ・セットをカタログし
てください。カタログしていないと、スタンドアロン・ダンプが作成する JCL は
スタンドアロン・ダンプ・プログラムの生成に失敗します。
v 直接アクセス・ボリューム上の常駐プログラムのためのスタンドアロン・ダンプ
を生成している場合は、AMDSAOSG はスタンドアロン・ダンプ・プログラムを
含む SYS1.PAGEDUMP.Vvolser データ・セットを作成およびロードして、ボリュ
ーム上に IPL テキストを置きます。ボリュームに SYS1.PAGEDUMP.Vvolser デ
ータ・セットが既に含まれている場合、AMDSAOSG は失敗します。
AMDSAOSG の実行中は、ボリュームのマウント属性は PRIVATE にしなければ
なりません。
v 磁気テープ・サブシステムからスタンドアロン・ダンプ・プログラムを生成する
場合は、どのテープ・フォーマットを使用するかに気を付けてください。そうし
ないとそのプログラムを IPL できない場合があります。特に、次のような場合は
IPL 処理が異常終了します。
– 3490E 磁気テープ・サブシステムにスタンドアロン・ダンプを生成し、3490E
以外のテープ・サブシステムを IPL で使用する。
– 3490E 以外のテープ・サブシステムにスタンドアロン・ダンプを生成し、
3490E 磁気テープ・サブシステムを IPL で使用する。
第 4 章 スタンドアロン・ダンプ
4-37
スタンドアロン・ダンプ
2 段階生成
スタンドアロン・ダンプ・プログラムの 2 段階生成では、2 つのタスクを実行する
必要があります。
1. AMDSADMP マクロのアセンブル
2. 常駐ボリュームの初期設定
AMDSADMP マクロのアセンブル
AMDSADMP マクロをコード化して、そのマクロをアセンブルすることができま
す。
例: AMDSADMP マクロをアセンブルするための段階 2 JCL
この JCL を使用して AMDSADMP マクロをアセンブルします。SYSLIB デー
タ・セットに AMDSADMP マクロを必ず含んでいる必要があります。
//ASSEMSAD
//ASM
//SYSLIB
//
//SYSUT1
//SYSPRINT
//SYSPUNCH
//SYSLIN
//SYSIN
JOB
MSGLEVEL=(1,1)
EXEC
PGM=ASMA90,REGION=4096K,PARM=’DECK’
DD
DSN=SYS1.MACLIB,DISP=SHR
DD
DSN=SYS1.MODGEN,DISP=SHR
DD
UNIT=SYSDA,SPACE=(1700,(400,50))
DD
SYSOUT=(*,,STD),HOLD=YES
DD
DSN=D10.SYS420.STAGE3.JCL(SADMPST2),DISP=SHR
DD
SYSOUT=H
DD
*
AMDSADMP
MINASID=ALL,IPL=DSYSDA,
X
DUMP=(’DATASPACES OF ASID(’XCFAS’,’CTTX’,’APPC’)’),
X
VOLSER=XXXXXX,
X
CONSOLE=((020,3277),(030,3277),(040,3277),(050,3277)),X
PROMPT,MSG=ALL,
X
OUTPUT=T560
END
/*
アセンブリーの出力は、常駐ボリュームを初期設定するために使用するジョブ・ス
トリームです。アセンブリーの出力は SYSPUNCH DD カードをコーディングし
て、DASD またはテープ装置に向けることができます。
アセンブリーの出力をテープに向ける場合は、次の SYSPUNCH DD ステートメン
トを使用してください。
//SYSPUNCH DD UNIT=tape,LABEL=(,NL),DISP=(NEW,KEEP),
// VOL=SER=volser
アセンブリーの出力を新しい直接アクセス・データ・セットに向ける場合は、次の
SYSPUNCH DD ステートメントを使用してください。
//SYSPUNCH DD UNIT=dasd,SPACE=(80,(30,10)),DSN=dsname,
// DISP=(NEW,KEEP),VOL=SER=volser
4-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
AMDSADMP の複数のバージョンをアセンブルする
それぞれが別の常駐ボリュームを指定している場合は、同時に複数のバージョンの
AMDSADMP をアセンブルすることができます。各マクロの開始に固有の記号をコ
ーディングすることによって、バージョンを区別します。 AMDSADMP は、固有の
段階 2 ジョブ名を生成するためにユーザーが示した記号を使用します。複数のアセ
ンブリーからの出力は、単一のリストと単一のオブジェクト・デックになります
が、必要な場合は、別々のジョブに分けることができます。
例: AMDSADMP マクロの複数のバージョンのアセンブル
複数の版の AMDSADMP をコーディングする場合に、この JCL を使用して
ください。
//MULTISAD
//ASM
//SYSLIB
//
//SYSUT1
//SYSPRINT
//SYSPUNCH
//SYSIN
TAPE
DASD1
DASD2
JOB MSGLEVEL=(1,1)
EXEC PGM=ASMA90,PARM=’DECK,NOOBJ’
DD
DSN=SYS1.MACLIB,DISP=SHR
DD DSN=SYS1.MODGEN,DISP=SHR
DD
UNIT=SYSDA,SPACE=(1700,(400,50))
DD SYSOUT=A
DD SYSOUT=B
DD *
AMDSADMP IPL=T3400,VOLSER=SADMP1
AMDSADMP VOLSER=SADMP2,MINASID=PHYSIN
AMDSADMP VOLSER=SADMP3
END
/*
常駐ボリュームの初期設定
2 段階 JCL を使用して直接アクセス・ボリューム上の常駐プログラムのためのスタ
ンドアロン・ダンプを生成している場合は、AMDSAOSG はスタンドアロン・ダン
プ・プログラムを含む SYS1.PAGEDUMP.Vvolser データ・セットを作成およびロー
ドして、ボリューム上に IPL テキストを置きます。ボリュームに
SYS1.PAGEDUMP.Vvolser データ・セットが既に含まれている場合、2 段階ジョブ
は失敗します。2 段階ジョブの実行中は、ボリュームのマウント属性は PRIVATE
でなければなりません。
初期設定ステップのアセンブリー部分からの物理的出力は、生成時に指定した情報
を含む、スタンドアロン・ダンプ共通通信テーブル (CCT) と装置およびダンプ・オ
プション (DDO) 制御ブロックのリストです。出力の残りの部分にはスタンドアロ
ン・ダンプと、装置ユーティリティー ICKDSF (常駐ボリュームが直接アクセス装
置の場合に) の両方からの、通知、エラー、および処置メッセージがあります。
磁気テープ・サブシステムからスタンドアロン・ダンプ・プログラムを生成する場
合は、どのテープ・フォーマットを使用するかに気を付けてください。そうしない
とそのプログラムを IPL できない場合があります。特に、次のような場合は IPL
処理が異常終了します。
v 3490E 磁気テープ・サブシステムにスタンドアロン・ダンプを生成し、3490E 以
外のテープ・サブシステムを IPL で使用する。
v 3490E 以外のテープ・サブシステムにスタンドアロン・ダンプを生成し、3490E
磁気テープ・サブシステムを IPL で使用する。
第 4 章 スタンドアロン・ダンプ
4-39
スタンドアロン・ダンプ
マイグレーション時に 2 段階生成を使用する
MVS の新しいバージョンにマイグレーションする場合は、スタンドアロン・ダン
プ・プログラムの新しいバージョンを生成することをお勧めします。スタンドアロ
ン・ダンプ・プログラムの新しいバージョンを作成する場合は、新しい MVS のシ
ステム・データ・セットを使用してください。
ダンプする MVS のリリースと同じリリースから生成されたスタンドアロン・ダン
プのバージョンを必ず使用してください。レベルの異なるスタンドアロン・ダンプ
では、そのダンプが対応するレベルの MVS 以外の正常なダンプは保証されませ
ん。新規バージョンの MVS が変更されて、スタンドアロン・ダンプ・プログラム
がその動作に必要な必須情報を見つけられなくなっていることがあります。
スタンドアロン・ダンプ・プログラムの新しいバージョンを生成するためには、通
常の 2 段階生成で行うステップと同じステップに従い、それから次のステップを実
行してください。
v AMDSADMP マクロの新しいバージョンが正しい SYSLIB データ・セットを指
定して使用されていることを確認してください。
v 正しい段階 2 JCL を作成するために、AMDSADMP マクロの呼び出しに
NUCLIB、MODLIB、LNKLIB および/または ALIB パラメーターを使用してくだ
さい。
例: AMDSADMP マクロをアセンブルするための段階 2 JCL
次の出力は volser=NEWSYS の 3390 DASD SYSLIB データ・セット
SYS1.MACLIB にある AMDSADMP マクロのバージョンをアセンブルしま
す。ALIB パラメーターを指定しているので、段階 2 JCL はまた
volser=NEWSYS の 3390 DASD にある SYS1.NUCLEUS、SYS1.MODGEN、
および SYS1.LINKLIB システム・データ・セットを使用します。
//ASSEMSAD
//ASM
//SYSLIB
//
//SYSUT1
//SYSPRINT
//SYSPUNCH
//SYSLIN
//SYSIN
JOB MSGLEVEL=(1,1)
EXEC PGM=ASMA90,REGION=4096K,PARM=’DECK’
DD
DSN=SYS1.MACLIB,DISP=SHR,
UNIT=3390,VOL=SER=NEWSYS
DD
UNIT=SYSDA,SPACE=(1700,(400,50))
DD
SYSOUT=(*,,STD),HOLD=YES
DD
DSN=D10.SYS430.STAGE3.JCL(SADMPST2),DISP=SHR
DD
SYSOUT=H
DD
*
AMDSADMP
MINASID=ALL,IPL=DSYSDA,
DUMP=(’DATASPACES OF ASID(’XCFAS’,’CTTX’,’APPC’)’),
VOLSER=SADUMP,
CONSOLE=((020,3277),(030,3277),(040,3277),(050,3277)),
PROMPT,MSG=ALL,
OUTPUT=T560,
ALIB=(NEWSYS,3390)
END
X
X
X
X
X
X
/*
注: ALIB パラメーターを使用すると、スタンドアロン・ダンプ・プログラムが使用
するすべてのシステム・データ・セットが同じボリューム上にある場合に便利
です。 また、NUCLIB、MODLIB、および LNKLIB キーワードに別々に、
volser と装置に NEWSYS と 3390 をそれぞれ指定してコーディングしても、
4-40
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
同じ結果が得られることに注意してください。
例: AMDSADMP マクロをアセンブルするための段階 2 JCL
次の出力は volser=NEWSYS の、3390 DASD SYSLIB データ・セット
SYS1.MACLIB にある AMDSADMP マクロのバージョンをアセンブルしま
す。MODLIB パラメーターを指定しているので、段階 2 JCL が
volser=SYS51A の 3380 DASD にある SYS1.MODGEN システム・データ・セ
ットを使用します。ALIB パラメーターを指定しているので、段階 2 JCL が
volser=SYS51B の 3390 DASD にある SYS1.NUCLEUS、および
SYS1.LINKLIB システム・データ・セットを使用します。
//ASSEMSAD
//ASM
//SYSLIB
//
//SYSUT1
//SYSPRINT
//SYSPUNCH
//SYSLIN
//SYSIN
JOB MSGLEVEL=(1,1)
EXEC PGM=ASMA90,REGION=4096K,PARM=’DECK’
DD
DSN=SYS1.MACLIB,DISP=SHR,
UNIT=3390,VOL=SER=NEWSYS
DD
UNIT=SYSDA,SPACE=(1700,(400,50))
DD SYSOUT=(*,,STD),HOLD=YES
DD DSN=D10.SYS430.STAGE3.JCL(SADMPST2),DISP=SHR
DD
SYSOUT=H
DD *
AMDSADMP
MINASID=ALL,IPL=DSYSDA,
DUMP=(’DATASPACES OF ASID(’XCFAS’,’CTTX’,’APPC’)’),
VOLSER=SADUMP,
CONSOLE=((020,3277),(030,3277),(040,3277),(050,3277)),
PROMPT,MSG=ALL,
OUTPUT=T560,
MODLIB=(SYS51A,3380),
ALIB=(SYS51B,3390)
END
X
X
X
X
X
X
X
/*
MODLIB パラメーターを別々に指定しているので、ALIB パラメーターは
SYS1.MODGEN システム・データ・セットに何も影響を与えないことに注意してく
ださい。
NUCLIB、MODLIB、LNKLIB、または ALIB パラメーターを指定していない場合
は、カタログされたシステム・データ・セットを使用してスタンドアロン・ダン
プ・プログラムが生成されます。
オーバーライド用に 2 段階生成を使用する
異なるシステム・データベースを使用するのにオーバーライドする場合、スタンド
アロン・ダンプ・プログラムの新しいバージョンを生成することをお勧めします。
スタンドアロン・ダンプ・プログラムの新しいバージョンを作成する場合は、新し
い MVS のシステム・データ・セットを使用してください。
現行バージョンのスタンドアロン・ダンプ・プログラムが新規バージョンの MVS
を正常にダンプできる場合がありますが、それは保証されていません。 MVS が変
更されて、スタンドアロン・ダンプ・プログラムが作動するための重要な情報を見
つけることができなくなっている場合があります。
第 4 章 スタンドアロン・ダンプ
4-41
スタンドアロン・ダンプ
スタンドアロン・ダンプ・プログラムの新しいバージョンを生成するためには、通
常の 2 段階生成で行うステップと同じステップに従い、それから次のステップを実
行してください。
v AMDSADMP マクロの新しいバージョンが正しい SYSLIB データ・セットを指
定して使用されていることを確認してください。
v 正しい段階 2 JCL を作成するために、AMDSADMP マクロの呼び出しに
NUCLIB、MODLIB、LNKLIB および/または ALIB パラメーターを使用してくだ
さい。
例: オーバーライド指定の AMDSADMP マクロをアセンブルするための段階 2 JCL
次の出力は、volser=OVRIDE 指定の 3390 DASD 上にある、SYSLIB データ・セットの
SYS1.MACLIB に入っている AMDSADMP マクロのバージョンをアセンブルします。 ALIB パラメ
ーターを指定しているので、段階 2 JCL がまた volser=OVRIDE の 3390 DASD にある
SYS1.NUCLEUS、SYS1.MODGEN、および SYS1.LINKLIB システム・データ・セットを使用しま
す。
// EXEC ASMAC,PARM.C=’DECK,NOOBJECT’
//C.SYSLIB
DD DSN=SYS1.MACLIB,DISP=SHR,UNIT=3390,VOL=SER=OVRIDE
//C.SYSPUNCH DD DSN=SMITH.TEST.CNTL(SADMP#2),DISP=OLD
//C.SYSIN DD *
AMDSADMP IPL=D3390,
IPL FROM DASD
VOLSER=SADIPL,
VOL=SER=SADIPL
OUTPUT=(D330,SYS1,SADMP),
DEFAULT OUTPUT DEVICE
MSG=ALL,
ALL MESSAGES TO CONSOLE
DUMP=(’SP(ALL) IN ASID(1) ALSO DATASPACES OF ASID(1,’JESXCF’,
’APPC’,’SMSVSAM’, ’CONSOLES’,’SYSBMAS’) ALSO PAGETABLES OF
DATASPACES
ALSO SP(ALL) IN ASID(’JES2’)’),
MINASID=ALL,
INCLUDE SWAPPED OUT SPACES
REUSEDS=CHOICE,
PROMPT FOR DATASET REUSE
DDSPROMPT=NO,
OVERRIDE BUILD DATASETS
ALIB=(OVRIDE,3390)
END
/*
X
X
X
X
X
X
X
X
X
注: ALIB パラメーターを使用すると、スタンドアロン・ダンプ・プログラムが使用
するすべてのシステム・データ・セットが同じボリューム上にある場合に便利
です。 また、NUCLIB、MODLIB、および LNKLIB キーワードに別々に、
volser と装置に NEWSYS と 3390 をそれぞれ指定してコーディングしても、
同じ結果が得られることに注意してください。
スタンドアロン・ダンプ・プログラムの実行
オペレーターは通常、下記のいずれかの問題のいずれかが発生した場合にスタンド
アロン・ダンプを取ります。
v 使用不能待機
v 使用可能待機
v ループ
v 部分的システム停止
4-42
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
これらの問題の 1 つが発生した場合、SYS1.PAGEDUMP.Vvolser データ・セット内
にあるスタンドアロン・ダンプ・プログラムを実行してスタンドアロン・ダンプを
生成することができます。スタンドアロン・ダンプ・プログラムを実行するために
使用できる以下のいくつかの手順があります。
v 『手順 A: スタンドアロン・ダンプの初期設定と実行』
v 4-48 ページの『手順 B: スタンドアロン・ダンプの再始動』
v 4-49 ページの『手順 C: スタンドアロン・ダンプの再 IPL』
v 4-49 ページの『手順 D: スタンドアロン・ダンプ・プログラムのダンプ』
どの手順をいつ使用するか。
v 手順 A は、スタンドアロン・ダンプ・プログラムを初期設定してストレージを
ダンプするために使用します。
v スタンドアロン・ダンプを再度実行したい場合、たとえばスタンドアロン・ダン
プが失敗した場合は、手順 B、手順 C、または手順 D を使用してください。
v スタンドアロン・ダンプを再始動したい場合は、手順 C または手順 D を試行す
る前に手順 B を試行してください。
v 手順 C と D は出力からいくつかの中央記憶装置を失う場合がありますが、手順
B では、そのようなことは通常はありません。
スタンドアロン・ダンプ・プログラムはオペレーティング・システムのもとで作成
されますが、スタンドアロン操作で実行されます。
手順 A: スタンドアロン・ダンプの初期設定と実行
スタンドアロン・ダンプを初期設定し、実行する場合は、以下の手順を使用しま
す。
注: ステップ 1 および 3 が必要なのは、SADUMP を IPL して、SADUMP 問題ま
たは VM システムをデバッグするときに限られます。
1. すべてのプロセッサーを停止してください。ストレージを消去しないでくださ
い。
2. システムが停止した時にオンラインだったプロセッサーを選択してください。
3. そのプロセッサーが、手作業で STORE STATUS を実行しないでスタンドアロ
ン・ダンプを IPL できる場合は、この機能を使用してスタンドアロン・ダンプ
を IPL してください。そのような機能を使用しないと、スタンドアロン・ダン
プを IPL する前に STORE STATUS を実行してください。オペレーターが状
況を記憶しないと、仮想記憶域はダンプされません。
ハードウェア状況保管機能は、現在のプログラム状況ワード (PSW)、現在のレ
ジスター、プロセッサー・タイマー、および時刻比較機構を接頭部が付けられ
ていない接頭部保管域 (PSA) に保管します。この PSA は中核初期設定プログ
ラム (NIP) がプレフィックス・レジスターを初期設定する前に使用されるもの
です。
ハードウェア・コンソールからスタンドアロン・ダンプを IPL する場合は、
STORE STATUS 操作を実行する必要はありません。ハードウェア・コンソー
ルからスタンドアロン・ダンプを呼び出した時に、自動状況保管がオンになり
状況が自動的に保管されます。
第 4 章 スタンドアロン・ダンプ
4-43
スタンドアロン・ダンプ
オペレーターがスタンドアロン・ダンプを IPL する前に STORE STATUS が
行われていない場合、メッセージ “ONLY GENERAL PURPOSE REGS
VALID” がフォーマット設定されたダンプに表示されます。 PSW、制御レジス
ター、などはダンプに含まれません。
注
LOAD CLEAR オプションは使用しないでください。LOAD CLEAR オプ
ションを使用すると主記憶域が消去され、障害を正しく診断できなくなり
ます。
4. 常駐装置を作動可能にしてください。それがテープの場合は、選択したプロセ
ッサーに接続されている装置にボリュームを取り付け、ファイル保護リングが
取り付けられていることを確認してください。それが DASD ボリュームの場合
は、書き込み可能なことを確認してください。
5. スタンドアロン・ダンプを IPL します。
スタンドアロン・ダンプはオペレーター・コンソールと通信することはできま
せん。代わりに、スタンドアロン・ダンプは待機理由コード X'3E0000' をもつ
使用可能待機 PSW をロードします。スタンドアロン・ダンプ・プログラムを
IPL すると、絶対ストレージ (X'0' から X'18' と X'FC0' で始まるストレージ)
が CCW でオーバーレイされます。この点に注意し、低ストレージ・オーバー
レイであると見なさないようにしてください。
注: スタンドアロン・ダンプは PSW を使用して、オペレーターまたはシステ
ム・プログラマーと通信します。
スタンドアロン・ダンプはコンソール入出力割り込みまたは外部割り込みを待
ちます。
6. スタンドアロン・ダンプを IPL するときに、スタンドアロン・ダンプの操作を
変更するロード・パラメーターを指定できます。ロード・パラメーターの形式
は、Sadddd です。
定数 S を最初の文字として指定してください。指定しなければ、ロード・パラ
メーターは無視されます。
a の指定によって、オペレーターのアクションなしに、スタンドアロン・ダン
プはコンソールを使用して開始できます。また、スタンドアロン・ダンプが使
用する出力装置およびデフォルトのダンプの表題を要求するプロンプト指示を
う回することもできます。a には次の値を指定できます。
4-44
N
コンソール通信を不要にします。デフォルトのダンプ装置と表題を使用
します。コンソール・メッセージを出さずに実行が開始されます。オペ
レーターへのプロンプト指示は行われません。プロンプト指示が発生す
る場合、待ち状態がロードされます。
O
デフォルトのコンソールをデフォルトのダンプ装置と表題で使用しま
す。オペレーターへのプロンプト指示は行われません。プロンプト指示
が発生する場合、待ち状態がロードされます。
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
M
デフォルトのコンソールをデフォルトのダンプ装置と表題で使用しま
す。必要に応じて、オペレーターへのプロンプト指示がさらに行われま
す。
C
デフォルトのコンソールを使用します。オペレーターはすべてのプロン
プト指示に応答しなければなりません。
P
使用されるコンソール装置からの割り込みを待機します。ロード・パラ
メーターを指定しない場合には、これがデフォルトです。
dddd の指定は、デフォルトのコンソール装置です。スタンドアロン・ダンプが
生成されたときに AMDSADMP マクロにコンソール装置として指定した装置の
いずれか、またはハードウェア・システム・コンソールを示す定数 SYSC でな
ければなりません。デフォルトのコンソール装置を指定しない場合、スタンド
アロン・ダンプは、スタンドアロン・ダンプが生成されたときに AMDSADMP
マクロに定義した最初のコンソールを使用します。
AMDSADMP マクロで、コンソール・リストの最初のコンソールとして SYSC
を指定できます。ロード・パラメーターにコンソール装置を指定せずに、この
マクロのコンソール・リストに最初のコンソールとして SYSC を指定した場
合、ハードウェア・システム・コンソールがデフォルトのコンソール装置とな
ります。
ロード・パラメーターを使用しない場合、スタンドアロン・ダンプ生成時に指
定 (AMDSADMP の CONSOLE キーワードに) したコンソール・リストに入っ
ている装置アドレスを持つシステム・コンソールまたはオペレーター・コンソ
ールを選択してください。オペレーターは、スタンドアロン・ダンプ実行時
に、スタンドアロン・ダンプ操作を制御するために CONSOLE= キーワードで
指定したコンソールまたはシステム・コンソールのいずれかを選択することが
できます。オペレーター・コンソールを選択する場合は、そのコンソールで
ATTENTION または ENTER を押してください。(コンソールによっては、最初
に RESET を押す必要があるものがあります。) この結果、コンソールのアド
レスをスタンドアロン・ダンプに通知する割り込みが起こります。メッセージ
AMD001A がコンソールに表示されます。
a. 出力装置を作動可能にしてください。実アドレスと仮想アドレスの両方を持
つ装置にダンプする場合は (たとえば、VM システムをダンプする)、スタン
ドアロン・ダンプ操作を制御するダンプ・プログラムに実アドレスのみを指
定してください。テープにダンプする場合は、テープ・カートリッジが書き
込み可能かどうかを確認してください。DASD にダンプする場合は、その
DASD データ・セットが IPCS SADMP または AMDSADDD REXX ダン
プ・データ・セット・ユーティリティーを使用して初期設定されていること
を確認してください。
b. 出力装置の装置番号を応答してください。DASD 装置にダンプを行い、
AMDSADMP マクロに DDSPROMPT=YES を指定した場合には、オペレー
ターにダンプ・データ・セット名を要求するプロンプト指示をするメッセー
ジ AMD002A が出されます。DDSPROMPT=NO を指定した場合には、メッ
セージ AMD002A は出されずに、スタンドアロン・ダンプ操作を制御する
ダンプ・プログラムはダンプ・データ・セット名を SYS1.SADMP と想定し
ます。
第 4 章 スタンドアロン・ダンプ
4-45
スタンドアロン・ダンプ
注:
1) メッセージ AMD001A に応答して ENTER を押すと、スタンドアロ
ン・ダンプ操作を制御するダンプ・プログラムは AMDSADMP マクロ
の OUTPUT= キーワードに指定されたデフォルト装置を使用します。デ
フォルト装置が DASD 装置である場合、メッセージ AMD001A に応答
して ENTER キーを押すと、スタンドアロン・ダンプ・プログラムは、
デフォルト装置と AMDSADMP マクロの OUTPUT= キーワードに指定
したダンプ・データ・セットとの両方を使用できるようになります。
OUTPUT= キーワードにダンプ・データ・セット名を指定せずに
DDSPROMPT=YES キーワードを指定すると、メッセージ AMD002A が
出されてオペレーターにダンプ・データ・セットを要求するプロンプト
指示を出します。DDSPROMPT=NO を指定した場合、スタンドアロン・
ダンプ・プログラムはダンプ・データ・セット名を SYS1.SADMP と想
定します。
2) 必要な装置タイプではない付加された装置の装置番号を応答した場合、
または装置が特定のタイプの入出力エラーを起こした場合、スタンドア
ロン・ダンプ操作を制御するダンプは使用不能待機 PSW をロードしま
す。この場合は、手順 B を使用してスタンドアロン・ダンプを再始動し
てください。
c. スタンドアロン・ダンプはメッセージ AMD011A を使用してダンプの表題
に関するプロンプト指示を出します。
例: ロード・パラメーターを使用してスタンドアロン・ダンプを実行する
この例では、コンソール・プロンプトなしが指定されたロード・パラメー
ターを使用して、ダンプが初期設定されます。
AMD083I
AMD101I
AMD005I
AMD005I
AMD005I
AMD005I
AMD005I
AMD005I
AMD005I
AMD108I
AMD108I
AMD108I
AMD108I
AMD056I
AMD005I
AMD005I
AMD005I
AMD104I
|
|
|
|
|
|
|
|
|
|
|
AMDSADMP: STAND-ALONE DUMP INITIALIZED
OUTPUT DEVICE: 0330 SADMP1 SYS1.SADMP
SENSE ID DATA: FF 3990 E9 3390 0A BLOCKSIZE: 24,960
DUMPING OF REAL STORAGE NOW IN PROGRESS.
DUMPING OF PAGE FRAME TABLE COMPLETED.
DUMPING OF REAL STORAGE FOR MINIMAL ASIDS COMPLETED.
DUMPING OF REAL STORAGE FOR SUMMARY ASIDS COMPLETED.
DUMPING OF REAL STORAGE FOR SWAPPED-IN ASIDS COMPLETED.
DUMPING OF REAL STORAGE IN-USE REAL STORAGE COMPLETED.
DUMPING OF REAL STORAGE SUSPENDED.
DUMPING OF AUXILIARY STORAGE FOR MINIMAL ASIDS COMPLETED
DUMPING OF AUXILIARY STORAGE FOR SUMMARY ASIDS COMPLETED
DUMPING OF AUXILIARY STORAGE FOR SWAPPED-IN ASIDS COMPLETED
DUMPING OF AUXILIARY STORAGE FOR SWAPPED-OUT ASIDS COMPLETED
DUMPING OF AUXILLIARY STORAGE COMPLETED.
DUMPING OF REAL STORAGE RESUMED.
DUMPING OF AVAILABLE REAL STORAGE COMPLETED
DUMPING OF REAL STORAGE COMPLETED.
DEVICE VOLUME USED DATA SET NAME
1
0330
SADMP1 43% SYS1.SADMP _
7. 使用できるコンソールがない場合は、スタンドアロン・ダンプはコンソールな
しで実行されます。
a. AMDSADMP マクロの OUTPUT パラメーターに指定したデフォルトの出力
装置を作動可能にしてください。テープの場合は、テープ・カートリッジが
書き込み可能であることを確認してください。DASD の場合には、
4-46
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
AMDSADDD REXX または IPCS SADMP ダンプ・データ・セット・ユー
ティリティーを使用してダンプ・データ・セットが初期設定されていること
を確認してください。
b. スタンドアロン・ダンプを IPL したプロセッサーで外部割り込みを起こし
てください。スタンドアロン・ダンプは、デフォルトの出力装置またはデフ
ォルトのダンプ・データ・セット (あるいはその両方) を使用して処理を行
います。どのコンソールにもメッセージは表示されません。スタンドアロ
ン・ダンプは PSW 待ち理由コードを使用してオペレーターと通信します。
|
|
|
8. スタンドアロン・ダンプは、最初に実ストレージを ASID の配列で処理しま
す。各フェーズの後に AMD005I メッセージが出されて、ダンプの状況を表示
します。
|
a. フェーズ 1 ではページ枠テーブルと関連構造を仮想配列でダンプします。
|
|
b. 次の 3 フェーズでは、最小、サマリー、スワップイン ASID と関連する実
ストレージを仮想配列でダンプします。
|
c. フェーズ 5 では、使用中の実ストレージを実際の配列でダンプします。
|
|
|
9. スタンドアロン・ダンプは、お客様の仕様に基づいて、ページアウトしたスト
レージを仮想配列で処理します。メッセージ AMD108I が出され、ダンプの仮
想フェーズの状況が表示されます。
|
|
|
a. フェーズ 6 から 8 では、最小、サマリー、スワップイン ASID のページア
ウトされたストレージをダンプします。フェーズ 8 の終わりには、スワッ
プイン ASID と関連するすべてのストレージがダンプされます。
|
b. フェーズ 9 では、スワップアウト ASID のストレージがダンプされます。
|
|
|
|
10. スタンドアロン・ダンプは、フェーズ 10 で使用できる実ストレージのダンプ
を進めます。このフェーズでダンプされたストレージには、これ以前にダンプ
されなかった実フレームも含まれます。このフェーズが完了すると、メッセー
ジ AMD104I がダンプの終了を知らせるために出されます。
|
|
11. スタンドアロン・ダンプが実ストレージのダンプを開始すると (フェーズ 1 か
らフェーズ 5 およびフェーズ 10)、メッセージ AMD005I を出します。メッセ
ージ AMD095I を 30 分ごとに出してダンプの進行を図示します。メッセージ
AMD005I は、実際のダンプの完了時だけではなく、実記憶域の特定部分がダン
プされたときも出されます。スタンドアロン・ダンプはこのステップで終了す
ることがあります。
12. スタンドアロン・ダンプが仮想ストレージをダンプするときは、仮想ストレー
ジの特定部分がダンプされるとメッセージ AMD108I が出されます。メッセー
ジ AMD056I は、仮想フェーズのダンプの終了を知らせるために出されます。
13. AMDSADMP マクロに PROMPT を指定している場合、スタンドアロン・ダン
プはメッセージ AMD059D を発行してダンプしたい追加のストレージについ
て、ユーザーにプロンプト指示します。
14. スタンドアロン・ダンプは、ページアウト仮想記憶域、スタンドアロン・ダン
プ・メッセージ・ログをダンプし、30 分ごとにメッセージ AMD095I を発行し
て、ダンプの進行を図示します。
15. スタンドアロン・ダンプの処理が完了すると、スタンドアロン・ダンプはテー
プがある場合はアンロードし、待機理由コード X'410000' を入力します。
第 4 章 スタンドアロン・ダンプ
4-47
スタンドアロン・ダンプ
参照
PSW にロードされる待ち状態理由コードに関する詳細は、「z/OS MVS システム・
コード」を参照してください。
注: プロセッサーの一部のモデルには、IPL を行う特定のプロセッサーの選択がで
きないものがあります。通常は直前に IPL したプロセッサーが次回の IPL に
再び選択されます。
|
手順 B: スタンドアロン・ダンプの再始動
スタンドアロン・ダンプ内部リソースが初期設定されていない時点でシステム再始
動が起きたり、スタンドアロン・ダンプが機能に非常に重い損傷を受けている場合
は、システム再始動は常に機能する訳ではありません。再始動が機能しない場合
は、手順 C (再 IPL) を試行してください。
ダンプを保持する十分なスペースがないために、DASD データ・セットへのダンプ
が切り捨てられる場合は、システム再始動を使用して元のデータをテープにダンプ
してください。システム再始動を起こすと、ダンプしたい元のデータを損失するこ
となく障害が起こったスタンドアロン・ダンプ・プログラムを再初期設定し再始動
することができます。
出力を入手すると、スタンドアロン・ダンプ・プログラムを再始動できる最大の回
数は 5 回です。
出力装置に永続エラーが発生すると、スタンドアロン・ダンプ・プログラムは、ス
タンドアロン・ダンプ・プログラムの再始動を行うべきかどうかを判別するため
に、オペレーターにプロンプト指示します。スタンドアロン・ダンプ・プログラム
の再始動を実行することを指定すると、スタンドアロン・ダンプ・プログラムは同
じコンソールを使用してダンプを再始動し、オペレーターに別の出力装置を指定す
るようにプロンプト指示します。手順 A をステップ 6A から開始します。4-45 ペ
ージを参照。
ほかのタイプのスタンドアロン・ダンプのエラーと待ち状態の場合は、オペレータ
ーがスタンドアロン・ダンプ・プログラムの手動再始動を実行する必要がありま
す。この場合は、オペレーターは次のステップを実行する必要があります。
1. スタンドアロン・ダンプを IPL したプロセッサーでシステム再始動を実行して
ください。
2. 再始動が正しく実行されると、スタンドアロン・ダンプは中央記憶装置をダンプ
します。スタンドアロン・ダンプが中央記憶装置のダンプ中に異常終了する場合
は、スタンドアロン・ダンプの再始動を試行してください。再始動が正しく行え
る場合は、スタンドアロン・ダンプはダンプ全体を再実行します。最初に
X'3E0000' の待ち状態に入り、新しいコンソールと出力装置を指定できます。出
力装置の入出力エラーからリカバリーするためにこれを用いることができます。
スタンドアロン・ダンプはコンソール・リスト内のいずれかのコンソールを認識
し、スタンドアロン・ダンプの IPL 時に使用した同じ出力装置のデフォルト値
で開始します。
3. 手順 A をステップ 5 から開始します。5 (4-44 ページ) を参照。
4-48
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
注: S/390® Enterprise Server の一部のモデルには、IPL を行う特定のプロセッサー
の選択ができないものがあります。通常は直前に IPL したプロセッサーが次回
の IPL に再び選択されます。
手順 C: スタンドアロン・ダンプの再 IPL
スタンドアロン・ダンプを再 IPL する場合は、スタンドアロン・ダンプの直前の実
行はすでに中央記憶装置のある部分をオーバーレイし、ページ・フレーム・テーブ
ルを修正しています。仮想記憶ダンプ・プログラムの制御中は、再 IPL はページア
ウトされた仮想記憶域をダンプしません。ページアウトされた仮想記憶域をダンプ
するためにスタンドアロン・ダンプを IPL できる回数は、存在するプロセッサーの
数と同じです。
手順 C を実行する場合は、手順 A を繰り返しますが、STORE STATUS は発行し
ません。スタンドアロン・ダンプ・ハードウェア機能を使用して IPL する場合は、
最初の IPL の後のスタンドアロン・ダンプのすべての IPL で STORE STATUS が
省略されます。直前のスタンドアロン・ダンプの IPL が X'250000' またはそれ以上
の待ち状態と理由コードをロードせず、再 IPL が完了した場合は、スタンドアロ
ン・ダンプは手順 A にあるように処理を完了します。直前の IPL 時にスタンドア
ロン・ダンプが内容をオーバーレイしたので、ある記憶場所では中央記憶装置の元
の内容が反映されていない場合があります。これらの位置には絶対 PSA が含ま
れ、別の PSA も含まれる場合があります。
手順 D: スタンドアロン・ダンプ・プログラムのダンプ
スタンドアロン・ダンプの新しい IPL を使用して、スタンドアロン・ダンプが失敗
した場合にそれをデバッグします。スタンドアロン・ダンプをダンプするためにス
タンドアロン・ダンプを使用する場合は、中央記憶装置のダンプによりスタンドア
ロン・ダンプ・エラーを診断するための十分な情報が得られるので、ダンプ・プロ
グラムは中央記憶装置のみをダンプします。手順 A のステップ 3 に従って、
STORE STATUS 命令を実行してください。スタンドアロン・ダンプは手順 A をス
テップ 8 まで実行し、それからメッセージ AMD088D を発行します。このメッセ
ージに対し、オペレーターは、中央記憶装置がダンプされた後でダンプを停止する
か、または仮想記憶域のダンプを継続するかを指定することができます。
自己ダンプとシステム再始動は、スタンドアロン・ダンプ・エラー・リカバリーの
2 つの機能です。仮想記憶域ダンプの実行中にエラーが発生すると、スタンドアロ
ン・ダンプは最大 5 回、自己ダンプをとることができます。これらを使用して、ス
タンドアロン・ダンプ処理エラーを診断することができます。スタンドアロン・ダ
ンプ・システム再始動機能を使用すると、スタンドアロン・ダンプのテストとデバ
ッグを行う助けになります。
スタンドアロン自己ダンプ
仮想記憶域ダンプを実行し、スタンドアロン・ダンプ・エラー・リカバリー機能が
スタンドアロン・ダンプにエラーを検出すると、スタンドアロン・ダンプは次に進
む前に自己ダンプを取ることができます。スタンドアロン・ダンプは最大で 10
回、自己ダンプを取ります。自己ダンプの 10 回目の要求のあと、スタンドアロ
ン・ダンプは自己ダンプを取るのを停止しますが、自己ダンプの要求回数をカウン
トし続け、 AMD066I メッセージを出し続けます。数多くの自己ダンプ要求のあ
第 4 章 スタンドアロン・ダンプ
4-49
スタンドアロン・ダンプ
と、スタンドアロン・ダンプは終了します。スタンドアロン・ダンプは、自己ダン
プとオペレーティング・システム・ダンプの両方を出力テープまたは DASD に置き
ます。
IPCS の LIST サブコマンドを使用して、スタンドアロン・ダンプ自己ダンプを印刷
することができます。サブコマンドのフォーマットは次のとおりです。
LIST address COMPDATA(AMDSAxxx)
ここで x = 001 - 010。
参照
詳しくは、「z/OS MVS IPCS コマンド」を参照してください。
シスプレックス内でのスタンドアロン・ダンプ・プログラムの実行
オペレーターは通常、MVS システムが応答しない場合には、シスプレックス内でス
タンドアロン・ダンプを取ります。スタンドアロン・ダンプを実行する必要がある
状況には、以下の状況が含まれます。
v コンソールが応答しない
v MVS が待ち状態にある
v MVS システムが、“状況更新の脱落” 条件にあって、シスプレックスから除去さ
れるのを待っている場合
v スタンドアロン・ダンプがレベル 2 により要求されている
シスプレックス内に常駐する MVS システムのスタンドアロン・ダンプを取るに
は、2 種類の高水準方式があります。これらの方式はどちらも、障害が起こってい
る MVS システムをシスプレックス内から迅速に除去することに重点を置いていま
す。障害が起こっている MVS システムがシスプレックス内から迅速に切り分けら
れないと、生き残っている MVS 上の処理が遅らされることがあります。
方式 A
この方式は、シスプレックス内に常駐する MVS システムのスタンドアロン・ダン
プを取るために使用します。ダンプされる MVS システムを、“SYSA” としましょ
う。
1. SYSA CPU を停止状態にするために STOP 機能を実行します。
2. SYSA 上のスタンドアロン・ダンプ・プログラムの IPL を行います (『スタン
ドアロン・ダンプ・プログラムの実行』を参照)。
3. メッセージ IXC402D または IXC102A がまだ表示されていない場合は、シスプ
レックス内の活動状態にある他の MVS システムから VARY XCF,SYSA,
OFFLINE を発行してください。
VARY XCF,SYSA,OFFLINE コマンドは、スタンドアロン・ダンプが完了するの
を待たずに発行することができます。
4. メッセージ IXC402D または IXC102A に、DOWN と応答します。
ステップ 3 およびステップ 4 をスタンドアロン・ダンプの IPL 直後に行うと、
SYSA に関するシスプレックスのリカバリー・アクションを促進し、SYSA に保留
4-50
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
されているリソースが迅速にクリーンアップされますので、シスプレックス内の他
のシステムが処理を続けることができます。
スタンドアロン・ダンプが一度 IPL されると、MVS は自動的に SFM 経由でシス
テム SYSA を分離できなくなりますので、VARY XCF,SYSA,OFFLINE コマンドの
後、または XCF 障害検出間隔が無効になった後に、メッセージ IXC402D また
は、メッセージ IXC102A が発行されます。シスプレックスの区分化が完了する前
に、IXC402D または IXC102A に DOWN で対処してください。
注: スタンドアロン・ダンプの IPL の、IXC402D、IXC102A に対してシステム・リ
セットで対処しないでください。この場合、スタンドアロン・ダンプの IPL に
よりシステム・リセットが発生しますので、システム・リセットは必要ありま
せん。スタンドアロン・ダンプの IPL が完了したら、IXC402D または
IXC102A に対しては DOWN で対処するのが安全なやりかたです。
方式 B
Stop 機能とスタンドアロン・ダンプ・プログラムの IPL の間に時間遅延がある場
合は (方式 A のステップ 1 およびステップ 2)、次の方式を使用します。この方式
を使用すると、スタンドアロン・ダンプの IPL の準備を行っている間に、システム
SYSA により保留されているリソースの解放を促進します。
1. SYSA CPU を停止状態にするために STOP 機能を実行します。
2. SYSA に対して、SYSTEM RESET-NORMAL 機能を実行します。
3. メッセージ IXC402D または IXC102A がまだ表示されていない場合は、シスプ
レックス内の活動状態にある他の MVS システムから VARY XCF,SYSA,
OFFLINE を発行してください。
4. メッセージ IXC402D または IXC102A に、DOWN と応答します。
ステップ 3 およびステップ 4 をシステム・リセットの直後に行うと、SYSA に
関するシスプレックスのリカバリー・アクションを促進し、SYSA に保留されて
いるリソースが迅速にクリーンアップされますので、シスプレックス内の他のシ
ステムが処理を続けることができます。
5. スタンドアロン・ダンプ・プログラムを IPL します。( 4-42 ページの『スタンド
アロン・ダンプ・プログラムの実行』を参照) このステップは、ステップ 2 の
後であればいつでも実行することができます。
システム・リセットを一度実行すると、MVS は SFM 経由でシステム SYSA を分
離することができませんので、VARY XCF,SYSA,OFFLINE コマンドの後で、また
は XCF 障害検出間隔が無効になった後で、メッセージ IXC402D または IXC102A
が発行されます。シスプレックスの区分化が完了する前に、IXC402D または
IXC102A に DOWN で対処してください。
注: スタンドアロン・ダンプを複数回 IPL しないでください。このアクションは、
MVS ダンプを無効にしてしまいます。スタンドアロン・ダンプ処理を再始動す
るには、スタンドアロン・ダンプ・プログラムが IPL された CPU 上で CPU
再始動機能を実行してください。
第 4 章 スタンドアロン・ダンプ
4-51
スタンドアロン・ダンプ
スタンドアロン・ダンプを高速に採取
問題を診断するのに、スタンドアロン・ダンプ情報の高速な処理が必要となる場合
があります。システムの停止時間を最低限に抑えるために、スタンドアロン・ダン
プ処理を迅速に実施することが重要です。ダンプ処理に時間がかかるためにスタン
ドアロン・ダンプを採取できない場合が時々あります。しかし、スタンドアロン・
ダンプを採取しないと、システム障害の診断ができなくなります。スタンドアロ
ン・ダンプを採取しないのではなく、可能な限り多くのスタンドアロン・ダンプを
可能な限り高速に入手して、時間短縮することは大切なことです。スタンドアロ
ン・ダンプ実行の処理時間を節約するには、以下の 2 つの方法があります。
v オペレーターによる処置の最小化
v 部分的スタンドアロン・ダンプの採取
オペレーターによる処置の最小化
オペレーターによるメッセージ応答待ち時間、または磁気テープのマウント待ち時
間は、アイドル時間です。オペレーターによる処置を最小化することにより、アイ
ドル時間をデータ採取時間に振り向けることができます。また、それによって処理
が単純化されて、スタンドアロン・ダンプ処理の実行が容易になります。ダンプ実
行時にオペレーター対応を最小化するには、以下の方法があります。
v スタンドアロン・ダンプの LOAD パラメーター SO または SM を使用してコン
ソールに対する入力指示をスキップし、メッセージに対するその他の応答を不要
にします。
v AMDSADMP マクロの OUTPUT= キーワード上でデフォルト装置を使用しま
す。デフォルト装置が DASD 装置である場合、メッセージ AMD001A に応答し
て ENTER キーを押すと、スタンドアロン・ダンプ・プログラムは、デフォルト
装置と AMDSADMP マクロの OUTPUT= キーワードに指定したダンプ・デー
タ・セットとの両方を使用できるようになります。
v AMDSADMP マクロ上の REUSEDS=ALWAYS を使用して、データ・セットが有
効であるが、以前のダンプのデータを含んでいる可能性があることをスタンドア
ロン・ダンプが判別した時に、指定した出力装置上のダンプ・データ・セットを
再利用することを示します。または、常にデータ・セットをクリアできます。
注: 別のダンプを上書きしないように注意してください。
v DDSPROMPT=NO を指定すると、スタンドアロン・ダンプ・プログラムはダン
プ・データ・セット名を SYS1.SADMP と想定します。
v IBM からお願いしない限り、AMDSADMP マクロで PROMPT を指定しないでく
ださい。
v 高速な出力装置を使用してください。
部分的スタンドアロン・ダンプの採取
完全なスタンドアロン・ダンプを採取することは常に最良なことですが、それが時
間的制約により許されないことが時々あります。部分的スタンドアロン・ダンプを
使用して障害を診断することが可能である保証はありませんが、全くダンプを採取
しないことと、部分的にダンプすることのどちらを選ぶかといえば、部分的にダン
プすることが最良の選択です。
4-52
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
部分的スタンドアロン・ダンプを採取時は以下を行います。
v スタンドアロン・ダンプができる限り長く実行できるようにしてください。ダン
プに許された時間を超える場合、ダンプを完全に停止できます。
v スタンドアロン・ダンプは最初に最重要な情報を書き出そうとします。
– すべての CPU に関する状況情報 (PSW、レジスターなど)
– 重要な実記憶域 (共通域とトレース情報を含む)
– ダンプ時に実行中のアドレス・スペースの実記憶域
– その他のすべての実記憶域
– スワップインされたアドレス・スペース用のページアウト記憶域
– スワップアウトされたアドレス・スペース用のページアウト記憶域
v EXTERNAL INTERRUPT キーを使用して、ダンプ処理を終了させます。これを
行うことにより、出力データ・セットが正しくクローズされて、完全に停止され
ます。
例: スタンドアロン・ダンプの終了
この例では、EXTERNAL INTERRUPT キーを使用してダンプを途中で終了さ
せています。
AMD083I
AMD094I
AMD101I
|
|
|
AMD005I
AMD005I
AMD005I
AMD005I
AMD089I
AMD066I
AMDSADMP: STAND-ALONE DUMP RESTARTED
0330 SADMP1 SYS.SADMP
IS VALID, HOWEVER, IT MAY ALREADY CONTAIN DATA FROM A PREVIOUS DUMP.
THE INSTALLATION CHOSE TO ALWAYS REUSE THE DUMP DATA SET.
OUTPUT DEVICE: 0330 SADMP1 SYS1.SADMP
SENSE ID DATA: FF 3990 E9 3390 0A BLOCKSIZE: 24,960
DUMPING OF REAL STORAGE NOW IN PROGRESS.
DUMPING OF PAGE FRAME TABLE COMPLETED.
DUMPING OF REAL STORAGE FOR MINIMAL ASIDS COMPLETED.
DUMPING OF REAL STORAGE FOR SUMMARY ASIDS COMPLETED.
DUMP TERMINATED DUE TO EXTERNAL KEY
AMDSADMP ERROR, CODE=0012, PSW=040810008101235E, COMPDATA9AMDSA002)
スタンドアロン・ダンプ出力のコピー、表示、および印刷
スタンドアロン・ダンプ処理がダンプを完了すると、出力はテープ・ボリューム、
DASD、またはこれらの装置の組み合わせのいずれかに存在します。ダンプを表示す
る簡単な方法は、ダンプを DASD データ・セットにコピーする方法です。複数の装
置またはダンプ・データ・セット (あるいはその両方) にスタンドアロン・ダンプが
存在する場合は、そのダンプを 1 つのデータ・セットに連結することができます。
ダンプが DASD 上で使用できるようになると、IPCS を使用してオンラインで表示
することができます。
注: ダンプが DASD ダンプ・データ・セットに存在する場合は、IPCS で処理する
ためにそのダンプを別のデータ・セットにコピーして、AMDSADDD または
IPCS SADMP ダンプ・データ・セット・ユーティリティーを使用してダンプ・
データ・セットをクリア (再初期設定) することをお勧めします。詳細について
は、 4-28 ページの『AMDSADDD ユーティリティーの使用』 と、z/OS MVS
IPCS ユーザーズ・ガイド 内の IPCS ダイアログの Utility オプションを参照し
てください。
第 4 章 スタンドアロン・ダンプ
4-53
スタンドアロン・ダンプ
ダンプをデータ・セットにコピーする
ダンプをオンラインで表示したい場合は、ダンプをデータ・セットにコピーしま
す。ダンプをコピーするための 2 つのツールがあります。
v IPCS 環境がユーザー・システムでセットアップされている場合は、IPCS
COPYDUMP サブコマンドを使用します。
v IPCS 環境がユーザーのシステムでセットアップされていない場合は、IEBGENER
ユーティリティーを使用します。多くのオペレーターがスタンドアロン・ダンプ
を取るので、システム・プログラマーはダンプを見ることができます。オペレー
ターはダンプを見ることはないのでシステムの IPCS は不要です。したがって、
オペレーターは IEBGENER ユーティリティーを使用して、システム・プログラ
マーのシステムでアクセス可能なデータ・セットにダンプをコピーします。
参照
v COPYDUMP についての情報は、「z/OS MVS IPCS コマンド」を参照してくださ
い。
v IEBGENER についての情報は、「z/OS DFSMSdfp Utilities」を参照してくださ
い。
テープからのコピー
下記の例は IEBGENER を使用してテープ出力を DASD にコピーする方法を示しま
す。スタンドアロン・ダンプ・テープ出力を DASD にコピーする 2 つの利点は次
のとおりです。
v スタンドアロン・ダンプが早々に終了し、スタンドアロン・ダンプ出力
(SYSUT1) にファイルの終了が書き出されていない場合は、SYSUT2 データ・セ
ットにはファイルの終了が含まれています。(SYSUT2 はスタンドアロン・ダンプ
出力がコピーされるデータ・セットです。) これは SYSUT2 が別テープの場合で
も起こります。IEBGENER は SYSUT1 の入出力エラーで終了することがありま
す。これは、SYSUT1 がファイルの終了を含まない場合には正常なことです。
v SYSUT2 を直接アクセス・データ・セットにして IPCS の入力として使用するこ
とにより、IPCS 処理時間を短縮することができます。
4-54
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
例: スタンドアロン・ダンプ出力をテープから DASD にコピーする
次の JCL を使用して IEBGENER ユーティリティーを呼び出します。このユ
ーティリティーはスタンドアロン・ダンプ出力をテープから DASD データ・
セットにコピーします。
//SADCOPY
//COPY
//SYSPRINT
//SYSIN
//SYSUT1
//
//
//SYSUT2
//
//
//
JOB MSGLEVEL=(1,1)
EXEC PGM=IEBGENER
DD SYSOUT=A
DD DUMMY
DD
DSN=SADUMP.TAPE,UNIT=tape,
VOL=SER=SADOUT,LABEL=(,NL),DISP=SHR,
DCB=(RECFM=FBS,LRECL=4160,BLKSIZE=29120)
DD
DSN=SADUMP.COPY,UNIT=dasd,
VOL=SER=SADCPY,DISP=(NEW,CATLG),
DCB=(RECFM=FBS,LRECL=4160,DSORG=PS),AVGREC=K,
SPACE=(4160,(8,4),RLSE)
注: AVGREC= を指定するには、SMS が実行されている必要がありますが、デ
ータ・セットは SMS 管理対象である必要はありません。
DASD からのコピー
次の例は IEBGENER を使用して、DASD 出力を DASD データ・セットにコピー
する方法を示しています。ダンプが正しくコピーされたら、AMDSADDD REXX ユ
ーティリティーを使用してダンプ・データ・セットをクリアし (再初期設定し)、そ
れが別のスタンドアロン・ダンプで使用できるようにしてください。詳しくは、以
下を参照してください。
v 「z/OS MVS IPCS ユーザーズ・ガイド」内の IPCS ダイアログの SADMP オプ
ション
v
4-28 ページの『AMDSADDD ユーティリティーの使用』
例: スタンドアロン・ダンプ出力をテープから DASD にコピーする
次の JCL を使用して IEBGENER を呼び出してください。このプログラムは
スタンドアロン・ダンプ出力を DASD データ・セットから別の DASD デー
タ・セットにコピーします。
//SADCOPY
//COPY
//SYSPRINT
//SYSIN
//SYSUT1
//
//SYSUT2
//
//
//
//
JOB MSGLEVEL=(1,1)
EXEC PGM=IEBGENER
DD SYSOUT=A
DD DUMMY
DD
DSN=SYS1.SADMP,UNIT=DASD,
VOL=SER=SADMP1,DISP=SHR
DD
DSN=SYS2.SADMP,UNIT=DASD,
DISP=(NEW,CATLG),
VOL=SER=SADMP2,
DCB=(LRECL=4160,BLKSIZE=20800,RECFM=FBS,DSORG=PS),
SPACE=(CYL,(90,0),RLSE)
第 4 章 スタンドアロン・ダンプ
4-55
スタンドアロン・ダンプ
複数ダンプ・データ・セットからのコピー
スタンドアロン・ダンプ・プログラムを使用すると、ダンプを複数のダンプ・デー
タ・セットに置くことができます。この場合、IPCS を使用してスタンドアロン・ダ
ンプを表示したい場合は、すべてのダンプ・データ・セットを 1 つの DASD デー
タ・セットに集結する必要があります。
例: スタンドアロン・ダンプを複数の DASD データ・セットからコピーする
次の JCL を使用して IPCS COPYDUMP サブコマンドを呼び出し、スタンド
アロン・ダンプ出力を 3 つの DASD ダンプ・データ・セットから別のデー
タ・セットにコピーすることができます。2 つのダンプ・データ・セットがボ
リューム SADMP1 にあり、3 番目のダンプ・データ・セットがボリューム
SADMP2 にあることに注意してください。
//SADCOPY JOB MSGLEVEL=(1,1)
//COPY
EXEC PGM=IKJEFT01
//IPCSDDIR DD DISP=SHR,DSN=D10IPCS.IPCS.DMPDIR
//SYSTSPRT DD SYSOUT=A
//COPYFROM DD DSN=SADMP1.DDS1,DISP=SHR,UNIT=DASD,VOL=SER=SADMP1
//
DD DSN=SADMP1.DDS2,DISP=SHR,UNIT=DASD,VOL=SER=SADMP1
//
DD DSN=SYS1.SADMP,DISP=SHR,UNIT=DASD,VOL=SER=SADMP2
//COPYTO
DD DSN=SADUMP.COPY,UNIT=DASD,
//
VOL=SER=SADCPY,DISP=(NEW,CATLG),
//
DCB=(RECFM=FBS,LRECL=4160,BLKSIZE=4160),
//
SPACE=(4160,(8000,4000),RLSE)
//SYSTSIN DD *
IPCS NOPARM
COPYDUMP OUTFILE(COPYTO) INFILE(COPYFROM) NOCONFIRM
END
/*
4-56
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
例: スタンドアロン・ダンプ出力を DASD とテープからコピーする
次の JCL を使用して IPCS COPYDUMP サブコマンドを呼び出し、スタンド
アロン・ダンプ出力を 2 つの DASD ダンプ・データ・セットと 2 つのテー
プ・ボリュームから 1 つの DASD データ・セットにコピーすることができま
す。
//SADCOPY JOB MSGLEVEL=(1,1)
//COPY
EXEC PGM=IKJEFT01
//IPCSDDIR DD DISP=SHR,DSN=D10IPCS.IPCS.DMPDIR
//SYSTSPRT DD SYSOUT=A
//COPYFROM DD DSN=SYS1.SADMP.MAIN.DDS1,DISP=SHR,UNIT=DASD,
//
VOL=SER=SADMP1
//
DD DSN=SYS1.SADMP.ALTERNAT.DDS1,DISP=SHR,UNIT=DASD,
//
VOL=SER=SADMP2
//
DD DSN=SYS1.SADMP.MAIN.DDS1,DISP=SHR,UNIT=TAPE,
//
VOL=SER=SADMP3
//
DD DSN=SYS1.SADMP.ALTERNAT.DDS1,DISP=SHR,UNIT=TAPE,
//
VOL=SER=SADMP4
//COPYTO
DD DSN=SADUMP.COPY,UNIT=DASD,
//
VOL=SER=SADCPY,DISP=(NEW,CATLG),
//
DCB=(RECFM=FBS,LRECL=4160,BLKSIZE=20800),
//
SPACE=(2080,(1600,800),RLSE)
//SYSTSIN DD *
IPCS NOPARM
COPYDUMP OUTFILE(COPYTO) INFILE(COPYFROM) NOCONFIRM
END
/*
注: 上記 JCL で、
v BLKSIZE=20800 は 3380 に最適です。
v BLKSIZE=24960 は 3390 に最適です。
スタンドアロン・ダンプ出力の表示
IPCS を使用して、スタンドアロン・ダンプ出力を端末装置で表示することができま
す。次の手順に従ってください。
1. IPCS セッションを開始してください。
2. 「IPCS Primary Option Menu」パネルで SUBMIT オプションを選択し、ダンプ
をコピーし初期のダンプ分析を行ってください。
3. 「IPCS Primary Option Menu」パネルに戻ってください。DEFAULTS オプショ
ンを選択してください。
4. IPCS は「IPCS Default Values」パネルを表示します。Source 行にダンプを含む
データ・セットの名前を入力してください。
5. 「IPCS Primary Option Menu」パネルに戻ってください。ダンプを表示するため
に、BROWSE、ANALYZE、または COMMAND オプションを選択してくださ
い。
参照
IPCS サブコマンドについての情報は、「z/OS MVS IPCS コマンド」を参照してく
ださい。
第 4 章 スタンドアロン・ダンプ
4-57
スタンドアロン・ダンプ
スタンドアロン・ダンプ出力の印刷
IPCS を使用して、スタンドアロン・ダンプの分析またはダンプ全体を印刷すること
ができます。
バッチ・モードでダンプの分析を印刷する場合は、次の手順に従ってください。
1. IPCS セッションを開始してください。
2. 「IPCS Primary Option Menu」パネルで SUBMIT オプションを選択し、ダンプ
をコピーし初期のダンプ分析を行ってください。
3. 「IPCS MVS/ESA™ Dump Batch Job Option Menu」パネルで、要求されている
情報を入力してください。
4. 次のパネルでは、sysout 出力クラスを入力してください。IPCS はダンプ分析を
指定した出力クラスに書き込みます。
5. システムはダンプを出力クラスの印刷出力に印刷します。
バッチ・モードでダンプ全体を印刷する場合は、次の手順に従ってください。
1. IPCS CLIST BLSCBSAP を使用してください。
参照
IPCS パネル、および CLIST BLSCBSAP については、「z/OS MVS IPCS ユーザー
ズ・ガイド」を参照してください。
例: 不定様式スタンドアロン・ダンプの印刷
次の例は IPCS CLIST を実行します。
v スタンドアロン・ダンプを IEFRDER DD ステートメントに定義したテー
プ・データ・セットから、カタログされた SA1DASD という名前の直接ア
クセス・データ・セットにコピーします。
v ダンプの解析とフォーマット設定を行います。
v フォーマット設定されたダンプ出力を IPCSPRNT という名のデータ・セッ
トに書き込みます。IPCS が使用する TSO/E CLIST は、この印刷された出
力データ・セットを、次の手順で sysout 印刷クラスに割り振ります。
ALLOCATE DDNAME(IPCSPRNT) SYSOUT(A)
CLIST を実行後、ダンプは、追加のジョブ・フォーマットのために SA1DASD
データ・セットを使用可能です。
//PRINTJOB JOB MSGLEVEL=1,REGION=800M
//IPCS
EXEC IPCS,CLIST=BLSCBSAP,DUMP=SA1DASD
//IEFPROC.IEFRDER DD DSN=SA1,DISP=OLD,UNIT=3490
//
VOL=SER=12345,LABEL=(1,NL)
/*
4-58
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
メッセージ出力
スタンドアロン・ダンプ・プログラムからのメッセージ出力は、3 つのタイプがあ
ります。次のとおりです。
v AMDSADMP からの MNOTES
v 3480、3490、または 3590 表示装置のメッセージ
v システム・コンソールまたはオペレーター・コンソールのメッセージ
参照
システム・コンソールまたはオペレーター・コンソールに表示されるメッセージの
詳細については、LookAt を使用するか、「MVS システム・メッセージ」を参照し
てください。
3480、3490、または 3590 表示装置上のスタンドアロン・ダンプ・メッセ
ージ
スタンドアロン・ダンプ出力が 3480、3490、または 3590 磁気テープ・サブシステ
ムに送信される場合、スタンドアロン・ダンプはサブシステムの 8 文字のメッセー
ジに表示して、オペレーターへの通知とプロンプトの指示を行います。メッセー
ジ・ディスプレイの左端の位置は、要求されるオペレーターの処置を示します。8
番目の位置 (右端) は追加情報を指定します。
以下にリストされるメッセージの中で、交互メッセージは、表示装置上で順番にフ
ラッシュしているメッセージが 2 つあることを示します。明滅メッセージは、表示
装置に繰り返される 1 つのメッセージです。
表示装置上に表示される可能性のあるスタンドアロン・ダンプ・メッセージは次の
とおりです。
Dvolser (交互)
MSADMP#U
ラベル付きテープは使用できず新しいテープを取り付ける必要があることを、オ
ペレーターに通知します。
MSADMP#U (明滅)
新しいテープを取り付けるように、オペレーターに要求します。
RSADMP#U (明滅)
スタンドアロン・ダンプ・プログラムがテープへの書き込みを終了したことを示
します。
RSADMP# (交互)
MSADMP#U
リール終わり条件が生じたので新しいテープを取り付ける必要があることを、オ
ペレーターに通知します。
SADMP# (明滅)
スタンドアロン・ダンプがテープを使用中であることを示します。
SADMP# (交互)
NTRDY
何らかタイプの介入が必要であることをオペレーターに通知します。
第 4 章 スタンドアロン・ダンプ
4-59
スタンドアロン・ダンプ
メッセージで使用される記号は次のとおりです。
#
スタンドアロン・ダンプ用に取り付けられたカートリッジの実際の数を示す
変数です。カートリッジの終わり条件が生じるごとに 1 から 1 つずつ増加
する 10 進数です。# 値が 9 を超えると 0 にリセットされます。
D
テープを取り外し、スクラッチ・テープなどの、今後のシステム使用のため
にそれを保存します。スタンドアロン・ダンプはそのテープに書き込みませ
ん。
M
新しいテープを取り付けてください。
R
テープを取り外し、スタンドアロン・ダンプの今後の使用のためにそれを保
存してください。
U
新しいテープはファイル保護されていてはなりません。
volser 既存のテープ・ラベルにあるボリューム通し番号を示す変数です。
スタンドアロン・ダンプ出力の分析
このセクションでは、スタンドアロン・ダンプからの出力を分析する方法を説明し
ます。スタンドアロン・ダンプは、次のタイプの問題を示す場合があります。
v 割り込み可能待ち状態
v 割り込み禁止待ち状態
v 使用可能ループ
v 使用不能ループ
このセクションの情報を使用して、システムが遭遇した問題のタイプを判別してく
ださい。問題のタイプが判別できたら、その問題のタイプの診断の詳細について、
z/OS Problem Management を参照してください。
このセクションのトピックは次のとおりです。
v 『初期データの収集』
v 4-64 ページの『使用可能待機の分析』
v 4-68 ページの『使用不能待ち状態の分析』
v 4-69 ページの『使用可能ループの分析』
v 4-70 ページの『使用不能ループの分析』
v
v 4-71 ページの『第 1 レベル割り込みハンドラーが保管する問題データ』
初期データの収集
オペレーターがスタンドアロン・ダンプを取る場合は、ダンプが取られた時点のシ
ステムの条件を判別することが重要です。スタンドアロン・ダンプはさまざまな問
題のタイプから要求されることがあるので、問題データの収集は問題の原因を判別
するために必ず必要なものです。
スタンドアロン・ダンプの出力を分析する目的は、次のとおりです。
v 症状データの収集
v システム状態の判別
v それまでのシステム活動の分析
v 障害が起こったモジュールとコンポーネントの検出
4-60
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
外部症状の収集
スタンドアロン・ダンプを取る場合は、最初にオペレーターまたはダンプを要求し
た担当者に問い合わせる必要があります。システム問題を引き起こした外部症状を
理解することが重要です。システムを停止する前に気付いたことは何であったの
か。その答えが、問題の存在する場所についてのヒントを与えてくれます。
ここで処理を続ける前に、以下の問いに答える必要があります。
v システムが待ち状態になったか ?
v コンソールは停止またはロックされたか ?
v コマンドは主コンソールで応答なしで受け入れられたか ?
v 重要なジョブまたはアドレス・スペースが停止していたか ?
IPCS 症状の収集
症状のリストを入手した後で、IPCS を使用してさらに症状データを収集してくださ
い。1 次症状ストリングは、通常スタンドアロン・ダンプでは使用できません。た
だし、IPCS で 2 次症状ストリングを追加することができます。
例: VERBEXIT SYMPTOMS 出力
次の出力では、2 次症状ストリングの説明は割り込み可能待ち状態条件を示し
ています。
* * * * S Y M P T O M * * * *
ASR10001I The dump does not contain a primary symptom string.
Secondary Symptom String:
WS/E000 FLDS/ASMIORQR VALU/CPAGBACKUP FLDS/IOSCOD VALU/CLCLC0D45
FLDS/IOSTSA VALU/CLCLDEV02
Symptom
--------------WS/E000
FLDS/ASMIORQR
VALU/CPAGBACKUP
Symptom data
------------000
ASMIORQR
PAGBACKUP
Explanation
----------Enabled wait state code
Data field name
Error related character value
システム状態の判別
スタンドアロン・ダンプを要求した場合に、システムの状態を説明し、ユーザーが
参照できる制御ブロックがいくつかあります。
制御ブロック
説明
CSD
活動状態の中央処理装置の数と代替 CPU リカバリ
ー (ACR) 機能が活動状態であるかどうかを説明し
ています。
PSA
中央処理装置、その作業単位、FRR スタック、保留
されているすべてのロックの表示についての現在の
環境を説明しています。
LCCA
保管域と割り込みハンドラーのフラグを含んでいま
す。
CVT
ほかのシステム制御ブロックへのポインターを含ん
でいます。
第 4 章 スタンドアロン・ダンプ
4-61
スタンドアロン・ダンプ
IPCS サブコマンドの STATUS WORKSHEET を使用して、システムの状態を判別
するのに役立つデータを入手してください。
例: STATUS WORKSHEET 出力
以下の出力では、次のものを探してください。
v CPU ビット・マスク。幾つのプロセッサーがオンラインかを示します。
v ダンプ時の PSW。
v PSATOLD。このフィールドがゼロの場合は、SRB が実行中であることを示し、SMPSW 内のアド
レスはタスク・ディスパッチング・プログラムの保管域を示します。これらのフィールドがゼロで
はない場合は、PSWSV 内のアドレスはタスク・ディスパッチング・プログラムの保管域を示しま
す。
v PSAAOLD。どのアドレス・スペースのジョブが実行中かを示します。
MVS Diagnostic Worksheet
Dump Title: SYSIEA01 DMPDSENQ 7/20/93
CPU Model 2064 Version 00 Serial no. 145667 Address 00
Date: 03/20/2001
Time: 05:41:26 Local
SYSTEM RELATED DATA
CVT
CSD
SNAME (154) ESYS
CUCB
(64) 00FD4B68
RTMCT (23C) 00F81198
VERID (-18)
PVTP (164) 00FE4A10
ASMVT (2C0) 00FD8030
Available CPU mask: C000
Alive CPU mask: C000
GDA (230) 01BE1168
RCEP (490) 012AA3F0
No. of active CPUs: 0002
PROCESSOR RELATED DATA
NAME
OFFSET | CPU 00
CPU 01
--------------------------+----------------------------------------PSW at time of dump
| 070E0000 070C9000
| 00000000 8124EE9C
CR0 Interrupt mask
| 5EB1EE40 5EB1EE40
CR6 I/O class mask
| FE
FE
------ LCCA --------------+----------------------------------------IHR1 Recursion
208 | 00
00
SPN1/2 Spin
20C | 0000
0000
CPUS CPU WSAVT
218 | 00F4BA00 00F6F550
DSF1/2 Dispatcher
21C | 0000
0080
CRFL ACR/LK flgs 2B4 | 00000000 00000000
------ PSA ---------------+----------------------------------------TOLD Curr TCB
21C | 00000000 00000000
ANEW ASCB
220 | 00FD3BC0 00F56180
AOLD Curr ASCB
224 | 00FD3280 00F56180
SUPER Super Bits
228 | 04000000 00000000
CLHT Lock Table
280 | 00FD4890 00FD4890
LOCAL Local lock
2EC | 00000000 00F0D700
CLHS Locks held
2F8 | 00000000 00000001
CSTK FRR stack
380 | 00F4D4D0 00000C00
SMPSW SRB Disp PSW 420 | 070C0000 070C0000
424 | 81142B60 82039000
PSWSV PSW Save
468 | 070E0000 070E0000
46C | 00000000 00000000
MODE Indicators
49F | 08
04
IPCS サブコマンド STATUS CPU REGISTERS を使用して、各中央処理装置の記憶
状況を入手することもできます。PSW の最初の半分でこれらのビットを探してくだ
さい。
4-62
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
v ビット 6 と 7 は使用不能 (04xxxxxx) または使用可能 (07xxxxxx) 条件を示しま
す。
v ビット 14 は待機 (000A0000) を示します。
v ビット 16 と 17 は 1 次、2 次のアクセス・レジスター (AR) またはホーム・モ
ードを示します。
例: STATUS CPU REGISTERS 出力
次の出力では、PSW が割り込み可能待ち状態条件を示しています。プログラ
ムは 24 ビットのアドレッシング (ビット 16 と 17 が 00 で 2 番目のワード
が 0 で始まる) の基本モードで実行しています。
CPU(X’00’) STATUS:
PSW=070E0000 00000000 NO WORK WAIT
ASCB1 at FD3280, JOB(*MASTER*), for the home ASID
ASXB1 at FD34F8 for the home ASID. No block is dispatched
CLTE: 01CB00E8
+0000 BLSD..... 00000000 XDS...... 00000000 XRES..... 00000000
+000C XQ....... 00FD4900 ESET..... 00FD4908 ULUT..... 00FD4910
CURRENT FRR STACK IS: SVC
PREVIOUS FRR STACK(S): NORMAL
GPR VALUES
0-3 00000000 00000000 00000000 00000000
4-7 00000000 00000000 00000000 00000000
8-11 00000000 00000000 00000000 00000000
12-15 00000000 00000000 00000000 00000000
ACCESS REGISTER VALUES
0-3 006FB01F 00000000 00000000 00000000
4-7 00000000 00000000 00000000 00000000
8-11 00000000 00000000 00000000 00000000
12-15 00000000 00000000 806FA03C 00000000
重要な制御ブロックからほかのフィールドを入手する場合は、IPCS サブコマンド
CBFORMAT を使用してください。
参照
CBFORMAT サブコマンドについての情報は、z/OS MVS IPCS コマンド を参照し
てください。
WHERE サブコマンドを使用して、ダンプ内の特定のエリアを識別することができ
ます。たとえば、汎用レジスターにアドレスがある場合は、WHERE サブコマンド
を使用してそのアドレスを含むモジュールは何かを判別することができます。
第 4 章 スタンドアロン・ダンプ
4-63
スタンドアロン・ダンプ
例: WHERE サブコマンド出力
次の出力では、WHERE サブコマンドはアドレスが READONLY 中核の一部
であることを示しています。
NOCPU ASID(X’0001’) 0124EE9C. IEANUC01.IGVSLIS1+0ADC IN READ ONLY NUCLEUS
使用可能待機の分析
使用可能待機はダミー待機または機能なし待機として知られています。使用可能待
機の表示は、 PSW が 070E0000 00000000 または 07060000 00000000
00000000 00000000 で、GPR がすべてゼロです。タスク・ディスパッチング・プ
ログラムがディスパッチするタスクを何も検出できない場合に使用可能待機が発生
します。リソース競合または別のエラーとの兼ね合いでシステムがタスク・ディス
パッチングできない場合に、使用可能待機が起こる場合があります。
未解決の入出力要求の調査
使用可能待ち条件についてスタンドアロン・ダンプを分析する場合は、入出力要求
の状況を調べてください。IOS 制御ブロックとすべての活動状態 UCB の表示によ
り、システムが待ち状態に遭遇した時に起きたことを判別する助けになります。
例: IOSCHECK ACTVUCBS サブコマンド出力
次の出力では、最後に HOT-I/O 検出が呼び出されたので、送信請求割り込み
が DCC-3 以外で完了したことを、HOTIO フィールドは示しています。また
IOQF と IOQL フィールドが同じで、この装置への最初と最後の要求が同じで
あることを示しています。
* * * ACTVUCBS
Processing
UCB AT 00F8B798: DEVICE 001; SUBCHANNEL 0001
UCBPRFIX: 00F8B768
-0030 RSTEM.... 00
RSV...... 08
-002D HOTIO.... 40
IOQF..... 00F7BC00
-0024 SIDA..... 0001
SCHNO.... 0001
-001E MBI...... 0000
LPM...... 80
-001A LPUM..... 80
PIM...... 80
-0014
00000000 LEVEL.... 01
-000E MIHCT.... 0000
LVMSK.... 00000001
-0004 IOQ...... 00F7BC00
* * *
MIHTI....
IOQL.....
PMCW1....
RSV......
CHPID....
IOSF1....
LOCK.....
40
00F7BC00
2888
00
21000000
00
00000000
リソース競合の分析
IPCS サブコマンドの ANALYZE を使用して、リソース競合に関連した情報を入手
することができます。このサブコマンドは I/O、ENQ、延期ロック、割り振り可能
装置と実記憶域についての競合情報を表示します。
4-64
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
例: ANALYZE サブコマンド出力
次の出力では、61 の作業単位が処理を待っています。最初の RB は待ち状態
です。
CONTENTION EXCEPTION REPORT
JOBNAME=*MASTER* ASID=0001 TCB=006E8E88
JOBNAME=*MASTER* HOLDS THE FOLLOWING RESOURCE(S):
RESOURCE #0011:There are 0061 units of work waiting for this resource
NAME=MAJOR=SYSIEA01 MINOR=DMPDSENQ SCOPE=SYSTEM
STATUS
This
Task
Top
FOR THIS UNIT OF WORK:
address space is on the SRM IN queue.
non-dispatchability flags from TCBFLGS4:
RB is in a wait
実記憶域データの獲得
IPCS RSMDATA サブコマンドを使用して、ストレージの使用状況とスタンドアロ
ン・ダンプを要求する前に発生したすべての例外条件についての情報を入手するこ
とができます。RSMDATA 出力では、使用率フィールドが 100% であれば、残され
たフレームはありません。また、使用可能な固定フレームの合計の比率が高い数に
するべきではありません。高くなる場合は、完了するために非常に多くのリソース
を使用するプログラムがあると考えられます。
例: RSMDATA 出力
次の出力では、使用可能な固定フレームの合計の比率は 25% です。
R S M
S U M
Tot real
-------In configuration . . . .
33,792
Available for allocation
32,672
Allocated . . . . . . .
32,398
Percent usage . . . . .
99
Common fixed frames . .
3,087
Percent of available .
9
Total fixed frames . . .
8,338
Percent of available .
25
M A R Y
R E P O R T
Below Prf real Dbl real
Expanded
----- -------- -------- ------------4,096
33,742
49,152
4,089
33,742
120
49,152
3,964
33,483
113
48,594
96
99
94
98
317
3,087
7
9
907
22
-
ASM 制御ブロックを調べて、入出力要求で使用できる統計を判別することができま
す。受信した入出力要求と完了した入出力要求は同じでなければなりません。
第 4 章 スタンドアロン・ダンプ
4-65
スタンドアロン・ダンプ
例: ASMCHECK 出力
次の出力では、受信された 509577 の入出力要求がすべて完了したことに注意
してください。
ASMVT AT 00FD8030
509577 I/O REQUESTS RECEIVED, 509577 I/O REQUESTS COMPLETED BY ASM
240487 NON-SWAP WRITE I/O REQUESTS RECEIVED, 240487 NON-SWAP WRITE I/O
REQUESTS COMPLETE
PART AT 01CB5310
PAGE DATA SET 0 IS ON UNIT 15B
PAGE DATA SET 1 IS ON UNIT 15B
PAGE DATA SET 3 IS ON UNIT 14A
PAGE DATA SET 4 IS ON UNIT 150
PAGE DATA SET 5 IS ON UNIT 15B
タスク・ディスパッチング可能性の判定
1 次システム・アドレス・スペースでアドレス・スペース分析を実行して、待ち状
態の作業があるかまたはアドレス・スペースが使用可能かどうかを判別することが
できます。分析すべき 1 次アドレス・スペースは、次のとおりです。
v マスター・スケジューラー、ASID 1
v CONSOLE
v JES2/JES3
v IMS/CICS/VTAM
アドレス・スペースのディスパッチ可能性を分析する場合は、以下の問題を覚えて
おく必要があります。
v サスペンドされた SRB がキューにあるか ?
ASCBSAWQ 上で WEB を実行し、X'000000' の ASCBSAWQ フィールドを持っ
た WEB を探してディスパッチ可能な SRB が存在するかどうかをチェックする
必要があります。
v ASCBTCBS または ASCBTCBL が示す作動可能な TCB があるか ?
ASCBTCBS と ASCBTCBL はディスパッチ可能な作動可能作業を含む TCB の
数を含んでいます。 ASCBTCBL 用の TCB を見つけるには、ホーム・スペース
に属する ASCBLTCS と ASCBLTCB キュー上で WEB を参照します。
v 作動可能作業がある場合は、ASCB がディスパッチ可能か (ASCBDSP1) ?
ASCBDSP1 はディスパッチ不能フラグです。ASCBDSP1 値が指示するものにつ
いての詳細は、「z/OS MVS Data Areas, Vol 1 (ABEP-DALT) 」を参照してくださ
い。
v 作動可能作業がない場合は、TCB は通常の待機か (TCBFLGS4、TCBFLGS5、
TCBNDSP) ?
これらのフィールドの非ゼロ値は、TCB がディスパッチ不能なことを示します。
4-66
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
例: SUMMARY FORMAT 出力
次の出力では、ASCBDSP1 が X'04' で、このアドレス・スペースが CML ロ
ック要求には使用できないことを示しています。ASCBSAWQ、ASCBLTCN、
および ASCBTCBS フィールドはすべてゼロで、使用できる作動可能作業がな
いことを示しています。
ASCB: 00FD2B80
+0000 ASCB.....
+000C LTCS.....
+0018 IOSP.....
+0024 ASID.....
+002A DPH......
+0038 CSCB.....
+0040 EJST.....
+0048 EWST.....
+0054 ECB......
+0060 DUMP.....
+0067 FLG1.....
+0070 SWCT.....
+0076 SRBS.....
+0080 LOCK.....
+008C MECB.....
+0098 FMCT.....
+009C XMPQ.....
+00A8 MCC......
+00B4 SRQ1.....
+00B7 SRQ4.....
+00C0 SSRB.....
+00C4 SWTL.....
+00D0 LTCB.....
+00DC LSQT.....
+00E5 TNDP.....
+00E8 LOCI.....
+00F4 SSO1.....
+00FC LTOV.....
+0106 ETCN.....
+010C STKH.....
+0118 GSYN.....
+0121 CS2......
+0128 EATT.....
+0130 INTS.....
+0139 LL2......
+013C RCMS.....
+0146 XCNT.....
+0150 ASSB.....
+0168 CREQ.....
+0171 AVM2.....
+0178 RSMA.....
ASCB
00000000
00000000
0001
01FF
00000000
0000009F
AEE06377
00000000
00699D90
00
47BE
0000
00000000
00000000
0000
00000000
00000000
00
00
0000
00000000
00000000
00000000
FF
00000000
000000
7FFD8400
0000
00FD35C0
00000000
00
0000000E
AED8EC7B
00
00000000
01F4
00FD2D00
00000000
00
02219000
FWDP.....
SVRB.....
WQID.....
LL5......
LDA......
TSB......
94659288
45A41803
UBET.....
AFFN.....
TMCH.....
DSP1.....
LLWQ.....
LSWQ.....
OUCB.....
LEVL.....
IQEA.....
JBNI.....
SRQ2.....
VGTT.....
SMCT.....
SRBT.....
LTCN.....
WPRB.....
NTSG.....
CMLW.....
SSO4.....
ATOV.....
LXR......
GQEL.....
XTCB.....
GXL......
DAC0D475
0C7C0900
LL3......
IOSC.....
NSQA.....
TCME.....
RSME.....
AGEN.....
DCTI.....
00FC4400 BWDP..... 00000000
00F4FBA8 SYNC..... 000727F4
0000
SAWQ..... 00000000
00
HLHI..... 01
7F748EB0 RSMF..... C0
00000000
00000000
FFFF
00000000
00
00000000
00000000
015178E8
03
00000000
00000000
00
00CD7458
00
000015D1
00000000
00FD2E90
FF
00000000
00
7FFDCCA8
0007
00000000
006A3D90
02449430
JSTL.....
TLCH.....
RCTF.....
ASXB.....
FLG2.....
RCTP.....
QECB.....
OUXB.....
FL2A.....
RTMC.....
JBNS.....
SRQ3.....
PCTT.....
SRBM.....
E5E32000
TCBS.....
NDP......
IODP.....
CMLC.....
ASTE.....
ETC......
AXR......
LQEL.....
CS1......
000141DE
00000000
01
00FD2EA8
CE
00000000
00000000
01517BF0
00
00000000
00FD2B18
00
1AB6F008
07
00000000
FF
FF
00000000
02900040
0007
0000
00000000
00
LL1...... 00
00
LL4...... 00
0000450A PKML..... 0000
00000000 ASM...... 00FD3520
00000000 GQIR..... 00000000
02219120 AVM1..... 00
0000
ARC...... 00000000
0066E2EE
参照
IHAWEB 下の WEB のマッピング・ストラクチャーについては、「z/OS MVS Data
Areas, Vol 2 (DCCB-ITZYRETC)」を参照してください。
アドレス・スペース分析の結果、作動可能作業がディスパッチ可能であれば、
ASCBDSP1 を調べてアドレス・スペースがディスパッチ可能であるかどうかを判別
します。アドレス・スペース分析の結果、ディスパッチ可能な作動可能作業がない
第 4 章 スタンドアロン・ダンプ
4-67
スタンドアロン・ダンプ
場合は、TCB を調べてそれらが通常の待機状態かどうかを判別します。
例: SUMMARY FORMAT 出力
次の出力では、TCB フィールドは最初の RB が待機状態であることを示して
います。
TCB: 00FD3608
+0000 RBP...... 006FF048 PIE...... 00000000
+000C TIO...... 00000000 CMP...... 00000000
+0018 MSS...... 7F7463A0 PKF...... 00
+0022 LMP...... FF
DSP...... FF
+0028 JLB...... 00000000 JPQ...... 006FF200
GENERAL PURPOSE REGISTER VALUES
0-3 00000001 000027C4 00009FBC 00000004
4-7 006FFF48 006FEFB8 00F6E900 0000005C
8-11 80001E52 00C0DCE8 006F5FF0 00FCF778
12-15 00FCF170 006FF348 80FCF1C0 806FF048
+0070 FSA...... 00000000 TCB...... 006FF6F0
+007C JSTCB.... 00FD3608 NTC...... 00000000
+0088 LTC...... 006FF6F0 IQE...... 00000000
+0094 TSFLG.... 00
STPCT.... 00
+0097 TSDP..... 00
RD....... 7F748F04
+00A0 STAB..... 00F0B860 TCT...... 00000000
+00AC NDSP..... 00000000 MDIDS.... 00000000
.
.
.
+014C BDT...... 00000000 NDAXP.... 00000000
Task non-dispatchability flags from TCBFLGS4:
Top RB is in a wait
DEB......
TRN......
FLGS.....
LLS......
00000000
00000000
00008004
006FFD38
TME......
OTC......
ECB......
TSLP.....
AE.......
USER.....
JSCB.....
00000000
00000000
00000000
00
7F746280
00000000
00C0BE84
00
SENV..... 00000000
使用不能待ち状態の分析
使用不能待ち状態は、エラー発生時の PSW を調べると分析できます。ビット 6 と
7 がゼロで、ビット 14 が 1 であれば、使用不能待ち状態です。待ち状態コードは
バイト 7、理由コードはバイト 5 にあります。
例: 待ち状態コードの判別
次の PSW では、待ち状態コードが X'014' で理由コードはゼロです。
PSW=000E0000
00000014
別の例では、待ち状態コードは X'064' で理由コードは X'09' です。
PSW=000A0000
00090064
z/Architecture® モードでは、PSW は次のように表示されます。
PSW=0002000 00000000 00000000 00090064
4-68
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
PSW で待ち状態コードを判別したら、その待ち状態コードに対して取ることのでき
る処置を資料で調べてください。
参照
発見した特定の待ち状態コードについては、「z/OS MVS システム・コード」を参
照してください。
文書化された待ち状態コードを見付けることができない場合は、次の 1 つを行って
ください。
v ダンプを分析し、それがスタンドアロン・ダンプ待ち状態であるかどうかを判定
する。
v PSASMPSW と PSAPSWSV を調べて、タスク・ディスパッチング・プログラム
がオーバーレイのため待ち状態 PSW をロードしたかどうかを判定する。ストレ
ージ・オーバーレイについての詳しい情報は、 7-1 ページの『第 7 章 ダンプ・
グラブ・バッグ』を参照してください。
v PSW に待ち状態をロードしたのはだれかを判定するために記憶状況レジスターを
使用する。
使用可能ループの分析
使用可能ループが発生したためにスタンドアロン・ダンプが要求されたかどうかを
判別する場合は、システム・トレース・テーブルを表示する必要があります。シス
テム・トレース・テーブル内に繰り返されたパターンがある場合は、使用可能ルー
プを示します。ただし、使用可能ループは通常はシステム障害を起こしません。下
記の条件で故障を起こす場合があります。
v SRB モード内の先行ではないループがある。
v TCB モードの優先順位の高いアドレス・スペースでループが生じた。
例: SYSTRACE 出力
次の出力では、CLKC 項目が使用可能ループを示しており、列 3 がすべて 0
なので、このループは SRB モードです。CLKC の PSW アドレスはループ・
プログラムを識別します。WHERE サブコマンドを使用して原因となるプログ
ラムを見付けてください。
01 003E 00000000
01 003E 00000000
01 003E 00000000
CLKC
CLKC
CLKC
070C0000 8100765C 00001004 00000000
070C2000 81005638 00001004 00000000
070C0000 810056E6 00001004 00000000
01 003E 00000000
CLKC
070C0000 80FF0768
00001004 00000000
01 003E 00000000
CLKC
070C0000 80FE4E34
00001004 00000000
01 003E 00000000
CLKC
070C1000 81004BB8
00001004 00000000
割り込み処理が使用可能ループ中に生じるために、保管されていた状況データはル
ープの原因となるモジュールを指し示していないかもしれません。第 1 レベル割り
込みハンドラー (FLIH) が活動状態かどうかを判定するために、PSA の PSASUPER
フィールドを調べてください。PSASUPER フィールドがゼロではない場合は、FLIH
はエラーの時点で活動状態でした。FLIH の保管域を使用して、エラー発生時の
第 4 章 スタンドアロン・ダンプ
4-69
スタンドアロン・ダンプ
PSW とレジスターを探してください。PSW の後半のアドレスは、ループ内に含ま
れるモジュールをポイントします。詳細については、 4-71 ページの『第 1 レベル
割り込みハンドラーが保管する問題データ』を参照してください。
使用不能ループの分析
使用不能ルーチンは割り込みを受け付けないので、使用不能ループはシステム・ト
レース出力では見ることはできません。通常は、使用不能ループはマルチプロセッ
サー環境でスピン・ループになります。スタンドアロン・ダンプを使用不能ループ
に関して分析する場合は、ループに含まれるモジュールを判別するために保管され
た状況データを使用してください。また、システム問題が発生してリカバリー・ル
ーチンが生成されたけれども、Logrec データ・セットに書き込むことができなかっ
た項目について、ストレージ内にある Logrec バッファーを調べてください。それ
が問題の解決のキーとなるレコードであることがよくあります。詳細については、
14-22 ページの『Logrec 記録制御バッファーからの情報の入手』を参照してくださ
い。
SLIP 作業域内の SLIP 問題データ
SLIP ACTION=WAIT トラップが一致した後で取られたスタンドアロン・ダンプで
は、接頭部保管域 (PSA) 内の PSAWTCOD フィールドがポイントする作業域で問
題データを検出することができます。
オフセット
長さ
内容
0(0)
1
RTM/SLIP 処理環境標識:
X'01': RTM1
X'02': RTM2
X'03': MEMTERM
X'04': PER
1(1)
2
論理プロセッサー ID (CPUID)
3(3)
1
オフセット 0 が 2 (RTM2) の場合、システム・マスク
4(4)
4
イベント発生時の汎用レジスター 0 から 15 へのポインター
8(8)
4
イベント発生時のプログラム状況ワード (PSW) へのポインター
12(C)
4
作業域のオフセット 0 の RTM/SLIP 処理環境標識の内容に応じて、次の 1
つ。
v オフセット 0 が 1 (RTM1) の場合、システム診断作業域 (SDWA) への
ポインター
v オフセット 0 が 2 (RTM2) の場合、リカバリー終了管理機能 2 (RTM2)
作業域 (RTM2WA) へのポインター
v オフセット 0 が 3 (MEMTERM) の場合、終了しようとしているアドレ
ス・スペース制御ブロック (ASCB) へのポインター
v オフセット 0 が 4 (PER) の場合、PER コードへのポインター
16(10)
4
イベントの発生時点でのメモリー間情報 (制御レジスター 3 と 4) へのポイ
ンター
20(14)
4
イベント発生時点でのアクセス・レジスター AR0 から AR15 へのポインタ
ー。64 ビット GPR の高位 32 ビットへのポインター、または、使用可能
でない場合は 0。詳細については、「z/OS MVS システム・コード」に記載
された『待ち状態 01B』を参照してください。
4-70
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ
第 1 レベル割り込みハンドラーが保管する問題データ
第 1 レベル割り込みハンドラー (FLIH) の 1 つで、処理が停止するかまたはエラ
ーが発生する場合は、割り込まれたプログラムの PSW とレジスターを判別する必
要があります。フィールド PSASUPER には、以下の FLIH のいずれかが制御中か
どうかを示すビットがあります。
v IO FLIH の PSAIO
v SVC FLIH の PSASVC
v 外部 FLIH の PSAEXT
v プログラム割り込み FLIH の PSAPI
次の表では、割り込まれたタスクまたは SRB の PSW およびレジスターを、各
FLIH が保管する場所を示します。
v
v 4-72 ページの『タスクのプログラム・チェックについて保管された問題データと
SRB コード』
v 4-73 ページの『タスクの I/O FLIH で保管された問題データと SRB コード』
v 4-73 ページの『タスクの外部 FLIH が保管した問題データと SRB コード』
タスクの SVC FLIH が保管した問題データと SRB コード
制御を停止するコード
保管されたデータ
データを受け取る
フィールド
制御ブロック
全 SVC、初期
汎用レジスター 7-9
PSAGPREG
PSA
問題発生の場合、汎用レジ
スター
LCCASGPR
LCCA
PSW
RBOPSW
リクエスターの RB
メモリー間状況
XSBXMCRS
XSB
PCLINK スタック・ヘッ
ダー
XSBSTKE
XSB
EAX
XSBEAX
XSB
アクセス・レジスター 0-15
STCBARS
STCB
現行リンケージ・スタック
入り口ポインター
STCBLSDP
STCB
タイプ 1 および 6 SVC
汎用レジスター 0-15
TCBGRS
TCB
タイプ 2、3、および 4
SVC
汎用レジスター 0-15
RBGRSAVE
SVRB
すべての SVC
第 4 章 スタンドアロン・ダンプ
4-71
スタンドアロン・ダンプ
タスクのプログラム・チェックについて保管された問題データと
SRB コード
制御を停止するコード
保管されたデータ
データを受け取る
フィールド
制御ブロック
初期の非再帰的プログラム
割り込み
汎用レジスター 0-15
LCCAPGR2
LCCA
PSW
LCCAPPSW
LCCA
ILC/PINT
LCCAPINT
LCCA
TEA
LCCAPVAD
LCCA
TEA AR 番号
LCCAPTR2
LCCA
制御レジスター 0-15
LCCAPCR2
LCCA
アクセス・レジスター 0-15
LCCAPAR2
LCCA
汎用レジスター 0-15
LCCAPGR1
LCCA
PSW
LCCAPPS1
LCCA
ILC/PINT
LCCAPIC1
LCCA
TEA
LCCAPTE1
LCCA
TEA AR 番号
LCCAPTR2
LCCA
制御レジスター 0-15
LCCAPCR1
LCCA
アクセス・レジスター 0-15
LCCAPAR1
LCCA
汎用レジスター 0-15
LCCAPGR3
LCCA
PSW
LCCAPPS3
LCCA
ILC/PINT
LCCAPIC3
LCCA
TEA
LCCAPTE3
LCCA
TEA AR 番号
LCCAPTR3
LCCA
制御レジスター 0-15
LCCAPCR3
LCCA
アクセス・レジスター 0-15
LCCAPAR3
LCCA
汎用レジスター 0-15
LCCAPGR4
LCCA
初期の再帰的プログラム割
り込み
ページ不在またはセグメン
ト不在処理中に発生した最
初のモニター呼び出し割り
込み
最初の全トレース・バッフ
ァー満杯割り込み
入出力を要求するページ不 レジスター
在またはセグメント不在の
アンロックされたタスク。 PSW
問題データは LCCA から移
他の状況
されます。
入出力を要求するページ不 レジスター
在またはセグメント不在の
ロックされたタスク。問題 PSW
データは LCCA から移され
他の状況
ます。
入出力を要求するページ不
在またはセグメント不在の
SRB。SRB は延期され、状
況は保管されません。
4-72
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
TCB と STCB
RB
XSB
IHSA
IHSA
IHSA の XSB
スタンドアロン・ダンプ
タスクの I/O FLIH で保管された問題データと SRB コード
制御を停止するコード
保管されたデータ
データを受け取る
フィールド
制御ブロック
初期
汎用レジスター 0-15
SCFSIGR1
SCFS
制御レジスター 0-15
SCFSICR1
SCFS
アクセス・レジスター 0-15
SCFSIAR1
SCFS
汎用レジスター 0-15
TCBGRS
TCB
PSW
RBOPSW
RB
メモリー間状況
XSBXMCRS
XSB
EAX
XSBEAX
XSB
アクセス・レジスター 0-15
STCBARS
STCB
現行リンケージ・スタック
入り口ポインター
STCBLSDP
STCB
汎用レジスター 0-15
IHSAGPRS
ロックされたアドレス・ス
ペースの IHSA
PSW
IHSACPSW
ロックされたアドレス・ス
ペースの IHSA
アクセス・レジスター 0-15
IHSAARS
ロックされたアドレス・ス
ペースの IHSA
現行リンケージ・スタック
入り口ポインター
IHSALSDP
ロックされたアドレス・ス
ペースの IHSA
メモリー間状況
XSBXMCRS
ロックされたアドレス・ス
ペースの XSB
EAX
XSBEAX
ロックされたアドレス・ス
ペースの XSB
汎用レジスター 0-15
SCFSIGR1
SCF
PSW
FLCIOPSW
PSA
アンロックされたタスク
ローカルにロックされたタ
スク
SRB と非優先 TCB
タスクの外部 FLIH が保管した問題データと SRB コード
制御を停止するコード
保管されたデータ
データを受け取る
フィールド
制御ブロック
初期
汎用レジスター 7-10
PSASLSA
PSA
ローカルにロックされたタ
スク
汎用レジスター 0-15
IHSAGPRS
IHSA
PSW
IHSACPSW
IHSA
アクセス・レジスター 0-15
IHSAARS
IHSA
現行リンケージ・スタック
入り口ポインター
IHSALSDP
IHSA
メモリー間状況
XSBXMCRS
XSB
EAX
XSBEAX
XSB
第 4 章 スタンドアロン・ダンプ
4-73
スタンドアロン・ダンプ
制御を停止するコード
保管されたデータ
データを受け取る
フィールド
アンロックされたタスク
汎用レジスター 0-15
TCBGRS
TCB
PSW
RBOPSW
RB
アクセス・レジスター 0-15
STCBARS
STCB
現行リンケージ・スタック
入り口ポインター
STCBLSDP
STCB
メモリー間状況
XSBXMCRS
XSB
EAX
XSBEAX
XSB
汎用レジスター 0-15
SCFSXGR1
SCFS
PSW
SCFSXPS1
SCFS
制御レジスター 0-15
SCFSXCR1
SCFS
アクセス・レジスター 0-15
SCFSXAR1
SCFS
汎用レジスター 0-15
SCFSXGR1
SCFS
PSW
SCFSXPS2
SCFS
制御レジスター 0-15
SCFSXCR2
SCFS
アクセス・レジスター 0-15
SCFSXAR2
SCFS
汎用レジスター 0-15
SCFSXGR3
SCFS
PSW
FLCEOPSW
PSA
制御レジスター 0-15
SCFSXCR3
SCFS
アクセス・レジスター 0-15
SCFSXAR3
SCFS
SRB と非優先 TCB
最初の再帰の場合
2 番目の再帰の場合
4-74
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
制御ブロック
第 5 章 ABEND ダンプ
ABEND ダンプでは、無許可プログラムの仮想ストレージが、高い優位で示されま
す。通常は、プログラムが処理を継続できなくなり異常終了した時にダンプが要求
されます。プログラムまたはアドレス・スペースが終了する時に、オペレーターが
ABEND ダンプを要求することもできます。
システムは 3 種類の ABEND ダンプ、すなわち 1 つの不定形式ダンプ
(SYSMDUMP) と 2 つの定様式ダンプ (SYSABEND と SYSUDUMP) を作成できま
す。これらのダンプは、プログラムが処理を続行できなくなり、終了したジョブ・
ステップの JCL に ABEND ダンプ用の DD ステートメントが組み込まれていた場
合に作成されます。組み込まれるデータは、次のものによります。
v IEAABD00、IEADMR00、および IEADMP00 parmlib メンバーでそれぞれ
SYSABEND、SYSMDUMP、および SYSUDUMP 用に提供されたパラメーター。
v システムの判断
v ABEND、CALLRTM、または SETRP マクロ・ダンプ・オプション
v IEAVTABX、IEAVADFM、または IEAVADUS インストール・システム出口の処
理
IBM は、SYSMDUMP 不定形式ダンプのご使用をお勧めします。不定形式ダンプで
は、要求されたストレージだけがデータ・セットに書き込まれ、したがって、アプ
リケーションが診断データを取り込んで速くオンラインに戻ることができるため、
ずっと効率的です。また、事前にフォーマットされたダンプでは、システムが単一
のセットのレポートを選択する必要があり、これでは、診断で問題が多く出た場合
はレポートが多すぎ、別のケースでは少なすぎることになります。不定形式ダンプ
を使用すれば、分析者が、多様なレポートからどの情報を使用するか、その情報を
どのように表示するかを決定できます。
単純な問題データが必要なプログラム問題の診断には、SYSUDUMP を使用してく
ださい。 SYSABEND ダンプでは、IBM 提供のデフォルトを使用して、
SYSUDUMP よりも、アプリケーション・プログラムの処理に関連するシステム情
報が多く提供されます。追加情報は、複雑な問題診断に、よりよく適しています。
主要トピック
ここでは、ABEND ダンプの使用法を説明する次のトピックを記載しています。
v 5-2 ページの『ABEND ダンプの一覧表』
v 5-4 ページの『ABEND ダンプの獲得』
v 5-9 ページの『ダンプの印刷と表示』
v 5-10 ページの『ABEND ダンプの内容』
v 5-18 ページの『ABEND ダンプ内容のカスタマイズ』
v 5-25 ページの『ABEND ダンプの分析』
© Copyright IBM Corp. 1988, 2008
5-1
ABEND ダンプ
ABEND ダンプの一覧表
ABEND ダンプの 3 つのタイプの早見表として、次の表を使用してください。
ABEND ダンプについて詳しい情報が必要な場合は、この表の次のセクションを参
照してください。
ダンプの獲得
ダンプの受取
ダンプ内容
SYSABEND:
DD 名が SYSABEND のデータ・セ
ット内の定様式ダンプ
デフォルトの内容は、障害を起こした
タスクの要約ダンプとその他のタス
ク・データです。 5-10 ページの
『ABEND ダンプの内容』を参照して
ください。
任意のプログラム内のアセンブラー・
v SYSOUT 内。出力クラスでの印刷
マクロ
または端末での表示
v DUMP を指定した ABEND
v テープまたは直接アクセス装置上。
v DUMP=YES を指定した SETRP
別ジョブでの印刷または端末での表
許可プログラム内のアセンブラー・マ
示
クロ
v プリンターで。(お勧めできませ
v DUMP を指定した ABEND
ん。ジョブ・ステップ中は別の作業
v DUMP=YES を指定した
用にプリンターを使用できなくなり
CALLRTM
ます。)
v DUMP=YES を指定した SETRP
詳しい情報は、 5-4 ページの
マスター権限を持つコンソールでのオ 『ABEND ダンプの獲得』を参照して
ペレーター・コマンド
ください。
v DUMP を指定した CANCEL
詳しい情報は、 5-4 ページの
『ABEND ダンプの獲得』を参照して
ください。
下記のすべてによってカスタマイズさ
れます。
v IEAADB00 parmlib メンバー
v 要求している ABEND、
CALLRTM、または SETRP マクロ
のパラメーター・リスト
v リカバリー終了マネージャー
(RTM) が呼び出すリカバリー・ル
ーチン
v SYSABEND を指定したすべての
CHNGDUMP オペレーター・コマ
ンドからの累積
v IEAVTABX、IEAVADFM、および
IEAVADUS 出口での、インストー
ル先作成ルーチン
カスタマイズについての詳しい情報
は、 5-18 ページの『ABEND ダンプ
内容のカスタマイズ』を参照してくだ
さい。
5-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
ダンプの獲得
ダンプの受取
SYSMDUMP という DD 名を持つデ
ータ・セット内の不定様式ダンプ
任意のプログラム内のアセンブラー・ v テープまたは直接アクセス装置上。
マクロ
IPCS を使用してダンプをフォーマ
v DUMP を指定した ABEND
ット設定し、印刷/表示する
v DUMP=YES を指定した SETRP
詳しい情報は、 5-4 ページの
許可プログラム内のアセンブラー・マ 『ABEND ダンプの獲得』を参照して
クロ
ください。
v DUMP を指定した ABEND
v DUMP=YES を指定した
CALLRTM
v DUMP=YES を指定した SETRP
SYSMDUMP:
マスター権限を持つコンソールでのオ
ペレーター・コマンド
v DUMP を指定した CANCEL
ダンプ内容
デフォルトの内容は、障害を起こした
タスクの要約ダンプとシステム・デー
タです。 5-10 ページの『ABEND ダ
ンプの内容』を参照してください。
下記のすべてによってカスタマイズさ
れます。
v IEADMR00 parmlib メンバー
v 要求している ABEND、
CALLRTM、または SETRP マクロ
のパラメーター・リスト
v リカバリー終了マネージャー
(RTM) が呼び出すリカバリー・ル
ーチン
v SYSMDUMP を指定したすべての
CHNGDUMP オペレーター・コマ
ンドからの累積
詳しい情報は、 5-4 ページの
『ABEND ダンプの獲得』を参照して
ください。
v IEAVTABX 出口でのインストール
先作成ルーチン
カスタマイズについての詳しい情報
は、 5-18 ページの『ABEND ダンプ
内容のカスタマイズ』を参照してくだ
さい。
SYSUDUMP:
DD 名が SYSUDUMP のデータ・セ
ット内の定様式ダンプ
任意のプログラム内のアセンブラー・
v SYSOUT 内。出力クラスでの印刷
マクロ
または端末での表示
v DUMP を指定した ABEND
v テープまたは直接アクセス装置上。
v DUMP=YES を指定した SETRP
別ジョブでの印刷または端末での表
許可プログラム内のアセンブラー・マ
示
クロ
v プリンターで。(お勧めできませ
v DUMP を指定した ABEND
ん。ジョブ・ステップ中は別の作業
v DUMP=YES を指定した
用にプリンターを使用できなくなり
CALLRTM
ます。)
v DUMP=YES を指定した SETRP
詳しい情報は、 5-4 ページの
マスター権限を持つコンソールでのオ 『ABEND ダンプの獲得』を参照して
ペレーター・コマンド
ください。
v DUMP を指定した CANCEL
詳しい情報は、 5-4 ページの
『ABEND ダンプの獲得』を参照して
ください。
デフォルトの内容は、障害を起こした
タスクの要約ダンプです。 5-10 ペー
ジの『ABEND ダンプの内容』を参照
してください。
下記のすべてによってカスタマイズさ
れます。
v IEADMP00 parmlib メンバー
v 要求している ABEND、
CALLRTM、または SETRP マクロ
のパラメーター・リスト
v リカバリー終了マネージャー
(RTM) が呼び出すリカバリー・ル
ーチン
v SYSUDUMP を指定したすべての
CHNGDUMP オペレーター・コマ
ンドからの累積
v IEAVTABX、IEAVADFM、および
IEAVADUS 出口での、インストー
ル先作成ルーチン
カスタマイズについての詳しい情報
は、 5-18 ページの『ABEND ダンプ
内容のカスタマイズ』を参照してくだ
さい。
第 5 章 ABEND ダンプ
5-3
ABEND ダンプ
ABEND ダンプの獲得
1 つの処理で SYSABEND、SYSUDUMP、および SYSMDUMP ダンプを獲得する
ことができます。特定のタイプの ABEND ダンプを獲得したい場合は、正しい DD
ステートメントをユーザーの JCL で指定してください。
v SYSABEND ダンプの場合、
//SYSABEND
DD ...
v SYSUDUMP ダンプの場合、
//SYSUDUMP
DD ...
v SYSMDUMP d ダンプの場合、
//SYSMDUMP
DD ...
これらのステートメントについて詳しくは、「z/OS MVS JCL 解説書」を参照して
ください。
ダンプを受信し、表示するためのデータ・セットを提供してください。データ・セ
ットが提供されていない場合は、システムは ABEND ダンプについての要求を無視
します。データ・セットをセットアップする場合は、特権データを含めるかどうか
を決定してください。その場合は、データ・セットをパスワードで保護するか、あ
るいは別のセキュリティー手段を使用して、データ・セットへのアクセスを制限し
てください。
ABEND ダンプが提供する情報はアプリケーション・プログラムをデバッグするた
めの情報であるので、ダンプがアクセスできるデータは限られています。許可プロ
グラムがアクセスできる情報をダンプに入れるには、許可プログラムで特別な処理
が必要です。違反が起こると、ABEND ダンプ処理では IEA848I メッセージを出し
ます。許可データをダンプする主な機能は SDUMPX マクロを使用しますが、イン
ストール済み環境で ABEND ダンプに許可データを入れることができるように、次
の 2 つのセキュリティー FACILITY クラスが用意されています。
IEAABD.DUMPAUTH
PROGRAM 機能で保護されているプログラムにアクセスする場合に使用し
ます。
IEAABD.DMPAKEY
許可キーで実行されるプログラムの場合に使用します。
詳しくは、「z/OS Security Server RACF セキュリティー管理者のガイド」を参照し
てください。
SDUMPX マクロについて詳しくは、以下を参照してください。
v z/OS MVS Programming: Authorized Assembler Services Reference LLA-SDU
v z/OS MVS Programming: Authorized Assembler Services Guide.
ダンプのデータ・セット
いずれかの方法でデータ・セットを定義します。
v バッチ処理の場合は、ジョブ・ステップ用の JCL
5-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
v フォアグラウンド・プロセスの場合、TSO/E ユーザー ID 用のログオン・プロシ
ージャー
SYSABEND、SYSMDUMP、または SYSUDUMP の DD 名を持つ DD ステートメ
ントにデータ・セットを定義してください。データ・セットの DD 名は、ダンプが
印刷または表示される方法、ダンプ内に含めるもの、ダンプ内容のカスタマイズ方
法を決定します。最初の 2 つの効果は次のトピックで説明します。
システムは、基本順次アクセス方式 (BSAM) を使用して順次データ・セットにダン
プを書き込みます。ダンプ・データ・セットは、BSAM でサポートされる任意の装
置に配置できます。システムがダンプ・データ・セット用のデータ制御ブロック
(DCB) を提供し、DCB をオープンし、クローズすることに注意してください。
ADDRSPC=REAL の VIO
ダンプするジョブまたはステップが、ページ不能仮想記憶で稼働している場合、す
なわち JCL JOB または EXEC ステートメントで ADDRSPC=REAL を指定してい
る場合には、SYSMDUMP DD ステートメントは仮想入出力 (VIO) を指定しなけれ
ばなりません。
SYSMDUMP ダンプ用の事前割り振りデータ・セット
SYSMDUMP データ・セットに対しては任意のデータ・セット名を付けて構いませ
ん。しかし、SYS1.SYSMDPxx は特別な扱いが必要です。 DISP=SHR データ・セッ
トで SYS1.SYSMDPxx のデータ・セット命名規則を使用すると、システムは最初の
ダンプだけを書き出し、後続のすべてのダンプ要求はシステム・メッセージ
IEA849I を受けとります。データ・セットは磁気テープ装置か直接アクセス記憶装
置 (DASD) データ・セットのいずれかにすることができます。
この命名規則を使用する場合は、SYSMDUMP ダンプに、同じデータ・セットを繰
り返し使用するようにダンプ・データ・セットを管理する必要があります。後続の
ダンプでは、まず ファイルの終わり (EOF) マークを最初のレコードとして使用し
て、SYS1.SYSMDPxx データ・セットの初期設定を行う必要があります。
命名規則
必ず SYS1.SYSMDPxx を使用してください。ここで、xx は 00 から FF で、使用
するデータ・セットを識別します。
データ・セット後処置
SYS1.SYSMDPxx 命名規則を使用して DISP=SHR を指定すると、システムに最初の
ダンプのみを書き出させるようにする機能が活動化されます。
SYS1.SYSMDPxx 命名規則を使用せずに DISP=SHR を指定すると、同じデータ・セ
ットが複数ダンプのターゲットである場合に、システムは新しいダンプを古いダン
プの上に書き出します。同じジョブ・ステップ内に複数のダンプがある場合にも、
各ステップの SYSMDUMP DD ステートメントで FREE=CLOSE を指定していなけ
れば、この現象が生じます。
DISP=SHR 以外の後処置を指定すると、システムはデータ・セットが MVS のほか
のデータ・セットであると見なします。DISP=MOD を指定すると、システムは直前
第 5 章 ABEND ダンプ
5-5
ABEND ダンプ
のダンプに続いてダンプを書き出し、データ・セットには複数のダンプが含まれる
ことになります。DISP=OLD を指定すると、同じデータ・セットが複数ダンプのタ
ーゲットである場合は、システムは新しいダンプを古いダンプの上に書き出しま
す。
データ・セット管理
後続のダンプの損失を最少にするために、ユーザーのインストール・システム出口
は、SYS1.SYSMDPxx データ・セットの管理に関して下記のステップに従ってくだ
さい。
1. システム・メッセージ IEA993I を代行受信してください。システムは、ダンプ
を SYS1.SYSMDPxx データ・セットに書き出した時に、このメッセージを発行
します。
2. ダンプを別のデータ・セットにコピーしてください。
3. 最初のレコードとして EOF マークを書き込んで、SYS1.SYSMDPxx データ・セ
ットをクリアし、書き出される次の SYSMDUMP ダンプでそのデータ・セット
を使用できるようにしてください。
インストール・システム出口ルーチンは次の 1 つにすることができます。
v IEAVMXIT
v MPFLSTxx parmlib メンバーの USEREXIT パラメーターに指定した出口ルーチ
ン
v 参照 システム¥メッセージ IEA849I および IEA993I の説明は、z/OS MVS シス
テム・メッセージ 第 6 巻 (GOS-IEA) を参照してください。
v インストール・システム出口ルーチンについての情報は、「z/OS MVS 導入シス
テム出口」を参照してください。
ABEND ダンプを獲得する処理
ダンプをコード化したいジョブ・ステップごとに、下記のステップを行うと、
ABEND ダンプを獲得することができます。
1. ダンプが必要なジョブ・ステップごとに、JCL に DD ステートメントをコード
化します。ステートメントには下記の 1 つを指定することができます。
v 直接アクセス記憶装置
v SYSOUT
v テープ
v プリンター (お勧めできません。ジョブ・ステップ中は別の作業用にプリンタ
ーを使用できなくなります。)
5-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
例: 直接アクセス SYSMDUMP DD ステートメント
次の例は直接アクセス装置にダンプを取る例です。この例では、SYSDA は
直接アクセス記憶装置 (DASD) のインストール・システム・グループ名で
す。テープの DD ステートメントのように、ステップがどのように終了し
たかに応じて、システムはデータ・セットの削除と保持を行います。
示されている DCB 属性が存在することにより、選択された DASD にとっ
て最も効率的なブロック・サイズが、システム決定のブロック・サイズ処
理で選択されます。詳しくは、z/OS DFSMS データ・セットの使用法 を参
照してください。ご使用のシステムで、ローカルの SMS クラス選択ルー
チンを使用すると、これらの属性の指定が不要になる場合があります。
例: SYSOUT SYSABEND DD ステートメント
次の例は sysout 出力クラス A にダンプを置きます。例では、出力クラス
A は印刷クラスです。システムでそのクラスの印刷を行うと、このクラス
に書かれたダンプを印刷します。
//SYSABEND
DD
SYSOUT=A
例: テープ SYSUDUMP DD ステートメント
次の例では SYSUDUMP ダンプをスクラッチ・テープに置きます。
例の中では、TAPE がインストール・システム・グループ名です。DEFER
は、データ・セットがオープンされた場合にのみオペレーターがテープを
取りに付けることを指定します。すなわち、ダンプに必要ではない場合
は、オペレーターはテープを取り付けません。
システムはジョブ・ステップが正常に終了するとデータ・セットを削除し
ます。この場合は、ダンプを書き出さないのでデータ・セットは不要だか
らです。ステップが異常終了すると、システムはデータ・セットを保存し
ます。データ・セットにはダンプが含まれています。後のジョブ・ステッ
プまたはジョブでダンプを印刷することができます。
//SYSUDUMP
DD
DSN=DUMPDS,UNIT=(TAPE,,DEFER),DISP=(,DELETE,KEEP)
2. ダンプされるプログラムを実行するジョブ・ステップ用の JCL、または TSO/E
ユーザー ID 用のログオン・プロシージャー内に DD ステートメントを置いて
ください。
第 5 章 ABEND ダンプ
5-7
ABEND ダンプ
例: ログオン・プロシージャー内 SYSABEND DD ステートメント
次の例では、TSO/E ユーザー ID 用のログオン・プロシージャーの
SYSABEND DD ステートメントを示します。フォアグラウンドでダンプの
処理を行うためには、ログオン・プロシージャー内に、ダンプ・ステート
メントが指定されている必要があります。
システムは、ジョブ・ステップが異常終了するとデータ・セットを保存し
ます。
//SYSABEND
DD
DSN=MYID3.DUMPS,DISP=(OLD,,KEEP)
3. ABEND ダンプ用のコードを含んでいないプログラムの診断をする必要がある場
合は、下記の 1 つをコーディングしてください。
v 問題プログラムまたは許可プログラム内に、DUMP パラメーターを指定した
ABEND アセンブラー・マクロ
例: ABEND マクロ・ダンプ要求
次の例では、ユーザー完了コード 1024 でプログラムを終了しダンプを
要求するマクロを示します。
ABEND 1024,DUMP
v 問題プログラムまたは許可プログラムのリカバリー・ルーチンに、
DUMP=YES パラメーターを指定した SETRP アセンブラー・マクロ
例: SETRP マクロ・ダンプ要求
次の例では、問題プログラム用の ESTAE リカバリー・ルーチン内のマ
クロを示します。システム診断作業域のアドレス (SDWA) は、デフォル
トの位置のレジスター 1 にあります。
SETRP DUMP=YES
v 許可プログラム内に、DUMP=YES パラメーターを指定した CALLRTM アセ
ンブラー・マクロ
例: CALLRTM マクロ・ダンプ要求
次の例では許可プログラム内のマクロを示します。マクロはプログラム
を終了しダンプを要求します。レジスター 5 にはプログラム用のタスク
制御ブロック (TCB) のアドレスが含まれます。
CALLRTM TYPE=ABTERM,TCB=(5),DUMP=YES
5-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
4. すでに ABEND ダンプ用のコードを含んでいるプログラムを診断する必要があ
り、そのプログラムがすでに異常終了している場合は、ステップ 5 に進んでく
ださい。
5. すでに ABEND ダンプ用のコードを含んでいるプログラムを診断する必要があ
り、そのプログラムはまだ異常終了していない場合は、オペレーターに、マスタ
ー権限を持つコンソールから DUMP パラメーターを指定した CANCEL コマン
ドを入力するように依頼してください。
例: ジョブの取り消しとダンプの要求
ジョブを取り消してダンプを要求する場合は、次のいずれかを使用するよ
うオペレーターに依頼してください。
CANCEL
BADJOB,DUMP
CANCEL
STARTING,A=1234,DUMP
例: ユーザー ID の取り消しとダンプの要求
ユーザー ID を取り消してダンプを要求する場合は、次のいずれかを使用
するようオペレーターに依頼してください。
CANCEL
U=MYID3,DUMP
CANCEL
U=*LOGON*,A=5678,DUMP
6. システムはステップ 1 で定義されたデータ・セットに定様式ダンプを書き出し
ます。
ダンプの印刷と表示
次のようにして様々なタイプの ABEND ダンプを印刷するか表示することができま
す。
SYSABEND と SYSUDUMP ダンプ
これらの 2 つのダンプは作成時にフォーマット設定されます。次のいずれかの場合
があります。
v SYSOUT データ・セット内にある。システムがその出力クラスを印刷する場合に
ダンプが印刷されます。端末装置で表示する場合は、JES SPOOL データ・セッ
トの表示を行う機能を使用してください。
v テープまたは直接アクセス・データ・セット上にある。別のジョブまたはジョ
ブ・ステップでダンプを印刷するか、またはダンプを含むデータ・セットを端末
装置でブラウズして、端末装置でダンプを表示します。
第 5 章 ABEND ダンプ
5-9
ABEND ダンプ
ダンプを印刷する簡単な方法は、前のジョブ・ステップが異常終了して、ダンプ
を要求した場合にのみ実行される後続のジョブ・ステップで、印刷を要求するこ
とです。この場合は、JCL EXEC ステートメントの COND パラメーターを使用
してください。
v プリンターに直接送られる場合。これはお勧めできません。ジョブ・ステップ中
は、ダンプが書き出される場合もそうでない場合も、別の作業用にプリンターを
使用できなくなります。
例: IEBPTPCH を使用してダンプを印刷する
次の JCL は IEBPTPCH 機能を使用して、定様式ダンプ・データ・セットを印
刷します。この例では、SYSABEND ダンプが印刷されます。同じ JCL を
SYSUDUMP で使用することができます。システムがダンプ作成時にダンプを
フォーマット設定するため、IEBPTPCH ユーティリティー・プログラムを使用
してこのダンプを印刷できます。
ダンプはテープ上で DUMPDS と名前が付けられたデータ・セット内にありま
す。
.
.
.
//PRINT
//SYSPRINT
//SYSUT1
//SYSUT2
//SYSIN
PRINT
/*
EXEC PGM=IEBPTPCH
DD
SYSOUT=A
DD
DSN=DUMPDS,UNIT=TAPE,DISP=(OLD,DELETE)
DD
SYSOUT=A
DD
*
PREFORM=A,TYPORG=PS
SYSMDUMP ダンプ
このダンプは作成されたときには不定様式です。システムはダンプをテープまたは
直接アクセス装置に書き込むことができます。IPCS を使用してダンプをフォーマッ
ト設定し、それから端末装置でそれを表示するか印刷します。SYSMDUMP ダンプ
は、IPCS によって特定の要求についての特定の情報を作成することができるので、
エラーの診断に特に役立ちます。
参照 詳しくは、「z/OS MVS IPCS ユーザーズ・ガイド 」を参照してください。
ABEND ダンプの内容
プログラム用の JCL の DD 名にパラメーターを指定して、ABEND ダンプの内容
を指定することができます。ここでは IBM 提供のデフォルトの内容とカスタマイ
ズで使用できる内容を説明します。
3 つの ABEND ダンプすべてに要約ダンプが含まれますが、SYSMDUMP 要約ダン
プには SYSABEND と SYSUDUMP 要約ダンプより少ない情報が記載されていま
す。SYSUDUMP は要約ダンプのみで構成されています。SYSABEND ダンプにはタ
スク・データも含まれ、SYSMDUMP はシステム・データも含んでいます。
SYSMDUMP ダンプは同期 SVC ダンプであり、SVC ダンプ内のデータと類似のデ
ータを含んでいます。
5-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
ハイパースペース
ABEND ダンプにはハイパースペースは含まれません。ABEND ダンプにハイパー
スペースを含めるためには、ダンプされるアドレス・スペース・ストレージに、ハ
イパースペースからデータを読み取る必要があります。
エリアの追加
必要なエリアがデフォルトとして含まれていない場合は、エリアを追加する方法を
5-18 ページの『ABEND ダンプ内容のカスタマイズ』で調べてください。
現行の ABEND ダンプ・オプション
SVC ダンプと ABEND SYSABEND、SYSMDUMP、および SYSUDUMP ダンプに
ついてダンプ・モードと有効なオプションを入手するためには、DISPLAY DUMP
オペレーター・コマンドを使用します。システムはメッセージ IEE857I でモードと
オプションを表示します。
例: モードとオプションの判別
モードとオプションを要求する場合は、次のように入力します。
DISPLAY DUMP,OPTIONS
リストされているオプションが必要としているものではない場合は、CHNGDUMP
オペレーター・コマンド使用してそれらを変更してください。
参照
v DISPLAY と CHNGDUMP オペレーター・コマンドについては、「z/OS MVS シ
ステム・コマンド」を参照してください。
v これらのメッセージの説明については、LookAt を使用するか、「MVS System
Messages」を参照してください。
ABEND ダンプのデフォルトの内容
3 つの ABEND ダンプの内容を、次の 2 つの表で詳しく説明します。下記の表で
は、ダンプ内のエリアを指定するパラメーターごとにダンプ内容を英字順に示しま
す。ダンプを選択する場合は、潜在しているエラーを診断するためにどのエリアを
使用するかを決定してください。表内でそのエリアを検出します。ダンプの下の欄
の記号は、そのダンプでエリアを獲得するための方法を示します。記号の意味は次
のとおりです。
D
IBM 提供のデフォルトの値の内容
M
ダンプを要求するマクロで使用できる
P
ダンプ・オプションを制御する parmlib メンバーで使用できる
X
ダンプ・タイプのオプションを変更する CHNGDUMP オペレーター・コマ
ンドで使用できる
第 5 章 ABEND ダンプ
5-11
ABEND ダンプ
パラメーター
ダンプ内容
ALL
SYSMDUMP ダンプ
で使用できるすべて
のダンプ・オプショ
ン、ただし NOSYM
と ALLNUC オプシ
ョンは除く
ALLNUC
DAT オンと DAT
オフの中核
ALLPA
次のリンク・パック
域すべて
v ジョブ・パック・
SYSUDUMP への
ABEND ダンプ
SYSABEND への
ABEND ダンプ
SYSMDUMP への
ABEND ダンプ
X
P X
M P X
D M P X
M
エリア (JPA)
v ダンプされるタス
ク用に活動化され
ているリンク・パ
ック域 (LPA)
v 関連する監視プロ
グラム呼び出し
(SVC) モジュー
ル
ALLPDATA
すべてのプログラ
ム・データ・エリア
P X
P X
ALLSDATA
すべてのシステム・
データ・エリア
P X
P X
P
ALLVNUC
以下を含む仮想制御
プログラム中核全体
v 接頭部付き保管域
(PSA)
v システム・キュ
M P X
M P X
M
M P X
D M P X
M
ー・エリア
(SQA)
v ローカル・システ
ム・キュー・エリ
ア (LSQA)
5-12
CB
ダンプされるタスク
の制御ブロック
CSA
共通サービス・エリ
ア (CSA) (サブプー
ル 227、228、
231、241)
DM
ダンプされるタスク
のデータ管理制御ブ
ロック
v データ制御ブロッ
ク (DCB)
v データ・エクステ
ント・ブロック
(DEB)
v 入出力ブロック
(IOB)
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
P X
M P X
D M P X
M
ABEND ダンプ
パラメーター
ダンプ内容
ENQ
ダンプされるタスク
のグローバル・リソ
ース逐次化制御ブロ
ック
v グローバル・キュ
SYSUDUMP への
ABEND ダンプ
SYSABEND への
ABEND ダンプ
P X
D P X
M P X
D M P X
SYSMDUMP への
ABEND ダンプ
ー制御ブロック
v ローカル・キュー
制御ブロック
ERR
ダンプされるタスク
のリカバリー終了マ
ネージャー (RTM)
制御ブロック
v RTM の拡張エラ
M
ー記述子 (EED)
v システム診断作業
域 (SDWA) から
のレジスター
v RTM2 作業域
(RTM2WA)
v タスクの非同期出
口設定 (STAE)
制御ブロック
(SCB)
GRSQ
ダンプされるタスク
のグローバル・リソ
ース逐次化制御ブロ
ック
v グローバル・キュ
ー制御ブロック
v ローカル・キュー
P X
制御ブロック
IO
ダンプされるタスク
の入出力監視プログ
ラム (IOS) 制御ブ
ロック
v 実行チャネル・プ
ログラム・デバッ
グ・エリア
(EXCPD)
v 装置制御ブロック
(UCB)
M P X
D M P X
M
JPA
ジョブ・パック・エ
リア (JPA): モジュ
ール名と内容
M P X
M P X
M
LPA
活動リンク・パック
域 (LPA): モジュー
ル名と内容
M P X
M P X
M P X
第 5 章 ABEND ダンプ
5-13
ABEND ダンプ
SYSUDUMP への
ABEND ダンプ
SYSABEND への
ABEND ダンプ
SYSMDUMP への
ABEND ダンプ
パラメーター
ダンプ内容
LSQA
アドレス・スペース
に割り振られたロー
カル・システム・キ
ュー域 (LSQA) (サ
ブプール 203 205、 213 - 215、
223 - 225、
229、230、 233 235、 249、 253 255)
M P X
D M P X
D M P X
NOSYM
症状ダンプなし (メ
ッセージ IEA995I)
P X
P X
P X
NUC
制御プログラム中核
の読み取り/書き込
み部分 (すなわち、
DAT-on 中核の非ペ
ージ保護エリアの
み)、次のものを含
みます。
v コミュニケーショ
ン・ベクトル・テ
M P X
M P X
D M P X
ーブル (CVT)
v ローカル・システ
ム・キュー・エリ
ア (LSQA)
v 接頭部付き保管域
(PSA)
v システム・キュ
ー・エリア
(SQA)
5-14
PCDATA
タスクに関するプロ
グラム呼び出し情報
M P X
M P X
M
PSW
ダンプが要求された
時のプログラム状況
ワード (PSW)
M P X
D M P X
M P X
Q
ダンプされるタスク
のグローバル・リソ
ース逐次化制御ブロ
ック
v グローバル・キュ
ー制御ブロック
v ローカル・キュー
制御ブロック
M
M
M
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
パラメーター
ダンプ内容
REGS
ABEND の入り口す
なわちダンプが要求
された時のレジスタ
ー
v アクセス・レジス
SYSUDUMP への
ABEND ダンプ
M P X
SYSABEND への
ABEND ダンプ
D M P X
SYSMDUMP への
ABEND ダンプ
M
ター
v 浮動小数点レジス
ター
v 汎用レジスター
v ベクトル機能を使
用するタスクに関
するベクトル・レ
ジスター、ベクト
ル状況レジスタ
ー、およびベクト
ル・マスク・レジ
スター
RGN
ダンプされる各アド
レス・スペースの専
用エリア内に割り振
られたページ
サブプール 0 127、129 - 132、
203 - 205、
213 - 215、
223 - 225、
229、230、236、
237、244、 249、
251 - 255 を含む
SA または SAH
保管域リンケージ情
報、プログラム呼び
出しリンケージ情
報、および保管域の
上方トレース
M P X
D M P X
M
SPLS
ダンプされるタスク
に対し、ユーザー・
サブプール 0 127、129 - 132、
244、251、および
252 に割り振られた
ストレージ
M P X
D M P X
M
D P X
SYSABEND または
SYSUDUMP ダンプ
に関してマクロ・パ
ラメーター・リスト
に指定する
SUBPLST が要求さ
れているダンプに関
してのみ、ダンプ・
オプション・リスト
の SPLS を指定変
更することに注意し
てください。
第 5 章 ABEND ダンプ
5-15
ABEND ダンプ
パラメーター
ダンプ内容
SQA
割り振られたシステ
ム・キュー・エリア
(SQA) (すなわち、
サブプール
226、239、245、
247、248)
SYSUDUMP への
ABEND ダンプ
SYSABEND への
ABEND ダンプ
SYSMDUMP への
ABEND ダンプ
M P X
M P X
D M P X
SQA 内の障害を起
こした制御ブロック
には、次のものが含
まれます。
v アドレス・スペー
ス制御ブロック
(ASCB)
v ジョブ・スケジュ
ーラー・アドレ
ス・スペース制御
ブロック (JSAB)
SUBTASKS
ダンプされるタス
ク、およびそのすべ
てのサブタスクのプ
ログラム・データに
使用されるストレー
ジ
M P X
M P X
D M
SUM
要約ダンプ、
『ABEND ダンプ内
の要約ダンプのデフ
ォルトの内容』を参
照
D M P X
D M P X
D M P X
SWA
スケジューラー作業
域 (SWA) (すなわ
ち、サブプール 236
と 237)
M P X
M P X
D M P X
TRT
使用可能なシステ
ム・トレースおよび
汎用トレース機能
(GTF) トレース
M P X
D M P X
使用可能なシステ
ム・トレース
D M P X
ABEND ダンプ内の要約ダンプのデフォルトの内容
要約ダンプのみが必要な場合、カスタマイズなしに SYSUDUMP ダンプを取得すれ
ば、表示されます。要約ダンプが別のダンプ・オプションと結び付くと、要約ダン
プ情報はダンプ全体に分散します。
次の表で S は、そのダンプ・タイプで要約ダンプが使用できることを示します。
5-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
ABEND
ダンプ
SYSUDUMP
ABEND
ダンプ
SYSABEND
ABEND
ダンプ
SYSMDUMP
完了コード: ABEND マクロがダンプを要求した場合の、シ
ステムまたはユーザー完了コードと、存在する場合は関連す
る理由コード
S
S
S
下記のものを含む、障害を起こしたタスク用の制御ブロック
v ASCB (アドレス・スペース制御ブロック)
v CDE (内容登録簿項目)
v LLE (ロード・リスト・エレメント)
v RB (要求ブロック)
v TCB (タスク制御ブロック)
v TIOT (タスク入出力テーブル)
v XL (エクステント・リスト)
S
S
リカバリー終了マネージャー (RTM) 用の制御ブロック
v RTM の EED (拡張エラー記述子)
v システム診断作業域 (SDWA) からのレジスター
v RTM2WA (RTM2 作業域)
v SCB (タスクの非同期出口設定 (STAE) 制御ブロック)
S
S
要約ダンプの内容
AMDDATA マクロがマップするダンプ・ヘッダー
S
S
ダンプ索引
S
S
ダンプの表題: ダンプするジョブとステップ、ダンプの時刻
と日付、ダンプ ID、およびプロセッサー
S
S
S
v 名前
S
S
S
v モジュールの内容
S
S
v 障害を起こした命令についてのロード・モジュール内のオ S
フセット
S
v 最後の PRB 内でポイントされるモジュール (プログラム S
要求ブロック)
S
ABEND の入り口すなわちダンプが要求された時点での
PSW (プログラム状況ワード)
S
S
S
ABEND の入り口すなわちダンプが要求された時のレジスタ
ー
S
S
S
レジスターの内容の保管域
S
S
PSW が活動状態のロード・モジュールをポイントしている
場合は、ロード・モジュール
PSW には、障害を起こした命令の命令長コードと割り込み
コードが含まれます。
第 5 章 ABEND ダンプ
5-17
ABEND ダンプ
ABEND
ダンプ
SYSUDUMP
要約ダンプの内容
ストレージ: PSW 内のアドレス、およびレジスター内のアド S
レスの 4 キロバイト前と 4 キロバイト後
ABEND
ダンプ
SYSABEND
ABEND
ダンプ
SYSMDUMP
S
S
ダンプは、ユーザーがアクセスを許可されているストレージ
についてのみアドレス昇順に示します。重複しているアドレ
スは除去されます。
ダンプされたアドレス・スペースについてのシステム・トレ
ース・テーブル項目
S
S
TCB の要約: ダンプしているアドレス・スペース内のタスク S
制御ブロック (TCB) からの情報
S
仮想ストレージ・マップ: ダンプしているアドレス・スペー
ス内のサブプール
v サブプール番号
v サブプール・キー
v 占有または共用タスク制御ブロック (TCB)
v 各割り振られたエリアの開始アドレスと長さ
v 各フリー・エリアの開始アドレスと長さ
S
S
ABEND ダンプ内容のカスタマイズ
ABEND ダンプ用のデータ・セットの DD 名によって、内容をカスタマイズする方
法が決まります。
システムは、ダンプのそのタイプ用に保持しているオプション・リストから特定の
ABEND ダンプの内容を判別します。ダンプ・オプション・リストは、次の表に示
されるいずれの方法でもカスタマイズすることができます。たとえば、ABEND マ
クロ用に書かれた SYSMDUMP ABEND ダンプを、本書に説明されているデフォル
トの SYSMDUMP ABEND ダンプと全く異なるものとすることができます。
参照
v parmlib メンバーについては、「z/OS MVS 初期設定およびチューニング 解説
書」を参照してください。
v CHNGDUMP オペレーター・コマンドについては、「z/OS MVS システム・コマ
ンド」を参照してください。
v ABEND、SETRP、SNAP、SNAPX、ESTAE、ESTAEX、および ESTAI マクロを
指定した ATTACH または ATTACHX マクロについては、「z/OS MVS プログラ
ミング: アセンブラー・サービス 解説書 ABE-HSP」と「z/OS MVS プログラミン
グ: アセンブラー・サービス解説書 第 2 巻 (IARR2V-XCTLX) 」を参照してくだ
さい。
v SETRP と CALLRTM マクロについては、「z/OS MVS Programming: Authorized
Assembler Services Reference SET-WTO」と、「z/OS MVS Programming:
Authorized Assembler Services Reference ALE-DYN 」を参照してください。
v IEAVTABX、IEAVADFM、および IEAVADUS インストール・システム出口につ
いては、「z/OS MVS 導入システム出口」を参照してください。
5-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
ABEND ダンプのカスタマイズについての推奨事項
インストール・システムでダンプをどのようにカスタマイズするかは、各ダンプの
タイプを通常使用する方法によります。ABEND ダンプについての IBM 提供のダ
ンプ・オプションは、次の目的で設計されています。
v SYSABEND ダンプ: オペレーティング・システムのもとで実行している任意のプ
ログラムで生じる複雑なエラーの診断用
v SYSMDUMP ダンプ: プログラム内でダンプが要求された場合の、システム問題
の診断用
v SYSUDUMP ダンプ: 単純な問題データが必要なプログラム問題の診断用
SYSUDUMP ダンプの場合は、IBM 提供の IEADMP00 メンバーはデフォルトの内
容を要約ダンプのみというように指定しています。インストール・システムでは
IEADMP00 メンバーを提供されたとおりに使用することを考えてください。単純な
問題については小さいダンプが提供されるようにするためです。
ダンプ内のプログラム・エリア
特定のプログラムについて意味あるダンプを要求する場合は、マクロ・パラメータ
ー・リストをポイントする ABEND マクロをコーディングしてください。異常終了
したプログラムを診断するために必要なデータ・エリアをリストで指定してくださ
い。ダンプ用の parmlib メンバー内には指定しません。2 つの例を示します。
v 終了するタスクがサブタスクを持ち、そのサブタスクがエラーを起こす場合は、
サブタスクをダンプするためにマクロ・パラメーター・リストに
PDATA=SUBTASKS を指定します。
v プログラムが使用するサブプールのみを調べる場合は、SYSABEND ダンプ用の
SUBPLST オプションにサブプール番号を指定します。SYSABEND ダンプのデフ
ォルトの値では、SPLS オプションはすべてのユーザー・サブプールを書き出し
ます。ダンプ・オプションに SPLS を指定すると、ダンプは必要以上に大きくな
る場合があります。マクロ・パラメーター・リスト内の SUBPLST が現行のダン
プ・オプション内の SPLS を指定変更します。
ダンプ内の中核域
ダンプ・オプションは、ダンプ内に出力される中核部分を制御することができま
す。ときには診断で中核すべてを解析する必要が生じる場合があります。インスト
ール・システムでダンプからすべての中核域を削除することができます。IBM 提供
のデフォルトの値を使用している場合は、SYSMDUMP ABEND ダンプには読み取
り/書き込み DAT-on 中核を含みます。
インストール・システムでは DUMP オペレーター・コマンドを入力して、DAT-off
中核のコピーを 1 つ作成し、発生するすべての問題に関して使用することができま
す。
中核域のダンプを制御する ABEND ダンプ・オプションは、次のとおりです。
ダンプ・オプション
中核域
SDATA=NUC
読み取り/書き込み DAT-on 中核
第 5 章 ABEND ダンプ
5-19
ABEND ダンプ
SDATA=ALLNUC
DAT-on 中核のすべて: 読み取り/書き込みおよび読み取り専用
SYSABEND ダンプ内容のカスタマイズ
SYSABEND カスタマイズ
効果
例
IEAABD00 parmlib メンバーの置換
(IEBUPDTE ユーティリティーを使用
する)。
IBM 提供のオプションを保存し、す
べての SYSABEND ダンプに、プロ
変更内容: IEAABD00 には IBM が提 グラム呼び出しデータとリンク・パッ
供するデフォルトのダンプ・オプショ ク域を追加する場合は、IEBUPDTE
ンが含まれます。IEAABD00 を変更
を使用して IEAABD00 メンバーに下
すると SYSABEND のダンプ・オプ
記のものを含めます。
ションが変更されます。
SDATA=(LSQA,CB,ENQ,TRT,ERR,
DM,IO,SUM,PCDATA)
PDATA=(PSW,REGS,SPLS,ALLPA,
SA,LPA)
変更が生じる時: システム初期設定時
この SYSABEND ダンプにプログラ
ム呼び出しデータとリンク・パック域
変更内容: マクロ・パラメーター・リ を追加する場合は、プログラムで次の
ABEND または CALLRTM マクロの スト・オプションが、要求されたダン ようにコーディングします。
プについてのみ、ダンプ・オプショ
DUMPOPT または DUMPOPX パラ
ABEND 76,DUMP,
メーターでパラメーター・リストをポ ン・リストに追加されます。
DUMPOPT=PARMS
イントします。通常は、リスト形式
PARMS
SNAP SDATA=PCDATA,
PDATA=LPA,MF=L
SNAP または SNAPX マクロでリス マクロ・パラメーター・リストの
SUBPLST
が、要求されたダンプにつ
トを作成します。
いてのみ、ダンプ・オプション・リス
トの SPLS を指定変更することに注
意してください。
マクロ・パラメーター・リストの使
用。
変更が生じる時: ダンプ要求時
リカバリー終了マネージャーが呼び出 変更が生じる時: ダンプの直前
すリカバリー・ルーチン
変更内容: SETRP マクロ・パラメー
v システム・コンポーネントの FRR
ター・リスト・オプションが、要求さ
(機能リカバリー・ルーチン)
れたダンプについてのみ、ダンプ・オ
v ESTAE または ESTAEX マクロま プション・リストに追加されます。
たは ATTACH または ATTACHX
マクロの ESTAI パラメーターが設
定する ESTAE/ESTAI リカバリ
ー・ルーチン
v ARR (関連したリカバリー・ルーチ
ン)
これらのルーチンは SETRP マクロを
発行します。ダンプ内容をカスタマイ
ズする場合は、SETRP マクロの
DUMPOPT または DUMPOPX パラ
メーターがパラメーター・リストをポ
イントします。通常は、リスト形式
SNAP または SNAPX マクロでリス
トを作成します。
5-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
この SYSABEND ダンプにプログラ
ム呼び出しデータとリンク・パック域
を追加する場合は、リカバリー・ルー
チンで次のようにコーディングしま
す。
PARMS
SETRP ,DUMP=YES,
DUMPOPT=PARMS
SNAP SDATA=PCDATA,
PDATA=LPA,MF=L
ABEND ダンプ
SYSABEND カスタマイズ
効果
SYSABEND パラメーターを指定した 変更が生じる時: 入力時即座に
CHNGDUMP オペレーター・コマン
ドをマスター権限を持つコンソールで 変更内容:
入力します。
ADD の場合: CHNGDUMP オプショ
ンは、IEAABD00 オプション、直前
の CHNGDUMP オプション、および
すべてのマクロ・パラメーター・リス
ト・オプションに追加されます。オプ
ションは CHNGDUMP
DEL,SYSABEND オペレーター・コマ
ンドが入力されるまで追加されたまま
です。
例
CHNGDUMP DEL,SYSABEND で変
更されるまで、すべての SYSABEND
ダンプにプログラム呼び出しデータと
リンク・パック域を追加する場合は、
次のように入力します。
CHNGDUMP SET,ADD,SYSABEND,
SDATA=PCDATA,PDATA=LPA
IEAABD00 オプションに戻る場合
は、次のように入力します。
CHNGDUMP DEL,SYSABEND
OVER の場合: CHNGDUMP オプシ
ョンは、ほかのダンプ・オプションす
べてを指定変更します。
DEL の場合: すべての CHNGDUMP
オプションが削除され、IEAABD00
のダンプ・オプションが再度使用され
ます。
SYSABEND を指定した複数の
CHNGDUMP オペレーター・コマン
ドが入力されると、効果は累積されま
す。
IEAVTABX インストール・システム
出口名リストを使用します。
IEAVADFM または IEAVADUS イン
ストール・システム出口を使用しま
す。IEAVADFM は実行しようとして
いるインストール・システム・ルーチ
ンのリストです。IEAVADUS は 1 つ
のインストール・システム・ルーチン
です。
変更が生じる時: ダンプの直前
変更内容: 現行ダンプについてのみ、
ルーチンでダンプ・オプションからオ
プションの追加または削除ができま
す。
「z/OS MVS 導入システム出口」を参
照してください。
変更が生じる時: ダンプ中。このルー 「z/OS MVS 導入システム出口」を参
チンは CB オプションを指定したダ 照してください。
ンプの制御ブロックのフォーマット設
定中に、実行します。
変更内容: このルーチンはダンプに制
御ブロックを追加することができま
す。
第 5 章 ABEND ダンプ
5-21
ABEND ダンプ
SYSMDUMP ダンプ内容のカスタマイズ
SYSMDUMP カスタマイズ
効果
例
IEADMR00 parmlib メンバーの置換
(IEBUPDTE ユーティリティーを使用
する)。
IBM 提供のオプションを保存し、す
べての SYSMDUMP ダンプに、リン
変更内容: IEADMR00 には IBM が提 ク・パック域を追加する場合は、
供するデフォルトのダンプ・オプショ IEBUPDTE を使用して IEADMR00
ンがあります。IEADMR00 を変更す メンバーに下記のものを含めます。
ると SYSMDUMP のダンプ・オプシ
SDATA=(NUC,SQA,LSQA,SWA,TRT,RGN,
ョンが変更されます。
SUM,LPA)
変更が生じる時: システム初期設定時
この SYSMDUMP ダンプにリンク・
パック域を追加する場合は、プログラ
変更内容: マクロ・パラメーター・リ ムに次のようなコーディングをしま
ABEND または CALLRTM マクロの スト・オプションが、要求されたダン す。
プについてのみ、ダンプ・オプショ
DUMPOPT または DUMPOPX パラ
ABEND 76,DUMP,
メーターでパラメーター・リストをポ ン・リストに追加されます。
DUMPOPT=PARMS
イントします。通常は、リスト形式
PARMS
SNAP PDATA=LPA,MF=L
SNAP または SNAPX マクロでリス
トを作成します。
マクロ・パラメーター・リストの使
用。
変更が生じる時: ダンプ要求時
リカバリー終了マネージャーが呼び出 変更が生じる時: ダンプの直前
すリカバリー・ルーチン
変更内容: SETRP マクロ・パラメー
v システム・コンポーネントの FRR
ター・リスト・オプションが、要求さ
(機能リカバリー・ルーチン)
れたダンプについてのみ、ダンプ・オ
v ESTAE または ESTAEX マクロま プション・リストに追加されます。
たは ATTACH または ATTACHX
マクロの ESTAI パラメーターが設
定する ESTAE/ESTAI リカバリ
ー・ルーチン
v ARR (関連したリカバリー・ルーチ
ン)
これらのルーチンは SETRP マクロを
発行します。ダンプ内容をカスタマイ
ズする場合は、SETRP マクロの
DUMPOPT または DUMPOPX パラ
メーターがパラメーター・リストをポ
イントします。通常は、リスト形式
SNAP または SNAPX マクロでリス
トを作成します。
5-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
この SYSMDUMP ダンプにリンク・
パック域を追加する場合は、リカバリ
ー・ルーチンに次のようなコーディン
グをします。
PARMS
SETRP ,DUMP=YES,
DUMPOPT=PARMS
SNAP PDATA=LPA,MF=L
ABEND ダンプ
SYSMDUMP カスタマイズ
効果
変更が生じる時: 入力時即座に
SYSMDUMP パラメーターを指定し
た CHNGDUMP オペレーター・コマ
ンドをマスター権限を持つコンソール 変更内容:
で入力します。
ADD の場合: CHNGDUMP オプショ
ンは、IEADMR00 オプション、直前
の CHNGDUMP オプション、および
マクロ・パラメーター・リスト・オプ
ションに追加されます。オプションは
CHNGDUMP DEL,SYSMDUMP オペ
レーター・コマンドが入力されるまで
追加されたままです。
例
CHNGDUMP DEL,SYSMDUMP で変
更するまで、リンク・パック域をすべ
ての SYSMDUMP ダンプに追加する
場合は次のように入力します。
CHNGDUMP SET,ADD,SYSMDUMP=(LPA)
IEADMR00 オプションに戻る場合
は、次のように入力してください。
CHNGDUMP DEL,SYSMDUMP
OVER の場合: CHNGDUMP オプシ
ョンは、ほかのダンプ・オプションす
べてを指定変更します。
DEL の場合: すべての CHNGDUMP
オプションが削除され、IEADMR00
のダンプ・オプションが再度使用され
ます。
SYSMDUMP を指定した複数の
CHNGDUMP オペレーター・コマン
ドが入力されると、効果は累積されま
す。
IEAVTABX インストール・システム
出口名リストを使用します。
変更が生じる時: ダンプの直前
変更内容: 現行ダンプについてのみ、
ルーチンでダンプ・オプションからオ
プションの追加または削除ができま
す。
「z/OS MVS 導入システム出口」を参
照してください。
SYSUDUMP ダンプ内容のカスタマイズ
SYSUDUMP カスタマイズ
効果
IEADMP00 parmlib メンバーの置換
(IEBUPDTE ユーティリティーを使用
する)。
変更が生じる時: システム初期設定時
例
要約ダンプを保存し、すべての
SYSUDUMP ダンプに、プログラム呼
変更内容: IEADMP00 には IBM が提 び出しデータとユーザー・サブプー
供するデフォルトのダンプ・オプショ ル・ストレージを追加する場合は、
ンがあります。IEADMP00 を変更す IEBUPDTE を使用して IEADMP00
ると SYSUDUMP のダンプ・オプシ メンバーに下記のものを含めます。
ョンが変更されます。
SDATA=(SUM,PCDATA)
PDATA=SPLS
第 5 章 ABEND ダンプ
5-23
ABEND ダンプ
SYSUDUMP カスタマイズ
効果
例
この SYSUDUMP ダンプにプログラ
ム呼び出しデータとユーザー・サブプ
変更内容: マクロ・パラメーター・リ ール・ストレージを追加する場合は、
ABEND または CALLRTM マクロの スト・オプションが、要求されたダン プログラムで次のようにコーディング
プについてのみ、ダンプ・オプショ
DUMPOPT または DUMPOPX パラ
します。
メーターでパラメーター・リストをポ ン・リストに追加されます。
ABEND 76,DUMP,
イントします。通常は、リスト形式
DUMPOPT=PARMS
SNAP または SNAPX マクロでリス マクロ・パラメーター・リストの
PARMS
SNAP SDATA=PCDATA,
SUBPLST が、要求されたダンプにつ
PDATA=SPLS,MF=L
トを作成します。
いてのみ、ダンプ・オプション・リス
トの SPLS を指定変更することに注
意してください。
マクロ・パラメーター・リストの使
用。
変更が生じる時: ダンプ要求時
リカバリー終了マネージャーが呼び出 変更が生じる時: ダンプの直前
すリカバリー・ルーチン
変更内容: SETRP マクロ・パラメー
v システム・コンポーネントの FRR
ター・リスト・オプションが、要求さ
(機能リカバリー・ルーチン)
れたダンプについてのみ、ダンプ・オ
v ESTAE または ESTAEX マクロま プション・リストに追加されます。
たは ATTACH または ATTACHX
マクロの ESTAI パラメーターが設
定する ESTAE/ESTAI リカバリ
ー・ルーチン
v ARR (関連したリカバリー・ルーチ
ン)
これらのルーチンは SETRP マクロを
発行します。ダンプ内容をカスタマイ
ズする場合は、SETRP マクロの
DUMPOPT または DUMPOPX パラ
メーターがパラメーター・リストをポ
イントします。通常は、リスト形式
SNAP または SNAPX マクロでリス
トを作成します。
5-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
この SYSUDUMP ダンプにプログラ
ム呼び出しデータとユーザー・サブプ
ール・ストレージを追加する場合は、
リカバリー・ルーチンで次のようにコ
ーディングします。
PARMS
SETRP ,DUMP=YES,
DUMPOPT=PARMS
SNAP SDATA=PCDATA,
PDATA=SPLS,MF=L
ABEND ダンプ
SYSUDUMP カスタマイズ
効果
変更が生じる時: 入力時即座に
SYSUDUMP パラメーターを指定し
た CHNGDUMP オペレーター・コマ
ンドをマスター権限を持つコンソール 変更内容:
で入力します。
ADD の場合: CHNGDUMP オプショ
ンは、IEADMP00 オプション、直前
の CHNGDUMP オプション、および
すべてのパラメーター・リスト・オプ
ションに追加されます。オプションは
CHNGDUMP DEL,SYSUDUMP オペ
レーター・コマンドが入力されるまで
追加されたままです。
例
CHNGDUMP DEL,SYSUDUMP で変
更されるまで、すべての SYSUDUMP
ダンプにプログラム呼び出しデータと
ユーザー・サブプール・ストレージを
追加する場合は、次のように入力しま
す。
CHNGDUMP SET,ADD,SYSUDUMP,
SDATA=PCDATA,PDATA=SPLS
IEADMP00 オプションに戻る場合
は、次のように入力します。
CHNGDUMP DEL,SYSUDUMP
OVER の場合: CHNGDUMP オプシ
ョンは、ほかのダンプ・オプションす
べてを指定変更します。
DEL の場合: すべての CHNGDUMP
オプションが削除され、IEADMP00
のダンプ・オプションが再度使用され
ます。
SYSUDUMP を指定した複数の
CHNGDUMP オペレーター・コマン
ドが入力されると、効果は累積されま
す。
IEAVTABX インストール・システム
出口名リストを使用します。
IEAVADFM または IEAVADUS イン
ストール・システム出口を使用しま
す。IEAVADFM は実行するルーチン
のリストで IEAVADUS は 1 つのイ
ンストール・システム・ルーチンで
す。
変更が生じる時: ダンプの直前
変更内容: 現行ダンプについてのみ、
ルーチンでダンプ・オプションからオ
プションの追加または削除ができま
す。
「z/OS MVS 導入システム出口」を参
照してください。
変更が生じる時: ダンプ中。このルー 「z/OS MVS 導入システム出口」を参
チンは CB オプションを指定したダ 照してください。
ンプの制御ブロックのフォーマット設
定中に、実行します。
変更内容: このルーチンはダンプに制
御ブロックを追加することができま
す。
ABEND ダンプの分析
注: SYSMDUMP ABEND ダンプは常に同期 SVC ダンプです。SYSMDUMP を分
析する場合は、 2-42 ページの『SVC ダンプの分析』を参照してください。
SYSABEND と SYSUDUMP データ・セットに書き出された ABEND ダンプは、オ
ペレーティング・システムのもとで実行しているプログラムで生じた問題を分析す
る場合に有効です。このプログラムは、次のいずれからでも呼び出すことができま
す。
第 5 章 ABEND ダンプ
5-25
ABEND ダンプ
v
v
v
v
v
インストール・システム提供のプログラム
アプリケーション・プログラム
未許可プログラム
問題プログラム
専用ストレージ内のプログラム
ABEND ダンプは次の 2 つの方法で検出された問題用に書き出されます。
v ソフトウェア検出問題。以下に例を示します。
– 呼び出されたモジュールからの非ゼロ戻りコード
– リカバリー・ルーチンが別の異常終了コードに変更する、異常終了コードが
X'0Cx' であるプログラム・チェック
– エラーのある制御ブロック・キュー
– システム・サービスへの無効な入力
v ハードウェア検出問題。リカバリー・ルーチンが別の異常終了コードに変更しな
い、異常終了コードが X'0Cx' のプログラム・チェック
分析手順
SYSABEND または SYSUDUMP を分析する場合は、次の手順に従ってください。
1. Logrec エラー・レコードの収集と分析。
異常終了したタスクに関連するすべての Logrec エラー・レコードを調べてく
ださい。早い段階でのシステム問題を示しているレコードがあるかどうかを判
定します。示しているレコードがある場合は、その問題の診断を継続します。
リカバリーとリカバリー機能委任のために、SYSABEND または SYSUDUMP
ダンプは早い段階でのシステム問題の最終結果である場合があります。
2. 問題についてのメッセージの収集と分析。 問題に関連するメッセージを選択す
るために、タイム・スタンプを使用してください。
v ジョブ・ログ
v システム・ログ (SYSLOG) または運用ログ (OPERLOG)
異常終了したタスクが実行している間に書き出された、早い時期のダンプにつ
いてのメッセージを調べてください。これらの早いダンプが早いシステム問題
を示しているかどうかを判別してください。示している場合は、その問題につ
いての診断を続行してください。
3. 次のステップの説明に従ってダンプを分析してください。
注: 問題の後でダンプの前に、リカバリー機能は、タスクが終了する前にエラ
ーのある制御ブロックのチェーンを再構築しようとします。問題がシステ
ム・コンポーネントにあることが示されると、SYSABEND または
SYSUDUMP ダンプは、リカバリー処理のためにその問題を分離するため
に使用することができません。これらのダンプは専用ストレージ内の問題
についてのみ役立ちます。
4. ダンプの先頭で、異常終了コード、理由コード、ジョブ名、ステップ名、およ
びプログラム状況ワード (PSW) をダンプの表題から入手します。
完了コードが USER=dddd であれば、アプリケーション・プログラムが、ダン
プを要求し完了コードを指定するために ABEND マクロを発行したことを示し
ています。
5-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
完了コードが SYSTEM=hhh であれば、システム・コンポーネントがアプリケ
ーション・プログラムを終了し、プログラム内のリカバリー・ルーチンがダン
プを要求したことを示しています。アプリケーション・プログラムが異常終了
の原因であると考えられます。
参照 異常終了コードの説明については、「z/OS MVS システム・コード」を参
照してください。
5. 次の手順に従って RTM2WA を分析してください。
v TCB の要約の中で、障害を起こしたタスクについてタスク制御ブロック
(TCB) を検出してください。この TCB は CMP フィールドに完了コードと
して異常終了コードを持っています。TCB の要約の中で、TCB についての
リカバリー終了マネージャー 2 (RTM2) 作業域 (RTM2WA) を検出してくだ
さい。
v RTM2WA の要約の中では、エラー発生時のレジスターと異常終了したプロ
グラムの名前とアドレスを入手してください。
v RTM2WA 要約に異常終了プログラム名とドレスがない場合は、SVC 命令が
異常終了していると考えられます。
v RTM2WA の要約に再帰用の直前の RTM2WA がある場合は、ESTAE また
はほかのリカバリー・ルーチンが他の元となる異常終了を処理している間に
このダンプの異常終了が生じたことを示しています。再帰的な異常終了の場
合は、複数の RTM2WA が作成されることがあります。原因となった問題を
診断するために、直前の RTM2WA を使用してください。
参照
v RTM2WA と SDWA データ・エリアについては、「z/OS MVS Data Areas,
Vol 4 (RD-SRRA)」を参照してください。
v TCB データ・エリアについては、「z/OS MVS Data Areas, Vol 5
(SSAG-XTLST)」を参照してください。
6. プログラム名をダンプで分析してください。RTM2WA 要約からプログラム名
を入手してください。名前フィールドがゼロの場合は、次の手順に従ってくだ
さい。
v ダンプしようとしているタスクの制御ブロックを検出してください。
v 最後の要求ブロックは SVRB です。SVRB 内の WLIC フィールドで、次の
SVC 割り込みコードを検出してください。
– SNAP SVC 割り込みの X'33'
– SYNCH SVC 割り込みの X'0C'
v 異常終了しているプログラムのプログラム要求ブロック (PRB) が、これらの
SVRB のすぐ前にあります。
v ダンプに複数の CDE が含まれる場合は、各 CDE の最初と最後のアドレス
を判別してください。入り口点アドレスは最初のアドレスです。最後のアド
レスを入手するために、入り口点アドレスに長さを加算します。これらのア
ドレスと、ダンプ・ヘッダー内にある PSW の右半分のアドレスを比較しま
す。その PSW のアドレスは現行の CDE の最初と最後のアドレスの間にな
ります。
第 5 章 ABEND ダンプ
5-27
ABEND ダンプ
PSW アドレスの左端の数字はアドレッシング・モードを示し、アドレスの一
部ではありません。
v その CDE の NAME フィールドはプログラム名を示します。
7. 障害を起こしたプログラム・モジュールを 16 進ダンプで探し出してくださ
い。
8. 異常終了の原因となった命令を検出してください。
ダンプ・ヘッダーの PSW はエラーが発生した時点でとられています。PSW の
右半分のアドレスを入手してください。左端の数字はアドレッシング・モード
を示し、アドレスの一部ではありません。
ほとんどの問題で、PSW アドレスからダンプ・ヘッダーの ILC フィールドの
命令長を減算し、障害を起こしたアドレスを入手してください。次の場合は命
令長を減算しないでください。PSW アドレスは障害を起こした命令を示してい
ます。
v ページ変換例外。
v セグメント変換例外。
v ベクトル演算割り込み。
v 命令の処理に対するその他の割り込み (この場合旧 PSW はヌルになりま
す。) 命令の処理が旧 PSW をヌルにして識別しているその他の割り込み。
割り込み操作については、「z/Architecture Principles of Operation」を参照し
てください。
v エラーの発生時にアクセス・レジスターを使用している場合は、アクセス・
リスト入り口トークン (ALET) が正しくない場合があります。
障害を起こしたモジュールのアドレスから障害を起こした命令アドレスを引い
てください。このオフセットを使用して異常終了したプログラムのアセンブラ
ー・リストで一致する命令を検出してください。
9. SVC またはシステム入出力ルーチンからの異常終了の場合は、最後のプログラ
ム命令を検出してください。
ダンプが取られたプログラムの代わりに実行されているシステム・コンポーネ
ントで異常終了が発生した場合は、次の手順で、プログラムで実行されていた
最後の命令を検出してください。
v SVC ルーチンからの異常終了の場合は、ダンプされたタスクについての制御
ブロック内の最後の PRB を調べてください。RTPSW1 フィールドの PSW
の右半分には SVC 命令に続く命令のアドレスが含まれます。
v システム入出力ルーチンからの異常終了の場合は、保管域トレースを調べて
ください。このトレースは、分岐する先の入出力ルーチンのアドレスを示し
ます。その保管域内の戻りアドレスは障害を起こしたプログラム内で実行し
た最後の命令です。
10. SVC またはシステム入出力ルーチンからの異常終了の場合は、異常終了の原因
を 次の手順で判別してください。
v SVC からの異常終了の場合は、ダンプされたタスクの制御ブロック内の
SVRB と一致する SVC 項目を、システム・トレース・テーブルで探してく
ださい。
5-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ABEND ダンプ
v 入出力ルーチンからの異常終了の場合は、障害をおこしたプログラムから発
行された入出力項目についてシステム・トレース・テーブルを調べてくださ
い。そのアドレスは PSW ADDRESS 列にあります。
SVC 入り口がダンプされたブロックと一致しているかまたは入出力項目が障害
を起こしたプログラムから発行されている場合は、システム・トレース・テー
ブルは問題とダンプの間でオーバーレイされることはありません。
この場合は、トレースの終わりにある最新の項目から開始してください。異常
終了したタスクの TCB アドレスを持つ最後の SVC 項目までたどってくださ
い。トレースの最後まで、問題の標識を探してください。詳細については、
8-1 ページの『第 8 章 システム・トレース』を参照してください。
11. プログラム割り込みの場合は、異常終了したプログラムの PRB に続く SVRB
と RTM2WA 内の、エラー発生時のレジスターを使用して異常終了の原因を判
別してください。
また、障害を起こしたモジュールの入力についてフォーマット設定された保管
域のトレースを調べます。
12. メモリー間環境の異常終了の場合は、ダンプを分析するために次の手順に従っ
てください。
プログラム呼び出し (PC) 命令を使用すると SVC または SRB を使用するより
も多くのサービスが要求されます。PC ルーチンが異常終了を発行すると、RB
の OPSW フィールドには異常終了を発行した PC ルーチンの命令アドレスが
含まれます。SVRB には PC ルーチンのレジスターが含まれます。
PC 命令か発行された時のレジスターと PSW を調べる場合は、下記の手順に従
ってください。
v スタッキング PC の場合は、リンケージ・スタック内のレジスターを検出し
てください。リンケージ・スタック内のすべての項目は、ダンプ内の RB の
前にあります。
v 基本 PC の場合は、PCLINK スタック内のレジスターを検出してください。
PCLINK スタック内のすべての項目は、ダンプ内の RB の後になります。
スタッキング PC の場合は、プログラムの RB/XSB に対応するリンケージ・ス
タック項目を検出してください。リンケージ・スタック項目の LSED フィール
ドと対応する XSB 内の XSBLSCP フィールドには同じ値が入ります。リンケ
ージ・スタック項目から、スタッキング PC が発行された時点のレジスターと
PSW を入手してください。PSW のアドレスは、異常終了したプログラムの
PC 命令の次の命令をポイントします。
基本 PC の場合は、PCLINK スタックからの呼び出し側を判定してください。
PCLINK スタック・エレメント (STKE) を見付ける場合は、次のことを参考に
してください。
v STKE はすべての RB に続くダンプ内に表示されます。ダンプが複数の
STKE を含む場合は、問題に組み込まれた PC と関連する STKE のポイン
ターは異常終了したプログラムについての RB の XSBSTKE フィールド内
にあります。
v RB 内の RBXSB フィールドは XSB をポイントします。
第 5 章 ABEND ダンプ
5-29
ABEND ダンプ
v XSB 内の XSBSEL フィールドは、現行の STKE をポイントします。
STKE では、STKERET フィールドは PCLINK サービスの呼び出し側の戻りア
ドレスを含んでいます。
参照 STKE データ域と XSB データ域については、「z/OS MVS Data Areas,
Vol 5 (SSAG-XTLST)」を参照してください。
5-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 6 章 SNAP ダンプ
プログラミング・インターフェース情報
このトピック (SNAP ダンプ) には、プログラミング・インターフェース情報が記載
されています。
プログラミング・インターフェース情報 の終り
SNAP ダンプにより、実行中のプログラムがシステムに対して要求したダンプの対
象となる仮想記憶域を見ることができます。したがって、SNAP ダンプは、異常終
了時ではなくプログラムの実行中に書き込まれます。小さいものでは 1 バイトのフ
ィールドから、大きいものでは現行ジョブ・ステップに割り当てられたすべてのス
トレージまで、プログラムは任意の規模のダンプを要求できます。プログラムで、
システム・データをダンプに含めるように要求することもできます。
SNAP は、特にプログラムのテスト中に使用すると便利です。プログラムで 1 つま
たは複数のフィールドを反復してダンプすると、プログラマーは計算の中間ステッ
プを検査できるようになります。たとえば、開発中のプログラムから得られた結果
が正しくない場合、個々の変数をダンプするための SNAP ダンプ要求をプログラム
に追加します。正しくないストレージが初めて検出されれば、エラーの原因となっ
たコードのセクションが絞り込まれるはずです。
主要トピック
ここでは、SNAP ダンプの使用方法を説明する以下のトピックを扱います。
v 『SNAP ダンプの獲得』
v 6-5 ページの『SNAP ダンプの内容のカスタマイズ』
SNAP ダンプの獲得
ダンプを受信するデータ・セットを用意し、ダンプを印刷するように準備してくだ
さい。プログラムで SNAP または SNAPX マクロを使用することにより、同じデ
ータ・セットにダンプを収めたり、異なるデータ・セットにダンプを収めたりでき
ます。それぞれの SNAP または SNAPX マクロ内の DCB パラメーターで、その
データ・セットを指定してください。
ダンプ・データ・セットを設定するときには、そのデータ・セットに特権データが
入るのかどうかを判別してください。その場合は、データ・セットをパスワードで
保護するか、あるいは別のセキュリティー手段を使用して、データ・セットへのア
クセスを制限してください。
SNAP ダンプを得るためには、以下のステップに従ってください。
1. SYSUDUMP、SYSABEND、SYSMDUMP、あるいはその他の制限された DD 名
以外の DD 名を使用して、ダンプ対象の問題プログラムを実行するジョブ・ス
テップ用の DD ステートメントを JCL 内でコーディングしてください。このス
テートメントでは、SNAP ダンプの出力を次のいずれかに書き込むように指定で
きます。
v 直接アクセス記憶装置。
© Copyright IBM Corp. 1988, 2008
6-1
SNAP ダンプ
v プリンター。プリンターは、z/VM® のもとで稼働するとき以外はお勧めでき
ないことに注意してください。ダンプの書き込みの有無にかかわらず、そのジ
ョブ・ステップの実行中はプリンターを他の用途に使用できないためです。
z/VM のもとでは、仮想プリンターを使用できます。この場合は、プログラム
の実行中でも使用されるシステム・リソースが少量に限られる場合は、実プリ
ンターで部分的に出力を表示または印刷することができます。
v SYSOUT。SNAP ダンプは、通常は SYSOUT を使用します。
v 磁気テープ。
例: SNAP ダンプ用の SYSOUT DD ステートメント
次の例は sysout 出力クラス A に SNAP ダンプを置きます。例では、出力
クラス A は印刷クラスです。システムは、出力クラスを印刷するときに、
そのクラスに書き込まれたすべてのダンプを印刷します。
//SNAP1
DD
SYSOUT=A
例: SNAP ダンプ用のテープ DD ステートメント
次に示す例では、SNAP ダンプをテープに書き込みます。この例の TAPE
は、インストール・システムで設定されたグループ名です。
システムは、ジョブ・ステップが終了すると、正常終了か異常終了かにか
かわらずデータ・セットを保持します。ステップがどのように終了したの
かにかかわらず、処理全体を通じて SNAP ダンプがとられます。
//SNAP2
DD
DSN=DUMPDS,UNIT=TAPE,DISP=(,KEEP,KEEP)
例: SNAP ダンプ用の直接アクセス記憶装置 DD ステートメント
次の例では、SNAP ダンプを直接アクセス記憶装置 (たとえば、3350 直接
アクセス記憶装置) に書き込みます。
//SNAP3
//
DD DSN=SNAPSHOT,UNIT=3350,DISP=(,KEEP,KEEP),
VOLUME=SER=12345,SPACE=(1680,(160,80))
システムは、基本順次アクセス方式 (BSAM) を使用して順次データ・セットに
ダンプを書き込みます。ダンプ・データ・セットは、BSAM でサポートされる
任意の装置に配置できます。
2. 問題プログラムで次のことを行ってください。
a. データ・セットにダンプを受信するための、データ制御ブロック (DCB) を指
定してください。標準ダンプの場合には、行当り 120 文字であるため、DCB
で次のように指定しなければなりません。
BLKSIZE=882 または 1632
DSORG=PS
LRECL=125
6-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SNAP ダンプ
MACRF=(W)
RECFM=VBA
高密度ダンプの場合、APA 3800 プリンターでは行当り 204 文字が印刷され
るため、DCB で次のように指定しなければなりません。
BLKSIZE=1470 または 2724
DSORG=PS
LRECL=209
MACRF=(W)
RECFM=VBA
b. DCB をオープンするために OPEN マクロをコーディングしてください。
SNAP または SNAPX マクロを発行する前に、DCB パラメーターで指定す
る DCB をオープンし、マクロが制御を戻すまでこの DCB がクローズされ
ないようにしなければなりません。この DCB をオープンするには、以下の
パラメーターを指定した DCB マクロを発行し、該当データ・セットに関す
る OPEN マクロを発行してください。
DSORG=PS,RECFM=VBA,MACRF=(W),BLKSIZE=nnn,LRECL=xxx,
and DDNAME=any name but SYSABEND, SYSMDUMP or SYSUDUMP
システム・ローダーがこのプログラムを処理する場合には、プログラムは最
後の SNAP または SNAPX マクロの発行後に DCB をクローズしなければ
なりません。
c. ダンプを要求するための SNAP または SNAPX アセンブラー・マクロをコー
ディングしてください。
例: SNAP マクロのコーディング
次に示す例の SNAP マクロは、レジスター 3 に入っている DCB アド
レス、ダンプ ID 245、レジスター 4 に入っているストレージの開始ア
ドレス、およびレジスター 5 に入っている終了アドレスを使用して、
ストレージのダンプを要求します。
SNAP
DCB=(3),ID=245,STORAGE=((4),(5))
プログラム内で、固有のダンプごとにダンプ ID を変えて、必要な回数
だけこのマクロを反復してください。システムは、同じ DCB が指定さ
れているすべてのダンプを同じデータ・セットに書き込みます。
第 6 章 SNAP ダンプ
6-3
SNAP ダンプ
例: プログラム内の 2 つの SNAP ダンプ要求
次の例で示す問題プログラムは、2 つの SNAP ダンプを要求します。両方の
ダンプを同じデータ・セットに書き込むために、この例の 2 つの SNAP マク
ロでは同じデータ制御ブロック (DCB) が指定されています。各ダンプの ID
は異なっていて、最初のダンプでは PIC3 が、2 番目のダンプでは PIC4 が指
定されています。両方のダンプでは、同じエリア、すなわち制御ブロックが示
されます。したがってプログラマーは、これらのエリアを、プログラムの処理
中における 2 つの時点で調べることができます。
SNAPDCB
DCB
BLKSIZE=882,DSORG=PS,LRECL=125,MACRF=(W),RECFM=VBA
.
.
.
OPEN
SNAPDCB,OUTPUT
LA
3,SNAPDCB
SNAP
DCB=(3),ID=PIC3,SDATA=CB
.
.
.
SNAP
DCB=(3),ID=PIC4,SDATA=CB
CLOSE SNAPDCB
d. CLOSE アセンブラー・マクロを使用して DCB をクローズしてください。
参照
v DCB、OPEN、および CLOSE マクロのコーディングについては、「z/OS
DFSMS Macro Instructions for Data Sets」を参照してください。
v DCB マクロの必須パラメーター、および SNAP または SNAPX マクロのコ
ーディングについては、「z/OS MVS プログラミング: アセンブラー・サービ
ス 解説書 ABE-HSP」と「z/OS MVS プログラミング: アセンブラー・サービ
ス解説書 第 2 巻 (IARR2V-XCTLX) 」を参照してください。
3. データ・セットを印刷または表示してください。SNAP または SNAPX マクロ
の出力は、1 桁目に ANSII 文字が入った標準 EBCDIC データ・セットです。
このデータ・セットは編集可能です。
ダンプは、作成されるときにフォーマット設定されます。印刷は、ダンプ作成時点
におけるダンプの場所によって変わってきます。
場所
印刷
SYSOUT
システムは、出力クラスの印刷時にダンプを印刷します。
磁気テープまたは直接アクセス・データ・セット
個別のジョブまたはジョブ・ステップでダンプを印刷します。
プリンター
システムは、ダンプの作成時にダンプを印刷します。
端末で SNAP ダンプを表示するには、ダンプが入っているデータ・セットをブラウ
ズしてください。
6-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SNAP ダンプ
例: SNAP ダンプの印刷
次の JCL は、SNAP ダンプを印刷します。システムがダンプ作成時にダンプ
をフォーマット設定するため、IEBPTPCH ユーティリティー・プログラムを使
用してこのダンプを印刷できます。
このダンプは SNAPSHOT データ・セットに入っています。
.
.
.
//PRINT
EXEC PGM=IEBPTPCH
//SYSPRINT DD
SYSOUT=A
//SYSUT1
DD
DSN=SNAPSHOT,UNIT=3350,DISP=(OLD,DELETE),
//
VOLUME=SER=12345
//SYSUT2
DD
SYSOUT=A
//SYSIN
DD
*
PRINT
TYPORG=PS
/*
SNAP ダンプの内容のカスタマイズ
SNAP ダンプの内容は、次のいずれかの方法によってカスタマイズできます。
v インストール・システム出口によって
v SDUMP または SDUMPX マクロのパラメーターによって
インストール・システム出口によるカスタマイズ
インストール・システムでは、IEAVADFM または IEAVADUS インストール・シ
ステム出口を使用して SNAP ダンプの内容をカスタマイズできます。IEAVADFM
は実行するルーチンのリストで IEAVADUS は 1 つのインストール・システム・ル
ーチンです。 インストール・システム出口ルーチンは、SNAP または SNAPX マ
クロで CB オプションが指定されている場合、ダンプの制御ブロック・フォーマッ
ト設定時に実行されます。このルーチンは、制御ブロックをフォーマット設定し
て、ダンプ用のデータ・セットに送ることができます。
参照
詳しくは、「z/OS MVS 導入システム出口」を参照してください。
SNAP または SNAPX マクロによるカスタマイズ
ダンプの内容は SNAP または SNAPX マクロのパラメーターによって決定されま
す。このマクロでは、次の表に示すエリアの一部または全部を指定できます。
ハイパースペース
パラメーターでは、ハイパースペースをダンプ対象に含めることは要求できません
ので、ご注意ください。ハイパースペース・データを SNAP ダンプに含めるには、
ハイパースペースからダンプ対象のアドレス・スペース・ストレージにデータを読
み込んでください。
第 6 章 SNAP ダンプ
6-5
SNAP ダンプ
参照
ハイパースペース・ストレージのデータの操作に関する詳細については、「z/OS
MVS Programming: Extended Addressability Guide」を参照してください。
パラメーター
ダンプ内容
ALLPA
次のリンク・パック域すべて
v ジョブ・パック・エリア (JPA)
v ダンプされるタスク用に活動化されているリンク・パック域 (LPA)
v 関連した監視プログラム呼び出し (SVC) モジュール
ALLVNUC
仮想制御プログラム中核全体
CB
ダンプされるタスクの制御ブロック
DM
ダンプされるタスクのデータ管理制御ブロック
v データ制御ブロック (DCB)
v データ・エクステント・ブロック (DEB)
v 入出力ブロック (IOB)
ERR
ダンプされるタスクのリカバリー終了マネージャー (RTM) 制御ブロック
v RTM の拡張エラー記述子 (EED)
v システム診断作業域 (SDWA) からのレジスター
v RTM2 作業域 (RTM2WA)
v タスクの非同期出口設定 (STAE) 制御ブロック (SCB)
IO
ダンプされるタスクの入出力監視プログラム (IOS) 制御ブロック
v 実行チャネル・プログラム・デバッグ・エリア (EXCPD)
v 装置制御ブロック (UCB)
JPA
ジョブ・パック・エリア (JPA): モジュール名と内容
LPA
ダンプされるタスクの場合に活動化されているリンク・パック域 (LPA): モジュールの名前
と内容
LSQA
アドレス・スペースに割り振られたローカル・システム・キュー域 (LSQA) (サブプール 203
- 205、213 - 215、223 - 225、229、230、233 - 235、249、253 - 255)
NUC
制御プログラム中核の読み取り/書き込み部分 (すなわち、DAT-on 中核の非ページ保護エリ
アのみ)、次のものを含みます。
v コミュニケーション・ベクトル・テーブル (CVT)
v ローカル・システム・キュー・エリア (LSQA)
v 接頭部付き保管域 (PSA)
v システム・キュー・エリア (SQA)
PCDATA
タスクに関するプログラム呼び出し情報
PSW
ダンプ要求時のプログラム状況ワード (PSW)
Q
ダンプされるタスクのグローバル・リソース逐次化制御ブロック
v グローバル・キュー制御ブロック
v ローカル・キュー制御ブロック
REGS
ダンプ要求時のレジスター
v アクセス・レジスター
v 浮動小数点レジスター
v 汎用レジスター
v ベクトル機能を使用するタスクに関するベクトル・レジスター、ベクトル状況レジスタ
ー、およびベクトル・マスク・レジスター
SA または SAH
保管域リンケージ情報、プログラム呼び出しリンケージ情報、および保管域の上方トレース
6-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SNAP ダンプ
パラメーター
ダンプ内容
SPLS
ダンプされるタスクに対し、ユーザー・サブプール 0 - 127、129 -132、244、251、および
252 に割り振られたストレージ
SQA
割り振られたシステム・キュー・エリア (SQA) (すなわち、サブプール
226、239、245、247、248)
SUBTASKS
ダンプされるタスク、およびそのすべてのサブタスクのプログラム・データに使用されるス
トレージ
SWA
スケジューラー作業域 (SWA) (すなわち、サブプール 236 と 237)
TRT
使用可能なシステム・トレースおよび汎用トレース機能 (GTF) トレース
-
SNAPX マクロで識別された 1 つまたは複数のデータ・スペース
-
SNAP または SNAPX マクロの開始アドレスと終了アドレスで識別された 1 つまたは複数
のストレージ
-
SNAP または SNAPX マクロのサブプール番号で識別された 1 つまたは複数のサブプール
第 6 章 SNAP ダンプ
6-7
SNAP ダンプ
6-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 7 章 ダンプ・グラブ・バッグ
ダンプには、問題のタイプを識別するために役立つ可能性のある、エラーに関する
情報が入っています。対話式問題管理システム (IPCS) を使用することにより、エラ
ーに関する情報をフォーマット設定して、検索を迅速かつ効率よく行える方法が提
供されます。
以下に挙げるヒントは、すべての種類のダンプ (SVC ダンプ、スタンドアロン・ダ
ンプ、および SYSMDUMP ダンプ) の処理に適用されます。
主要トピック
ここでは、以下のトピックについて説明します。
v 『ストレージ・オーバーレイに関する問題データ』
v 7-3 ページの『リンケージ・スタックから得られる問題データ』
v 7-5 ページの『モジュールの問題データ』
v 7-6 ページの『リカバリー作業域から得られる問題データ』
v 7-6 ページの『ACR の問題データ』
v 7-7 ページの『マシン・チェックの問題データ』
ストレージ・オーバーレイに関する問題データ
ダンプを分析するときには常に、ストレージ・オーバーレイの可能性を考慮する必
要があります。 MVS のシステム問題は、多くの場合、ストレージ・オーバーレイ
が発生してデータ、制御ブロック、または実行可能コードが破壊されることによっ
て起こります。このようなオーバーレイによって生じる結果はさまざまです。たと
えば、
v システムがエラーを検出し、異常終了コードを発行しているが、エラーを特定の
アドレス・スペースに分離することが可能であることがあります。エラーの分離
は、オーバーレイがグローバル・ストレージまたはローカル・ストレージのどち
らで起こっているのかを判定するために重要です。
v データまたは命令を参照することによって指定例外 (異常終了 X'0C4') や命令コ
ード例外 (異常終了 X'0C1') などの即時エラーが発生する可能性があります。
v 不良データを使用して別の位置が参照され、それによってさらに別のエラーが発
生することがあります。
記憶場所の内容が無効であることを認識してから、ビット・パターンを特定の制御
ブロックまたは特定のデータとして認識することにより、一般に、誤りのあるプロ
セスやコンポーネントを識別して、詳細な分析を開始できるようになります。
損傷区域の分析
ストレージの不良またはオーバーレイが明らかになった場合には、原因の究明を試
みてください。まず、不良データの範囲を判定してください。ストレージ内の
EBCDIC データまたはモジュール・アドレスを調べて、その所有者を特定してくだ
さい。ストレージ内のなんらかのタイプのパターンによってエラーが示され、損傷
を受けたストレージを使用しているプログラムが識別できる可能性があります。明
らかに不良な区域の双方のデータを調べてください。不良領域の長さが既知のもの
© Copyright IBM Corp. 1988, 2008
7-1
ダンプ・グラブ・バッグ
であるのか、つまり、その長さを既知の制御ブロック長、データ・サイズ、MVC 長
と関連付けることができるかどうかを調べてください。関連付けられる場合には、
さまざまなオフセットを検査してその内容を判定し、何らかの内容が分かれば、正
確な制御ブロックの判定を試みてください。
例: パターンの認識
次の出力では、CSA から得られるストレージが割り振りブロックのパターン
を示しています。
00CFD000
00000000
00CFD010
00000020
00CFD020
00BE3D30
00CFD030
00000020
00CFD040
00CA6A60
00CFD050
00CFE018
00CFD060
E24BC4C1
00CFD070 TO 00CFD07F
00CFD080
40404040
00CFD090
00000000
00CFD0A0
1FFE0000
00CFD0B0
00000000
00CFD0C0
E34BC5D5
00CFD0D0
F1000000
00CFD0E0
C8C5C240
00000000
E5C7E3E3
080000F1
| ........VGTT...
00000000
0000E3D8
00000000
| ..........TQ...
00000000
E5C7E3E3
080000F1
| ........VGTT...
00CFD008
0000E260
00000000
| ......}...S-...
00000000
17000080
E5E2C90F
| ...-........VSI
00CFD0B8
C8E2D4D3
4BD4C3C4
| ..\...}.HSML.MC
E3C14040
40404040
40404040
| S.DATA
(X’00000010’ bytes)--All bytes contain X’40’, C’ ’
000E0042
00000000
00000000
|
...........
00000000
00000000
17CA0000
| ...............
C2C3E3F3
D3C90001
00000000
| ....BCT3LI.....
40080000
E2E8E2F1
4BE4C3C1
| .... ...SYS1.UC
E5F2F600
00000168
00CFD0C8
| T.ENV26.......}
00CFD230
00CFD22C
13C9C4C1
| 1.....K...K..ID
00100150
00CFD244
00000160
| HEB ...&;.K....
パターンが分からない場合にも、もう 1 つステップをとってみてください。ビッ
ト・パターンを作るために使用されるある基準からのオフセットを判別できる場合
には、特定のオフセットに特定のビット・パターンにあることが手掛かりになる可
能性があります。
たとえば、オフセット X'C' にある BALR レジスター値 (X'40D21C58') は、プログ
ラムがこのストレージを (おそらくは、不良レジスター 13 が原因になっている) レ
ジスター保管域として使用していることを表している可能性があります。同じオー
バーレイ・エリア内の別のフィールドが認識のヒントになる場合があります。
パターンの反復は、悪いプロセスを表している可能性があります。この悪いデータ
が認識できる場合、そのデータを、エラーの原因となっているコンポーネントまた
はモジュールと関連付けできることがあります。これにより、これ以降の分析の手
掛かりが得られます。
一般的な不良アドレス
以下に示すのは、一般に知られている不良アドレスです。診断中のコードからこれ
らのアドレスが認められた場合には、これらのエリアを重点的に調べて問題ソース
を識別してください。
v X'000C0000'、X'040C0000'、または X'070C0000'、およびこれらのいずれかのアド
レスになんらかのオフセットを加えた値。これらのアドレスは一般に、なんらか
のコードが制御ブロックの基底レジスターとして 0 を使用し、そのあとで 0 に
なんらかのオフセットを加えてポインターをロードして、PSA 内の PSW の前半
部分を取り出した結果として起こります。
7-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ・グラブ・バッグ
旧 PSW によって指し示されたコード内でストレージ・オーバーレイが起こって
いないかどうかを調べてください。これらのオーバーレイは、0 にオフセットを
加えることによって PSW の後半部分がポインターとして使用された場合に起こ
ります。
v X'C00'、X'D00'、X'D20'、X'D28'、X'D40'、および、通常の機能回復ルーチン
(FRR) スタック内のフィールドを指すその他のポインター。 ルーチンは多くの場
合、SETFRR マクロ展開中にレジスターの内容を失い、マクロ展開から戻された
24 バイト作業域のアドレスを誤って使用します。
v レジスター保管域。正しくないレジスター保管域アドレスを使用して複数記憶
(STM) 命令を実行するコードにより、ストレージがオーバーレイされることがあ
ります。このようなときには、多くの場合、保管されたレジスターが問題のある
コンポーネントまたはモジュールの判定に役立ちます。
リンケージ・スタックから得られる問題データ
ブランチ命令によってシステム・サービスが出された場合には、リンケージ・スタ
ックを使用して、そのサービスを要求したプログラムを識別します。
第 7 章 ダンプ・グラブ・バッグ
7-3
ダンプ・グラブ・バッグ
例: リンケージ・スタック項目の表示
アドレス・スペース ID (ASID) X'1A' に関連したリンケージ・スタック項目を
調べるためには、IPCS サブコマンドを使用してください。
SUMMARY FORMAT ASID(X’1a’)
アドレス・スペースに関連したリンケージ・スタックの場合に生成されるダン
プでは、次のような項目が表示されます。
LINKAGE STACK ENTRY 01 LSED: 7F7490B0
LSE: 7F749010
GENERAL PURPOSE REGISTER VALUES
00-03.... 7FFEB410 04504DF4 04532000
04-07.... 04504CE4 81150380 00000028
08-11.... 04503A75 04502A76 04501A77
12-15.... 84500A78 00000000 80FD7618
ACCESS REGISTER VALUES
00-03.... 00000000 00000000 00000000
04-07.... 00000000 00000000 00000000
08-11.... 00000000 00000000 00000000
12-15.... 00000000 00000000 00000000
1S/A ON AQFT PER SYSTEM HUNG 22:30 08/30/88
04541FFF
04504B50
04504630
8450FAF8
00000000
00000000
00000000
00000000
24 09:42:48 10/14/88
PKM..8000 SASN..001A EAX..0000 PASN..001A PSW..070C0000
TARG... 8450FB12 MSTA... 0451E300 00000000
TYPE... 84
BAKR STATE ENTRY
RFS... 0F38
NES... 0000
80FD7618
BAKR STATE ENTRY
この項目は分岐スタック (BAKR) 命令によって作られます。
SASN..1A および PASN..1A
BAKR の実行時には、このプログラムは仮想記憶間モードになっていませ
んでした。分岐を行うプログラムが仮想記憶間モードになっていない場合
には、2 次アドレス・スペース番号 (SASN) と 1 次アドレス・スペース
番号 (PASN) は同じになります。このプログラムが仮想記憶間モードにな
っていた場合には、SASN と PASN は同じにはなりません。
PSW..070C0000 80FD7618
BAKR によって実行された分岐の戻りアドレスは FD7618 です。このアド
レスは、プログラム状況ワード (PSW) の右半分に含まれています。
多くのシステム・サービスは分岐によって呼び出されます。分岐入り口サービスに
ついては、レジスター 14 を使用して呼び出しプログラムを識別してください。呼
び出しプログラムに問題があるかどうか調べてください。
リンケージ・スタックの詳細については、「z/OS MVS Programming: Extended
Addressability Guide」を参照してください。
7-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ・グラブ・バッグ
モジュールの問題データ
モジュールの場合、モジュールが制御を失ったときの処理モードに応じて、システ
ムはさまざまな場所からモジュールの状況を保管し、復元します。各プロセッサー
について直前まで実行されていたモジュールのモードを調べるには、IPCS STATUS
CPU サブコマンドを使用してください。保管された状況を、診断のための問題デー
タとして使用してください。
処理モード
以下で、処理モードについて説明します。コードは常に、これらの 1 つ以上のモー
ドで実行されます。たとえば、タスク・モードまたはサービス要求ブロック (SRB)
モードで実行されるコードは、ローカルでロックしたりあるいは物理的に使用不能
にすることができます。
v タスク・モードは、最も一般的な処理モードです。ATTACH、ATTACHX、
LINK、LINKX、XCTL、および XCTLX マクロによって制御権を与えられたプロ
グラムは、すべてタスク・モードで実行されます。
v SRB モードは、サービス要求ブロック (SRB) キューのうちの 1 つから実行され
るコード用のモードです。
v 物理的使用不能モードは、クリティカルなシステム・キューおよびデータ・エリ
アを操作する、優先順位の高いシステム・コード用に予約されています。このモ
ードは、通常は監視プログラム状態で PSW 内のキー 0 と組み合わされていま
す。このような組み合わせになっていると、ルーチンは、制御を失う前に関数を
完了できるようになります。このモードは、システム内のごく一部のモジュール
(たとえば、割り込みハンドラー、タスク・ディスパッチング・プログラム、およ
びグローバル・スピン・ロックを保留しているプログラムなど) だけに制限され
ています。
v ロック・モードは、ロックを保留しているときにシステムで実行されるコード用
のモードです。
v 仮想記憶間モード。仮想記憶間モードは、以下のように定義されています。
– 1 次アドレス・スペース: 制御レジスター 3 に入っているアドレス・スペース
ID (ASID)
– 2 次アドレス・スペース: 制御レジスター 4 に入っている ASID
– ホーム・アドレス・スペース: PSAAOLD フィールド内のアドレス・スペース
制御ブロック (ASCB) のアドレス
– PSW の S ビット (PSW のビット 16): 現行アドレス可能度の標識
S ビット=0 - 1 次アドレス・スペースの標識
S ビット=1 - 2 次アドレス・スペースの標識
1 次アドレス可能度と 2 次アドレス可能度がホーム・アドレス・スペースを
指していて、S ビット=0 になっている場合、作業は仮想記憶間モードになっ
ていません。
v アクセス・レジスター (AR) モードの場合、プログラムは、(MVCP と MVCS を
除く) アセンブラー命令の全セットを使用して別のアドレス・スペースまたはデ
ータ・スペース内のデータを操作できます。仮想記憶間とは異なり、アクセス・
レジスターは多くのアドレス・スペースまたはデータ・スペース内のデータに完
全にアクセスできます。
第 7 章 ダンプ・グラブ・バッグ
7-5
ダンプ・グラブ・バッグ
リカバリー作業域から得られる問題データ
リカバリー作業域 (RWA) を使用すると、障害のあるモジュールを検出できます。
ほとんどの場合、障害モジュールの検出には RWA ではなく TCB および RB 構造
体が使用されます。以下の状態の場合には、RWA を使用してください。
v SLIP トラップで SVC ダンプが要求された場合。このダンプでは、問題発生時の
現行状況はリカバリー保管域または SDUMP SQA の 4K バッファーに入ってい
ます。詳細については、 2-57 ページの『SDUMPX 4K SQA バッファーの読み取
り』を参照してください。
v その問題がリカバリー・プロセスの途中である場合。
v ループ発生の疑いがあってスタンドアロン・ダンプが書き込まれた場合。
リカバリー作業域には、以下のものがあります。
v Logrec レコード
v システム内の Logrec バッファー: VERBEXIT LOGDATA サブコマンドによって
得られます。
v 可変記録域 (VRA) を含むシステム診断作業域 (SDWA): Logrec レコードおよび
Logrec バッファー内にフォーマット設定されます。
v 機能リカバリー・ルーチン (FRR) スタック: 次のトピックで説明します。
v RTM2 作業域 (RTM2WA) を含むリカバリー終了マネージャー (RTM) データ・
エリア: SUMMARY FORMAT サブコマンドでフォーマット設定されるか、ある
いは ERR オプションにより定様式 ABEND ダンプまたは SNAP ダンプ内に取
られます。
RTM2WA および SDWA ブロックには、レジスター、PSW、およびその他の問題
時の情報が含まれています。これらのブロックがタスク制御ブロック (TCB) と関連
している場合には、診断に使用してください。
参照
v 詳細については、 14-1 ページの『第 14 章 Logrec エラー・レコードの記録』を
参照してください。
v 制御ブロックについては、「z/OS MVS Data Areas, Vol 4 (RD-SRRA)」を参照し
てください。
v IPCS コマンドについては、「z/OS MVS IPCS コマンド」を参照してください。
ACR の問題データ
ダンプ時点で代替 CPU リカバリー (ACR) が活動状態になっている場合には、IPCS
STATUS WORKSHEET 出力の検索引き数で症状が示されています。
FLDS/CSDACR
前処理フェーズのデータ
ACR が活動状態になっている場合、前処理フェーズの問題データには、次のものが
あります。
v 共通システム・データ (CSD) の CSDCPUAL フィールドには、障害が起こった
プロセッサーとまだ実行されているプロセッサーが表示されます。
7-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ・グラブ・バッグ
v IDENT 列が ACR になっているシステム・トレース・テーブル項目は、ACR が
開始されたことを示し、障害のあるプロセッサーも示しています。
v CSD オンライン・マスクを使用して、どの CPU の LCCA を調べる必要がある
のかを判定します。IPCS サブコマンド CBFORMAT を使用して、障害のある
CPU の LCCA を調べてください。
v 両方のプロセッサーの論理構成通信域 (LCCA) のための CPU 作業保管域ベクト
ル・テーブル (WSAVTC) 内の WSACACR は、両方のプロセッサーの PSA およ
び FRR スタックのコピーを指しています。
v 両方のプロセッサーの LCCADCPU は障害の起こったプロセッサーの LCCA を
指し、LCCARCPU は実行されているプロセッサーの LCCA を指します。
実行されているプロセッサーが ACR を開始したときには、ダンプは障害のあるプ
ロセッサーの PSA を示しています。通常の FRR スタック、その他の FRR スタッ
クを指すポインター、ロック、PSA スーパー・ビット、およびその他のデータは、
障害発生時のプロセッサーを反映しています。
前処理フェーズのデータ
ACR が完了して CSDACR フラグが X'00' にリセットされると、メッセージ
IEA858E が出されます。
IPCS によって獲得されるデータ
次の IPCS サブコマンドを使用すると、すべての LCCA と CSD を見ることができ
ます。
STATUS CPU DATA WORKSHEET
参照
v 制御ブロックについては、「z/OS MVS Data Areas, Vol 3 (IVT-RCWK)」を参照し
てください。
v IPCS コマンドについては、「z/OS MVS IPCS コマンド」を参照してください。
マシン・チェックの問題データ
ハードウェアは、ハードウェアの誤動作を検出したことを制御プログラムに通知す
るために、マシン・チェック割り込みを使用します。マシン・チェックがソフトウ
ェア処理に与える影響は、エラーによってかなり異なります。
v ソフト・エラー: マシン・チェックの中には、ソフトウェア・リカバリー・アク
ションを必要としないハードウェア障害をプロセッサーが検出および訂正したこ
とをソフトウェアに通知するためのものがあります。
v ハード・エラー: その他のハードウェア障害がプロセッサーによって検出された
場合には、ソフトウェアが損傷修理のためのアクションを開始する必要がありま
す。ハード・エラーの場合にはまた、ソフトウェア・リカバリーによって、障害
のあったプロセスの保全性を検査する必要もあります。
PSA FLCMCIC フィールド内のマシン・チェック割り込みコード (MCIC) は、割り
込みの原因となったエラーを記述しています。複数の障害条件を表すために、MCIC
の複数のビットがオンになっていることがあります。
第 7 章 ダンプ・グラブ・バッグ
7-7
ダンプ・グラブ・バッグ
マシン・チェックの場合、システムは Logrec エラー・レコードを書き込みます。
以下の場合を除き、このエラー・レコードには MCIC が含まれています。
v Logrec バッファー (LRB) の LRBMTERM フィールドの LRBMTCKS ビットが
ON になっていて、マシン・チェックの旧 PSW と MCIC がともにゼロであるこ
とを表している場合。
v LRBMTERM フィールドの LRBMTINV ビットが ON になっていて、マシン・
チェックの旧 PSW が非ゼロで、MCIC がゼロであることを表している場合。
ハード・エラーが発生すると、FRR および ESTAE 処理が行われます。
参照
MCIC については、「z/Architecture Principles of Operation」を参照してください。
7-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 8 章 システム・トレース
システム・トレースを使用すると、システムの初期設定および操作中に発生するハ
ードウェア・イベントおよびソフトウェア・イベントを継続的に記録できます。シ
ステムは初期設定時にシステム・トレースを活動化し、インストール・システムで
IBM 提供のシステム・トレースを変更しない限り、継続的にトレースが実行されま
す。システム初期設定後に、マスター権限が与えられているコンソールから TRACE
オペレーター・コマンドを使用して、システム・トレースをカスタマイズできま
す。
システム・トレースは通常は常に実行されているため、問題判別に大変役立ちま
す。システム・トレースでリストされるシステム・イベントのうちの多くは、汎用
トレース機能 (GTF) の場合と同じものですが、システム・トレースでは、GTF が
開始される前のシステム初期設定中に発生したイベントもリストされます。システ
ム・トレースは、分岐命令および仮想記憶間命令もトレースしますが、GTF はこれ
らの命令をトレースできません。
主要トピック
以下のトピックで、システム・トレースについて詳しく説明します。
v 『システム・トレースのカスタマイズ』
v
8-3 ページの『システム・トレース・データをダンプで受けとる』
v
8-3 ページの『ダンプ内のシステム・トレース・データのフォーマット設定』
v
8-4 ページの『システム・トレース出力の読み方』
システム・トレースのカスタマイズ
システムがシステム初期設定時にシステム・トレースを開始させ、そのトレースが
継続的に実行されます。ただし、ユーザーはシステム・トレースに若干の変更を加
えることができます。
v 『システム・トレース・テーブルのサイズの拡大』
v
8-2 ページの『分岐命令のトレース』
システム・トレース・テーブルのサイズの拡大
システム・トレース・テーブルは、各プロセッサーの固定ストレージに入っていま
す。デフォルトのトレース・テーブル・サイズはプロセッサー当たり 256 キロバイ
トですが、TRACE ST コマンドを使用して変更することができます。デフォルトの
256 キロバイト未満の大きさのトレース・テーブルを使用して実行することは、お
勧めできません。ただし、以下の場合には、デフォルトの 256 キロバイトからシス
テム・トレース・テーブルのサイズを拡大することができます。
v システム・トレースに、十分に長い時間枠のトレースが含まれていない場合
v (トレース開始時に TRACE ST コマンドで BR=ON オプションを使用して) 分岐
命令をトレースしたい場合
トレース・テーブルのサイズを拡大するには、次のようにしてください。
© Copyright IBM Corp. 1988, 2008
8-1
システム・トレース
v TRACE ST コマンドを入力して、システム・トレース・テーブルのサイズを変更
してください。例えば、システム・トレースを再始動して、トレース・テーブル
のサイズをデフォルトのプロセッサー当たり 256 キロバイトから、プロセッサー
当たり 320 キロバイトに拡大する場合は、次のように入力します。
TRACE ST,320K
v TRACE ST コマンドを BUFSIZ パラメーターと入力して、割り振られたシステ
ム・トレース・テーブルの合計サイズを変更してください。例えば、プロセッサ
ーが 10 個あるシステムで、システム・トレースを再始動して、トレース・テー
ブルのサイズをデフォルトの 2560 キロバイト (プロセッサー当たり 256 キロバ
イト) から、20 メガバイト (プロセッサー当たり 2 メガバイト) に拡大する場合
は、次のように入力します。
|
|
|
|
|
|
|
TRACE ST,BUFSIZ=20M
注意: 使用可能な中央ストレージと、システム・トレースに必要な実際のストレー
ジを考慮の上、システム・トレース・ストレージの妥当な値を選択してください。
システム・トレース・ストレージの値を大きくしすぎると、システムのページング
可能なストレージの不足を招く可能性があります。
|
分岐命令のトレース
システム・トレースを使用すると、他のシステム・イベントの他に BALR、
BASR、BASSM、および BAKR などの分岐命令をトレースすることができます。
z/OS V1R9 では、モード・トレースのオプションは分岐トレースから分離されてい
ます。
|
|
|
重要: 分岐トレースを ON に設定して実行すると、システム・パフォーマンスに
影響を与え、大量のストレージを使用することがあります。分岐トレースは、シス
テムのシステム・トレースのデフォルトとしては使用しないで、特定の問題を解決
するために短時間だけ使用するようにしてください。デフォルトのシステム・トレ
ースには、分岐命令は含まれません。
BALR、BASR、BASSM、および BAKR などの分岐命令をトレースしたい場合に
は、次のようにしてください。
v マスター権限を割り当てられたコンソールから TRACE コマンドを使用し、分岐
トレースを指定してシステム・トレースを再始動させてください。
TRACE ST,BR=ON
|
|
|
分岐命令をトレースすると、生成されるトレース項目の数が著しく増加する傾向
があるため、分岐命令のトレースをオンに設定する場合には、次のようにトレー
ス・テーブルのサイズを拡大してください。
|
|
– 例 1: 各プロセッサーのトレース・テーブルのサイズを、デフォルトの 256 キ
ロバイトから 999 キロバイトに拡大するには、以下を発行します。
|
|
|
|
TRACE ST,999K,BR=ON
– 例 2: トレース・バッファーのストレージの合計サイズ (つまりインストール
されたプロセッサーすべてのトレース・テーブル項目用に取っておくストレー
ジの合計) を 2 メガバイトに拡大するには:
|
TRACE ST,BUFSIZ=2M,BR=ON
8-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
参照
v 「z/Architecture Principles of Operation」には、分岐命令トレースの項目とモー
ド・トレースの項目が記載されており、MVS はそれらを結合します (これらの項
目はハードウェアが生成します)。MVS は、命令により制御レジスター・ビット
を操作して、これらのフォーマットされていない項目の生成を可能にしたり、不
可能にしたりします。「分岐 (またはモード)」項目でないトレース・テーブル項
目は、TRACE または TRACG 命令により MVS ソフトウェアが生成します。詳
細については『Tracing』のトピックを参照してください。
v マッピング・マクロ IHATTE の TTE 記述については、「z/OS MVS Data Areas,
Vol 5 (SSAG-XTLST)」の『TTE Programming Interface Information』の章を参照し
てください。
システム・トレース・データをダンプで受けとる
システム・トレースは、トレース・アドレス・スペース内のシステム・トレース・
テーブルにトレース・データを書き込みます。システム・トレースはプロセッサー
ごとにトレース・テーブルを維持します。トレース・データは、SDATA=TRT オプ
ションを指定したダンプによって獲得してください。次の表は、デフォルト・オプ
ションで TRT が使用されるダンプをリストし、デフォルトではトレース・データ
が含まれないダンプ用のトレース・データを要求する方法を示しています。
ダンプ
トレース・データの取得方法
SYSABEND への ABEND ダンプ
デフォルト
SYSMDUMP への ABEND ダンプ
デフォルト
SYSUDUMP への ABEND ダンプ
デフォルト
SNAP ダンプ
SDATA=TRT を要求する
スタンドアロン・ダンプ
デフォルト
SDUMP または SDUMPX マクロに対する SVC ダン
プ
デフォルト
DUMP オペレーター・コマンドに対する SVC ダンプ デフォルト
デフォルト
ACTION=SVCD、ACTION=STDUMP、
ACTION=SYNCSVCD、または ACTION=TRDUMP を
指定した SLIP オペレーター・コマンドに対する
SVC ダンプ
トレース・データを除外するようにカスタマイズされ
た任意のダンプ
SDATA=TRT を要求する
ダンプ内のシステム・トレース・データのフォーマット設定
v 定様式ダンプの場合、システム・トレースがシステム・トレース・データをフォ
ーマット設定し、システムが直接そのデータを印刷します。
v 不定様式ダンプの場合は、IPCS SYSTRACE サブコマンドを使用してダンプ内の
トレース・データをフォーマット設定し、印刷または表示してください。
第 8 章 システム・トレース
8-3
システム・トレース
システム・トレース出力の読み方
このトピックでは、IPCS SYSTRACE サブコマンドを使用してフォーマット設定さ
れたダンプに表示される、システム・トレース・テーブル項目 (TTE) について説明
します。以下の各トピックについて説明します。
v 『ダンプ内のシステム・トレースの例』
v
8-5 ページの『システム・トレース項目 ID の要約』では、ダンプ内の各システ
ム・トレース項目に対応するシステム・トレース ID の表を示し、このセクショ
ンのどの箇所にその項目のフォーマットが説明されているのかを示します。項目
の多くは類似していて、グループにまとめられているため、特定の項目を調べた
い場合にはこの表から始めてください。
v
8-7 ページの『ACR トレース項目』から 8-41 ページの『USRn トレース項目』
までには、各タイプのトレース項目のフォーマットが示されています。TTE の詳
しいフォーマットについては、「z/OS MVS Data Areas, Vol 5 (SSAG-XTLST)」を
参照してください。
ダンプ内のシステム・トレースの例
次の例は、システム・トレース項目を示しています。IPCS は、SVC ダンプの例か
ら得られた項目をフォーマット設定しています。ABEND ダンプにおけるシステ
ム・トレース・データも同じフォーマットになっていることにご注意ください。
IPCS サブコマンド入力パネルから発行されたコマンドは、次のとおりです。
SYSTRACE
このトレースでは、最も古いトレース項目が最初に現れ、最新の項目は最後に表示
されます。ID の前にあるアスタリスク (*) は、通常と異なる条件を表しています。
説明については、該当項目のフォーマットを参照してください。
8-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
--------------------------------------------------- SYSTEM TRACE TABLE -----------------------------------------------------------------------------------------PR ASID WU-ADDR- IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-LOCAL CP
UNIQUE-4 UNIQUE-5 UNIQUE-6 PSACLHSE
DATE-03/18/2005
05-003E 008EA818
05-003E 008EA818
05-003E 01E8A508
SVC
SVCR
SRB
05-003E 00000000
SSRV
06-0006 00000000
SSRV
05-003E
05-003E
05-003E
05-003E
06-003F
008ABCE0
008ABCE0
008ABCE0
008ABCE0
113089D0
DSP
SVC
SVCR
SVC
SRB
06-003F
06-003F
06-003F
06-003F
06-003F
113089D0
113089D0
113089D0
113089D0
00000000
PC
PC
PR
PR
SSRV
06-003F
05-003E
05-003E
05-003E
05-003E
05-003E
06-003F
008E4E88
008ABCE0
008ABCE0
008ABCE0
008ABCE0
008ABCE0
008E4E88
DSP
SVCR
SVC
SVCR
SVC
SVCR
I/O
1 078D1000 B5E6DB78
1 078D1000 B5E6DB78
070C0000 8113C9D8
00055BB0
808DD798
0000003E
008ABCE0
2
80FEDC5C 00069350
00000000
116
815F7D2E 01DE9AFC
00000001
078D1000 B5E6DB78 00000000
78 078D0000 8000725C 00000002
78 078D0000 8000725C 00000000
78 078D0000 B5E576C8 00000002
070C0000 815F6F40 0000003F
008E4E88
... 0
015F718C
... 0
0134C9C2
... 0
0134C9C2 01320A54
... 0
015F718C 0134CC9A
10F
815F7238 00F73100
00000000
070C4000 815F89AE 00800000
78 078D0000 B5E576C8 00000000
78 078D2000 B5E577A2 00000003
78 078D2000 B5E577A2 00000000
78 078D2000 800072B6 00000003
78 078D2000 800072B6 00000000
04966 070C2000 8000BF56 80C04007
4901
00000001
00000001
11089E00
80
7F000000
FFFAA150
FFFAA150
11089E2C
Wait
00000000
Post
16:46:39.825763
02
00F73100 000000FC
Schedule
16:46:39.825765
06
00000001
00000060
00000060
000003E0
01DE9AFC
20
00312
0030A
00000000 00000000 003E 003E 16:46:39.825765
Getmain
16:46:39.825766
16:46:39.825767
Getmain
16:46:39.825767
00
003F 003F 16:46:39.825767
02
02
02
02
06
FFF97150
00000000
00051F08
00000000
01DE9B28
00
16:46:39.825759 02
16:46:39.825760 02
003E 003E 16:46:39.825761 02
TcbToken
LocAscb
003F
003F
008E4E88 008FF2B8
Resume
16:46:39.825772
06
00000001
000003E0
000003E0
000003E0
00000060
00000060
5BF4D050
0223EE88
00000000 00000000 003F 003F 16:46:39.825774
16:46:39.825776
Freemain
16:46:39.825777
16:46:39.825787
Freemain
16:46:39.825788
16:46:39.825788
00000080 00000000 003F 003F 16:46:39.825788
00000000
06
02
02
02
02
02
06
118BC200
35EB0C20
35EB0C20
35EB0C20
00051F08
00051F08
0C000000
0040000E
図 8-1. SVC ダンプ内のシステム・トレースの例
システム・トレース項目 ID の要約
このトピックでは、すべてのシステム・トレース項目を ID ごとに要約していま
す。トレース項目の多くは類似しているため、一緒に説明されています。下記の表
を使用して、特定の項目に関するフォーマットを探してください。
例: SVC 項目のフォーマットの探し方
次のトレース項目では、システム・トレース ID は SVC です。
01 000C 00AFF090
SVC
1 070C2000 00EB19CC
00000000 00000001 00C13340
表 8-1 内の SVC を調べて、SVC トレース項目のフォーマットが説明されて
いるページを探してください。この場合の、SVC トレース項目は、 8-29 ペー
ジの『SVC、SVCE、および SVCR トレース項目』で説明されています。
表 8-1. システム・トレース項目のフォーマットの説明への参照
ID (IDENT)
説明
フォーマットについては下記を参照
ACR
代替 CPU リカバリー
8-7 ページの『ACR トレース項目』
ALTR
トレース・オプションの更新
8-9 ページの『ALTR トレース項目』
BR
BAKR、BALR、BASR、または BASSM 命令
による分岐
8-10 ページの『BR トレース項目』
第 8 章 システム・トレース
8-5
システム・トレース
表 8-1. システム・トレース項目のフォーマットの説明への参照 (続き)
ID (IDENT)
説明
フォーマットについては下記を参照
BSG
サブスペース・グループで分岐
8-11 ページの『BSG、PC、PR、PT、PTI、SSAR、
および SSIR トレース項目』
CALL
外部呼び出し外部割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
CLKC
時刻比較機構外部割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
CSCH
サブチャネル切断操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
DSP
タスク・ディスパッチ
8-15 ページの『DSP、SRB、SSRB、および WAIT
トレース項目』
EMS
緊急信号外部割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
EXT
汎用外部割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
HSCH
サブチャネル停止操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
I/O
入出力割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
MCH
マシン・チェック割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
MOBR
命令アドレスの変更を伴うアドレッシング・モ 8-13 ページの『MODE および MOBR トレース項
ードの変更
目』
MODE
アドレッシング・モードの変更
8-13 ページの『MODE および MOBR トレース項
目』
MSCH
サブチャネル修正操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
PC
プログラム呼び出し制御命令
8-11 ページの『BSG、PC、PR、PT、PTI、SSAR、
および SSIR トレース項目』
PGM
プログラム割り込み
8-23 ページの『PGM、SPER および SPR2 トレー
ス項目』
PR
プログラム戻り制御命令
8-11 ページの『BSG、PC、PR、PT、PTI、SSAR、
および SSIR トレース項目』
PT
プログラム制御権移動命令
8-11 ページの『BSG、PC、PR、PT、PTI、SSAR、
および SSIR トレース項目』
RCVY
リカバリー・イベント
8-24 ページの『RCVY トレース項目』
RSCH
サブチャネル再開操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
RST
再始動割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
8-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
表 8-1. システム・トレース項目のフォーマットの説明への参照 (続き)
|
|
ID (IDENT)
説明
フォーマットについては下記を参照
SIGA
シグナル・アダプター操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
SPER
SLIP プログラム・イベント記録
8-23 ページの『PGM、SPER および SPR2 トレー
ス項目』
SPR2
STDATA が指定されているときの、SLIP プロ 8-23 ページの『PGM、SPER および SPR2 トレー
グラム・イベント記録
ス項目』
SRB
初期サービス要求ブロック・ディスパッチ
8-15 ページの『DSP、SRB、SSRB、および WAIT
トレース項目』
SS
サービス信号外部割り込み
8-19 ページの『CALL、CLKC、EMS、EXT、I/
O、MCH、RST、および SS トレース項目』
SSAR
2 次アドレス・スペース番号設定制御命令
8-11 ページの『BSG、PC、PR、PT、PTI、SSAR、
および SSIR トレース項目』
SSCH
サブチャネル開始操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
SSRB
中断サービス要求ブロック・ディスパッチ
8-15 ページの『DSP、SRB、SSRB、および WAIT
トレース項目』
SSRV
プログラム呼び出し (PC) 命令または分岐によ
って入ったシステム・サービス
8-31 ページの『SSRV トレース項目』
SUSP
ロック中断
8-21 ページの『SUSP トレース項目』
SVC
監視プログラム呼び出し割り込み
8-29 ページの『SVC、SVCE、および SVCR トレ
ース項目』
SVCE
SVC エラー
8-29 ページの『SVC、SVCE、および SVCR トレ
ース項目』
SVCR
SVC 戻り
8-29 ページの『SVC、SVCE、および SVCR トレ
ース項目』
TIME
タイマー・サービス
8-40 ページの『TIME トレース項目』
USRn
ユーザー・イベント
8-41 ページの『USRn トレース項目』
WAIT
待機タスク・ディスパッチ
8-15 ページの『DSP、SRB、SSRB、および WAIT
トレース項目』
XSCH
サブチャネル取り消し操作
8-16 ページの
『CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、
および XSCH トレース項目』
?EXPL
SYSTRACE サブコマンドがシステム・トレー
ス項目を識別できない
該当なし
ACR トレース項目
目的
ACR トレース項目は、プロセッサーの障害が発生し、それに続いて代替 CPU リカ
バリー・コンポーネントに入ったことを表します。
第 8 章 システム・トレース
8-7
システム・トレース
項目のフォーマット
PR ASID TCB-ADDR
CP
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr fail tcb-addr *ACR
cpu
PSACLHS-
PSALOCAL PASD SASD TIMESTAMP-RECORD
PSACLHSE-
psaeepsw flg-crex psacstk- psaclhs- psalocal
psasuper psamodew
psaclhse-
timestamp------- CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
fail: 障害が起こっているプロセッサーのホーム・アドレス・スペース ID
(ASID)。
TCB-ADDR
tcb-addr: TTE の作成対象となった現行タスクのタスク制御ブロック (TCB) の
アドレス。
IDENT
以下の TTE ID。
ACR
代替 CPU リカバリー
ACR の前には常にアスタリスク (*) が示され、通常と異なる条件が発生してい
ることを表します。
CD/D
cpu: PSA の PSACPUPA フィールドから得られた障害プロセッサーのアドレ
ス。
PSW----- ADDRESSブランク
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
flg-crex: 障害プロセッサーに関する論理構成連絡域 (LCCA) の
LCCACREX フィールド。
psacstk-: 障害プロセッサーから得られた接頭部保管域 (PSA) の PSACSTK
フィールド。
psaeepsw: PSA の PSAEEPSW フィールド。バイト 1 および 2 には障害プ
ロセッサーのアドレスが入っています。バイト 3 および 4 には外部割り込
みコードが入っています。
psamodew: PSA の PSAMODEW フィールド
psasuper: PSA の PSASUPER フィールド
PSACLHSpsaclhs-: 障害プロセッサーの PSA の PSACLHS フィールドから得られた保留
されている現行ロックに関するストリング。
PSACLHSEpsaclhse-: 障害プロセッサーの PSA の PSACLHSE フィールドから得られた
保留されている現行ロックに関する拡張ストリング。
PSALOCAL
psalocal: 障害プロセッサーの PSA の PSALOCAL フィールドから得られたロ
ーカルでロックされたアドレス・スペース標識。
8-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
ALTR トレース項目
目的
ALTR トレース項目は、システム・トレース・オプションの変更を表します。オプ
ションの変更は、TRACE ST オペレーター・コマンドを使用して行います。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr home tcb-addr *ALTR
tobtropt gpr0---- gpr1---pol-buf-
pasd sasd timestamp-------
CP
CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
ALTR トレース・オプションの変更
ALTR の前には常にアスタリスク (*) が示され、通常と異なる条件が発生して
いることを表します。
CD/D
ブランク
PSW----- ADDRESSブランク
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
第 8 章 システム・トレース
8-9
システム・トレース
tobtropt: システム・トレース・オプション・ブロック (TOB) の
TOBTROPT フィールドから得られた、制御レジスター 12 のフォーマット
のトレース・オプション。
gpr0----: 汎用レジスター 0
gpr1----: 汎用レジスター 1
pol-: TOB の TOBTRPOL フィールドから得られた、トレースが活動状態に
なっているかあるいは延期されているプロセッサーの番号。
buf-: TOB の TOBTRBUF フィールドから得られた、プロセッサー当りのト
レース・バッファーの数。
PSACLHSブランク
PSALOCAL
ブランク
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
BR トレース項目
目的
BR トレース項目は、分岐リンク (BALR)、分岐保管 (BASR)、分岐保管モード設定
(BASSM)、または分岐スタック (BAKR) 命令の R₂ フィールドがゼロでない場合に
は、その命令が処理されていることを表します。これらの分岐は、TRACE オペレー
ター・コマンドで BR=ON を指定して分岐トレースを要求した場合にだけトレース
されます。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr last tcb-addr
BR
address- address-
address- address- address- address- etc.
PR
pr: TTE を作成したプロセッサーの ID。
8-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
CP
システム・トレース
ASID
last: トレース・バッファー内の最後のホーム・アドレス・スペース ID
(ASID)。
TCB-ADDR
tcb-addr: TTE の作成対象となった現行タスクのタスク制御ブロック (TCB) の
アドレス。
IDENT
以下の TTE ID。
BR
分岐命令
CD/D
ブランク
PSW----- ADDRESSUNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
PSACLHSPSALOCAL
PASD
SASD
TIMESTAMP-RECORD
CP
address-: 正常に実行された分岐のアドレス。BR 項目で指定された連続分岐数
だけ繰り返されます。アドレスは、次のフォーマットで表示されます。
アドレッシング・モードおよび位置
表示
24 ビット・アドレス
xxxxxx
31 ビット・アドレス
xxxxxxxx
高位ビットにゼロが入った 64 ビット・アドレス
ゼロ以外の高位ビットをもつ 64 ビット・アドレス
00_xxxxxxxx
xxxxxxxx_xxxxxxxx
BSG、PC、PR、PT、PTI、SSAR、および SSIR トレース項目
目的
これらのトレース項目は、仮想記憶間命令の処理を表しています。
v BSG トレース項目は、サブスペース・グループでの分岐 (BSG) 制御命令を表し
ています。
v PC トレース項目は、プログラム呼び出し (PC) 制御命令を表しています。
v PR トレース項目は、プログラム戻り (PR) 制御命令を表しています。
v PT トレース項目は、プログラム転送 (PT) 制御命令を表しています。
v PTI トレース項目は、インスタンス付きプログラム転送 (PTI) 制御命令を表して
います。
v SSAR トレース項目は、2 次アドレス・スペース番号設定 (SSAR) 制御命令を表
しています。
v SSIR トレース項目は、インスタンス付き 2 次アドレス・スペース番号設定
(SSAIR) 制御命令を表しています。
第 8 章 システム・トレース
8-11
システム・トレース
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr last tcb-addr
PC
pkey-flg pc-addr-
pc#-----
pr last tcb-addr
PR
psw-key- pr-addr-
pr-faddr
pr last tcb-addr
PT
psw-key- pt-addr-
pt-asid-
pr last tcb-addr
PTI
psw-key- pt-addr-
pt-asid-
pr last tcb-addr
SSAR
newsasid
sasd
pr last tcb-addr
SSSR
newsasid
sasd
pr last tcb-addr
BSG
alet
pasd
bsg-addr
PR
pr: TTE を作成したプロセッサーの ID。
ASID
last: TTE に関連する最後のホーム・アドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: TTE の作成対象となった現行タスクのタスク制御ブロック (TCB) の
アドレス。
IDENT
以下の
PC
PR
PT
PTI
SSAR
SSIR
BSG
TTE ID。
プログラム呼び出し制御命令
プログラム戻り制御命令
プログラム転送制御命令
インスタンス付きプログラム転送 (PTI) 制御命令
2 次アドレス・スペース番号設定制御命令
インスタンス付き 2 次アドレス・スペース番号設定 (SSAIR) 制御命令
サブスペース・グループでの分岐制御命令
CD/D
ブランク
PSW----- ADDRESSalet: BSG 実行中の ALET ワード
newsasid: SSAR 命令から得られた新しい SASID
return--: 呼び出し側の戻りアドレス
psw-key-: プログラム状況ワード (PSW) キー
pkey-flag: プログラム状況ワード (PSW) のキーとフラグ。フラグの値は、
ブランク、または 1 ∼ 3 の 16 進値。
– 0 - PSW ビット 31 がゼロで置き換えられた。また、置き換えられる
前、PSW ビット 31 はゼロだった。
– 1 - PSW ビット 31 が 1 で置き換えられた。また、置き換えられる前、
PSW ビット 31 はゼロだった。
– 2 - PSW ビット 31 がゼロで置き換えられた。また、置き換えられる
前、PSW ビット 31 は 1 だった。
– 3 - PSW ビット 31 が 1 で置き換えられた。また、置き換えられる前、
PSW ビット 31 は 1 だった。
pc-addr-: PC 命令から得られた戻りアドレス
8-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
pr-addr-: PR 命令によって更新された新しい命令アドレス
pt-addr-: PT 命令によって更新された新しい命令アドレス
bsg-addr: BSG 命令によって更新された新しい命令アドレス
アドレスは、次のフォーマットで表示されます。
アドレッシング・モードおよび位置
表示
24 ビット・アドレス
xxxxxx
31 ビット・アドレス
xxxxxxxx
高位ビットにゼロが入った 64 ビット・アドレス
ゼロ以外の高位ビットをもつ 64 ビット・アドレス
00_xxxxxxxx
xxxxxxxx_xxxxxxxx
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
pc#-----: PC 命令から得られた PC 番号
pr-faddr: PR 命令のあとの位置のアドレス
pt-asid-: PT 命令で指定された新しい ASID
PSACLHSこのフィールドには、PC トレース項目の一部の記述テキストが入ります。この
記述テキストは SNAP、SYSUDUMP、または SYSABEND の各出力には表示さ
れません。
PSALOCAL
このフィールドには、PC トレース項目の一部の記述テキストが入ります。この
記述テキストは SNAP、SYSUDUMP、または SYSABEND の各出力には表示さ
れません。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。このフィールドには、PC
トレース項目の一部の記述テキストが入ります。この記述テキストは SNAP、
SYSUDUMP、または SYSABEND の各出力には表示されません。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。このフィールドには、PC
トレース項目の一部の記述テキストが入ります。この記述テキストは SNAP、
SYSUDUMP、または SYSABEND の各出力には表示されません。
TIMESTAMP-RECORD
ブランク
CP
ブランク
MODE および MOBR トレース項目
目的
以下のトレース項目は、アドレッシング・モードの変更を表しています。
v MODE トレース項目は、64 ビットへのまたは 64 ビットからのアドレッシン
グ・モードの変更を表しています。
v MOBR トレース項目は、命令アドレスの変更を伴う 64 ビットへのまたは 64 ビ
ットからのアドレッシング・モードの変更を表しています。
第 8 章 システム・トレース
8-13
システム・トレース
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr last tcb-addr
MODE
target
address-
address- address- address- address- etc.
pr last tcb-addr
MOBR
target
address-
address- address- address- address- etc.
CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
last: トレース・バッファー内の最後のホーム・アドレス・スペース ID
(ASID)。
TCB-ADDR
tcb-addr: TTE の作成対象となった現行タスクのタスク制御ブロック (TCB) の
アドレス。
IDENT
以下の TTE ID。
MODE アドレッシング・モード変更命令
MOBR ブランチ命令と結合したアドレッシング・モード変更
CD/D
ブランク
PSW----target: ターゲットのアドレッシング・モード
24 or 31
ターゲットのアドレッシング・モードは、24 ビットまたは 31 ビット
のどちらかです。
64
ターゲットのアドレッシング・モードは、64 ビットです。
ADDRESSUNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
PSACLHSPSALOCAL
PASD
SASD
TIMESTAMP-RECORD
CP
address-: ターゲット・アドレス。アドレスは、次のフォーマットで表示されま
す。
アドレッシング・モードおよび位置
24 ビット・アドレス
xxxxxx
31 ビット・アドレス
xxxxxxxx
高位ビットにゼロが入った 64 ビット・アドレス
ゼロ以外の高位ビットをもつ 64 ビット・アドレス
8-14
表示
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
00_xxxxxxxx
xxxxxxxx_xxxxxxxx
システム・トレース
DSP、SRB、SSRB、および WAIT トレース項目
目的
これらのトレース項目は、作業単位のディスパッチを表しています。
v DSP トレース項目は、タスクのディスパッチを表します。
v SRB トレース項目は、サービス要求の初期ディスパッチを表します。
v SSRB トレース項目は、延期されたサービス要求のディスパッチを表します。
v WAIT トレース項目は、待機タスクのディスパッチを表します。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
CP
pr home
wu-addr
DSP
dsp-new- psw-----
psamodew gpr0---- gpr1----
psaclhs- psalocal pasd sasd timestamp-------
02
pr home
wu-addr
SRB
srb-new- psw-----
safnasid gpr0---- gpr1---purgetcb flg-srb-
srbhlhi-
pasd sasd timestamp-------
02
pr home
wu-addr
SSRB
ssrb-new psw-----
safnasid
psaclhs4 psalocal pasd sasd timestamp-------
02
pr home
wu-addr
WAIT
timestamp-------
02
gpr1----
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
WU-ADDR
wu-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の
DSP
SRB
SSRB
WAIT
TTE ID。
タスク・ディスパッチ
初期サービス要求ディスパッチ
延期サービス要求ディスパッチ
待機タスク・ディスパッチ
CD/D
ブランク
PSW----- ADDRESSdsp-new- psw: ディスパッチされるプログラム状況ワード (PSW)
srb-new- psw: SRB ディスパッチで制御を受け取る PSW
ssrb-new psw: SSRB 再ディスパッチで制御を受け取る PSW
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
gpr0----: 汎用レジスター 0
gpr1----: 汎用レジスター 1
psamodew: PSA の PSAMODEW フィールド
safnasid: 論理構成通信域 (LCCA) の LCCASAFN フィールドおよび関連の
ASID
flg-srb: SRB から得られた SRBFLGS フィールド
第 8 章 システム・トレース
8-15
システム・トレース
purgetcb: SRB がアベンドしてパーコレートする場合に制御が渡る TCB
(SRB のスケジューラーのアドレス・スペース内にある)
PSACLHSpsaclhs-: PSA の PSACLHS フィールドから得られた、現在保持されている
ロック用のストリング。
psaclhs4: PSA の PSACLHS4 フィールド
srbhlhi-: SRB の SRBHLHI フィールド
このフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは SNAP、SYSUDUMP、または
SYSABEND の各出力には表示されません。
PSALOCAL
psalocal: PSA の PSALOCAL フィールドから得られた、ローカルでロックさ
れているアドレス・スペース標識。このフィールドには、SVC、SSRV、および
PC の各トレース項目の一部の記述テキストが入ります。この記述テキストは
SNAP、SYSUDUMP、または SYSABEND の各出力には表示されません。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。このフィールドには、
SVC、SSRV、および PC の各トレース項目の一部の記述テキストが入ります。
この記述テキストは SNAP、SYSUDUMP、または SYSABEND の各出力には表
示されません。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。このフィールドには、
SVC、SSRV、および PC の各トレース項目の一部の記述テキストが入ります。
この記述テキストは SNAP、SYSUDUMP、または SYSABEND の各出力には表
示されません。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
CSCH、HSCH、MSCH、RSCH、SSCH、SIGA、および XSCH トレース
項目
目的
これらのトレース項目は、入出力操作を表しています。
v CSCH トレース項目は、サブチャネル切断操作を表しています。
v HSCH トレース項目は、サブチャネル停止操作を表しています。
v MSCH トレース項目は、サブチャネル修正操作を表しています。
v RSCH トレース項目は、サブチャネル再開操作を表しています。
8-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
v SSCH トレース項目は、サブチャネル開始操作を表しています。
v SIGA トレース項目は、シグナル・アダプター操作を表しています。
v XSCH トレース項目は、サブチャネル取り消し操作を表しています。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
CP
pr asid tcb-addr
CSCH
dev cc
di
iosbaddr
ucb-addr ioq-addr asc-iosb
timestamp-------
CP
pr asid tcb-addr
HSCH
dev cc
di
iosbaddr
ucb-addr ioq-addr asc-iosb
timestamp-------
CP
pr asid tcb-addr
MSCH
dev cc
iosbaddr
ucb-addr f1f2pmom mbi-t2lb
timestamp-------
CP
pr asid tcb-addr
RSCH
dev cc
di
iosbaddr
ucb-addr
timestamp-------
CP
pr asid tcb-addr
SSCH
dev cc
di
iosbaddr
timestamp-------
CP
pr asid tcb-addr
XSCH
dev cc
di
iosbaddr
ucb-addr orb-wrd2 orb-wrd3
orb-wrd4 cap-addr bdev
ucb-addr ioq-addr bdev
timestamp-------
CP
pr asid tcb-addr
SIGA
dev cc
fc
qib-addr
subsysid q-mask-1 q-mask-2
ucb-addr
time stamp-------
CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
asid: 入出力に関連するアドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の
CSCH
HSCH
MSCH
RSCH
SSCH
XSCH
SIGA
TTE ID。
サブチャネル切断操作
サブチャネル停止操作
サブチャネル修正操作
サブチャネル再開操作
サブチャネル開始操作
サブチャネル取り消し操作
シグナル・アダプター操作
RSCH、SSCH または SIGA の前のアスタリスクは、その入出力に関連する条件
コードが 0 になっていなかったことを表しています。
CD/D
dev: 次のうちのいずれか
– 入出力と関連する装置番号。必要な場合には、サブチャネル・セット ID
が含まれます。
– IOSADMF マクロがデータを転送していた場合には、ADMF
PSW----- ADDRESScc: 入出力に関連するビット 2 および 3 の中の条件コード
di: 入出力に関連するドライバー ID
fc: 入出力に関連する機能コード
iosbaddr: 入出力に関連する入出力監視プログラム・ブロック (IOSB) アド
レス
第 8 章 システム・トレース
8-17
システム・トレース
qib-addr: 入出力に関連するキュー識別ブロック (QIB) アドレス
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
asc-iosb: 入出力に対する関連 SSCH 要求の IOSB アドレス
bdev: 入出力が別名装置に関連する場合の基本装置番号。
cap-addr: 獲得された、SSCH I/O に関連する装置制御ブロック (UCB) アド
レス。このフィールドは、16 MB より下位の UCB または 16 MB より上
位の実際の UCB アドレスがサブチャネル開始 (SSCH) 操作に使用された場
合にはブランクになります。16 MB より上位の実際の UCB のアドレス
は、ucb-addr フィールドにあります。
f1f2pmom: 入出力と関連するサブチャネル情報ブロック (SCHIB) から得ら
れ、以下のとおりです。
f1
SCHFLG1 フラグ・フィールド
f2
SCHFLG2 フラグ・フィールド
pm
SCHLPM フィールド
om
SCHPOM フィールド
ioq-addr: 入出力と関連する入出力キュー (IOQ) アドレス
mbi-t2lb:
mbiSCHIB から得られる SCHMBI フィールド
t2
IOSB から得られる IOSOPT2 フィールド
lb
IOSB から得られる IOSFLB フィールド
orb-wrd2: 入出力に関連する操作要求ブロック (ORB) のワード 2
orb-wrd3: 入出力に関連する操作要求ブロック (ORB) のワード 3
orb-wrd4: 入出力に関連する操作要求ブロック (ORB) のワード 4
q-mask-1: 入出力に関連するキュー・マスクの読み取りまたは書き込み
q-mask-2: 入出力に関連するキュー・マスクの読み取り
subsysid: 入出力に関連するサブシステム ID
ucb-addr: 入出力に関連する装置制御ブロック (UCB) アドレス
PSACLHSこのフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出
力には表示されません。
PSALOCAL
このフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出
力には表示されません。
PASD
このフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出
力には表示されません。
SASD
このフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出
力には表示されません。
8-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
CALL、CLKC、EMS、EXT、I/O、MCH、RST、および SS トレース項目
目的
これらのトレース項目は、割り込みを表しています。
v そのうち 5 つの項目は外部割り込みを表しています
– CALL トレース項目は、外部呼び出しを表します
– CLKC トレース項目は、時刻比較機構を表します
– EMS トレース項目は、緊急信号を表します
– EXT トレース項目は、汎用外部割り込みを表します
– SS トレース項目は、サービス信号を表します
v I/O トレース項目は入出力割り込みを表します
v MCH トレース項目は、マシン・チェックを表します
v RST トレース項目は、再始動を表します
項目のフォーマット
PR ASID
WU-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6 PSACLHSE-
CP
pr home tcb-addr
CALL
ext-old- psw-----
psaeepsw pccarph
psaclhs- psalocal pasd sasd timestamp------psaclhse-
06
pr home tcb-addr
CLKC
ext-old- psw-----
psaeepsw tge-tcb- tge-asid
psaclhs- psalocal pasd sasd timestamp------psaclhse-
06
pr home tcb-addr
EMS
ext-old- psw-----
psaeepsw pccaemsi pccaemsp
pccaemse
psaclhs- psalocal pasd sasd timestamp-------
pr home tcb-addr
EXT
code ext-old- psw-----
psaeepsw
psaclhs- psalocal pasd sasd timestamp------psaclhse-
pr home tcb-addr
I/O
dev i/o-old- psw-----
pr home tcb-addr *MCH
pr home tcb-addr *RST
pr home tcb-addr
SS
06
06
flg-ctl- ccw-addr dvch-cnt psaclhs- psalocal pasd sasd timestamp------- 06
ucb-addr ext-stat psaclhsemch-old- psw----- machine- chk-code psasuper psaclhs- psalocal pasd sasd timestamp------- 06
psaclhserst-old- psw----- gpr15--- gpr0---- gpr1---- psaclhs- psalocal pasd sasd timestamp------- 06
psasuper psamodew
ext-old- psw-----
psaeepsw psaeparm msf-bcmd psaclhs- psalocal pasd sasd timestamp------flg-brsp mssfasid mssfatcb psaclhse-
06
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
第 8 章 システム・トレース
8-19
システム・トレース
WU-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の
CALL
CLCK
EMS
EXT
I/O
MCH
RST
SS
TTE ID。
外部呼び出し外部割り込み
時刻比較機構外部割り込み
緊急信号外部割り込み
汎用外部割り込み
入出力割り込み
マシン・チェック割り込み
再始動割り込み
サービス信号外部割り込み
MCH および RST の前には常にアスタリスク (*) が示され、通常と異なる条件
が発生していることを表します。
EXT の前のアスタリスクは、その割り込みが誤動作警報 (MFA) であるか、あ
るいは外部割り込みキーを押したために発生したものであることを表していま
す。
I/O の前のアスタリスクは、割り込み要求ブロック (IRB) の IRBFLAGS フィー
ルド内の以下のビットが ON になっていることを表しています。IRBFLAGS フ
ィールドは、I/O 項目の UNIQUE-1 列にあります。
v IRBN (パスが操作不能)
v IRBSALRT (警報状況)
CD/D
code: 外部割り込みコード
dev: 入出力に関連する装置番号、またはコプロセッサー装置の場合は、
ADM のように入出力コプロセッサー ID。
PSW----- ADDRESSext-old- psw:
i/o-old- psw:
mch-old- psw:
rst-old- psw:
外部の旧プログラム状況ワード (PSW)
入出力の旧 PSW
マシン・チェックの旧 PSW
再始動の旧 PSW
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
ccw-addr: その入出力のチャネル・コマンド・ワード (CCW) のアドレス
-cnt: 残余カウント
dvch: 装置状況およびサブチャネル状況
ext-stat: 拡張状況ワード
flg-brsp: 保守サービス・サポート機能 (MSSF) のハードウェア・フラグお
よび MSSF 応答コード
flg-ctl-: IRB の IRBFLAGS フィールドおよびサブチャネル制御バイト
gpr15--- gpr0---- gpr1----: 汎用レジスター 15、0、および 1
machine- chk-code: 接頭部は保管域 (PSA) の FLCMCIC フィールドから得
られた、マシン・チェック割り込みコード。
msf-bcmd: サービス・プロセッサー・コマンド・ワード
mssfasid: サービス・プロセッサーのアドレス・スペース ID
8-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
mssfatch: サービス・プロセッサーの TCB アドレス
pccaemse: 物理構成連絡域 (PCCA) の PCCAEMSE フィールド
pccaemsi: PCCA の PCCAEMSI フィールド
pccaemsp: PCCA の PCCAEMSP フィールド
pccarph-: PCCA の PCCARPB フィールド
psaeepsw: PSA の PSAEEPSW フィールド。CALL および EMS の場合、バ
イト 1 および 2 には発行側プロセッサーのアドレスが入っています。すべ
ての項目で、バイト 3 および 4 には外部割り込みコードが入っています。
psaeparm: PSA の PSAEPARM フィールド。MSSF バッファー・アドレスが
入っています。
psamodew: PSA の PSAMODEW フィールド
psasuper: PSA の PSASUPER フィールド
tge-asid: 関連するタイマー・キュー・エレメント (TQE) の ASID
tge-tcb-: 関連する TQE の TCB 内のアドレス、または、システム TQE
の TQE アドレス
ucb-addr: 装置制御ブロック (UCB) アドレス
PSACLHSpsaclhs-: PSA の PSACLHS フィールドから得られた、現在保持されているロ
ック用のストリング。
PSACLHSEpsaclhse-: PSA の PSACLHSE フィールドから得られた、現在保持されている
ロック用の拡張ストリング。
PSALOCAL
psalocal: PSA の PSALOCAL フィールドから得られた、ローカルでロックさ
れているアドレス・スペース標識。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
SUSP トレース項目
目的
SUSP トレース項目は、中断タイプのロックが要求され、そのロックが使用不可能
なために要求側が中断されたことを表します。
第 8 章 システム・トレース
8-21
システム・トレース
項目のフォーマット
PR ASID TCB-ADDR
pr home tcb-addr
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6 PSACLHSESUSP
return--
rb-addr- suspndid rel-addr psaclhs- psalocal
ssrbaddr
psaclhse-
timestamp-------
CP
02
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: 現行タスクに関するタスク制御ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
SUSP
ロック中断
CD/D
ブランク
PSW----- ADDRESSreturn--: 呼び出し側の戻りアドレス
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
rb-addr-: 中断された要求ブロック (RB) のアドレス。
rel-addr: ロック中断のタイプに関連するアドレス。
– 0: LOCL ロックの場合
– ASCB アドレス: CML ロックの場合
– ロックワード・アドレス: CEDQ、CLAT、CMS、および CSMF ロックの
場合
ssrbaddr: 中断されたサービス要求ブロック (SSRB) のアドレス。
suspndid: ロック中断タイプの ID。 CEDQ、CLAT、CML、CMS、CSMF、
または LOCL
PSACLHSpsaclhs-: PSA の PSACLHS フィールドから得られた、現在保持されているロ
ック用のストリング。
PSACLHSEpsaclhse-: PSA の PSACLHSE フィールドから得られた、現在保持されている
ロック用の拡張ストリング。
PSALOCAL
psalocal: PSA の PSALOCAL フィールドから得られた、ローカルでロックさ
れているアドレス・スペース標識。
PASD
ブランク
SASD
ブランク
8-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
|
PGM、SPER および SPR2 トレース項目
目的
これらのトレース項目は、プログラム・イベントを表しています。
v PGM トレース項目は、プログラム割り込みを表します。
v SPER トレース項目は、SLIP トラップで要求された PER イベントを表します。
v SPR2 トレース項目は、STDATA キーワードがトラップで指定されているとき
の、SLIP トラップで要求された PER イベントを表します。
|
|
項目のフォーマット
|
|
|
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6 PSACLHSE-
CP
pr home tcb-addr
PGM
pr home tcb-addr
SPER code pgm-old- psw-----
pr home tcb-addr
SPER code pgm-old- psw-----
code pgm-old- psw-----
ilc-code tea----tea----ilc-code
trap---per-addH per-addL
psaclhs- psalocal pasd sasd timestamp------psaclhsepsaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
var1
var4
psaclhs-
CP
var2
var5
var3
spc-exc
psalocal pasd sasd timestamp-------
CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
PGM プログラム割り込み
SPER SLIP プログラム・イベント記録
PGM の前のアスタリスク (*) は、通常とは異なる条件を表します。解決される
可能性のあるプログラム割り込みの PGM トレース項目にはフラグが付いてい
ません。プログラム割り込みが解決されない場合は、後続の RCVY トレース項
目が作成され、アスタリスクでフラグが付けられます。
CD/D
code (PGM 項目の場合): プログラム割り込みコード
第 8 章 システム・トレース
8-23
システム・トレース
code (SPER 項目の場合): PER 番号
PSW----- ADDRESSpgm-old- psw: プログラムの旧プログラム状況ワード (PSW)
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
ilc-code: 命令長コードおよび割り込みコード
per-addH: SLIP/PER 状況アドレスの上位ビット
per-addL: SLIP/PER 状況アドレスの下位ビット
tea-----: 変換例外アドレス。高位ビットの 0 は 1 次を表し、1 は 2 次を
表します。
trap----: ID=xxxx 形式による SLIP/PER トラップ ID
var1、var2、var3、var4、var5: それぞれは STDATA キーワードで指定さ
れた変数データを 1 ワード含んでいます。
spc-exc: 変数データの 5 ワードを超えるデータが STDATA キーワードで
要求されたときの、メッセージ SpaceExc。
|
|
|
|
PSACLHSpsaclhs-: PSA の PSACLHS フィールドから得られた、現在保持されているロ
ック用のストリング。
PSACLHSEpsaclhse-: PSA の PSACLHSE フィールドから得られた、現在保持されている
ロック用の拡張ストリング。
PSALOCAL
psalocal: PSA の PSALOCAL フィールドから得られた、ローカルでロックさ
れているアドレス・スペース標識。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
RCVY トレース項目
目的
RCVY トレース項目は、エラーまたは割り込みのあとでリカバリー・ルーチンに入
ったことを表します。
8-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
特定の RCVY イベントのあとの再入
次の 5 つのタイプのリカバリー・イベントでは、新しい環境またはアドレス・スペ
ースに入り直す必要があります。RCVY トレース・イベントがどのような場合に再
入を必要とするのかは、次の表を参照してください。
リカバリー・
イベントの
トレース項目
再入
再入のトレース項目
RCVY ABT
終了するタスクが現行ホーム・アド
レス・スペース以外のアドレス・ス
ペースに入っている場合にだけ必要
RCVY ITRM
常に必要
RCVY ITRR (終了する作業単位が
ローカルでロックされているか、あ
るいはこの作業単位で EUT FRR
が設定されている場合)
RCVY MEM
常に必要
RCVY MEMR
RCVY RCML
常に必要
RCVY RCMR
RCVY STRM
常に必要
RCVY STRR (終了する作業単位が
SRB モードになっているか、ロー
カルでロックされているか、あるい
はこの作業単位で EUT FRR が設
定されている場合)
RCVY ABTR
第 8 章 システム・トレース
8-25
システム・トレース
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6 PSACLHSE-
pr home tcb-addr *RCVY ABRT
trk-----
CP
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
comp---- reas---- rc------ psaclhs- psalocal pasd sasd timestamp------asid---- tcb----pasclhse-
CP
pr home tcb-addr *RCVY ABTR
comp---- reas---- rc------ psaclhs- psalocal pasd sasd timestamp------asid---- tcb----pasclhse-
CP
pr home tcb-addr *RCVY DAT
comp---- reas---- psasuper
psaclhs- psalocal pasd sasd timestamp------pasclhse-
CP
comp---- reas---- psasuper psaclhs- psalocal pasd sasd timestamp------fpw----- psaclhse-
CP
comp---- reas---pppp---- pppp----
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
pr home tcb-addr *RCVY ITRR
comp---- reas---pppp---- pppp----
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
pr home tcb-addr *RCVY MCH
comp---- reas---- psasuper
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
comp---- reas---- rc------ psaclhs- psalocal pasd sasd timestamp------asid---psaclhse-
CP
pr home tcb-addr *RCVY MEMR
comp---- reas---asid----
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
pr home tcb-addr *RCVY PERC
comp---- reas----
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
comp---- reas---- asid---- psaclhs- psalocal pasd sasd timestamp------pppp---- pppp---psaclhse-
CP
pr home tcb-addr *RCVY RCMR
comp---- reas---pppp---- pppp----
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
pr home tcb-addr *RCVY RESM retry--- psw-----
comp---- reas---- psasuper psaclhs- psalocal pasd sasd timestamp------cpu----fpw----- psaclhse-
CP
pr home tcb-addr *RCVY RSRT
comp---- reas---- psasuper
CP
pr home tcb-addr *RCVY RTRY retry--- psw-----
comp---- reas---- psasuper psaclhs- psalocal pasd sasd timestamp------fpw----- psaclhse-
pr home tcb-addr *RCVY SABN
comp---- reas---- psasuper
psaclhs- psalocal pasd sasd timestamp------psaclhse-
CP
pr home tcb-addr *RCVY SPRC
comp---- reas---- psasuper psaclhs- psalocal pasd sasd timestamp------asid---- tcb----- fpw----- psaclhse-
CP
comp---- reas---- tcb----- psaclhs- psalocal pasd sasd timestamp------pppp---- pppp---psaclhse-
CP
comp---- reas---- tcb---pppp---- pppp----
CP
pr home tcb-addr *RCVY ABT
pr home tcb-addr *RCVY FRR
return--
frr-new- psw-----
pr home tcb-addr *RCVY ITRM
return--
pr home tcb-addr *RCVY MEM
return--
fpw----pr home tcb-addr *RCVY PROG
comp---- reas---- psasuper
pr home tcb-addr *RCVY RCML
return--
pr home tcb-addr *RCVY STRM
return--
pr home tcb-addr *RCVY STRR
psaclhs- psalocal pasd sasd timestamp------psaclhse-
psaclhs- psalocal pasd sasd timestamp------psaclhse-
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
8-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
RCVY リカバリー・イベント
RCVY の前には常にアスタリスク (*) が示され、通常と異なる条件が発生して
いることを表します。
CD/D
以下に示す、リカバリー・イベントのタイプ。
ABRT: なんらかのリカバリー終了管理 (RTM) 処理中にリカバリー不能エラ
ーが起こったことによる打ち切り処理
ABT: CALLRTM TYPE=ABTERM マクロによるタスク異常終了の要求 (シス
テムまたはユーザー完了コードが戻されます)
ABTR: タスクがホーム・アドレス・スペースに入っていない場合の、タスク
終了のための CALLRTM TYPE=ABTERM 要求の再スケジュール
DAT: 動的アドレス変換 (DAT) エラーが原因で RTM1 に入った
FRR: 機能リカバリー・ルーチン (FRR) を呼び出すための RTM1 処理
ITRM: 割り込みを受けたタスクを終了させることをシステムが RTM1 に要求
ITRR: 割り込みを受けたタスクを終了させる要求を処理するための ITRM 再
入
MCH: マシン・チェック割り込みが原因で RTM1 に入った
MEM: CALLRTM TYPE=MEMTERM マクロによるメモリー異常終了の要求
(完了コードが戻されます)
MEMR: MEM イベントのあとのメモリー異常終了の処理
PERC: リカバリー処理を継続するための、RTM1 から RTM2 までのリカバ
リー機能委任
PROG: プログラム・チェック割り込みが原因で RTM1 に入った
RCML: 障害のあるアドレス・スペース内のタスクに関する特別な終了処理を
実行するために、RTM1 に入った。障害のあるアドレス・スペースには、別
のアドレス・スペースのローカル・ロックが保留されている。
RCMR: リソース・マネージャーによる異常終了を処理するための RCML 再
入
RESM: RSRT 入力に続く RESTART 要求のあとの FRR から再開
RSRT: オペレーターからの RESTART 要求により RTM に入った
RTRY: FRR からの再試行
SABN: 現行作業単位を終了させることをシステムが RTM1 に要求
SPRC: サービス要求ブロック (SRB) リカバリーからの最後のリカバリー機能
委任
STRM: 中断されたタスクを異常終了させることをシステムが RTM1 に要求
STRR: 中断されたタスクの異常終了を処理するための STRM 再入
PSW----- ADDRESSreturn--: 呼び出し側の戻りアドレス
frr-new- psw-----: FRR に制御を与えるための新規プログラム状況ワード
(PSW)
retry--- psw-----: 再試行 PSW
第 8 章 システム・トレース
8-27
システム・トレース
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
asid----: 終了処理のターゲット ASID
SPRC 項目内の ASID は、SRB からタスクへのリカバリー機能委任によ
って異常終了するタスクの ASID です。このフィールドと
tcb-----: フィールドがゼロになっている場合には、SRB からタスクへのリ
カバリー機能委任は実行されません。
comp----: システムまたはユーザー完了コード
cpu-----: オペレーターの RESTART 要求のあとで出された FRR 再開の要
求で指定された、再始動エラーのターゲット・プロセッサー。
fpw-----: 次のフォーマットの FRR 処理ワード
rsxxxxxp xxxxxxxx ssssssss eeeeeeee
r
Bit 0 = 1 は、リソース・マネージャーが FRR に入ったことを意味
します。
s
Bit 1 = 1 は、FRR がスキップされたことを意味します。
p
Bit 7 = 0 は、SRB からタスクへのリカバリー機能委任が逐次化さ
れていないことを意味します。
Bit 7 = 1 は、SRB からタスクへのリカバリー機能委任が逐次化さ
れていることを意味します。
ssssssss
スタック索引、すなわち FRR スタックの索引です。この索引の意味
は次のとおりです。
0 通常スタック
1 SVC 入出力タスク・ディスパッチング・プログラム・スタッ
ク
2 マシン・チェック・スーパー・スタック
3 PC FLIH スーパー・スタック
4 外部 FLIH スーパー・スタック 1
5 外部 FLIH スーパー・スタック 2
6 外部 FLIH スーパー・スタック 3
7 再始動スーパー・スタック
8 ACR スーパー・スタック
9 RTM スーパー・スタック
eeeeeeee
項目索引、すなわちスタック上の FRR 項目の索引です。この索引の
範囲は 0 から 16 までです。現行スタックがスーパー・スタックで
ある場合には、索引 0 はスーパー FRR を意味します。
pppp---- pppp----: 割り込みを受けた作業単位の PSW。
この PSW 内の命令は、障害の原因となっていない可能性があります。
たとえば、時間制限が満了したために割り込みが発生した場合には、割り
込みを受けた命令には障害はありません。
rc------: CALLRTM からの戻りコード
reas----: この項目に表示される完了コードに伴う理由コード。理由コード
が提供されない場合には、NONE。
psasuper: 接頭部は保管域 (PSA) の PSASUPER フィールド
8-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
tasn----: RCML 再入のためのターゲット ASID
tcb-----: 終了処理のためのターゲット・タスク制御ブロック (TCB)
SPRC 項目内の TCB は、SRB からタスクへのリカバリー機能委任によ
って異常終了するタスクの TCB です。このフィールドと asid---- フィ
ールドがゼロになっている場合には、SRB からタスクへのリカバリー機
能委任は実行されません。
STRM または STRR 項目で TCB アドレスがゼロになっている場合に
は、その要求が中断 SRB を終了させるためのものであったことを意味し
ます。
trk-----: RTM1 エラー・トレース・エリア
PSACLHSpsaclhs-: PSA の PSACLHS フィールドから得られた、現在保持されているロ
ック用のストリング。
PSACLHSEpsaclhse-: PSA の PSACLHSE フィールドから得られた、現在保持されている
ロック用の拡張ストリング。
PSALOCAL
psalocal: PSA の PSALOCAL フィールドから得られた、ローカルでロックさ
れているアドレス・スペース標識。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
SVC、SVCE、および SVCR トレース項目
目的
これらのトレース項目は、監視プログラム・イベントを表しています。
v SVC トレース項目は、監視プログラム呼び出し (SVC) 命令の処理の場合の項目
です。
v SVCE トレース項目は、SVC 命令の処理中に発生したエラーの場合の項目です。
v SVCR トレース項目は、SVC 命令処理からの戻りの場合の項目です。
第 8 章 システム・トレース
8-29
システム・トレース
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD
UNIQUE-4 UNIQUE-5 UNIQUE-6
CP
pr home tcb-addr
SVC
timestamp-------
02
pr home tcb-addr
SVCE code svc-old- psw-----
gpr15--- gpr0---- gpr1---- psaclhs- psalocal pasd sasd timestamp------env-data
psaclhse-
02
pr home tcb-addr
SVCR code ret-new- psw-----
gpr15--- gpr0---- gpr1----
02
code svc-old- psw-----
gpr15--- gpr0---- gpr1----
timestamp-------
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の
SVC
SVCE
SVCR
TTE ID。
監視プログラム呼び出し (SVC) 割り込み
SVC エラー
SVC 戻り
SVC、SVCE、または SVCR の前のアスタリスクは、その SVC が異常終了
(SVC D) に関するものであり、その異常終了が通常のタスク終了に関するもの
ではないこと、つまり、(UNIQUE-3 列にある) レジスター 1 の左端バイト内の
ビット X'08' がオンになっていないことを表しています。
CD/D
code: SVC 番号
PSW----- ADDRESSret-new- psw: SVC が再びディスパッチされたときに制御を受け取るプログ
ラム状況ワード (PSW)
svc-old- psw: SVC の旧 PSW
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
gpr15--- gpr0---- gpr1----: 汎用レジスター 15、0、および 1
env-data: 障害が起こっている環境の特性。次のいずれかの値になります。
v 00000004 - SVC の発行元が SRB モードだった
v 00000008 - SVC の発行元がロックされていた
v 0000000C - SVC の発行元が使用不可だった
v 00000010 - SVC の発行元が仮想記憶間モードだった
v 00000014 - SVC の発行元が EUT FRR モードだった
v 00000018 - SVC の発行元が AR モードだった
PSACLHSpsaclhs-: SVCE の場合、PSA の PSACLHS フィールドから得られた、現在保
持しているロック用のストリング。このフィールドには、SVC トレース項目の
8-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
一部の記述テキストが入ります。この記述テキストは SNAP、SYSUDUMP、ま
たは SYSABEND の各出力には表示されません。
PSACLHSEpsaclhse-: SVCE の場合、PSA の PSACLHSE フィールドから得られた、現在
保持されているロック用の拡張ストリング。
PSALOCAL
psalocal: SVCE の場合、PSA の PSALOCAL フィールドから得られた、ロー
カルでロックされているアドレス・スペース標識。このフィールドには、SVC
トレース項目の一部の記述テキストが入ります。この記述テキストは
SNAP、SYSUDUMP、または SYSABEND の各出力には表示されません。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。このフィールドには、
SVC トレース項目の一部の記述テキストが入ります。この記述テキストは
SNAP、SYSUDUMP、または SYSABEND の各出力には表示されません。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。このフィールドには、
SVC トレース項目の一部の記述テキストが入ります。この記述テキストは
SNAP、SYSUDUMP、または SYSABEND の各出力には表示されません。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
SSRV トレース項目
目的
SSRV トレース項目は、システム・サービスに入ったことを表します。このサービ
スへは、PC 命令または分岐によって入ることができます。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD CP
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr home tcb-addr
SSRV ssid
return--
data---- data---- data----
psaclhs- psalocal pasd sasd timestamp------- 06
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
第 8 章 システム・トレース
8-31
システム・トレース
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
SSRV
システム・サービスの要求
CD/D
ssid: SSRV 項目 ID
SSRV 項目 ID には、以下のものがあります。
8-32
ssid (16 進数)
0001
0002
0004
0005
000A
005F
SSRV 要求のためのマクロ
WAIT
POST
GETMAIN
FREEMAIN
GETMAIN、FREEMAIN
SYSEVENT
0078
007A
GETMAIN、FREEMAIN
SPI、SPIINT
0100
0101
0102
0103
0104
0105
0106
0107
0108
0109
010A
010E
010F
0110
0111
0112
0113
0114
0115
0116
0117
0118
0119
011A
011B
011C
011D
011E
011F
0128
0129
012A
ETCON
ETCRE
ATSET
AXSET
AXEXT
AXFRE
AXRES
ETDES
ETDIS
LXFRE
LXRES
SUSPEND
RESUME
SCHEDULE
SCHEDULE
SCHEDULE
DSGNL
RISGNL
RPSGNL
SCHEDULE
SCHEDULE
SUSPEND
RESUME
RESUME
RESUME
SCHEDULE
IEAMSCHD
IEAVPSE または IEAVXFR
IEAVRLS または IEAVXFR
WAIT
POST
POST
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント
タスク管理
タスク管理
仮想記憶管理
仮想記憶管理
仮想記憶管理
システム・リソース・
マネージャー
仮想記憶管理
サービス・プロセッサー・インタ
ーフェース
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
PC/AUTH
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
監視プログラム制御
タスク管理
タスク管理
タスク管理
システム・トレース
|
|
|
ssid (16 進数)
012B
012C
012D
012E
0132
0133
0146
SSRV 要求のためのマクロ
POST
ASCBCHAP
STATUS
STATUS
STORAGE OBTAIN
STORAGE RELEASE
SPI、SPIINT
014B
014C
014D
014E
014F
IARV64
ISGENQ
ENQ/RESERVE
DEQ
SYSCALL
コンポーネント
タスク管理
タスク管理
タスク管理
タスク管理
仮想記憶管理
仮想記憶管理
サービス・プロセッサー・インタ
ーフェース
実記憶管理
グローバル・リソース逐次化
グローバル・リソース逐次化
グローバル・リソース逐次化
UNIX® システム・サービス
PSW----- ADDRESSreturn--:
v PC/AUTH、監視プログラム制御、およびタスク管理の場合: 分岐によってサ
ービスに入った場合には呼び出し側の戻りアドレス。PC 命令によってサービ
スに入った場合には 0。
v 仮想記憶管理の場合: SSRV 132 (ストレージの入手) および SSRV 133 (スト
レージの解放) では、ALET になります。 そのほかの VSM SSRV
(004、005、00A、078) では、呼び出し元の戻りアドレスになります。
|
v Unix システム・サービス、シスコール・コード
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
data----: データ。各イベントについて固有のトレース・データがデータ・エリ
アから得られます。PC/AUTH、監視プログラム制御、およびタスク管理のエリ
アについては、z/OS MVS Data Areas, Vol 5 (SSAG-XTLST) に記載されていま
す。
v PC/AUTH コンポーネントに対する SSRV 要求の場合: PCTRC データ・エリ
ア
v 監視プログラム制御に対する SSRV 要求の場合: SPTRC データ・エリア
v タスク管理に対する SSRV 要求の場合: TMTRC データ・エリア
v 仮想記憶管理に対する SSRV 要求の場合のデータは、以下のとおりです。
– UNIQUE-1 の下は、VSM 記憶サービスへの入力情報。
- バイトは以下のとおりです。
0
フラグ:
X...
.1..
..1.
..0.
...1
....
....
....
....
....
....
....
1...
0...
....
.1..
RESERVED
KEY が指定された
AR 15 は使用中
AR 15 は使用中ではない
LOC=(nnn,64) が指定された。ストレージは境界より上に
戻される
CHECKZERO=YES が指定された
CHECKZERO=NO が明示的に、あるいはデフォルトによ
り指定された
TCBADDR が STORAGE OBTAIN または RELEASE に
指定された
第 8 章 システム・トレース
8-33
システム・トレース
OWNER=HOME が明示的に、あるいはデフォルトにより
指定された
....
..01
OWNER=PRIMARY が指定された
....
..10
OWNER=SECONDARY が指定された
....
..11
OWNER=SYSTEM が指定された
ストレージ・キー (ビット 8 から 11)
サブプール番号
要求フラグ:
1...
....
ALET オペランドが指定されている
.1..
....
ストレージは任意の箇所に戻される
..00
....
ストレージに呼び出し側が常駐していなければならない
..01
....
ストレージのアドレスは 24 ビットでなければならない
..10
....
要求は明示アドレスについてである
..11
....
ストレージのアドレスは 24 ビットでも 31 ビットでもか
まわない
....
1...
最大および最小の要求
....
.1..
ストレージはページ境界上になければならない
....
..1.
無条件要求
....
...0
OBTAIN 要求
....
...1
FREEMAIN 要求
....
1
2
3
..00
– UNIQUE-2 の下は、
- VSM STORAGE OBTAIN または GETMAIN での SSRV トレース項目
の場合には、以下のいずれか。
v 正常に獲得されたストレージの長さ
v ストレージが獲得されなかった場合には、要求された最小ストレージ
- VSM STORAGE RELEASE または FREEMAIN に関する SSRV トレー
ス項目の場合:
v 解放されるストレージの長さ、あるいは、サブプール解放が要求され
た場合にはゼロ。
– UNIQUE-3 の下は、
- VSM STORAGE OBTAIN または GETMAIN での SSRV トレース項目
の場合には、以下のいずれか。
v アドレスを指定した場合には正常に獲得されたストレージのアドレ
ス、それ以外の場合にはゼロ。
v ストレージが獲得されなかった場合には、要求された最大ストレー
ジ。
- VSM STORAGE RELEASE または FREEMAIN に関する SSRV トレー
ス項目の場合:
v 解放されるストレージのアドレス
– UNIQUE-4 の下は、
- UNIQUE-4 の下の左側の 2 バイト: ターゲット・アドレス・スペースの
ASID
- UNIQUE-4 の下の次のバイト: 予約済み
- UNIQUE-4 の下の右側のバイト:
GETMAIN/FREEMAIN/STORAGE OBTAIN/STORAGE RELEASE が無条
件の場合は、異常終了が発生し、SSRV トレース項目の UNIQUE-4 の
8-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
3 番目のバイトには X'FF' が含まれます。GETMAIN/FREEMAIN/
STORAGE OBTAIN/STORAGE RELEASE が条件付きの場合、異常終了
は発生せず、SSRV トレース項目の UNIQUE4 の 3 番目のバイトには
記憶サービスからの実際の戻りコードが含まれます。
v 実記憶管理への SSRV 要求 (SSID 14B) の場合、IARV64 データは以下のと
おりです。
– ADDRESS の下は
- バイトは以下のとおりです。
0
1
1
1
1
1
1
|
1
2
要求タイプ ID:
01
GETSTOR
02
GETSHARED
03
DETACH
04
PAGEFIX
05
PAGEUNFIX
06
PAGEOUT
07
DISCARDDATA
08
PAGEIN
0A
SHAREMEMOBJ
0B
CHANGEACCESS
0D
CHANGEGUARD
GETSTOR GETSHARED 要求フラグ:
1...
....
COND=YES 要求
.1..
....
FPROT=NO 要求
..1.
....
CONTROL=AUTH 要求 (GETSTOR のみに適用)
...1
....
SVCDUMPRGN=NO 要求 (GETSTOR のみに適用)
....
1...
CHANGEACCESS = GLOBAL 要求 (GETSHARED の
みに適用)
....
.1..
GUARDLOC=HIGH 要求 (GETSTOR のみに適用)
DETACH 要求フラグ:
1...
....
COND=YES 要求
.1..
....
MATCH=USERTOKEN 要求
..1.
....
AFFINITY=SYSTEM 要求
...1
....
OWNER=NO 要求
SHAREMEMOBJ 要求フラグ:
1...
....
COND=YES 要求
.1..
....
SVCDUMPRGN=NO 要求
CHANGEGUARD 要求フラグ:
1...
....
COND=YES 要求
.1..
....
TOGUARD 要求
..1.
....
FROMGUARD 要求
PAGEFIX 要求フラグ:
1...
....
LONG=NO 要求
DISCARDDATA 要求フラグ
1...
....
CLEAR=NO 要求
.1..
....
KEEPREAL=NO 要求
CHANGEACCESS 要求フラグ
1...
....
READONLY 要求
.1..
....
SHAREDWRITE 要求
..1.
....
HIDDEN 要求
キー使用フラグ
1...
....
KEY が指定された
.1..
....
USERTOKEN が指定された
..1.
....
TTOKEN が指定された
第 8 章 システム・トレース
8-35
システム・トレース
3
...1
....
....
1...
....
.1..
各種バイト
CONVERTSTART が指定された
GUARDSIZE64 要求
CONVERTSIZE64 要求
v GETSTOR および GETSHARED 要求のストレージ・キー
v 範囲リスト要求の範囲リスト内の範囲数
v 他の要求の場合はすべて 0
– UNIQUE-1 の下は
- 戻りコード/異常終了コード (4 バイト)
– UNIQUE-2 の下は
- 理由コード (4 バイト)
– UNIQUE-3 の下は
- IARV64 要求で指定された ALET (4 バイト)
– 以下に続く IARV64 サービスによる追加の UNIQUE フィールド
- GETSTOR/GETSHARED
v メモリー・オブジェクトの起点アドレス - 8 バイト
v メモリー・オブジェクトのサイズ - 8 バイト
v ユーザー・トークン - 8 バイト
- DETACH
v メモリー・オブジェクトの開始アドレス (MATCH=SINGLE 要求の場
合) ゼロ (MATCH=USERTOKEN 要求の場合) - 8 バイト
v ユーザー・トークン - 8 バイト
- PAGEFIX、PAGEUNFIX、PAGEOUT、PAGEIN、DISCARDDATA、
CHANGEACCESS
v 範囲リストのアドレス - 8 バイト
v 1 番目の範囲リスト項目からの VSA - 8 バイト
v 1 番目の範囲リスト項目からのブロック数 - 8 バイト
- CHANGEGUARD
v メモリー・オブジェクトの開始 (ConvertStart が指定されなかった場
合)、あるいは変換開始アドレス (ConvertStart が指定された場合) - 8
バイト
v 変換されるセグメント数 - 8 バイト
- SHAREMEMOBJ
v 範囲リスト・アドレス - 8 バイト
v 1 番目の範囲リスト項目からの VSA - 8 バイト
v ユーザー・トークン - 8 バイト
v SSID (14C) を指定したグローバル・リソースの逐次化の SSRV トレース項
目では、ISGENQ データは以下のようになります。
– UNIQUE-1 の下は
- 戻りアドレス (4 バイト)
– UNIQUE-2 の下は、
8-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
- 以下の 2 バイトのフラグ:
1
2
フラグ:
01..
10..
11..
..1.
...0
...1
...1
....
....
....
....
フラグ:
1...
.1..
..1.
...1
....
....
....
....
....
....
....
....
0...
0...
1...
.1..
.0..
..1.
...1
REQUEST=OBTAIN
REQUEST=CHANGE
REQUEST=RELEASE
COND=YES
SCOPE=STEP
SCOPE=SYSTEM
SCOPE=SYSTEMS
CONTROL=SHARED
CONTROL=EXCLUSIVE
RESERVEVOLUME=YES
SYNCHRES=YES
....
....
....
....
1...
.1..
..1.
...1
SYNCHRES=NO
出口が要求を変更した
WAITTYPE=ECB
CONTENTIONACT=Fail
RESLIST=YES
RNL が有効範囲を変更した
TEST=YES
RNL=NO
注: バイト 1 の最後のビットおよびバイト 2 の最初のビットが両方と
もオフである場合、SYNCHRES のシステム・デフォルトが使用さ
れます。
ISGENQ 理由コード (2 バイト)
v リスト要求が指定されている場合は、このフィールドは、エラーがあ
る特定のリスト項目の理由コードを示します。エラーがある項目が複
数ある場合は、最も高い理由コードが示されます。
– UNIQUE-3 の下は、
- 1 次 ASID (2 バイト)
- 最後の 2 バイトは以下のことを表します。
v 不完全なトレース項目の場合は X'FFFF'。不完全な項目は、プログラ
ム・チェックまたはエラーが検出された結果起こります。この項目に
は、信用できるデータだけが入ります。したがって、フラグによって
は、部分的にしか埋まりません。混乱を避けるには、装置番号として
X'FFFF' を指定し、予約要求ビットをオフにすると、項目が不完全で
あることをユーザーに通知できます (2 バイト)。
v 予約要求でない場合は X'0000' (2 バイト)。
v 予約要求の場合は装置番号 (2 バイト)。 – UNIQUE-4 の下は、
- QNAME の最初の 4 バイト (4 バイト)。 リスト要求の場合、これは要
求の中の最初の QNAME を表します。
– UNIQUE-5 の下は、
- QNAME の最後の 4 バイト (4 バイト)。 リスト要求の場合、これは要
求の中の最初の QNAME を表します。
第 8 章 システム・トレース
8-37
システム・トレース
v SSID (14D) ENQ 、および SSID (14E) DEQ を指定したグローバル・リソー
スの逐次化の SSRV トレース項目では、情報は以下のようになります。
|
|
– UNIQUE-1 の下は
|
- 戻りアドレス (4 バイト)
|
– UNIQUE-2 の下は、
|
|
|
|
- PELLAST および PELXFLG1 の説明については、PEL マッピングを参
照してください。「z/OS MVS Data Areas, Vol 3 (IVT-RCWK)」を参照し
てください。
|
- 3 バイトのフラグ。
|
- バイト 1 は以下のとおりです。
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1
|
v バイト 2 は PELLAST を表します。
フラグ:
0...
.0..
.1..
.0..
.0..
.1..
..1.
...1
....
....
....
....
....
....
....
....
....
....
....
....
1...
0...
0...
1...
.000
.001
..010
.011
.100
.101
.110
.111
排他的要求
STEP
SYSTEM
SYSTEM (UCB 付き)
SYSTEMS (UCB 付き)
SYSTEMS
出口が要求を変更した
RNL が有効範囲を変更した
RET=NONE
RET=HAVE
RET=CHNG
RET=USE
RET=ECB
RESERVED
RESERVED
RET=TEST
– ビット 4 は無視されます。
|
v バイト 3 は PELXFLG1 を表します。
|
– ビット 8 は無視されます。
|
|
|
- ENQ 戻りコード (SSID14D) (1 バイト) または DEQ 戻りコード (SSID
14E) (1 バイト)
|
|
|
v リスト要求が指定されている場合は、このフィールドは、エラーがあ
る特定のリスト項目の戻りコードを示します。エラーがある項目が複
数ある場合は、最も高い戻りコードが示されます。
|
|
|
|
v ABEND の場合、このフィールドの形式は X'Fn' になります。ここ
で、n は ABEND コードの最初の 16 進数字を表します。たとえば、
‘X'F7' は X'738' ABEND を表し、X'F4' は X'438' ABEND を表しま
す。
– UNIQUE-3 の下は、
|
|
- 1 次 ASID (2 バイト)
|
- 最後の 2 バイトは以下のことを表します。
v 不完全なトレース項目の場合は X'FFFF'。不完全な項目は、プログラ
ム・チェックまたはエラーが検出された結果起こります。この項目に
|
|
8-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
|
|
|
|
は、信用できるデータだけが入ります。したがって、フラグによって
は、部分的にしか埋まりません。混乱を避けるには、装置番号として
X'FFFF' を指定し、予約要求ビットをオフにすると、項目が不完全で
あることをユーザーに通知できます (2 バイト)。
|
v 予約要求でない場合は X'0000' (2 バイト)。
|
v 予約要求の場合は装置番号 (2 バイト)。 |
|
|
|
– UNIQUE-4 の下は、
- QNAME の最初の 4 バイト (4 バイト)。 リスト要求の場合、これは要
求の中の最初の QNAME を表します。
– UNIQUE-5 の下は、
|
|
- QNAME の最後の 4 バイト (4 バイト)。 リスト要求の場合、これは要
求の中の最初の QNAME を表します。
|
|
v UNIX システム・サービスに対する SSRV 要求の場合のデータは、以下のと
おりです。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
– UNIQUE-1 の下は
- PPRT 制御ブロックのアドレス
– UNIQUE-2 の下は、
- AMODE 64 呼び出し元の 8 バイトのパラメーターでは第 1 のパラメ
ーターの低位の 4 バイト、それ以外では第 1 のパラメーターの最初の
4 バイト (パラメーターが使用可能な場合)。パラメーターが使用不可の
場合は、ゼロ。
– UNIQUE-3 の下は
- AMODE 64 呼び出し元の 8 バイトのパラメーターでは第 2 のパラメ
ーターの低位の 4 バイト、それ以外では第 2 のパラメーターの最初の
4 バイト (パラメーターが使用可能な場合)。パラメーターが使用不可の
場合は、ゼロ。
– UNIQUE-4 の下は、
- AMODE 64 呼び出し元の 8 バイトのパラメーターでは第 3 のパラメ
ーターの低位の 4 バイト、それ以外では第 3 のパラメーターの最初の
4 バイト (パラメーターが使用可能な場合)。パラメーターが使用不可の
場合は、ゼロ。
PSACLHSpsaclhs-: PSA の PSACLHS フィールドから得られた、現在保持されているロ
ック用のストリング。このフィールドには、SSRV トレース項目の一部の記述テ
キストが入ります。この記述テキストは SNAP、SYSUDUMP、または
SYSABEND の各出力には表示されません。
PSALOCAL
psalocal: PSA の PSALOCAL フィールドから得られた、ローカルでロックさ
れているアドレス・スペース標識。このフィールドには、SSRV トレース項目の
一部の記述テキストが入ります。この記述テキストは SNAP、SYSUDUMP、ま
たは SYSABEND の各出力には表示されません。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。このフィールドには、
第 8 章 システム・トレース
8-39
システム・トレース
SSRV トレース項目の一部の記述テキストが入ります。この記述テキストは
SNAP、SYSUDUMP、または SYSABEND の各出力には表示されません。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。このフィールドには、
SSRV トレース項目の一部の記述テキストが入ります。この記述テキストは
SNAP、SYSUDUMP、または SYSABEND の各出力には表示されません。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
TIME トレース項目
目的
TIME トレース項目は、タイマー・サービス・コンポーネントによる動的な時刻機
構 (TOD) 調整を表します。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD CP
UNIQUE-4 UNIQUE-5 UNIQUE-6 PSACLHSE
TIMESTAMP-RECORD CP
pr home tcb-addr
TIME
CODE
word1--- word2--- data---data---- data---- data----
pasd sasd timestamp------- CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
TIME
タイマー・サービス
CD/D
コード: 値は 1 になっています。これは、時刻機構 (TOD) と外部時刻参照
(ETR) が同期しなくなったときにシステムが TOD クロックを進めた時間の長
さが、word1 と word2 に入っていることを表します。
PSW----- ADDRESSreturn: PTRACE マクロを発行したプログラムの戻りアドレス
8-40
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
word1、word2: コード値が 1 になっている場合、TOD クロックと ETR が
同期しなくなったときにシステムが TOD クロックを進めた時間の長さを表
します。
PSACLHSブランク
PSACLHSEブランク
PSALOCAL
ブランク
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
USRn トレース項目
目的
USRn トレース項目は、許可プログラムでの PTRACE マクロの処理を表します。こ
のトレース項目には、PTRACE マクロから得られたデータが含まれます。
項目のフォーマット
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD CP
UNIQUE-4 UNIQUE-5 UNIQUE-6
pr home tcb-addr
USRn
return--
data---- data---- data---data---- data---- data----
pasd sasd timestamp------- CP
pr home tcb-addr
USRn
return--
idc- rbc data---- data---data---- data---- data----
pasd sasd timestamp------- CP
PR
pr: TTE を作成したプロセッサーの ID。
ASID
home: TTE に関連するホーム・アドレス・スペース ID (ASID)。
第 8 章 システム・トレース
8-41
システム・トレース
TCB-ADDR
tcb-addr: 現行タスクまたは作業エレメント・ブロック (WEB) の、タスク制御
ブロック (TCB) のアドレス。
IDENT
以下の TTE ID。
USRn
ユーザー・イベント。n は X'0' から X'F' までの数です。
CD/D
ブランク
PSW----- ADDRESSreturn: PTRACE マクロを発行したプログラムの戻りアドレス
UNIQUE-1/UNIQUE-2/UNIQUE-3
UNIQUE-4/UNIQUE-5/UNIQUE-6
data----: PTRACE マクロから得られたユーザー定義データ
idc-: PTRACE 識別カウント
rbc: 相対バイト・カウント
PSACLHSこのフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出
力には表示されません。
PSALOCAL
このフィールドには、SVC、SSRV、および PC の各トレース項目の一部の記述
テキストが入ります。この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出
力には表示されません。
PASD
cpsd: トレースに入ったときの 1 次 ASID (PASID)。このフィールドには、
SVC、SSRV、および PC の各トレース項目の一部の記述テキストが入ります。
この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出力には表示されませ
ん。
SASD
sasd: トレースに入ったときの 2 次 ASID (SASID)。このフィールドには、
SVC、SSRV、および PC の各トレース項目の一部の記述テキストが入ります。
この記述テキストは、SNAP/SYSUDUMP/SYSABEND 出力には表示されませ
ん。
TIMESTAMP-RECORD
timestamp-------: システム・トレースがこのトレース項目を作成したときの時
刻 (TOD)。この値は、Logrec データ・セット・レコードのタイム・スタンプと
同じフォーマットになっています。
CP
CP 列には、2 桁の 16 進数字のプロセッサー・モデル従属情報が入ります。こ
の情報は、トレース項目を作成した物理 CP を識別することを意図していま
す。 CP は、IPCS のもとで SYSTRACE をフォーマット設定するときにのみ提
供されます。 CP は、SYSUDUMP、SYSABEND、または SNAP には提供され
ません。
8-42
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
システム・トレース
1 つのユーザー・イベントに対する複数のトレース項目
PTRACE マクロが 5 フルワードを超えるトレース・データの記録を要求した場合
には、1 つのユーザー・イベントが複数のトレース項目に表示されることがありま
す。
たとえば、次の PTRACE マクロは 11 フルワードのトレース・データの記録を要
求します。
PTRACE TYPE=USER3,REGS=(2,12),SAVEAREA=STANDARD
このマクロの場合には、システム・トレースによってトレース・テーブルに 3 つの
項目が設けられます。各項目の内容は次のとおりです。
v 最初の項目には、レジスター 2 から 6 までに入っている 5 フルワードのトレー
ス・データが入ります。
v 2 番目の項目には、レジスター 7 から 11 までに入っている 5 フルワードのト
レース・データが入ります。
v 3 番目の項目には、レジスター 12 に入っているフルワードのトレース・データ
が入ります。
PTRACE マクロを発行するプログラムが割り込みを受ける場合、3 つのトレース項
目はトレース・テーブル内で連続していないことがあります。複数の項目に、
UNIQUE-1 に関するデータとして継続情報が含まれています。継続情報のフォーマ
ットは次のとおりです。
nnnn hhh
nnnn
PTRACE 識別カウント。1 つのマクロ処理の場合のすべての項目に対して
PTRACE によって割り当てられた 16 進数です。
hhh
トレース・データの次のバイトの 16 進数によるバイト・オフセット
(UNIQUE-2 の下の項目)。最初の項目の場合、このオフセットは X'000' です。2
番目の項目の場合、このオフセットは X'014' です。3 番目の項目の場合、この
オフセットは X'028' です。
次の例は、前の PTRACE マクロから得られた 3 つのトレース項目を示していま
す。
PR ASID TCB-ADDR
IDENT CD/D PSW----- ADDRESS- UNIQUE-1 UNIQUE-2 UNIQUE-3 PSACLHS- PSALOCAL PASD SASD TIMESTAMP-RECORD CP
UNIQUE-4 UNIQUE-5 UNIQUE-6
01 000C 00AFF090
USR3
81A007B6
01 000C 00AFF090
USR3
81A007B6
01 000C 00AFF090
USR3
81A007B6
003D 000
00000003
003D 014
00000008
003D 028
00000001
00000004
00000006
00000009
0000000B
00000002
00000005
00000007
0000000A
000C 000C 9DAA507461CB3E02 CP
000C 000C 9DAA507461CB3E02 CP
000C 000C 9DAA507461CB3E02 CP
第 8 章 システム・トレース
8-43
8-44
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 9 章 マスター・トレース
マスター・トレースは、最近発行されたすべてのシステム・メッセージのテーブル
を保持しています。これは、外部システム・アクティビティーのログを作成します
が、ほかのトレースは、内部システム・アクティビティーをログに記録します。マ
スター・トレースはシステム初期設定時に自動的に活動化されますが、TRACE コマ
ンドを使用してオンまたはオフにすることもできます。
マスター・トレースを使用すると、最も新しく出されたシステム・メッセージのロ
グが提供されるため、問題が診断しやすくなります。たとえば、ダンプ内のマスタ
ー・トレース出力には、システム・メッセージが含まれています。このメッセージ
は、ダンプで発行される通常のコンポーネント・メッセージよりも問題とのかかわ
りが深いことがあります。
主要トピック
以下のトピックで、マスター・トレースについて説明します。
v 『マスター・トレースとハードコピー・ログ』
v
9-2 ページの『マスター・トレースのカスタマイズ』
v
9-2 ページの『マスター・トレースの要求』
v
9-3 ページの『マスター・トレースの受取り』
v
9-4 ページの『マスター・トレース・データの読み方』 には、以下のトピックが
含まれています。
–
9-4 ページの『ダンプ内でフォーマット設定されたマスター・トレース出力』
–
9-5 ページの『ストレージ内のマスター・トレース・テーブル』
マスター・トレースとハードコピー・ログ
マスター・トレースでは、システムが自動的かつ永続的にハードコピー・ログに保
管するものと同じメッセージがリストされますが、メッセージ項目は折り返しテー
ブルに維持されます。つまり、テーブルがいっぱいになると古い項目に上書きされ
ます。必要なメッセージがダンプに含まれているときには、ダンプ内のマスター・
トレース・データをハードコピー・ログの代りに使用できます。ユーザーがダンプ
を要求する前にマスター・トレース・テーブルが折り返されて、問題に関連するメ
ッセージが上書きされると、そのダンプには有益なメッセージは含まれなくなりま
す。
次の条件を想定してください。
v 午後 9 時にマスター・トレース・テーブルが折り返されます。
v 午後 9 時 10 分から 9 時 20 分までの間にシステムが問題に関連するメッセー
ジを発行します。
v 9 時 30 分にシステムが SVC ダンプを発行します。
この例では、トレース・テーブルが折り返されてからダンプが発行されるまでの間
に問題が発生したため、その問題に関連するメッセージがダンプ内のマスター・ト
レース・データに含まれています。
© Copyright IBM Corp. 1988, 2008
9-1
マスター・トレース
ハードコピー・ログを含むシステム管理データ・セットを印刷するには、OUTPUT
JCL ステートメントの JESDS パラメーターを使用してください。
マスター・トレースのカスタマイズ
初期設定時に、マスター・スケジューラーは 24 キロバイトのマスター・トレー
ス・テーブルを設定します。24 キロバイトのテーブルには、メッセージが約 336
入ります (メッセージの平均長を 40 文字とします)。SCHEDxx parmlib メンバーの
パラメーターを変更することにより、マスター・トレース・テーブルのサイズを変
更したり、トレース・テーブルを使用しないようにしたりすることができます。
また、TRACE コマンドを使用してテーブルのサイズを変更することもできます。た
とえば、トレース・テーブル・サイズを 36 キロバイトに変更するには、次のよう
に入力してください。
TRACE MT,36K
参照
SCHEDxx メンバーについては、「z/OS MVS 初期設定およびチューニング 解説
書」を参照してください。
マスター・トレースの要求
マスター・トレースの開始、変更、または停止は、マスター権限のあるコンソール
から TRACE オペレーター・コマンドを入力して行います。たとえば、マスター・
トレースを開始するには、次のように入力します。
TRACE MT
マスター・トレースを停止するには、次のように入力します。
TRACE MT,OFF
また、TRACE コマンドを使用してマスター・トレースの現行状況を入手することも
できます。システムはこの状況をメッセージ IEE839I で表示します。たとえば、こ
のトレースの状況を知りたい場合には、次のように入力してください。
TRACE STATUS
例: TRACE STATUS の出力
次の出力では、MT=(ON,140K) で示されているように、マスター・トレースは
140 キロバイトのトレース・テーブルを使用して活動状態になっています。
TRACE STATUS
IEE839I ST=(ON,0500K,01000K) AS=ON BR=OFF EX=ON MT=(ON,140K)
ISSUE DISPLAY TRACE CMD FOR SYSTEM AND COMPONENT TRACE STATUS
システム・トレース、マスター・トレース、およびコンポーネント・トレースの現
行状況を調べたい場合には、DISPLAY TRACE コマンドを使用してください。シス
9-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
マスター・トレース
テムはこの状況をメッセージ IEE843I で表示します。たとえば、これら 3 つのト
レースの状況を知りたい場合には、次のように入力してください。
DISPLAY TRACE
例: DISPLAY TRACE の出力
次の例では、MT=(ON,140K) で示されているように、マスター・トレースは
140 キロバイトのマスター・トレース・テーブルを使用して活動状態になって
います。
DISPLAY TRACE
IEE843I 15.17.14 TRACE DISPLAY 564
SYSTEM STATUS INFORMATION
ST=(ON,0500K,01500K) AS=ON BR=OFF EX=ON MT=(ON,140K)
COMPONENT MODE COMPONENT MODE COMPONENT MODE COMPONENT MODE
-------------------------------------------------------------SYSGRS
ON
SYSSPI
OFF
SYSSMS
OFF
SYSDLF
MIN
SYSOPS
ON
SYSXCF
ON
SYSLLA
MIN
SYSXES
ON
SYSAPPC
ON
SYSRSM
ON
SYSAOM
OFF
SYSVLF
MIN
CTTX
MIN
参照
v TRACE と DISPLAY オペレーター・コマンドについては、「z/OS MVS システ
ム・コマンド」を参照してください。
v IEE839I と IEE843I メッセージについては、「z/OS MVS システム・メッセージ
第 7 巻 (IEB-IEE)」を参照してください。
マスター・トレースの受取り
マスター・トレースは、マスター・スケジューラーのアドレス・スペース (ASID 1)
内にあるマスター・トレース・テーブルにトレース・データを書き込みます。トレ
ース・データを入手するための TRT がダンプ・オプション・リストに含まれてい
る場合には、スタンドアロン、SVC、または不定様式ダンプでマスター・トレー
ス・データを得ることができます。次のテーブルには、マスター・トレース・デー
タを含むダンプが示されています。
ダンプ
マスター・トレース・データがダンプにあるか
どうか？
スタンドアロン・ダンプ
デフォルト
SDUMP または SDUMPX マクロに対する SVC
ダンプ
デフォルト
DUMP オペレーター・コマンドに対する SVC ダ
ンプ
デフォルト
ACTION=SVCD、ACTION=STDUMP、
ACTION=SYNCSVCD、または ACTION=TRDUMP
を指定した SLIP オペレーター・コマンドに対す
る SVC ダンプ
デフォルト
トレース・データを除外するようにカスタマイズ
された不定様式ダンプ
SDATA=TRT を要求することにより可能
SYSABEND への ABEND ダンプ
利用不可
SYSMDUMP への ABEND ダンプ
利用不可
第 9 章 マスター・トレース
9-3
マスター・トレース
ダンプ
マスター・トレース・データがダンプにあるか
どうか？
SYSUDUMP への ABEND ダンプ
利用不可
SNAP ダンプ
利用不可
マスター・トレース・データのフォーマット設定は、IPCS VERBEXIT MTRACE サ
ブコマンドを使用するか、あるいは IPCS Trace Processing 選択パネルを使用して行
います。
参照
v VERBEXIT MTRACE サブコマンドについては、「z/OS MVS IPCS コマンド」を
参照してください。
v パネルについては、「z/OS MVS IPCS ユーザーズ・ガイド」を参照してくださ
い。
マスター・トレース・データの読み方
このセクションの以下のトピックでは、マスター・トレース項目のフォーマットを
示します。
v 『ダンプ内でフォーマット設定されたマスター・トレース出力』
v 9-5 ページの『ストレージ内のマスター・トレース・テーブル』
ダンプ内でフォーマット設定されたマスター・トレース出力
マスター・トレース・テーブル内の項目は、ハードコピー・ログと同じように先入
れ後出し (FIFO) の順序でリストされます。メッセージは、発行されたとおりの順
序でマスター・トレース・テーブルに入るとは限らないため、発生順になっていな
いことがあります。
定様式マスター・トレース出力の例
次の出力は、IPCS でフォーマット設定されたダンプ内のマスター・トレース・デー
タを示しています。IPCS サブコマンド入力パネルから発行されたコマンドは、次の
とおりです。
VERBEXIT MTRACE
9-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
マスター・トレース
*** MASTER TRACE TABLE ***
TAG
0001
0001
0001
0001
0001
IMM DATA
00000013
00000013
00000013
00000009
00000013
0001 00000013
0001
0001
0001
0001
0001
00000013
00000013
00000013
00000013
00000013
0001 00000013
0001
0001
0001
0001
0001
00000013
00000013
00000009
00000013
00000013
0001 00000013
0001 00000013
0001 00000013
|------------------------ MESSAGE DATA ------------------>|
N C040000 SCOTT01
NC0000000 SCOTT01
W C040000 SCOTT01
NRC040000 SCOTT01
N C040000 SCOTT01
NAME=SCOTT01
N C040000 SCOTT01
JOB=YES,
N C040000 SCOTT01
N C040000 SCOTT01
N C040000 SCOTT01
N C040000 SCOTT01
N C040000 SCOTT01
SEND=(NOTSET)),
N C040000 SCOTT01
TRACE=NO
NC0000000 SCOTT01
W C040000 SCOTT01
NRC040000 SCOTT01
N C040000 SCOTT01
N 0000000 SCOTT01
KEPT
N 0000000 SCOTT01
N 0000000 SCOTT01
KEPT
N 0000000 SCOTT01
03147
03147
03147
03147
03147
21:24:22.76
00000000 $HASP468 JES2 INIT DECK PROCESSED
21:24:22.77 INTERNAL 00000290 REPLY 0002,N1 AUTH=(NET=YES),NAME=SCOTT01
21:24:22.76
00000000 *0002 $HASP469 REPLY PARAMETER STATEMENT, CANCEL, OR END
21:24:22.77 INTERNAL 00000090 IEE600I REPLY TO 0002 IS;N1 AUTH=(NET=YES),NAME=SCOTT01
21:24:22.77
00000290 $HASP466 CONSOLE STMT
126 N1 AUTH=(NET=YES),
03147 21:24:22.77
00000090
$HASP826 NODE(1)
NAME=SCOTT01,AUTH=(DEVICE=YES,
03147
03147
03147
03147
03147
21:24:22.77
21:24:22.77
21:24:22.78
21:24:22.78
21:24:22.78
00000090
00000090
00000090
00000090
00000090
$HASP826
$HASP826
$HASP826
$HASP826
$HASP826
NET=YES,SYSTEM=YES),TRANSMIT=BOTH,
RECEIVE=BOTH,HOLD=NONE,PENCRYPT=NO,
ENDNODE=NO,REST=0,SENTREST=ACCEPT,
COMPACT=0,LINE=0,LOGMODE=,LOGON=0,
PASSWORD=(VERIFY=(NOTSET),
03147 21:24:22.78
00000090
$HASP826
PATHMGR=YES,PRIVATE=NO,SUBNET=,
03147
03147
03147
03147
03147
21:24:22.78 INTERNAL 00000290 REPLY 0003,END
21:24:22.78
00000000 *0003 $HASP469 REPLY PARAMETER STATEMENT, CANCEL, OR END
21:24:22.78 INTERNAL 00000090 IEE600I REPLY TO 0003 IS;END
21:24:22.78
00000290 $HASP466 CONSOLE
STMT
127 END
21:24:22.79
00000290 IEF196I IEF285I
CONSOLE.OSV142.PARMLIB
03147 21:24:22.79
03147 21:24:22.79
00000290
00000290
IEF196I IEF285I
IEF196I IEF285I
VOL SER NOS= D72666.
SYS1.PARMLIB
03147 21:24:22.79
00000290
IEF196I IEF285I
VOL SER NOS= D72666.
前の例で強調表示されたテキストの意味は、次のとおりです。
TAG
呼び出し側を識別するハーフワード。TAG は、次のいずれかです。
タグ
呼び出し側
000
予約済み
001
WTO SVC
002
マスター・スケジューラー
003
トレース・コマンド
現行 ID は IEZMTPRM マクロで定義されています。このマクロは、パラメー
ター・リストをマップするものです。
IMM DATA
呼び出し側で定義された 32 ビットからなるフルワードの即値データ。即値デー
タの意味は、呼び出し側によって定義されています。
MESSAGE DATA
メッセージ。処理中に問題が発生した場合には、メッセージの次の行に問題が示
されています。
ストレージ内のマスター・トレース・テーブル
このトピックでは、マスター・スケジューラー・アドレス・スペースのマスター・
トレース・テーブルに記録されるマスター・トレース・データを説明しています。
この情報を使用して、マスター・トレース情報に関するユーザー独自のフォーマッ
ト設定ルーチンまたは分析ルーチンを作成できます。
マスター・トレースの項目は、FIFO 順序で配置されます。したがって、現行項目
は、古い項目の手前に配置されます。テーブルがいっぱいになるとマスター・トレ
ースが折り返され、テーブルの終わりから項目の記録が再開されます。
第 9 章 マスター・トレース
9-5
マスター・トレース
メッセージは、発行されたとおりの順序でマスター・トレース・テーブルに入ると
は限らないため、発生順になっていないことがありますので、注意してください。
位置
次のようにコミュニケーション・ベクトル・テーブル (CVT) からマスター・トレー
ス・テーブルを見付けてください。
位置:
フィールド名:
検索するアドレス:
CVT+X'94'
CVTMSER
IEEBASEA (マスター・スケジューラー常駐
データ・エリア)
IEEBASEA+ X'8C'
BAMTTBL
マスター・トレース・テーブルの先頭
フォーマット
マスター・スケジューラー・アドレス・スペース内の不定様式マスター・トレー
ス・テーブルには、ヘッダーと、そのテーブルにログされたメッセージごとに 1 つ
の項目が含まれています。次の 2 つのトピックでは、ヘッダーおよび項目のフィー
ルドを示します。マスター・トレースのヘッダーと項目は、 IEEZB806 マクロの
MTT マッピングによってマップされます。このマクロについては、z/OS MVS Data
Areas, Vol 2 (DCCB-ITZYRETC) で説明されています。
マスター・トレース・テーブルのヘッダー
TABLE ID
SUBPOOL
CURRENT
LENGTH
WRAP POINT
START
END
DATA LENGTH
RESERVED2...
WRAP TIME
RESERVED1
TABLE ID
MTT を含むフルワード・フィールド。MTT は、マスター・トレース・テーブ
ルの先頭を示す目印です。
CURRENT
現行 (最も新しく格納された) 項目のアドレスを含むフルワード・フィールド。
START
トレース・エリアの最初のバイトのアドレスを含むフルワード・フィールド。
END
トレース・エリアの終わりを超えた最初のバイトのアドレスを含むフルワード・
フィールド。
SUBPOOL
このテーブルが入っているサブプールの番号を含む 1 バイトのフィールド。
LENGTH
テーブル・ヘッダー、および項目の入っているエリアの長さ (バイト単位) を含
む 3 バイトのフィールド。この長さは、デフォルト・テーブル・サイズまたは
TRACE コマンドで指定されたサイズのいずれかです。
9-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
マスター・トレース
WRAP TIME
テーブルが初期設定された時刻または最後のテーブル折り返しが行われた時刻を
含むダブルワード・フィールド。時刻は、次のような XXHH:MM:SS.T 形式で
示されます。
HH
時
IT
MM
SS
T
テーブルが初期設定された時刻を示します。
WT
テーブルが最後に折り返された時刻を示します。
分
秒
10 分の 1 秒
WRAP POINT
最新のテーブル折り返しが行われる前に格納された最後の項目の最初のバイトの
アドレスが入っているフルワード・フィールド。
注: このアドレスはゼロに初期設定され、最初のテーブル折り返しが起こるまで
ゼロのままになります。
RESERVED1
フルワードの予約フィールド。
DATA LENGTH
テーブルのデータ・エリア部分の長さ (バイト単位) を含むフルワード・フィー
ルド。
RESERVED2
21 ワード・フィールド。
マスター・トレース・テーブルの項目
FLAGS
TAG
IMM DATA
LEN
CALLER-PASSED DATA
Entry header
10 バイトの項目ヘッダー。
FLAGS
マスター・トレースに渡されたパラメーター・リストで呼び出し側によって設定
されたフラグを含むハーフワード。
TAG
呼び出し側を識別するハーフワード。TAG は、次のいずれかです。
タグ
呼び出し側
0000
予約済み
0001
WTO SVC
0002
マスター・スケジューラー
0003
トレース・コマンド
現行 ID は IEZMTPRM マクロで定義されています。このマクロは、パラメー
ター・リストをマップするものです。
第 9 章 マスター・トレース
9-7
マスター・トレース
IMM DATA
呼び出し側によって定義された 32 ビットを含むフルワード。マスター・トレー
スは、妥当性を検査せずにこれらのビットをテーブルに格納します。
IMMEDIATE DATA の意味は呼び出し側によって定義されています。この値と
しては、カウンター、制御ブロック・アドレス、または渡されるデータを説明す
るフラグなどが考えられます。
LEN
呼び出し側によって渡されたデータの長さが入っているハーフワード。
CALLER-PASSED DATA
呼び出し側によって提供されたデータの長さが入っている可変長フィールド。
マスター・トレース・テーブルの項目の長さはさまざまです。呼び出し側が呼び出
し側引き渡しデータの長さとしてゼロを指定すると、マスター・トレース・テーブ
ルの項目には 10 バイト・ヘッダーだけが含まれます。
9-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 10 章 汎用トレース機能 (GTF)
汎用トレース機能 (GTF) は、システムとプログラムの問題を記録および診断するた
めに使用できる保守援助機能です。GTF は MVS システム・プロダクトの一部であ
り、START GTF コマンドを入力して明示的に活動化させる必要があります。
GTF は、ご使用のシステムのすべてのプロセッサーで発生するさまざまなシステ
ム・イベントとプログラム・イベントの記録に使用します。IBM 提供のデフォルト
を使用するとシステム・トレースでリストされるイベントの多くが、 GTF でリス
トされ、それらのイベントに関する最小限のデータが示されます。ただし、GTF は
システム・トレースよりも多くのリソースとプロセッサー時間を使用するため、問
題が生じたときにだけ、その原因と考えられる 1 つまたは複数のイベントを選んで
GTF を使用することをお勧めします。これにより、問題の診断に役立つ詳細な情報
が得られます。 イベント、1 つのタイプのイベントの特定の発生、または
GTRACE マクロが生成した ユーザー定義のプログラム・イベントを組み合わせて
トレースすることができます。たとえば、次のようなトレースを行うことができま
す。
v サブチャネル操作の開始と再開のためのチャネル・プログラムおよび関連データ
と、入出力割り込みの組み合わせ
v 特定の 1 つの装置で発生した入出力割り込み
v システム・リカバリー・ルーチン操作
GTF がトレースするイベントは、parmlib メンバーでオプションとして指定された
ものです。 IBM が提供する parmlib メンバーを使用することも、ユーザー独自の
メンバーを用意することもできます。必要なストレージ、出力の宛先、GTF のリカ
バリーなどの GTF 操作の詳細は、SYS1.PROCLIB 内のカタログ式プロシージャー
に定義されています。
GTF は、16 メガバイト境界の上と下の両方のシステムおよびプログラム・イベン
トをトレースできます。 GTF は、トレース対象の各イベントについて、トレー
ス・レコードを出力として生成します。GTF に、この出力を次のいずれかに送付さ
せることができます。
v 仮想記憶域内のトレース・テーブル
v テープまたは直接アクセス記憶装置 (DASD) のデータ・セット
良好なシステム・パフォーマンスを維持することがユーザーのインストール・シス
テムにとって非常に重要な場合には、GTF 出力の宛先としてトレース・テーブルを
選択してください。トレース・テーブルにはデータ・セットほど多くの GTF トレ
ース・データを収めることができませんが、入出力オーバーヘッドがないため、デ
ータ・セットに比べてシステム・パフォーマンスに与える影響は少なくなります。
トレース・テーブルに収まりきらない量のデータを収集したい場合には、1 つまた
は複数のデータ・セットを選択してください。データ・セットにトレース・データ
を書き込むと、入出力オーバーヘッドが生じ、トレース・テーブルの場合よりもシ
ステム・パフォーマンスへの影響が大きくなります。
© Copyright IBM Corp. 1988, 2008
10-1
汎用トレース機能
GTF は、仮想記憶域で 1 つのテーブルだけしか使用できませんが、16 までのデー
タ・セットを使用できます。複数のデータ・セットを指定する場合、それらすべて
が同じクラス、テープ、または DASD の装置になければなりません。
以下で、GTF とその他の診断用ツールおよびサービスとの関係の要点を簡単に説明
します。
GTF と IPCS
IPCS を使用して GTF 出力のマージ、フォーマット設定、表示、および印刷を行う
ことができます。
参照
COPYTRC、GTFTRACE、MERGE サブコマンド、および IPCS ダイアログ機能の
トレース処理オプションについては、「z/OS MVS IPCS ユーザーズ・ガイド」、お
よび「z/OS MVS IPCS コマンド」を参照してください。
GTF と GTRACE マクロ
TRACE=USR を指定して GTF を活動化させた場合には、GTF と GTRACE マクロ
を組み合わせて使用できます。この場合、ユーザーのプログラムで GTRACE マク
ロを出してトレース・レコードを生成し、 GTF でそのレコードをトレース・テー
ブルに格納できます。
参照
GTRACE マクロのコーディングについての情報は、「z/OS MVS Programming:
Authorized Assembler Services Reference EDT-IXG」を参照してください。
GTF とシステム・トレース
GTF とシステム・トレースを組み合わせて使用できます。システム・トレースは、
事前判別済みのシステム・イベントを記録し、各イベントに関する最小限の詳細情
報を提供します。特定の GTF オプションを選択してシステム・トレース情報を補
足すると、システムおよびユーザー・イベントに関してさらに詳しい情報が提供さ
れます。システム・トレースの詳細については、 8-1 ページの『第 8 章 システ
ム・トレース』を参照してください。
GTF と索引付き VTOC 処理
GTF を使用して、索引付きボリューム目録 (VTOC) の処理中に発生したイベントを
トレースできます。
参照
詳細については、「z/OS DFSMSdfp Diagnosis」を参照してください。
以下のトピックでは、GTF について詳しく説明します。
v
10-2
10-3 ページの『IBM デフォルトによる GTF の使用』では、IBM 提供の parmlib
メンバー (GTFPARM) と IBM 提供のカタログ式プロシージャーについて説明し
ます。
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
v
10-5 ページの『GTF のカスタマイズ』では、IBM のデフォルトを指定変更する
か、あるいはユーザー独自の parmlib メンバーおよびカタログ式プロシージャー
を提供して、GTF をカスタマイズする方法について説明します。
v
10-14 ページの『GTF の開始』
v
10-22 ページの『GTF の停止』
v
10-24 ページの『GTF トレース・オプション』では、GTF トレースの対象となる
イベントを選択するために使用できるオプションを説明します。このトピックで
はまた、GTF オプションを組み合わせて、プロンプト指示オプション用のキーワ
ードを指定するための指針も示します。
v
10-40 ページの『GTF トレースの受け取り』では、GTF トレース・データを含む
ダンプを要求する方法、および IPCS を使用してダンプまたはデータ・セット内
の GTF データをフォーマット設定する方法について説明します。このトピック
では、GTF トレース・データの複数のソースをまとめる方法、ダンプから GTF
トレース・データを抽出する方法、および GTF トレース・データを発生順にマ
ージする方法についても説明します。
v
10-44 ページの『GTF 出力の読み方』では、定様式および不定様式の両方の GTF
トレース・レコードのフォーマットを説明しています。
IBM デフォルトによる GTF の使用
GTF 操作に IBM のデフォルトを使用したい場合には、事前定義の GTF トレー
ス・オプションを含む SYS1.PARMLIB (parmlib とも呼ばれます) メンバーとカタ
ログ式プロシージャーの両方が IBM によって提供されます。GTF を活動化する
START コマンドで特定のパラメーターを使用することにより、デフォルト・オプシ
ョンのうちのいくつかを指定変更できます。
GTF トレース・オプションの IBM 提供 parmlib メンバー
IBM により、GTFPARM parmlib メンバーが提供されています。これには、以下の
GTF トレース・オプションが含まれています。
TRACE=SYSM,USR,TRC,DSP,PCI,SRM
これらのオプションは、以下のイベントをトレースするように GTF に対して要求
します。
SYSM 選択されたシステム・イベント
USR
GTRACE マクロが GTF に渡すユーザー・データ
TRC
GTF と関連したトレース・イベント
DSP
ディスパッチ可能作業単位
PCI
プログラムで制御される入出力割り込み
SRM
システム・リソース・マネージャー (SRM) と関連したトレース・データ
これらのトレース・オプションの詳しい説明については、 10-24 ページの『GTF ト
レース・オプション』を参照してください。
第 10 章 汎用トレース機能 (GTF)
10-3
汎用トレース機能
IBM 提供のカタログ式プロシージャー
IBM 提供の GTF カタログ式プロシージャーが SYS1.PROCLIB に入っています。
カタログ式プロシージャーは、GTF 操作、出力場所、リカバリー機能、トレース出
力データ・セット、および、GTF オプションとデフォルトが入る parmlib メンバー
を定義します。 図 10-1 は、IBM 提供のカタログ式プロシージャーの内容を示しま
す。
//GTFNEW PROC MEMBER=GTFPARM
//IEFPROC EXEC PGM=AHLGTF,PARM=’MODE=EXT,DEBUG=NO,TIME=YES’,
// TIME=1440,REGION=2880K
//IEFRDER DD
DSNAME=SYS1.TRACE,UNIT=SYSDA,SPACE=(TRK,20),
//
DISP=(NEW,KEEP)
//SYSLIB DD
DSN=SYS1.PARMLIB(&MEMBER),DISP=SHR
図 10-1. IBM 提供の GTF カタログ式プロシージャー
このカタログ式プロシージャー内のステートメントは、以下のとおりです。
PROC
GTF カタログ式プロシージャーを定義します。
EXEC
PGM=AHLGTF
プログラム AHLGTF の実行をシステムに要求します。
PARM=’MODE=EXT,DEBUG=NO,TIME=YES’,
ここで選択されているパラメーターは、GTF がトレース・データをテー
プ、または DASD 上のデータ・セットに送り、エラーが発生した場合には
リカバリーを試み、それぞれのトレース・レコードにタイム・スタンプを付
けることを指定しています。詳細については、 10-6 ページの『カタログ式
プロシージャーの設定』の中の EXEC ステートメントの説明を参照してく
ださい。
TIME=1440
GTF が活動状態になっている時間の長さ (秒単位)。
REGION=2880K
GTF で必要となるストレージの最大サイズを指定します。
IEFRDER DD
以下のデフォルトにもとづき、トレース出力データ・セットを定義します。
v トレース出力データ・セットの名前は SYS1.TRACE になっています。
v このデータ・セットが入っている DASD は、20 の物理ブロックをデータ・
セットに含められる大きさになっています。20 の物理ブロックが完全に埋ま
ると、GTF は出力データ・セットの先頭からすでに書き込まれているレコー
ドを、新しいトレース・レコードで上書きしていきます。
インストール SMS ルーチンと相互作用する場合の制約事項:
v DSNTYPE=LARGE データ・セットを使用できるのは、トレースが、V1R7 以
降のリリースのシステムで作成およびプロセスされている場合に限られま
す。
10-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
v VSAM 線形データ・セットで、拡張フォーマットまたは従来型のフォーマッ
トを持ち、32 k の制御インターバル・サイズ (CISIZE) を備えているものが
置換できます。
v 拡張順次データ・セットあるいは VSAM データ・セットは、必要な CISIZE
を備えている線形データ・セットでない場合は、使用してはなりません。
SYSLIB DD
GTF トレース・オプションとそのデフォルト値を含む IBM 提供の GTFPARM
parmlib メンバーを定義します。
同時に複数の GTF のインスタンスをアクティブにできます。 GTF のインスタ
ンスごとに固有のトレース・データ・セットが必要です。カタログ式プロシージ
ャー内のデフォルトのトレース・データ・セットは、START コマンドで異なる
データ・セットを指定するか、アクティブにする GTF のインスタンスごとにカ
タログ式プロシージャーを設定することにより、指定変更できます。
GTF のカスタマイズ
START GTF コマンドを使用して IBM のデフォルトを指定変更するか、あるいは
GTF 用にユーザー独自の parmlib メンバーおよびカタログ式プロシージャーを用意
して、インストール先の必要に合わせて GTF をカスタマイズできます。
次のいずれかの方法で GTF をカスタマイズしてください。
v parmlib またはデータ・セットのメンバー内で GTF トレース・オプションを事前
定義する。『GTF トレース・オプションの定義』を参照してください。
v カタログ式プロシージャーを設定する。 10-6 ページの『カタログ式プロシージャ
ーの設定』を参照してください。
v START コマンドを使用して IBM 提供の GTF カタログ式プロシージャーのデフ
ォルトを指定変更する。 10-14 ページの『GTF を呼び出すための START コマン
ドの使用』を参照してください。
v ユーザーが選択したトレース・オプションのために GTF が必要とするストレー
ジのサイズを決定する。 10-12 ページの『GTF の必要記憶容量の決定』を参照
してください。
v START コマンドを入力した後でコンソールから直接トレース・オプションを指定
する。 10-16 ページの『システム・プロンプト指示による GTF トレース・オプ
ションの指定または変更』を参照してください。
GTF トレース・オプションの定義
GTF トレース・オプションを含むユーザー独自の parmlib メンバーまたはデータ・
セットを指定する場合には、 10-24 ページの『GTF トレース・オプション』にリス
トされた任意のオプションを選択できます。 GTF の各インスタンスをアクティブ
にするオプションのセットは、同じでも、異なっていてもかまいません。
事前定義されたトレース・オプションを含むメンバーは、parmlib メンバーに収める
必要はありません。カタログ式プロシージャーの SYSLIB DD ステートメントまた
は START コマンドで指定されたデータ・セットは、SYS1.PARMLIB と互換性のあ
る属性になっている限り、どのようなものでも GTF によって受け入れられます。
第 10 章 汎用トレース機能 (GTF)
10-5
汎用トレース機能
カタログ式プロシージャーの設定
以下のような GTF 操作の詳細を制御したい場合には、ユーザー独自の GTF カタロ
グ式プロシージャーを設定してください。
v トレースに必要なストレージの量
v GTF のリカバリー
v トレース出力データ・セットの数およびタイプ
独自のカタログ式プロシージャーを用意したい場合には、以下のステートメントを
含めてください。
PROC
ユーザーのカタログ式プロシージャーを定義します。
EXEC
PGM=AHLGTF
プログラム AHLGTF の実行をシステムに要求します。
PARM=’parm, parm...’
PARM パラメーターで指定されたオプションは、GTF がトレース・データ
を書き込む場所、および GTF が各種ダンプ・タイプのトレース・データを
収集および保管するために必要なストレージの大きさを指定します。parm
には、次のいずれかを指定できます。
MODE={INT|EXT|DEFER}
SADMP={nnnnnnK|nnnnnnM|40K}
SDUMP={nnnnnnK|nnnnnnM|40K}
NOPROMPT
ABDUMP={nnnnnnK|nnnnnnM|0K}
BLOK={nnnnn|nnnnnK|nnnnnM|40K}
SIZE = {nnnnnnK|nnnnnnM|1024K}
TIME=YES
DEBUG={YES|NO}
MODE={INT|EXT|DEFER}
GTF がトレース・データを書き込む場所を定義します。MODE=INT を
指定すると仮想記憶域内のトレース・テーブルにデータが送られ、
MODE=EXT を指定するとテープまたは DASD 上のデータ・セットに
データが送られます。
MODE=INT を指定した場合、GTF の各インスタンスは仮想記憶域内の
個別のトレース・テーブルにトレース・データを送り、GTF 出力デー
タ・セットを定義する DD ステートメントを無視します。GTF の実行
中に良好なシステム・パフォーマンスを維持することがきわめて重要な
場合には、このオプションを選択してください。トレース・テーブルに
はデータ・セットほど多くの GTF トレース・データを収めることがで
きませんが、入出力オーバーヘッドがないため、データ・セットに比べ
てシステム・パフォーマンスに与える影響は少なくなります。
MODE=EXT または MODE=DEFER を指定した場合には、 GTF の各
インスタンスは GTFOUTxx または IEFRDER DD ステートメントで定
義された個別のトレース・データ・セットに出力を送ります。
MODE=EXT はデフォルト値です。トレース・テーブルに収まりきらな
い量のデータを収集したい場合には、MODE=EXT または
MODE=DEFER を選択してください。データ・セットにトレース・デー
10-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
タを書き込むと、入出力オーバーヘッドが生じるため、これらのどちら
かのオプションを選択すると MODE=INT を選択した場合よりもシステ
ム・パフォーマンスへの影響が大きくなります。
MODE=DEFER を指定すると、STOP GTF コマンドが入力されるまで
GTF アドレス・スペースにトレース・データが入ります。GTF のすべ
てのインスタンスは、そのインスタンス自身のアドレス・スペース内で
実行されます。 GTF 終了処理中、GTF の各インスタンスはそのインス
タンスのアドレス・スペースから出力データ・セットにデータを転送し
ます。
MODE=EXT または MODE=DEFER の場合に転送されるデータの量
は、次のいずれかです。
v デフォルト量
v SADMP|SA キーワードで指定された量
トレース出力データ・セットがいっぱいになると、GTF は次のように処
理を続行します。
v 直接アクセス装置: 1 次割り振りがいっぱいになると、GTF はデー
タ・セットの先頭から記録を再開します。つまり、GTF は古いほう
のトレース・データから上書きしていきます。
v テープ装置: GTF はファイルの終わりレコードを書き込みます。テー
プが巻き戻されてアンロードされ、新規ボリュームがテープ装置に装
着されます。GTF にテープ・データ・セットが 1 つしかなく、その
データ・セット用に 1 つの装置だけしかない場合、テープが使用不
能になっている間 GTF はトレース・レコードを書き込まないため、
トレース・データが失われます。
GTF は、次のいずれかの方法で複数のテープ装置に書き込みを行う
ことができます。
– 複数の GTFOUTxx DD ステートメントでテープ・データ・セット
を指定できます。1 つのデータ・セットがいっぱいになると、GTF
は次のデータ・セットに切り替えます。
– IEFRDER DD ステートメントで 2 つのテープ装置を指定できま
す。この場合 GTF は、いっぱいになったボリュームを巻き戻して
アンロードしながら、別の装置で現行トレース・データの書き込み
を再開します。
SADMP|SA=nnnnnnK|nnnnM|40K}
スタンドアロン・ダンプ用の GTF トレース・データを保管するために
必要なストレージの量を指定します。ストレージの量をキロバイト (K)
またはメガバイト (M) 単位で指定してください。最小量は 40K であ
り、最大量は 2048M から 400K を引いた値、すなわち 2096752K で
す。GTF は、DASD データ・セットの場合にはブロック・サイズ境界
までストレージ量を切り上げ、テープ・データ・セットまたは内部モー
ドの場合には 32K 境界まで切り上げます。このパラメーターのデフォ
ルト値は 40K です (正しい境界まで切り上げられます)。
SDUMP|SD={nnnnnnK|nnnnM|40K}
SVC ダンプ用の GTF トレース・データを保管するために必要なストレ
ージの量を指定します。ストレージの量をキロバイト (K) またはメガバ
第 10 章 汎用トレース機能 (GTF)
10-7
汎用トレース機能
イト (M) 単位で指定してください。最小量はゼロであり、最大量は
SADMP パラメーターで定義されたストレージの最大量を超えることは
できません。GTF は、DASD データ・セットの場合にはブロック・サ
イズ境界までストレージ量を切り上げ、テープ・データ・セットまたは
内部モードの場合には 32K 境界まで切り上げます。このパラメーター
のデフォルト値は 40K です (正しい境界まで切り上げられます)。
NOPROMPT|NP
このパラメーターを指定すると、トレース・オプションを指定するよう
に促すプロンプトが出されなくなります。メッセージ AHL125A および
AHL100A は発行されません。希望する GTF オプションを使用して
parmlib メンバーを設定してあって、シスプレックス環境で複数の応答
を回避したい場合には、このパラメーターを使用してください。
ABDUMP|AB={nnnnnnK|nnnnM|0K}
ABEND または SNAP ダンプでフォーマット設定する GTF トレース・
データの量を指定します。トレース・データの量をキロバイト (K) また
はメガバイト (M) 単位で指定してください。最小量はゼロであり、最
大量は SADMP パラメーターで定義されたストレージの最大量を超え
ることはできません。GTF は、DASD データ・セットの場合にはブロ
ック・サイズ境界までストレージ量を切り上げ、テープ・データ・セッ
トまたは内部モードの場合には 64K 境界まで切り上げます。このパラ
メーターのデフォルトの値は 0K です。これは、ABEND または SNAP
ダンプに GTF データが含まれないことを意味します。
ABEND または SNAP ダンプの場合、GTF は、障害のあるアドレス・
スペースと直接関連しているレコードだけをフォーマット設定します。
障害のあるアドレス・スペースと関連しているチャネル・プログラムの
トレース・データはフォーマット設定しません。
BLOK={nnnnn|nnnnnK|nnnnnM|40K}
GTF がトレース・データを収集するために使用する仮想記憶域 (E)CSA
の大きさを指定します。このストレージ量は、4096 バイト・ページ単
位 (nnnnn) またはバイト単位 (nnnnnK または nnnnnM) で指定してく
ださい。最大は 99999 であり、デフォルトは 40K です。 40K 未満の
値を指定すると、GTF はデフォルトを使用します。
SIZE={nnnnnK|nnnnnM|1024K}
バッファーのサイズを指定します。この量をバイト単位 (nnnnnK また
は nnnnnM) で指定します。SIZE キーワードの範囲は、1M から
2046M です。最大の量は 2046M であり、デフォルトは 1024K です。
1024K 未満の量を指定すると、GTF はデフォルトを使用します。
TIME=YES
各 GTF トレース・レコードにタイム・スタンプ、およびデータの各ブ
ロックに関連したブロック・タイム・スタンプを付けるように指定しま
す。タイム・スタンプは、GTF がレコードをトレース・テーブルに記録
した現地時間を表す 8 バイトの時刻 (TOD) クロック値です。GTF は
TIME=NO を受け入れません。すべての出力レコードにはタイム・スタ
ンプが付けられます。
IPCS を使用してトレース・レコードをフォーマット設定および印刷す
ると、各トレース・レコードのあとにタイム・スタンプ・レコードが続
10-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
けられます。これらのタイム・スタンプ・レコードを使用して、あるト
レース項目から次のトレース項目までの経過時間を計算することができ
ます。タイム・スタンプ・レコードについては、 10-50 ページの『タイ
ム・スタンプ・レコード』で説明されています。
DEBUG={YES|NO}
エラーを検出したあとで GTF がリカバリーを試みるかどうかを指定し
ます。DEBUG=YES を指定した場合には、GTF はリカバリーを試みま
せん。その代りに、GTF はエラーの検出後にエラー・メッセージを発行
して終了し、エラーの直前のトレース・テーブルの内容が損なわれない
ようにします。
デフォルトである DEBUG=NO を指定した場合には、GTF は次のこと
を行います。
v GTF 処理中にエラーが発生した場合、GTF は次のいずれかのことを
行ってから処理を続行します。
– エラーに関連したトレース・レコードまたはトレース・レコード・
フィールドにフラグを付ける。
– コンソールにメッセージを発行し、エラーの発生を通知する。
– エラーまたはそのエラーが発生した機能を抑制する。
v エラーが GTF 自体で発生したのでない場合には、GTF は異常終了し
ます。GTF の処理が停止しても、それによって他のタスクが停止す
ることはありません。
TIME=nnnn
GTF のための無制限のプロセッサー時間を指定します。
REGION=nnnnK
GTF で必要となるストレージの最大サイズを指定します。832K から 2880K ま
での間の任意の値を指定してください。REGION の値の決定方法については、
10-12 ページの『GTF の必要記憶容量の決定』を参照してください。
IEFRDER DD または GTFOUTxx DD
トレース出力の 1 つまたは複数のデータ・セットを定義します。このステート
メントは、次のいずれかのことを行う場合にだけ必要になります。
v MODE=EXT または MODE=DEFER を指定する
v デフォルト MODE=EXT を使用する
トレース出力データ・セットが 1 つの場合、IEFRDER DD は使用可能です
が、使用する必要はありません。追加のデータ・セットは、GTFOUTxx DD ス
テートメントで定義する必要があります。この場合の xx には、DDNAMES で
有効な 1 つまたは 2 つの文字を指定します。トレース出力データ・セット (複
数の場合もあります) は固有でなければならず、GTF のアクティブなインスタ
ンス間で共用することはできません。GTF 用の出力データ・セットを定義する
方法については、 10-10 ページの『カタログ式プロシージャーで GTF トレース
出力データ・セットを定義するための指針』を参照してください。
SYSLIB DD
オプションで SYSLIB DD ステートメントを組み込むと、GTF トレース・オプ
ションを含む IBM 提供のメンバーまたはインストール先提供のメンバーを定義
第 10 章 汎用トレース機能 (GTF)
10-9
汎用トレース機能
できます。このメンバーが存在する場合には、GTF はそのメンバー内のオプシ
ョンを使用します。このメンバーが存在しない場合には、GTF はエラー・メッ
セージを発行して停止します。
SYSLIB DD ステートメントを含まないプロシージャーをコーディングすると、
GTF はメッセージ AHL100A を発行して、START GTF コマンド後でオプショ
ンを入力するようにプロンプトを出します。これに応答して、希望するトレー
ス・オプションをコンソールから指定することができます。コンソールからオプ
ションを指定する例については、 10-16 ページの『システム・プロンプト指示に
よる GTF トレース・オプションの指定または変更』を参照してください。
カタログ式プロシージャーで GTF トレース出力データ・セットを定
義するための指針
トレース出力データ・セットは GTF のインスタンスごとに固有でなければなら
ず、カタログ式プロシージャー内で定義できます。開始する GTF の各インスタン
スには個別のカタログ式プロシージャーが必要です。または、同じカタログ式プロ
シージャーを使用する場合は、START コマンドで異なるトレース・データ¥セット
を指定する必要があります。
IEFRDER DD または GTFOUTxx DD ステートメントでトレース出力データ・セッ
トを指定するには、以下の指針を参考にしてください。
v GTF で使用する出力データ・セットは 16 まで定義できます。16 を超える数の
データ・セットを定義すると、GTF は最初の 16 個だけを受け入れ、残りは無視
します。
v GTF がすべてのデータ・セットをオープンできない場合には、オープンされなか
ったデータ・セットを示すメッセージを発行し、オープンされたデータ・セット
を使用して処理を続行します。
v GTF の実行中には出力データ・セットが 2 回以上オープンおよびクローズされ
ることになるため、 SPACE パラメーターを使用する場合には RLSE オプション
を指定しないでください。
注: GTF トレース出力が SMS 管理対象ボリューム上にある場合は、SMS 管理
クラスに部分解放を行わせないようにする必要があります。
v トレース・データ・セットには 2 次エクステントを要求しないでください。GTF
は 1 次エクステントのみを使用します。
スペースが割り振られるトレース項目数を最大限に制御できるようにするために
は、スペース割り振りを、トレース・データ・セットの BLKSIZE でブロック長
を使用して指定してください。2 次スペースは指定しないでください。連続ブロ
ックを要求するには、CONTIG オプションを使用します。たとえば、BLKSIZE
が 8192 の場合、SPACE キーワードを次のようにコーディングしてください。
SPACE=(8192,(500,0),,CONTIG)
v すべてのデータ・セットは同じ装置クラスに入っていなければなりません。すな
わち、 DASD またはテープに入っていなければなりませんが、その両方に入れ
ることはできません。装置クラスを混合させると、GTF はテープを無視して
DASD だけを使用します。しかし、データ・セットの装置タイプは異なっていて
もかまいません。たとえば、3380 装置タイプと 3390 装置タイプを混合させるこ
とができます。
10-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
v DSNTYPE=LARGE データ・セットは、従来型のデータ・セットと同様に扱われ
ますが、ボリューム当たり 64 k を超えるトラックを占有できる点が従来型デー
タ・セットと異なります。
v VSAM 線形データ・セットは、従来型データ・セットに類似した取り扱いを受け
ます。データ・セットが 32 k という制御インターバル・サイズ要件に準拠しな
い場合、データ・セットの使用はリジェクトされます。 VSAM 拡張アドレス方
式オプションは受け入れられます。
WRAP 処理が要求されると、1 次スペース要求が相談され、そのスペースに入っ
ている制御インターバルのみが使用されます。 WRAP プロセッシングに使用さ
れる非 VSAM データ・セットと異なり、1 次スペースは、単一エクステントを
使用して満足される必要はありません。
WRAP プロセッシングが要求されない場合は、GTF が停止するかデータ・セッ
トがフルになるまで、制御インターバルは充てんされます。
v GTF 処理が最も効率良く行われるようにするには、次のどちらでも、1 つまたは
複数の出力データ・セットに特定のブロック・サイズを指定しないようにしてく
ださい。
– GTF 用のカタログ式プロシージャー
– 1 つまたは複数のデータ・セットを事前割り振りするために使用される可能性
のある JCL、 TSO/E コマンド、または対話式システム生産性向上機能 / プロ
グラム開発機能 (ISPF/PDF) パネル
システムは、各データ・セットをオープンするときに最適のブロック・サイズを
計算します。
例外: GTF でラベルなしテープを出力データ・セットとして使用したい場合に
は、そのデータ・セットを割り振るときに論理レコード長とブロック・サイズを
指定する必要があります。
v 複数のデータ・セットを定義する場合には、データ・セットに達するパスの数が
データ・セットの数と同じになるようにしてください。
v 各 DD ステートメントの NCP パラメーターを使用して、各出力データ・セット
のチャネル・プログラムの数を指定できます。この NCP 値により、GTF が出力
データ・セットにデータを転送する速度が決まります。たとえば、毎秒 25 バッ
ファーの速度でデータをデータ・セットに転送したい場合に、データ・セットが
5 つあるときには、NCP 値として 5 を指定する必要があります。この場合 GTF
はデータ・セット当り毎秒 5 バッファーの速度で 5 つのデータ・セットにデー
タを転送し、合計で毎秒 25 バッファーの速度が得られます。
NCP の最大値は 255 です。NCP の値を指定しない場合、または 4 未満の値を
指定した場合には、GTF は以下のデフォルト値を使用します。
– テープの場合: 4
– DASD の場合: トラック当りの出力ブロック数に 4 を掛けた値
v START コマンドを入力するときに複数の出力データ・セットの DD ステートメ
ントのいずれかを指定変更した場合には、その DD ステートメントで記号パラメ
ーターを使用しなければなりません。詳細については、 10-14 ページの『GTF を
呼び出すための START コマンドの使用』を参照してください。
第 10 章 汎用トレース機能 (GTF)
10-11
汎用トレース機能
GTF の必要記憶容量の決定
GTF に必要なストレージは、ユーザーが選択するトレース・オプションによって異
なります。 GTF で使用するオプションを決定したあとで 10-13 ページの図 10-2
を使用して、ユーザーのカタログ式プロシージャーの EXEC ステートメントまたは
START GTF コマンドの REGION パラメーターで指定すべき記憶量を決定してく
ださい。計算する必要のあるストレージとして、次のようないくつかのタイプがあ
ります。
v 拡張ページング可能リンク・パック域 (EPLPA)
v システム・キュー・エリア (SQA)
v 拡張共通サービス域 (ECSA)
v 領域ストレージ
図 10-2 に示した式を使用して、各ストレージ・タイプに必要なストレージの量を計
算してください。それらの値をすべて合計すると、REGION パラメーターで指定す
べき最終値が得られます。この図で示されているオプションについては、 10-24 ペ
ージの『GTF トレース・オプション』を参照してください。
10-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
Fix = Opt + Prmpt + 8K
Fix:
SQA = 16500 + REG + SAVE + CBLOC
GTF
EPLPA
Opt:
SQA:
REG:
GTF
OPT
232
(
SAVE:
1352
1.5K
(
8K:
)
(GTF
SRM (
1. PCI
)
)
SYSP
DSP
18K
PIP
2K
SIO
SVC
SVCP
SRM
RR
SIOP
SSCH
6K
10K
RNIO
PCI
SQA
16 + 1200 * (
PCITAB
)
2. CCW
GTF
CCWP
4096
3. USRP
4096
SQA
GTF
SQA
3K
SLIP
USR
CCWP
2.5K
EXT
IO IOP
SSCHP
CCW
GTF
7K
)
)
:
4K
SYS (DSP
RNIO (
)
CBLOC: 1700-2200
8K
SYSM
PI
/
(GTF
Prmpt:
SYS
GTF
)
8K
USRP
(CSA)
1.5K
TRC
CCW
ESQA = N
9.3K
CCWP
N:
:
GTF START
BLOCK =
4500
1. 1
1
DSP
PI
45056
2.5K
2.
4K
3.
'FIX'
4K
:
= PIP DSP SLIP
Fix = 10.5 + 1.5 + 8 = 20K
= 12 + 1.5 + 8 = 21.5 = 24K
2)
= SYSM SRM USR
Fix = 8.5 + 0 + 8K = 16.5 = 20K
= 12 + 0 + 8K = 20K
SUBPOOL: GTF
1031 KB
1)
TRC
REGION:
GTF
800K
図 10-2. GTF 必要記憶容量
第 10 章 汎用トレース機能 (GTF)
10-13
汎用トレース機能
GTF の開始
1 つのシステムで同時に複数の GTF のインスタンスをアクティブにできます。
GTF をアクティブにすると、各インスタンスは独自のアドレス・スペース内でシス
テム・タスクとして作動します。GTF を活動化するには、マスター権限の与えられ
たコンソールから START GTF コマンドを入力しなければなりません。このコマン
ドを使用して、GTF で使用する IBM 提供のプロシージャーまたはユーザーのカタ
ログ式プロシージャーを選択します。カタログ式プロシージャーでは GTF 操作が
定義されます。このプロシージャーが設定するデフォルトを受け入れることも、
START GTF コマンドで特定のパラメーターを指定してデフォルトを変更すること
もできます。
GTF はマスター権限のあるコンソールにメッセージを送るため、このコマンドは、
マスター権限を与えるのに適したコンソールだけで入力してください。このように
しないと、トレース・オプションおよびその他の操作情報を確認するために GTF
から出されるメッセージを見ることができなくなります。
GTF の各インスタンスには、固有の ID を割り当てることができます。この ID
は、START GTF コマンドの GTF キーワードの後ろで指定します。これにより、
GTF の特定のインスタンスの認識と制御が可能になります。固有 ID が指定されな
い場合は、オペレーティング・システムがデフォルトを割り当てますが、これは、
トレース・データ・セットがある装置の装置番号です。デフォルトの ID を持つ
GTF のインスタンスについては、10-19 ページの 例を参照してください。
GTF を呼び出すための START コマンドの使用
IBM 提供のプロシージャー名および ID 以外のパラメーターが指定されていない
START コマンドは、カタログ式プロシージャーのデフォルトを使用します。そのソ
ース JCL に、事前定義のトレース・オプションのデータ・セット・メンバーに関す
る DD ステートメントが含まれている場合、GTF はそれらのオプションをリスト
するメッセージを発行し、オプションを指定変更できるようにします。このような
DD ステートメントが含まれていない場合、GTF は、コンソールから直接トレー
ス・オプションを指定するようにプロンプトを出します。詳細については、 10-16
ページの『システム・プロンプト指示による GTF トレース・オプションの指定ま
たは変更』を参照してください。
GTF を呼び出すには、以下に示す START コマンドを入力します。
{START|S}{GTF|membername}[.identifier]
参照
GTF カタログ式プロシージャーの変更に使用できる START GTF コマンドおよび
パラメーターについては、「z/OS MVS システム・コマンド」を参照してくださ
い。
GTF カタログ式プロシージャー内の JCL ステートメントを指定変更
するための指針
START コマンドの keyword=option パラメーターを使用して指定変更できるの
は、ただ 1 つの出力データ・セット内のパラメーターだけです。複数の出力デー
10-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
タ・セットを定義したときに、いずれかの DD ステートメントの DDNAME とし
て IEFRDER を使用した場合、START コマンドで指定されたキーワードは、
IEFRDER で定義されるデータ・セットの属性が指定変更されます。別のデータ・セ
ットまたは複数のデータ・セットの属性を変更したい場合には、次のようにする必
要があります。
v 変更したい属性に関連する、JCL DD ステートメント内で記号パラメーターを使
用します。DD ステートメントのキーワードを記号パラメーターとして使用する
ことはできません。たとえば、 UNIT=&UNIT をコーディングすることはできま
せん。
v カタログ式プロシージャーの EXEC または PROC ステートメントで記号パラメ
ーターに値を割り当てます。
v START コマンドでキーワードを指定して、EXEC または PROC ステートメント
で指定された記号パラメーター値を指定変更します。
GTF カタログ式プロシージャーの JCL ステートメントを指定変更す
る例
以下の例は、START コマンドの keyword=option パラメーターを使用してカタロ
グ式プロシージャー内の JCL ステートメントを指定変更したい場合の、カタログ式
プロシージャーの設定方法を示しています。以下の両方のプロシージャーにおける
DD ステートメント・パラメーターは、例を示すにすぎません。ユーザーのインス
トール・システムでは、DSNAME、UNIT、および DISP に代えて、あるいは追加し
て、別の DD ステートメント・パラメーターを提供しなければならないことがあり
ます。
例: 1 つのデータ・セットの更新
START コマンドを使用して 1 つのデータ・セットだけを更新したい場合に
は、次のようなカタログ式プロシージャーを使用します。
//GTFABC
//IEFPROC
//
//IEFRDER
//
//SYSLIB
//GTFOUT1
//GTFOUT2
//GTFOUT3
PROC
EXEC
DD
DD
DD
DD
DD
MEMBER=GTFPARM
PGM=AHLGTF,REGION=2880K,TIME=1440,
PARM=(’MODE=EXT,DEBUG=NO’)
DSNAME=SYS1.GTFTRC,UNIT=SYSDA,
SPACE=(4096,20),DISP=(NEW,KEEP)
DSN=SYS1.PARMLIB(&MEMBER),DISP=SHR
DSNAME=SYS1.TRACE1,UNIT=SYSDA,DISP=(NEW,KEEP)
DSNAME=SYS1.TRACE2,UNIT=SYSDA,DISP=(NEW,KEEP)
DSNAME=SYS1.TRACE3,UNIT=SYSDA,DISP=(NEW,KEEP)
START GTFABC,,,UNIT=TAPE と入力すると、IEFRDER で定義されるデー
タ・セットだけが更新されます。
第 10 章 汎用トレース機能 (GTF)
10-15
汎用トレース機能
例: 2 つ以上のデータ・セットの更新
START コマンドを使用して 2 つ以上のデータ・セットの属性を更新したい場
合には、カタログ式プロシージャーで次のような JCL ステートメントを使用
します。
//GTFABC
//
//IEFPROC
//
//
//SYSLIB
//GTFOUT1
//GTFOUT2
//GTFOUT3
PROC MEMBER=GTFPARM,NAME1=’SYS1.TRACE1’,
NAME2=’SYS1.TRACE2’,NAME3=’SYS1.TRACE3’,
EXEC PGM=AHLGTF,REGION=2880K,TIME=1440,
DEVICE=’SYSDA’,DSPS=’OLD’
PARM=(’MODE=EXT,DEBUG=NO’)
DD
DSN=SYS1.PARMLIB(&MEMBER),DISP=SHR
DD
DSNAME=&NAME1,UNIT=&DEVICE,DISP=&DSPS;
DD
DSNAME=&NAME2,UNIT=&DEVICE,DISP=&DSPS;
DD
DSNAME=&NAME3,UNIT=&DEVICE,DISP=&DSPS;
START GTFABC,,,DEVICE=TAPE と入力すると、カタログ式プロシージャー
内の各出力データ・セットに関する UNIT パラメーターのデフォルト値が指定
変更されます。
参照
JCL ステートメントにおける記号パラメーターの使用に関する詳細は、「z/OS MVS
JCL 解説書」を参照してください。
システム・プロンプト指示による GTF トレース・オプションの指定または
変更
START コマンドを入力すると、GTF はトレース・オプションの指定または変更を
するためのメッセージ AHL100A または AHL125A を発行します。カタログ式プロ
シージャーまたは START コマンドに事前定義オプションのメンバーが含まれてい
ない場合、 GTF はトレース・オプションの入力をするためのメッセージ AHL100A
を発行します。このプロシージャーまたはコマンドに事前定義のオプションのメン
バーが含まれている場合、 GTF はコンソール・メッセージ AHL121I および
AHL103I を発行してそれらのオプションを示します。その後は、オプションを受け
入れるか、拒否して新しいオプションを指定することができます。
複数のインスタンスがアクティブの場合、GTF はトレース・オプションの重複を許
可します。これらの一連メッセージは、次のとおりです。
AHL121I TRACE OPTION INPUT INDICATED FROM MEMBER memname OF PDS dsname
AHL103I TRACE OPTIONS SELECTED keywd=(value),...,keywd=(value)
keywd,keywd,...,keywd
AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
注: START GTF コマンドで NOPROMPT または NP を指定すると、システムはト
レース・オプションの再指定または初期設定の続行を要求するためのメッセー
ジ AHL125A を発行しなくなります。
10-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
メンバー内のなんらかのオプションを受け入れない場合には、そのメンバーで指定
されたすべてのオプションを拒否することになります。トレース・オプションを再
指定しても、データ・セット・メンバー内のオプションは修正されません。
応答のフォーマットは次のとおりです。
TRACE=trace option[,trace option]...
トレース・オプションによって GTF に必要なストレージの量が決まります。
10-12 ページの『GTF の必要記憶容量の決定』を参照してください。
GTF は、 10-24 ページの『GTF トレース・オプション』にリストされたトレース・
オプションを受け入れます。
GTF の開始例
このトピックでは、以下の例を示します。
v 『カタログ式プロシージャーおよび parmlib メンバーによる GTF の開始』
v
10-18 ページの『内部トレースを行う GTF の開始』
v
10-18 ページの『テープ上の既存のデータ・セットへのトレース出力を行う GTF
の開始』
v
10-19 ページの『SYS1.PARMLIB に格納されているトレース・オプションを使用
したGTF の開始』
v
10-20 ページの『メンバー内のトレース・オプションを使用せずに行う GTF の
開始』
v
10-21 ページの『VTAM リモート・ネットワーク活動をトレースするための GTF
の開始』
カタログ式プロシージャーおよび parmlib メンバーによる GTF の
開始
この例は、GTFPARM parmlib メンバーを示すカタログ式プロシージャーによって
開始される GTF を示しています。トレース・オプションは parmlib メンバー・レ
コード内で指定されます。この例のメッセージ AHL103I は、GTFPARM メンバー
で指定されているオプション TRACE=SYSM、DSP、PCI、SRM、TRC、USR を示
しています。この例では、最初の START コマンドによって生成されたメッセージ
と応答を示し、また GTFPARM の仕様を有効にすることを示しています。この
GTF のインスタンスは、EXAMPLE1 の ID で認識されます。
第 10 章 汎用トレース機能 (GTF)
10-17
汎用トレース機能
例: カタログ式プロシージャーによる GTF の開始
START GTF.EXAMPLE1
AHL121I TRACE OPTION INPUT INDICATED FROM MEMBER GTFPARM OF PDS SYS1.PARMLIB
AHL103I TRACE OPTIONS SELECTED--SYSM,USR,TRC,DSP,PCI,SRM
00 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 00,U
AHL031I GTF INITIALIZATION COMPLETE
内部トレースを行う GTF の開始
この例は、MODE=INT で開始される、ID が EXAMPLE2 の GTF を示していま
す。トレース・データは仮想記憶域に維持され、外部装置には記録されません。こ
の例では、提供された parmlib メンバーで指定されたトレース・オプションを指定
変更できます。
例: 内部トレースを伴う GTF の開始
START GTF.EXAMPLE2,,,(MODE=INT),DSN=NULLFILE
AHL121I TRACE OPTION INPUT INDICATED FROM MEMBER memname OF PDS dsname
AHL103I TRACE OPTIONS SELECTED - SYSM,USR,TRC,DSP,PCI,SRM
00 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 00,TRACE=IO,SSCH,SVC,DSP
AHL103I TRACE OPTIONS SELECTED -- DSP,SVC,IO,SSCH
01 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 01,U
AHL031I GTF INITIALIZATION COMPLETE
テープ上の既存のデータ・セットへのトレース出力を行う GTF の開
始
この例では、START コマンドを使用して、GTF トレース出力を DASD 上の既存デ
ータ・セットではなくテープ上の既存データ・セットに送付する方法を示していま
す。装置タイプとボリューム通し番号を指定されています。トレース・データ・セ
ットの後処置および名前は、DISP=(NEW,KEEP) および DSNAME=SYS1.TRACE か
ら DISP=(OLD,KEEP) および DSNAME=TPOUTPUT に変更します。指定されたテ
10-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
ープは、ボリューム通し番号が TRCTAP であり、3400 テープ装置に装着されてい
ます。トレース・オプションを指定するために GTFPARM parmlib メンバーが使用
されていることにご注意ください。
ここでは、GTF キーワードの後ろに固有な ID がないため、ID はデフォルトのボ
リューム通し番号になっています。
例: GTF の開始、テープ上の既存データ・セットへのトレース出力
START GTF,3400,TRCTAP,(MODE=EXT),DISP=OLD,DSNAME=TPOUTPUT
AHL103I TRACE OPTIONS SELECTED--SYSM,DSP,PCI,SRM,TRC,USR
00 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 00,U
AHL031I GTF INITIALIZATION COMPLETE
SYS1.PARMLIB に格納されているトレース・オプションを使用した
GTF の開始
この例は、SYS1.PARMLIB のメンバーへのトレース・オプションの格納方法を示し
ています。この方法を使用すると、GTF 開始の際に時間を節約できます。最初にト
レース・オプションの 1 つまたは複数の組み合わせを SYS1.PARMLIB にメンバー
として格納し、カタログ式プロシージャーに SYSLIB DD ステートメントを組み込
みます。GTF を開始すると、GTF は、コンソールに対してトレース・オプションを
指定するようにプロンプトを出すのではなく、SYS1.PARMLIB からトレース・オプ
ションを検索します。GTF はトレース・オプションを表示し、メッセージ
AHL125A を発行します。このメッセージに U で応答し、parmlib オプションを受
け入れます。
例:SYS1.PARMLIB に格納済みトレース・オプションを使用した GTF の開始
この例は、IEBUPDTE を使用してトレース・オプションを SYS1.PARMLIB に
追加するために必要な、ジョブ制御ステートメントおよびユーティリティー
JCL ステートメントを示しています。
//GTFPARM
JOB
MSGLEVEL=(1,)
//
EXEC
PGM=IEBUPDTE,PARM=NEW
//SYSPRINT
DD
SYSOUT=A
//SYSUT2
DD
DSNAME=SYS1.PARMLIB,DISP=SHR
//SYSIN
DD
DATA
./
ADD
NAME=GTFA,LIST=ALL,SOURCE=0
TRACE=SYSP,USR
SVC=(1,2,3,4,10),IO=(D34,D0C),SSCH=ED8,PI=15
./
ADD
NAME=GTFB,LIST=ALL,SOURCE=0
TRACE=IO,SSCH,TRC
./
ADD
NAME=GTFC,LIST=ALL,SOURCE=0
TRACE=SYS,PCI
/*
第 10 章 汎用トレース機能 (GTF)
10-19
汎用トレース機能
参照
v ステートメントの説明は、「z/OS DFSMSdfp Utilities」を参照してください。
v ステートメントの説明は、「z/OS MVS JCL 解説書」を参照してください。
v SYS1.PARMLIB についての詳細は、「z/OS MVS 初期設定およびチューニング
解説書」を参照してください。
GTF カタログ式プロシージャーに組み込まれるサンプル SYSLIB DD ステートメン
トは、次のようになります。
//SYSLIB DD DSN=SYS1.PARMLIB(GTFA),DISP=SHR
次の例に示すように、IBM 提供の GTF プロシージャーを使用しながら、新規メン
バー名を START コマンドで指定することもできます。
S GTF,,,(MODE=EXT,TIME=YES),MEMBER=GTFB
メンバー内のトレース・オプションを使用せずに行う GTF の開始
次の例は、トレース・オプションが指定された事前定義のメンバーがない場合のイ
ンストール先作成プロシージャーを示しています。このプロシージャーには
SYSLIB DD ステートメントが含まれていません。SYSLIB DD ステートメントが含
まれないプロシージャーによって GTF が開始されると、メッセージ AHL100A が
発行され、GTF トレース・オプションを指定するようにプロンプトが出されます。
この例では、インストール先作成のカタログ式プロシージャー USRPROC が呼び出
されて、装置 250 にある直接アクセス・データ・セット ABCTRC に対して外部モ
ードで GTF が開始されます。トレース・オプションを選択すると、以下のものに
関するトレース・データが収集されます。
v すべての SVC および IO 割り込み
v すべての SSCH 操作
v 指定されているトレースに一致するすべての SLIP トラップ、または DEBUG モ
ードの SLIP トラップ
v すべてのタスク・ディスパッチング・プログラム・イベント
v GTRACE マクロのすべての発行元について、トレース・バッファーにユーザー・
データが記録されます。
トレース・データはデータ・セット ABCTRC に書き込まれます。(1 次エクステン
トの終わりに達すると、書き込みは先頭から続行されます。)
10-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
例: トレース・オプションをメンバーに格納しない GTF の開始
START USRPROC,250,333005,(MODE=EXT),DSN=ABCTRC
00 AHL100A SPECIFY TRACE OPTIONS
REPLY 00,TRACE=SVC,SSCH,IO,DSP,SLIP,USR
AHL103I TRACE OPTIONS SELECTED--USR,DSP,SVC,IO,SLIP,SSCH
01 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 01,U
AHL031I GTF INITIALIZATION COMPLETE
VTAM リモート・ネットワーク活動をトレースするための GTF の開始
GTF によって VTAM 活動をトレースできるのは、VTAM が GTF オプションを指
定して開始されている場合に限られます。詳細については、「z/OS Communications
Server: SNA オペレーション」を参照してください。次の例では、GTF オプション
は parmlib に格納されていません。トレース・オプションはコンソールから入力さ
れます。すべての VTAM トレースを記録するためには、次の 3 つの GTF オプシ
ョンが必要です。
v NCP または NCP に接続されたリモート装置に関する VTAM 入出力トレースが
機能するようにするために、RNIO を指定しなければなりません。
v ローカル装置に関する VTAM 入出力トレースが機能するようにするために、IO
または IOP を指定しなければなりません。
v VTAM バッファーと NCP 回線トレースが機能するようにするために、USR ま
たは USRP を指定しなければなりません。
VTAM からトレースを活動化するには、その前に START GTF コマンドを入力す
る必要があります。
例: VTAM リモート・ネットワーク活動をトレースするための GTF の開始
START MYPROC.EXAMPLE8,,,(MODE=EXT)
00 AHL100A SPECIFY TRACE OPTIONS
REPLY 00,TRACE=RNIO,IO,USRP
AHL103I TRACE OPTIONS SELECTED--IO,USRP,RNIO
01 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 01,USR=(FF0,FF1),END
AHL031I GTF INITIALIZATION COMPLETE
第 10 章 汎用トレース機能 (GTF)
10-21
汎用トレース機能
GTF の停止
STOP コマンドは、GTF 処理中にいつでも入力できます。 GTF を実行させる時間
の長さは、インストール・システム、および捕そくしたい問題によって異なります
が、一般的には 15 分から 30 分までの間です。
SLIP トラップが定義された問題に関連する情報を収集するために GTF を実行して
いる場合は、トラップ条件が満たされたときに GTF のすべてのインスタンスを停
止するように SLIP に指示することができます。詳細については、「z/OS MVS シ
ステム・コマンド」の SLIP コマンドの資料を参照してください。
GTF 処理を停止するには、STOP コマンドを入力します。STOP コマンドには、
START コマンドで指定された GTF ID、または、データ・セットに出力を送るため
に MODE=EXT または MODE=DEFER を指定した場合には、GTF トレース・デー
タ・セットの装置番号を組み込む必要があります。 START コマンドで GTF ID を
指定していない場合、GTF のこのようなインスタンスは同じ ID (ボリューム通し番
号) を持つことになります。
トレース・データ・セットの ID や装置番号が正確にわからない場合は、次のコマ
ンドを入力します。
DISPLAY A,LIST
例: DISPLAY A,LIST の出力
次の DISPLAY A,LIST 出力の例では、GTF の ID は EVENT1 になっていま
す。
IEE114I 14.51.49 1996.181 ACTIVITY
JOBS
M/S
TS USERS
SYSAS
00000
00003
00000
00016
LLA
LLA
LLA
NSW S
JES2
JES2
IEFPROC NSW S
GTF
EVENT1
IEFPROC NSW S
FRAME LAST
F
E
INITS
ACTIVE/MAX VTAM
00000
00000/00000
VLF
VLF
VLF
SYS=SY1
OAS
00000
NSW S
STOP コマンドは、マスター権限のあるコンソールから入力する必要があります。
STOP コマンドの一般的なフォーマットは次のとおりです。
{STOP|P} identifier
例: GTF の停止
ID EVENT1 に関する GTF を停止するには、次のコマンドを入力します。
STOP EVENT1
STOP コマンドが効力を表すと、システムはメッセージ AHL006I を発行します。
システムがメッセージ AHL006I を発行しない場合には、GTF トレースは続行さ
れ、 STOP コマンドが効力を表すかあるいは次の初期プログラム・ロード (IPL) が
10-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
行われるまで活動状態のままになります。 このような場合には、GTF トレースを
再始動することはできません。この場合、FORCE ARM コマンドを使用して GTF
を停止できます。
START コマンドで指定された同じ ID を持つ複数の機能が開始している場合には、
STOP コマンドで同じ ID を使用すると、これらすべての機能が停止します。
STOP コマンドでボリューム通し番号を使用した場合は、そのボリューム通し番号
のデータ・セットに送られるトレース・データを持つ GTF のすべてのインスタン
スが停止します。この動作は、GTF の各インスタンスに割り当てられた ID とは無
関係に発生します。
例えば、EX1、EX2、EX3 という ID を持つ GTF の 3 つのアクティブなインスタ
ンスがあり、トレース・データをボリューム通し番号が 1020 の同じボリュームの
異なるデータ・セットに送っている場合は、次のコマンドによってこの 3 つの
GTF のインスタンスがすべて停止します。
例: GTF の停止
同じボリューム上にトレース・データ・セットを持つ、EX1、EX2、および
EX3 という ID の GTF を停止するには、次のコマンドを入力します。
STOP 1020
参照
STOP および FORCE ARM コマンドについての詳細は、「z/OS MVS システム・コ
マンド」を参照してください。
GTF 停止の例
例: ID を使用する GTF の停止
この例では、ID EXAMPLE を指定し、また GTF アドレス・スペースにトレ
ース・データを維持することを指定して GTF トレースを開始します。カタロ
グ式プロシージャーで指定された外部トレース・データ・セットが割り振られ
ないようにするために、DSN キーワードが指定されています。
START GTF.EXAMPLE,,,(MODE=INT),DSN=NULLFILE
上のコマンドで開始された GTF トレースを停止するためのコマンドは次のと
おりです。
STOP EXAMPLE
第 10 章 汎用トレース機能 (GTF)
10-23
汎用トレース機能
例: GTF を停止するための活動状態のジョブの表示
この例は、GTF を停止する前に活動状態のジョブを表示する必要がある場合を
示しています。この例では、外部装置であるデータ・セット GTF.TEST01 に
トレース・データを記録するように指定して GTF を開始しています。また、
EX1 という ID の別の GTF のインスタンスが開始され、同じボリューム上の
別のデータ・セットにトレース・データが送られています。MODE=EXT はデ
フォルトであるため、指定する必要はありません。
S GTF,,,DSNAME=GTF.TEST01,VOLUME=SER=IPCS01,DISP=OLD
S GTF.EX1,DSNAME=GTF.TEST02,VOLUME=SER=IPCS01
GTF の記録装置がどの装置であるかが明らかでないため、GTF を停止する前
に、 DISPLAY A,LIST コマンドを使用してアクティブなジョブを表示する必
要があります。この例では、GTF 用の装置番号は 0227 です。
IEE114I 09.33.45 1996.183 ACTIVITY 951
JOBS
M/S
TS USERS
SYSAS
INITS
ACTIVE/MAX VTAM
OAS
00001
00006
00001
00015
00002
00001/00300
00000
LLA
LLA
LLA
NSW S VLF
VLF
VLF
NSW S
VTAM
VTAM
VTAM
NSW S JES2
JES2
IEFPROC NSW S
TCAS
TCAS
TSO
OWT S SDJSST1B STEP1
OWT J
GTF
0227
IEFPROC NSW SGTF
EX1
IEFPROC NSW S
GTF の 2 番目のインスタンスのみを停止する必要がある場合は、次のコマン
ドを発行します。
STOP EX1
両方のインスタンスを停止する場合は、次のコマンドを入力します。
STOP 227
GTF トレース・オプション
このトピックでは、START GTF コマンドに対応するシステムのプロンプト指示、
または事前定義の parmlib またはデータ・セットのメンバーで指定できる、GTF オ
プションについて説明します。ただし、オプションの特定の組み合わせの中には、
GTF で使用されないものがあります。これらの組み合わせのリストについては、
10-30 ページの表 10-1 を参照してください。
GTF トレース・オプションの中にはキーワードが必要なものもあります。事前定義
オプションを含むメンバーまたはデータ・セット内で、キーワードを必要とするオ
プションを指定する場合には、関連するキーワードも指定しなければなりません。
これについては、 10-31 ページの『プロンプト指示キーワード』で説明されていま
す。
ASIDP
GTF トレースをアドレス・スペースのサブセットだけに限定することを要求し
ます。 ASIDP を指定すると、GTF トレースの対象となる 1 つから 5 つまで
のアドレス・スペース ID (ASID) を入力するように、GTF がプロンプト指示を
10-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
出すようになります。ASIDP は、SVC や IO などのトレースを生成する GTF
オプションを指定した場合にだけ機能します。GTF プロンプト指示への応答の
説明については、 10-31 ページの『プロンプト指示キーワード』を参照してくだ
さい。
CCW
チャネル・プログラムおよび関連データについて、入出力イベントのトレースを
要求します。 CCW は、別のトレース・オプションとして SSCH、SSCHP、
IO、または IOP が指定されている場合にだけ有効です。 10-30 ページの表 10-1
を参照してください。
CCW トレース・レコード・フォーマットは、z/OS V1R6 以上と互換性があり
ます。 たとえば、z/OS V1R4 システムは、z/OS V1R6 で生成された CCW ト
レース・レコードをフォーマット設定できません。
CCWP
チャネル・プログラムおよび関連データについて、入出力イベントのトレースを
要求し、以下の情報の入力に関する GTF プロンプト指示を要求します。
v サブチャネル開始 (SSCH) 操作または入出力割り込み、あるいはその両方に
関する、チャネル・コマンド・ワード (CCW) のトレース。
v 各イベントに関する CCW の最大数
v 各 CCW に関するデータの最大バイト数
v オプションの入出力監視プログラム・ブロック (IOSB) およびエラー・リカ
バリー・プロシージャー作業域 (EWA) トレース
v プログラム制御割り込み (PCI) テーブルのサイズ
GTF プロンプト指示への応答の説明については、 10-31 ページの『プロンプト
指示キーワード』を参照してください。
CCWP は、別のトレース・オプションとして SSCH、SSCHP、IO、または IOP
が指定されている場合にだけ有効です。 10-30 ページの表 10-1を参照してくださ
い。
CSCH
すべてのサブチャネル切断操作に関する記録を要求します。このオプションと他
の GTF オプションの組み合わせに関する詳細については、 10-30 ページの表
10-1 を参照してください。
DSP
すべてのディスパッチ可能作業単位に関する記録、すなわち、サービス要求ブロ
ック (SRB)、ローカル監視プログラム・ルーチン (LSR)、タスク制御ブロック
(TCB)、および監視プログラム呼び出し (SVC) のプロローグ・ディスパッチ・
イベントの記録を要求します。SYSM と DSP の両方のトレース・オプション
を指定すると、GTF は DSP の最小限のトレース・データを記録します。それ
以外の場合には、GTF は DSP に関する広範囲のトレース・データを記録しま
す。
EXT
すべての外部割り込みに関する広範囲の記録を要求します。このオプションと他
の GTF オプションの組み合わせに関する詳細については、 10-30 ページの表
10-1 を参照してください。
第 10 章 汎用トレース機能 (GTF)
10-25
汎用トレース機能
HSCH
すべてのサブチャネル停止操作に関する記録を要求します。このオプションと他
の GTF オプションの組み合わせに関する詳細については、 10-30 ページの表
10-1 を参照してください。
IO すべての非プログラム制御入出力割り込みの記録を要求します。 PCI トレー
ス・オプションも指定しない限り、GTF はプログラム制御割り込みを記録しま
せん。このオプションと他の GTF オプションの組み合わせに関する詳細につい
ては、 10-30 ページの表 10-1 を参照してください。
IOX
I/O 要約トレース・レコード内に入出力割り込みのための完全なチャネル・プロ
グラムの要約を提供するすべての非プログラム制御入出力割り込みの記録を要求
します。PCI トレース・オプションも指定しない限り、GTF はプログラム制御
割り込みを記録しません。
IOP
GTF による非プログラム制御入出力割り込みの記録対象となる特定の装置番号
を指定するためのプロンプト指示を出すように、GTF に対して要求します。PCI
トレース・オプションを指定しない限り、GTF はプログラム制御割り込みを記
録しません。このオプションと他の GTF オプションの組み合わせに関する詳細
については、 10-30 ページの表 10-1 を参照してください。 GTF プロンプト指
示への応答の説明については、 10-31 ページの『プロンプト指示キーワード』を
参照してください。
IOXP
装置番号の入力を求めるプロンプト指示を出すよう GTF に要求します。この装
置番号は、入出力要約トレース・レコード内に入出力割り込みのための完全なチ
ャネル・プログラムの要約を提供する非プログラム制御入出力割り込みを GTF
に記録させたい装置番号です。PCI トレース・オプションを指定しない限り、
GTF はプログラム制御割り込みを記録しません。GTF プロンプト指示への応答
に関する詳細は、 10-31 ページの『プロンプト指示キーワード』を参照してくだ
さい。
インストール時に IOX または IOXP に加えて IO または IOP を選択した場合
は、 DASD およびテープ装置についての IOX レコードと、他のすべての装置
についての IO レコードを受け取ります。
JOBNAMEP
GTF トレースをジョブのサブセットだけに限定することを要求します。
JOBNAMEP を指定すると、GTF トレースの対象となる 1 つから 5 つまでの
ジョブ名を入力するように、ユーザーに対して GTF をプロンプト指示を出しま
す。
ジョブ名は総称ジョブ名であっても特定のジョブ名であってもかまいません。総
称ジョブ名を指定する場合には、ジョブ名の中で * または % を使用します。
アスタリスクは、1 つまたは複数の有効なジョブ名文字を表すか、あるいは文字
がないことを表す変数です。例えば、JOBNAMEP=I*MS* と入力すると、GTF
は IABMS01、IAMS、IMS、IMSA、IMS00012 などのジョブ名を持つアドレ
ス・スペースに関するトレース・データを処理します。ただし、
JOBNAMEP=*MASTER* と入力すると、このジョブ名はマスター・アドレス・
スペースだけを表します。
10-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
パーセント記号は、単一の有効なジョブ名文字を表す変数です。例えば、
JOBNAMEP=I%MS%% と入力すると、GTF は IAMS01 および IXMSBC とい
うジョブ名を持つアドレス・スペースに関するトレース・データを処理します
が、IMS001 や I999MS というジョブ名についてはトレース・データを処理し
ません。%* の組み合わせは、少なくとも 1 文字を表す変数です。
JOBNAMEP は、SVC や IO などのトレースを生成する GTF オプションを指
定した場合にだけ機能します。GTF プロンプト指示への応答の説明について
は、 10-31 ページの『プロンプト指示キーワード』を参照してください。
MSCH
すべてのサブチャネル修正操作に関する記録を要求します。このオプションと他
の GTF オプションの組み合わせに関する詳細については、 10-30 ページの表
10-1 を参照してください。
PCI
GTF が生成する他の入出力トレース・レコードと同じフォーマットで中間状況
割り込みを記録するよう要求します。PCI を使用すると特に、GTF はプログラ
ム制御入出力割り込み、初期状況要求割り込み、サブチャネル再開操作命令、お
よびチャネル・プログラム中断割り込みを記録するようになります。入出力イベ
ント (IOP トレース・オプション) の入力を求めるプロンプトに応答して特定の
装置を選択すると、GTF はそれらの装置についてだけ中間状況割り込みを記録
します。PCI は、別のトレース・オプションとして IO、IOP、SYS、SYSM、ま
たは SYSP が指定されている場合にだけ有効です。
PI すべてのプログラム割り込み (0-255) に関する広範囲の記録を要求します。この
オプションと他の GTF オプションの組み合わせに関する詳細については、
10-30 ページの表 10-1 を参照してください。
PIP
GTF によるプログラム割り込みの記録対象となる割り込みコードを指定するた
めのプロンプト指示を出すように、GTF に対して要求します。GTF プロンプト
指示への応答の説明については、 10-31 ページの『プロンプト指示キーワード』
を参照してください。このオプションと他の GTF オプションの組み合わせに関
する詳細については、 10-30 ページの表 10-1 を参照してください。
RNIO
すべての仮想記憶通信アクセス方式 (VTAM) ネットワーク活動の記録を要求し
ます。SYSM と RNIO の両方のトレース・オプションを指定すると、 GTF は
RNIO に関して最小限のトレース・データを記録します。それ以外の場合には、
GTF は RNIO に関する広範囲のトレース・データを記録します。
RR
リカバリー・ルーチン (STAE ルーチンや ESTAE ルーチンなど) のすべての呼
び出しに関連するデータの広範囲の記録を要求します。GTF は、リカバリー・
ルーチンからリカバリー終了マネージャー (RTM) に制御が戻されたときに、リ
カバリー・ルーチンの活動を説明するトレース・レコードを作成します。このオ
プションと他の GTF オプションの組み合わせに関する詳細については、
10-30 ページの表 10-1 を参照してください。
{SIO|SIOP}
SIO または SIOP トレース・オプションを指定すると、 GTF はその要求を
SSCH または SSCHP の要求として処理します。GTF はメッセージ AHL138I
第 10 章 汎用トレース機能 (GTF)
10-27
汎用トレース機能
を発行してこの置換を示します。そのあとで発行されるメッセージで、元の
SIO または SIOP トレース・オプションが参照されます。
注: SIO キーワードは、互換性を維持するためにだけ提供されています。このキ
ーワードではなく、SSCH キーワードを使用することをお勧めします。
SIOP オプションは、互換性を維持するためにだけ提供されています。この
オプションではなく、SSCHP オプションを使用することをお勧めします。
SLIP
次のことが起こるたびにトレース項目を作成するように要求します。
v ACTION=TRACE が指定された SLIP トラップに一致した場合
v SLIP DEBUG が指定された SLIP トラップがチェックされた
作成される SLIP トレース・レコードのデータ量およびタイプは、SLIP コマン
ドで指定されます。
SRM
システム・リソース・マネージャー (SRM) が呼び出されるたびにトレース・デ
ータを記録することを要求します。SYSM と SRM の両方のトレース・オプシ
ョンを指定すると、GTF は SRM の最小限のトレース・データを記録します。
それ以外の場合には、GTF は SRM に関する広範囲のトレース・データを記録
します。
SSCH
サブチャネル開始操作およびサブチャネル再開操作に関する記録を要求します。
このオプションと他の GTF オプションの組み合わせに関する詳細については、
10-30 ページの表 10-1 を参照してください。
SSCHP
GTF によるサブチャネル開始操作およびサブチャネル再開操作の記録対象とな
る特定の装置番号を指定するためのプロンプト指示を行なうように、GTF に要
求します。GTF プロンプト指示への応答の説明については、 10-31 ページの
『プロンプト指示キーワード』を参照してください。このオプションと他の
GTF オプションの組み合わせに関する詳細については、 10-30 ページの表 10-1
を参照してください。
SVC
すべての SVC 割り込みに関する広範囲の記録を要求します。このオプションと
他の GTF オプションの組み合わせに関する詳細については、 10-30 ページの
表 10-1 を参照してください。
SVCP
データ記録の対象となる SVC 番号を入力するためのプロンプト指示を出すよう
に、GTF に要求します。GTF プロンプト指示への応答の説明については、
10-31 ページの『プロンプト指示キーワード』を参照してください。このオプシ
ョンと他の GTF オプションの組み合わせに関する詳細については、 10-30 ペ
ージの表 10-1 を参照してください。
SYS
以下のすべてのものに関する広範囲のトレース・データの記録を要求します。
v サブチャネル切断操作
v 外部割り込み
v サブチャネル停止操作
10-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
v
v
v
v
v
v
入出力割り込み
サブチャネル修正操作
プログラム割り込み
リカバリー・ルーチン
サブチャネル開始操作とチャネル再開操作
SVC 割り込み
SYS を指定すると GTF はこれらすべてのイベントを自動的にトレースするよ
うになるため、なんらかの形でトレース・オプション CSCH、HSCH、MSCH、
SSCH、EXT、IO、PI、RR、または SVC を指定しても、GTF はそれらを無視
します。このオプションと他の GTF オプションの組み合わせに関する詳細につ
いては、 10-30 ページの表 10-1 を参照してください。
SYSM
SYS の場合と同じイベントに関する最小限のトレース・データの記録を要求し
ます。
SYSM を指定すると GTF はこれらすべてのイベントを自動的にトレースする
ようになるため、なんらかの形でトレース・オプション CSCH、HSCH、
MSCH、SSCH、EXT、IO、PI、RR、または SVC を指定しても、GTF はそれら
を無視します。
SYSM に加えて DSP、RNIO、または SRM を指定すると、GTF はそれらのイ
ベントに関して、広範囲のトレース・データではなく最小限のトレース・データ
を生成します。
SYSP
SYS オプションの場合と同じイベントに関する記録を要求しますが、GTF は、
ユーザーに対して記録しようとする特定の SVC、IO、SSCH、および PI イベン
トを選択するようにプロンプト指示を出します。GTF プロンプト指示への応答
の説明については、 10-31 ページの『プロンプト指示キーワード』を参照してく
ださい。
SYSP を指定すると GTF はこれらすべてのイベントを自動的にトレースするよ
うになるため、なんらかの形でトレース・オプション CSCH、HSCH、MSCH、
SSCH、EXT、IO、PI、RR、または SVC を指定しても、GTF はそれらを無視
します。このオプションと他の GTF オプションの組み合わせに関する詳細につ
いては、 10-30 ページの表 10-1 を参照してください。
TRC
GTF 自体に関連するトレース・イベントの記録を要求します。TRC を要求しな
い限り、GTF はこれらのイベントをトレースしません。TRC は、SVC や IO
などのトレースを生成する GTF オプションを指定した場合にだけ機能します。
USR
GTRACE マクロが GTF に渡すすべてのデータの記録を要求します。 GTRACE
マクロからのデータをトレースするには、USR または USRP を指定する必要が
あります。特定のイベントについてデータをトレースする場合には USRP を使
用してください。USRP ではなく USR を使用すると、トレース・データ・セッ
トに多くの不要レコードが含まれる可能性があります。USR も USRP も指定し
ないで GTRACE マクロをコーディングすると、GTF は GTRACE マクロを無
視します。このオプションと他の GTF オプションの組み合わせに関する詳細に
ついては、 10-30 ページの表 10-1 を参照してください。
第 10 章 汎用トレース機能 (GTF)
10-29
汎用トレース機能
参照
GTRACE マクロのコーディングについての情報は、「z/OS MVS プログラミン
グ: アセンブラー・サービス 解説書 ABE-HSP」を参照してください。
USRP
GTRACE マクロが GTF に渡すデータの特定のイベント ID (EID) の入力を求
めるプロンプト指示を出すように、GTF に要求します。EID は、ユーザー、プ
ログラム・プロダクト、または IBM のサブシステムおよびコンポーネントのイ
ベントを表します。EID 値のリストについては、 10-37 ページの表 10-4 を参照
してください。
このオプションと他の GTF オプションの組み合わせに関する詳細については、
表 10-1 を参照してください。 GTF プロンプト指示への応答の説明について
は、 10-31 ページの『プロンプト指示キーワード』を参照してください。
XSCH
すべてのサブチャネル取り消し操作の記録を要求します。
このオプションと他の GTF オプションの組み合わせに関する詳細については、
表 10-1 を参照してください。 GTF プロンプトへの応答については、 10-31 ペ
ージの表 10-2を参照してください。
GTF オプションの組み合わせ
表 10-1 は、GTF で組み合わせて使用されない TRACE オプションを示していま
す。同じ行の複数のオプションを指定すると、GTF は列番号の低いオプションを使
用し、その他のオプションを無視します。例えば、SYSP と PI (行 D を参照) の両
方を指定すると、GTF は SYSP (列 2) を使用し、 PI (列 5) を無視します。
表 10-1. GTF オプションの組み合わせ
行
列
1
2
3
4
5
A
SYSM
SYSP
SYS
SSCHP
SSCH
B
SYSM
SYSP
SYS
IOP, IOXP
IO, IOX
C
SYSM
SYSP
SYS
SVCP
SVC
D
SYSM
SYSP
SYS
PIP
PI
E
SYSM
SYSP
SYS
EXT
F
SYSM
SYSP
SYS
RR
G
SYSM
SYSP
SYS
CSCH
H
SYSM
SYSP
SYS
HSCH
I
SYSM
SYSP
SYS
MSCH
J
SYSM
SYSP
SYS
XSCH
K
CCWP
CCW
L
USRP
USR
インストール時に IOX または IOXP に加えて IO または IOP を選択した場合は、
DASD およびテープ装置についての IOX レコードと、他のすべての装置について
の IO レコードを受け取ります。
10-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
プロンプト指示キーワード
表 10-2 にリストされているトレース・オプションのいずれかを指定すると、GTF
はメッセージ AHL101A を発行して特定の値を指定するようにプロンプトを出しま
す。
AHL101A SPECIFY TRACE EVENT KEYWORDS - keyword=,...,keyword=
このメッセージで示されるキーワードは、指定されたトレース・オプションに対応
しています。メッセージ・テキストで示されたトレース・イベントのキーワードだ
けを入力してください。トレース・オプションとそれに対応するキーワードは次の
とおりです。
表 10-2. GTF トレース・オプションおよび対応するプロンプト・キーワード
トレース・オプション
プロンプト指示キーワード 許されるプロンプト指示値の数
ASIDP
ASID=
5
CCWP
CCW=
該当なし
IOP, IOXP, SYSP
IO=SSCH=
無制限
IOP, IOXP, SSCHP, SYSP
IO=SSCH=
無制限
JOBNAMEP
JOBNAME=
5
PIP、SYSP
PI=
50
SSCHP, SIOP, SYSP
SIO=
無制限
SSCHP, SIOP, SYSP
SSCH=
無制限
SVCP、SYSP
SVC=
50
USRP
USR=
50
注:
1. SIO キーワードは、互換性を維持するためにだけ提供されています。このキーワードで
はなく、SSCH キーワードを使用することをお勧めします。SIOP オプションは、互換性
を維持するためにだけ提供されています。このオプションではなく、SSCHP オプション
を使用することをお勧めします。
2. PAV 基本装置番号をトレースすると、その基本装置番号に関連するすべての PAV 別名
もトレースされます。 PAV 別名装置番号が PAV 基本装置番号に関連付けられていな
いときに、それに関連する問題を特定するのに入出力トレースが必要な場合は、PAV 別
名装置の装置番号を明示的に指定します。
プロンプト指示キーワードに値を指定する指針は次のとおりです。 キーワードをプ
ロンプト指示するメッセージ AHL101A に応答する際には、次の指針を使用してく
ださい。
v メッセージ AHL101A で表示された各キーワードに対して応答を指定しないと、
GTF はそのトレース・オプションに関するすべてのイベントを記録するため、
GTF が必要とするストレージの量が多くなります。表示された各キーワードにつ
いて、問題のデバッグに役立つ値を選択して指定することをお勧めします。
v メッセージ AHL101A で表示されたキーワードの値だけを指定できます。
v GTF は、プロンプトを介して指定できる特定の値の数を制限します。各キーワー
ドについて許可される値の最大数については、表 10-2 を参照してください。最大
値を超える数の値を指定すると、GTF がメッセージを発行するので、それに応答
して該当するすべてのキーワードの値を再指定します。
第 10 章 汎用トレース機能 (GTF)
10-31
汎用トレース機能
v 必要記憶量はユーザーが指定するトレース・オプションに依存するため、プロン
プト指示を出すようにすると、GTF が必要とするストレージの量が増大すること
にご注意ください。詳細については、 10-12 ページの『GTF の必要記憶容量の決
定』を参照してください。
v 1 つの応答で指定する各キーワードは、その応答内で完結している必要がありま
す。あるキーワードについて、1 つの応答で指定しきれない数の値を指定する必
要がある場合には、次の応答でそのキーワードを繰り返し、そのキーワードに関
する追加の値をコーディングします。正しい応答の例を次に示します。
REPLY 01 IO=(191-193),SVC=(1,2,3,4,5)
REPLY 01 SVC=(6,7,8,9,10)
あるキーワードに関して GTF が許可する値の最大数は、そのキーワードに関す
るすべての値を指定するために 1 つの応答を入力するのか複数の応答を入力する
のかにかかわらず、変わりません。
v すべてのキーワードと値の指定後は、END キーワードを入力する必要がありま
す。このキーワードは、イベント定義が完了したことを通知するものです。応答
から END キーワードが検出されなかった場合、システムはメッセージ
AHL102A を発行して、追加のイベント・キーワードおよび値を入力するように
プロンプト指示します。END キーワードが検出された場合には、システムはメッ
セージ AHL103I を発行して、有効になっているすべてのトレース・オプション
のリストを示します。
一連のプロンプト指示のサンプルについては、 10-37 ページの『一連のサンプル・
プロンプト指示の例』を参照してください。
GTF がメッセージ AHL101A を発行して値の入力をプロンプト指示した場合には、
以下のキーワードを使用してください。
ASID=(asid1[,asidn]...[,asid5])
GTF トレースを行いたいアドレス・スペースを表す、1 つから 5 つまでの ID
を指定します。‘asid1’ から ‘asid5’ までの値は、X'0001' からアドレス・スペー
ス・ベクトル・テーブル (ASVT) 内の項目の最大数までの 16 進数です。
ASIDP を指定して、ASID= を指定しないまま END で応答すると、GTF はす
べてのアドレス・スペース ID をトレースします。
ASID の値の数が多く 1 行では収まらない場合で、特定の ASID 値が正しくな
い場合、 GTF は、すべての ASID を再入力せずに正しい値を再指定できるよ
うにします。
ASID と JOBNAME の両方を指定すると、JOBNAMEP で識別されたジョブの
うちのいくつかが別のアドレス・スペースで実行されている場合には、GTF は
ASIDP で識別されなかったアドレス・スペースもトレースします。
CCW=([S|I|SI][,CCWN=nnnnn][,DATA=nnnnn][,IOSB][,PCITAB=n])
チャネル・プログラムをトレースするためのさまざまなオプションを指定しま
す。CCW= を 2 回以上指定すると、GTF は CCW= の最後の指定値を使用し
ます。
CCWP を指定し、CCW= キーワードの値を指定しない場合には、GTF のデフ
ォルト CCW トレースは、他にどのようなトレース・オプションが指定されて
いるかによって変わってきます。以下の表は、他に指定されたトレース・オプシ
ョンに依存するデフォルト CCW トレースを表しています。
10-32
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
表 10-3. 選択された TRACE オプションに対応する CCW のデフォルト
他に選択されたトレース・オプション
CCW サブパラメーターのデフォルト
SSCH または SSCHP
S
IO、IOP、IOX または IOXP
I
SSCH、SSCHP、IO、IOP、IOX または
IOXP
SI
PCI
PCITAB=1
SSCH、SSCHP、IO、IOP、IOX または
IOXP
CCWN=50
SSCH、SSCHP、IO、IOP、IOX または
IOXP
DATA=20
Examples:
TRACE=IO,CCWP
TRACE=IOP,SSCH,PCI,CCWP
CCW defaults to: CCW=(I,CCWN=50,DATA=20)
CCW defaults to: CCW=(SI,CCWN=50,DATA=20,PCITAB=1)
同じ行で 1 つのオプションを 2 回以上指定すると、GTF はそのオプションに
ついて最後に指定された指定値を使用します。ただし、S、I、または SI につい
ては、最初の指定値が使用されます。行にエラーが含まれている場合、GTF は
値を再指定するようにプロンプトを出します
S|I|SI
チャネル・プログラムをトレースする対象となる入出力イベントのタイプを
指定します。複数のオプションを指定すると、GTF は最初のオプションを
使用します。
S
サブチャネル開始操作とサブチャネル再開操作の場合チャネル・プログ
ラムを GTF がトレースするように指定します。CCW=S は、SSCH ま
たは SSCHP トレース・オプションが指定されている場合にだけ機能し
ます。
I
GTF が入出力割り込みのチャネル・プログラムをトレースするように指
定します。トレース・オプションとして PCI を指定した場合には、プ
ログラム制御割り込みも含まれます。CCW=I は、IO または IOP トレ
ース・オプションが指定されている場合にだけ機能します。
SI サブチャネル開始操作とサブチャネル再開操作および入出力割り込みの
場合にチャネル・プログラムを GTF がトレースするように指定しま
す。CCW=SI は、SSCH または SSCHP のいずれかのトレース・オプシ
ョン、および IO または IOP のいずれかのトレース・オプションが指
定されている場合にだけ機能します。
CCWN=nnnnn
各イベントについてトレースされる CCW の最大数を指定します。値
nnnnn は、1 から 32767 までの任意の 10 進数です。デフォルトは 50 で
す。
DATA=nnnnn
各 CCW についてトレースされるデータの最大バイト数を指定します。値
nnnnn は、0 から 32767 までの任意の 10 進数です。デフォルトは 20 で
す。
第 10 章 汎用トレース機能 (GTF)
10-33
汎用トレース機能
GTF は、データ・チェーン内の各 CCW について nnnnn バイトのデータを
トレースします。 GTF は、間接データ・アドレッシング・ワード (IDAW)
のリスト、または、変更された間接アドレッシング・ワードのリスト内の
nnnnn バイトのデータをトレースします。
サブチャネル開始操作およびサブチャネル再開操作については、GTF はチ
ャネル・プログラム内の読み取りコマンド、逆方向読み取りコマンド、また
は検知コマンドに関するデータをトレースしません。データが転送されない
場合には、入出力操作のタイプとは無関係に、GTF は読み取りコマンド、
逆方向読み取りコマンド、または検知コマンドのデータをトレースしませ
ん。
CCW 内のデータ・カウントが nnnnn 以下の場合には、GTF はデータ・バ
ッファー内のすべてのデータをトレースします。CCW 内のデータ・カウン
トが nnnnn を超えている場合には、GTF はデータ・バッファー内の最初と
最後のデータだけをトレースします。トレース・データを調べることによ
り、そのチャネルが読み取り操作のバッファーを完全に埋めているかどうか
を確認できます。
入出力割り込みが発生したときにデータ転送が進行中である場合、GTF は
他の場合と異なる CCW トレース方式を使用します。GTF トレースは、
CCW 内のデータ・カウントを使用せずに、伝送データ・カウントにもとづ
いて行われます。伝送データ・カウントは、CCW 内のカウントとチャネル
状況ワード (CSW) 内の残余カウントの差です。
v CSW 内の残余カウントが CCW 内のデータ・カウントよりも大きい場
合、GTF は CCW 内のすべてのデータをトレースします。
v 伝送データ・カウントが nnnnn 以下の場合には、GTF はすべての伝送デ
ータをトレースします。
v 伝送データ・カウントが nnnnn を超えている場合には、GTF は伝送デー
タの最初と最後の部分だけをトレースします。
IOSB
すべての CCW イベントについて、入出力監視プログラム・ブロック
(IOSB)、および (可能な場合には) エラー・リカバリー・プロシージャー作
業域 (EWA) のトレースを指定します。ユーザーが IOSB を指定しなかっ
た場合には、GTF は、チャネル・プログラムのトレース中に例外条件を検
出した場合にだけ IOSB および EWA トレースを行います。
PCITAB=n
内部プログラム制御割り込み (PCI) テーブル内で GTF が割り振る項目数の
100 単位の増分を表す 10 進数を指定します。n の値は、1 から 9 までの
整数です。デフォルトは 1 (100 項目) です。
PCI テーブルには、PCI を使用するチャネル・プログラムが記録されます。
PCI テーブル内の 1 つの項目には、1 つのチャネル・プログラム内で発生
したプログラム制御割り込みに関する情報が入ります。PCI テーブルのこの
項目には、CCW アドレスと IOSB アドレスが入っています。
IO=(DEVCLASS=xxxx,DEVCLASS=xxxx,devnum1 [,devnumn...,devnum])
入出力割り込みをトレースしたい装置を指定します。
装置は、装置番号または装置クラスを入力して指定します。
10-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
装置番号は 16 進数で指定しますが、これはサブチャネル番号ではありません。
IO= と SSCH=、および IO=SSCH= の任意の組み合わせを指定した場合、プロ
ンプトが出されるすべてのキーワードに装置番号を結合した数は無制限です。装
置番号を単独で、または装置番号の範囲をダッシュ (-) またはコロン (:) で範囲
の最小番号と最大番号を区切って指定してください。たとえば、装置番号 193
から 198 までについて入出力割り込みをトレースする場合には、 IO=(193-198)
と指定します。
装置クラスは、DEVCLASS= キーワード・パラメーターで指定しなければなり
ません。これにより、指定した装置クラス内のすべての装置をトレースできるよ
うになります。使用できるキーワード・パラメーターは、次のとおりです。
TAPE
COMM
DASD
DISP
UREC
CTC
(magnetic tape devices)
(communications)
(direct access storage device)
(display)
(unit/record)
(channel to channel)
IOP、IOXP または SYSP を指定し、プロンプト・メッセージに対する応答で
IO= を指定していないと、GTF の処理は、IO、IOX、または SYS イベント・
キーワードが個々に指定されたかのように進行します。
次の例では、以下にリストされている I/O 装置番号および関連する装置タイプ
が使用されています。
I/O 装置番号
230
450
575
663
020
装置タイプ
3390 DASD
3490 テープ装置
3480 テープ駆動機構
3380 DASD
3274 通信コントローラー
例 1:
IO=(DEVCLASS=DASD,450)
トレースの結果には、すべての DASD 装置および、アドレス 450 の 3490 テープ
駆動機構の情報が含まれています。
例 2:
IO=(DEVCLASS=DASD,DEVCLASS=TAPE,020)
トレースの結果には、すべての DASD およびテープ装置、アドレス 020 の通信コ
ントローラーの情報が含まれています。
例 3:
IO=(450-663)
トレースの結果には、アドレス 450、575 および 663 の装置の情報が含まれていま
す。
IO=SSCH=(DEVCLASS=xxxx,DEVCLASS=xxxx,devnum1[,devnumm....
[,devnum])
入出力割り込みとサブチャネル開始操作の両方をトレースしたい装置を指定しま
す。
第 10 章 汎用トレース機能 (GTF)
10-35
汎用トレース機能
トレースする装置を指定する方法に関する説明は、IO= プロンプト指示キーワ
ードを参照してください。
JOBNAME=(jobname1[,jobnamen]...[,jobname5])
GTF トレースを行う対象となる、1 つから 5 つまでのジョブ名を指定します。
job1 から job5 までの値は、有効なジョブ名でなければなりません。
ジョブ名は総称ジョブ名であっても特定のジョブ名であってもかまいません。総
称ジョブ名を指定する場合には、ジョブ名の中で * または % を使用する必要
があります。
アスタリスクは、1 つまたは複数の有効なジョブ名文字を表すか、あるいは文字
がないことを表す変数です。例えば、JOBNAME=I*MS* と入力すると、GTF は
ジョブ名 IABMS01、IAMS、IMS、IMSA、IMS00012 などのジョブ名を持つア
ドレス・スペースに関するトレース・データを処理します。ただし、
JOBNAME=*MASTER* とコーディングすると、このジョブ名はマスター・アド
レス・スペースだけを表します。
パーセント記号は、単一の有効なジョブ名文字を表す変数です。例えば、
JOBNAMEP=I%MS%% とコーディングすると、GTF は IAMS01 および
IXMSBC というジョブ名を持つアドレス・スペースに関するトレース・データ
を処理しますが、IMS001 や I999MS というジョブ名についてはトレース・デ
ータを処理しません。%* の組み合わせは、少なくとも 1 文字を表す変数で
す。
JOBNAME を指定して、JOBNAME を指定しないまま END で応答すると、
GTF はすべてのジョブ名をトレースします。
JOBNAME の値の数が多くて 1 行では収まらない場合で、特定のジョブ名値が
正しくない場合、 GTF は、すべてのジョブ名を再入力せずに正しい値のみを再
指定できるようにします。
ASID と JOBNAME の両方を指定すると、ASID で識別されるアドレス・スペ
ースの一部に JOBNAME で識別されなかったジョブが含まれる場合には、GTF
は JOBNAME で識別されなかったジョブもトレースします。
PI=(code0[,coden]...[,code50])
トレースしたい 1 から 50 までのプログラム割り込みコードを 10 進数で指定
します。PIP または SYSP を指定し、このプロンプト・メッセージへの応答で
PI= を指定しないと、GTF はすべてのプログラム割り込みをトレースします。
SSCH=(DEVCLASS=xxxx,DEVCLASS=xxxx,devnum1[,devnumn....,
devnum])
サブチャネル操作をトレースしたい装置を指定します。
トレースする装置を指定する方法については、 10-31 ページの『プロンプト指示
キーワード』 の IO= を参照してください。
SVC=(svcnum1[,svcnumn]...[,svcnum50])
トレースしたい 1 から 50 までの SVC 番号を 10 進表記で指定します。SVCP
または SYSP を指定し、このプロンプト・メッセージへの応答で SVC= を指定
しないと、GTF はすべての SVC 番号をトレースします。 SVC の入り口と出
口の両方が記録されます。
USR=(event1[,eventn]...[,event50])
ユーザー・データをトレースしたい 1 から 50 までのユーザー・イベント ID
10-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
(EID) を指定します。USR の値は、次のような 3 桁の 16 進数です。
表 10-4. イベント ID とそれによって表されるイベントのタイプ
ID (16 進数)
イベントのタイプ
000-3FF
ユーザー
400-5FF
プログラム・プロダクト用に予約済み
600-FFF
IBM サブシステムおよびコンポーネント用に予約済み
USRP を指定し、プロンプト・メッセージに応答して USR= を指定しないと、
TEST=YES を指定して発行された GTRACE のすべてのインスタンスは、トレ
ースがアクティブになっていないことを示す標識とともに戻されます。
一連のサンプル・プロンプト指示の例
この例は、SYS1.PARMLIB メンバーへのプロンプト指示キーワードの格納方法を示
しています。
SYS1.PARMLIB に格納されたプロンプト指示キーワードを要求するオプションを指
定して GTF を開始する場合、これらのプロンプト指示キーワードは parmlib メン
バーにも含まれていなければなりません。parmlib メンバー内に応答を含めずにプロ
ンプト指示キーワードを使用すると、コンソールから GTF に応答が戻されなくな
ります。GTF はプロンプト指示しないでオプションを使用します (たとえば、SVCP
は SVC になります)。ユーザーのカタログ式プロシージャー内に SYSLIB DD ステ
ートメントが含まれていると、GTF は指定された parmlib メンバーからプロンプト
指示キーワードを読み取ります。このメンバー内の 2 番目およびそれ以降の論理レ
コードには、プロンプト指示キーワードだけを含めてください。
GTF は、parmlib から得られるプロンプト指示入力がそれ以上存在しないことを示
すために、 END キーワード、またはメンバーのファイルの終わりを使用します。
ある 1 つのキーワードに関するイベントの数が多いために、1 つのレコードに収ま
りきらない場合、次のように、後続のプロンプト指示レコードで追加イベントを使
用してそのキーワードを再指定してください。
Record #1 TRACE=IOP,SVCP,SSCH
Record #2 IO=(D34,D0C),SVC=(1,2,3)
Record #3 SVC=(4,5,6,7,8,9,10),END
この時点では、システム・コンソールからキーワードを再指定しないでください。
システム・コンソールから再指定すると、GTF は parmlib メンバー内のすべてのオ
プションとキーワードを指定変更してしまいます。
GTF は、parmlib メンバー内のオプションとプロンプト指示キーワードの読み取り
が終わると、次のように、メッセージ AHL103I によってそれらのオプションを表
示します。
AHL103I TRACE OPTIONS SELECTED--IOP,SVCP,SSCH
AHL103I IO=(D34,D0C),SVC=(1,2,3,4,5,6,7,8,9,10)
第 10 章 汎用トレース機能 (GTF)
10-37
汎用トレース機能
このメッセージは、選択するオプションの数によっては、複数行メッセージになる
ことがあります。IO= と SSCH= に指定した一連の装置が同一になっている場合、
メッセージ AHL103I は、 IO=SSCH を使用して指定した場合と同じようにそれら
の装置を示します。
指定されたすべてのオプションが GTF によって表示された後は、それらの parmlib
オプションを受け入れることも、コンソールから以下のメッセージに応答してオプ
ションを再指定し、完全に変更することもできます。
AHL125A RESPECIFY TRACE OPTIONS OR REPLY U.
例: トレース・オプション SYSP および USRP のプロンプト指示による指定
この例では、カタログ式プロシージャーで定義されたデータ・セットに対する外部
モードを指定して GTF を開始しています。
応答 00 では、次の 2 つのトレース・オプションを指定しています。
v SYSP は、特定のシステム・イベント・タイプをトレースするように GTF に要
求します。
v USRP は、GTRACE マクロで生成される特定のユーザー項目をトレースするよう
に GTF に要求します。
メッセージ AHL101A は、SVC、IO、SSCH、PI、および USR キーワードの値を指
定するように指示しています。
メッセージ AHL101A に対する応答 01 では、以下を選択しています。
v 5 つの SVC
v 非プログラム制御入出力割り込み用の 2 つの装置
v SSCH 操作用の 1 つの装置
v 3 つのユーザー・イベント ID
GTF は、その他の SVC、IO、および SSCH イベントを記録しません。PI= に対応
するプログラム割り込みコードを指定していないため、GTF はすべてのプログラム
割り込みをトレースします。
10-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
トレース・オプション SYSP および USRP のプロンプト指示の指定
START MYPROC.EXAMPLE7,,,(MODE=EXT)
00 AHL100A SPECIFY TRACE OPTIONS
REPLY 00,TRACE=SYSP,USRP
01 AHL101A SPECIFY TRACE EVENT KEYWORDS--IO=,SSCH=,SVC=,PI=,USR=
01 AHL101A SPECIFY TRACE EVENT KEYWORDS--IO=SSCH=
REPLY 01,SVC=(1,2,3,4,10),IO=(191,192),USR=(10,07A,AB)
02 AHL102A CONTINUE TRACE DEFINITION OR REPLY END
REPLY 02,SSCH=282,END
AHL103I TRACE OPTIONS SELECTED--SYSP,PI,IO=(191,192),SSCH=(282)
AHL103I SVC=(1,2,3,4,10),USR=(010,07A,0AB)
03 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 03,U
例: トレース・オプションのプロンプト指示による指定
この例では、カタログ式プロシージャーで指定されたデータ・セットで定義された
トレース・オプションを使用して、外部モードで GTF を開始しています。プロン
プトによって次のように情報が要求されます。
v メッセージ AHL100A により、トレース・オプションを指定するようにプロンプ
トが出されます。
v 応答 00 で、6 つのトレース・オプション、SSCHP、IOP、PCI、 CCWP、SVC、
および JOBNAMEP を選択します。
v メッセージ AHL101A により、IO、SSCH、CCW、および JOBNAME プロンプ
ト・キーワードの値を指定するようにプロンプトが出されます。
v 応答 01 で、IO と SSCH の両方のイベントをトレースするための 1 つの装置を
選択し、GTF のトレースを 1 つのジョブに制限します。
v 応答 02 で、CCW トレースに関する 5 つのオプションを指定します。
このような指定の最終的な結果として、GTF は、ジョブ BACKWARD に関して装
置 580 で発生したサブチャネル開始操作と入出力割り込みの両方の CCW、および
BACKWARD のアドレス・スペースにおけるすべての SVC をトレースします。
GTF は PCI テーブルに 200 項目を割り振り、100 までの CCW、各 CCW に 40
バイトまでのデータ、および IOSB をトレースします。
第 10 章 汎用トレース機能 (GTF)
10-39
汎用トレース機能
トレース・オプションのプロンプト指示の指定
START USRPROC,,,(MOD=EXT)
00 AHL100A SPECIFY TRACE OPTIONS
REPLY 00, TRACE=SSCHP,IOP,PCI,CCWP,SVC,JOBNAMEP
01 AHL101A SPECIFY TRACE EVENT KEYWORDS
--IO=,SSCH=,CCW=,JOBNAME=,IO=SSCH=
REPLY 01,JOBNAME=(BACKWARD),IO=SSCH=580
02 AHL102A CONTINUE TRACE DEFINITION OR REPLY END
REPLY 02,CCW=(CCWN=100,DATA=40,PCITAB=2,IOSB,SI),END
AHL103I TRACE OPTIONS SELECTED--PCI,SVC,IO=SSCH=(580)
AHL103I CCW=(SI,IOSB,CCWN=100,DATA=40,PCITAB=2)
AHL103I JOBNAME=(BACKWARD)
03 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 03,U
GTF トレースの受け取り
GTF は、ストレージの GTF アドレス・スペース内の GTF トレース・テーブルに
トレース・データを書き込みます。ダンプ・オプション・リストにトレース・デー
タを要求するための TRT が含まれている場合には、ストレージ内の GTF トレー
ス・データはダンプの一部として印刷または表示されます。次のテーブルには、デ
フォルト・オプションとして TRT が含まれているダンプが示されています。IPCS
を介して印刷または表示される不定様式ダンプの場合、IPCS GTFTRACE サブコマ
ンドを指定するか、IPCS トレース処理選択パネルを使用するかして、トレース・デ
ータをフォーマット設定してください。
GTFOUTxx または IEFRDER データ・セット内の GTF トレース・データをフォー
マット設定または印刷するには、IPCS GTFTRACE サブコマンドを指定するか、あ
るいは IPCS トレース処理選択パネルを使用してください。
GTF データが VTAM 診断用に作成されたものである場合には、ACF/TAP プログ
ラムを使用して VTAM データをフォーマット設定できます。
10-40
ダンプ
トレース・データの取得方法
SYSABEND への ABEND ダンプ
デフォルト
SYSMDUMP への ABEND ダンプ
利用不可
SYSUDUMP への ABEND ダンプ
SDATA=TRT を要求する
SNAP ダンプ
SDATA=TRT を要求する
スタンドアロン・ダンプ
デフォルト
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
ダンプ
トレース・データの取得方法
SDUMP または SDUMPX マクロに対する SVC ダ デフォルト
ンプ
DUMP オペレーター・コマンドに対する SVC ダ
ンプ
デフォルト
デフォルト
ACTION=SVCD、ACTION=STDUMP、
ACTION=SYNCSVCD、または ACTION=TRDUMP
を指定した SLIP オペレーター・コマンドに対する
SVC ダンプ
トレース・データを除外するようにカスタマイズさ SDATA=TRT を要求する
れた任意のダンプ
参照
v GTFTRACE サブコマンドについては、「z/OS MVS IPCS コマンド」を参照して
ください。
v パネル・インターフェースについては、「z/OS MVS IPCS ユーザーズ・ガイド」
を参照してください。
GTF トレース出力の結合、抽出、およびマージ
GTF トレース・データは、COPYTRC および MERGE の 2 つの IPCS サブコマン
ドを使用することにより、他のデータと結合させたり、ダンプおよびデータ・セッ
トから抽出したりできます。
統合またはマージされたトレース出力を使用すると、あるエラーの前後に起こった
イベントを発生順に表示できます。マージの開始時刻と終了時刻を指定して、エラ
ーが発生した少し前から少しあとまでに起こったイベントを調べてください。
CTRACE および GTFTRACE サブコマンドで、関連するジョブおよびアドレス・ス
ペース ID (ASID) を指定し、組み合わされた出力の中に関連性のあるトレース・レ
コードだけが含まれるようにしてください。
マージは、いくつかのコンポーネントでトレースが実行されている場合に最も有効
です。これと並行してシステムが GTF トレースを実行していてもかまいません。
各コンポーネントのトレース・レコードは、コンポーネント独自のバッファーに別
個に入れられます。GTF はすべてのコンポーネント・トレースから独立していま
す。これらの個別のレコードをマージして 1 つの発生順レコードを作成すると、診
断が容易になります。
参照
COPYTRC および MERGE についての情報は、「z/OS MVS IPCS コマンド」を参
照してください。
GTF 出力の結合および抽出
IPCS COPYTRC サブコマンドを使用すると、次のうちの 1 つまたは複数の作業を
行うことができます。
v 以下のものから得られた GTF トレース・データを 1 つのデータ・セットに統合
する。
第 10 章 汎用トレース機能 (GTF)
10-41
汎用トレース機能
– 複数の GTF データ・セット
– 複数の GTF データ・セット、ダンプ、またはその両方
– 複数のシステム
v SVC ダンプおよびスタンドアロン・ダンプから GTF トレース・データを抽出す
る。
v 指定されたシステムのリストに関する GTF トレース・データを、組み合わされ
たデータから抽出する。
例: 複数のデータ・セットから得られた GTF 出力の統合
1 つのシステムに関するデータを複数のデータ・セットに書き込むように GTF
を設定した場合、IPCS COPYTRC サブコマンドを使用してそのデータを 1 つ
のデータ・セットに統合できます。これは、複数のシステムから得られた GTF
データを MERGE または COPYTRC サブコマンドによって統合する前に行っ
てください。
システム SYS01 から得られる GTF データ用に 3 つのデータ・セットを定義
する GTF カタログ式プロシージャーは、次のようになります。
//GTFABC
//IEFPROC
//
//IEFRDER
//
//SYSLIB
//GTFOUT1
//GTFOUT2
//GTFOUT3
PROC
EXEC
DD
DD
DD
DD
DD
MEMBER=GTFPARM
PGM=AHLGTF,REGION=2880K,TIME=1440,
PARM=(’MODE=EXT,DEBUG=NO’)
DSNAME=SYS1.GTFTRC,UNIT=SYSDA,
SPACE=(4096,20),DISP=(NEW,KEEP)
DSN=SYS1.PARMLIB(&MEMBER),DISP=SHR
DSNAME=SYS01.DSN1,UNIT=&DEVICE,DISP=&DSPS;
DSNAME=SYS01.DSN2,UNIT=&DEVICE,DISP=&DSPS;
DSNAME=SYS01.DSN3,UNIT=&DEVICE,DISP=&DSPS;
IPCS から次のコマンドを発行して、上のカタログ式プロシージャーで定義さ
れたデータ・セットから得られたデータを GTF.SYS01 という 1 つのデー
タ・セットに統合します。
COPYTRC TYPE(GTF)
INDATASET(SYS01.DSN1,SYS01.DSN2,SYS01.DSN3)
OUTDATASET(GTF.SYS01)
10-42
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
例: 複数のシステムから得られた GTF 出力の統合
次の例では、COPYTRC サブコマンドを使用して、データ・セット
GTF.SYS01、GTF.SYS02、および GTF.SYS03 内の 3 つのデータ・セットか
ら得られたデータを、GTF.ALLSYS という 1 つの出力データ・セットに統合
します。
COPYTRC TYPE(GTF)
INDATASET(GTF.SYS01,GTF.SYS02,GTF.SYS03)
OUTDATASET(GTF.ALLSYS)
COPYTRC コマンドで 1 つのシステムについて 1 つのデータ・セットだけし
か使用されていないことにご注意ください。最良の結果を得るためには、1 つ
のシステムに複数のデータ・セットがある場合、最初別のに COPYTRC コマ
ンドを使用してそれらを統合してください。
GTF データ用の出力データ・セットをフォーマット設定するには、次の IPCS
サブコマンドを発行してください。
GTFTRACE DSNAME(ALLSYS)
トレース出力のマージ
IPCS MERGE サブコマンドを使用すると、複数のトレースを 1 つの発生順デー
タ・セットにマージすることができます。このトレースには、以下のすべてのもの
が該当します。
v 直接アクセス記憶装置 (DASD) 上の同じダンプから得られたコンポーネント・ト
レース
v DASD 上の異なるダンプから得られたコンポーネント・トレース
v テープまたは DASD 上のダンプまたはデータ・セットから得られた GTF トレー
ス・レコード
例: 複数のシステムから得られた GTF 出力のマージ
次の例では、MERGE サブコマンドを使用して、データ・セット
GTF.SYS04、 GTF.SYS05、および GTF.SYS06 に入っている 3 つのシステム
から得られたデータを統合およびフォーマット設定して、出力データ・セット
GTF.SYSALL に発生順に配置します。
MERGE
GTFTRACE DSNAME(GTF.SYS04)
GTFTRACE DSNAME(GTF.SYS05)
GTFTRACE DSNAME(GTF.SYS06)
MERGEEND
第 10 章 汎用トレース機能 (GTF)
10-43
汎用トレース機能
GTF 出力の読み方
このトピックでは、GTF が作成するトレース・レコードのフォーマット設定を示し
ます。ユーザーが注意深くトレース・オプションを選択すると、ユーザーの問題が
存在しているシステムおよびユーザー・イベントに関する詳細情報が GTF によっ
て提供されるため、問題が診断しやすくなります。
このセクションでは、以下のトピックについて説明します。
v
10-46 ページの『定様式の GTF トレース出力』。ここでは、IPCS GTFTRACE
サブコマンドによってフォーマット設定されるトレース・レコードについて説明
します。
v
10-94 ページの『不定形式の GTF トレース出力』。ここでは、不定様式トレー
ス・レコードについて説明します。
次に示す表は、GTF トレース・オプションと、それらのオプションによって GTF
トレース出力内に生成されるトレース・レコードを示しています。この表を使用し
て、選択したオプションと関連トレース・レコードを相関させてください。この表
に示すトレース・オプションの中には、次のように、関連するトレース・レコード
が存在しないものがあります。
v ASIDP - 選択アドレス・スペースから得られたイベントだけを GTF がトレース
するように指定します。
v JOBNAMEP - 選択されたジョブ内のイベントだけを GTF がトレースするように
指定します。
v END - 指定されたプロンプト指示キーワード値の終わりを指定します。
v TRC - GTF トレースに GTF アドレス・スペースを含むように指定します。
10-44
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
トレース・オプション
ASIDP
CCW
CCWP
CSCH
DSP
END
EXT
HSCH
IO
IOX
IOP
IOXP
JOBNAMEP
MSCH
PCI
PI
PIP
RNIO
RR
SIO
SIOP
SLIP
SRM
SSCH
SSCHP
SVC
SVCP
SYS
SYSM
SYSP
TRC
USR
USRP
XSCH
トレース・レコード ID
該当なし
CCW
CCW
CSCH
DSP、LSR、SDSP、SRB
該当なし
EXT
HSCH
EOS、IO
IOX
EOS、IO
IOX
該当なし
MSCH
PCI
PGM、PI
PGM、PI
RNIO
FRR、STAE
RSCH、SSCH
RSCH、SSCH
SLIP
SRM
RSCH、SSCH
RSCH、SSCH
SVC
SVC
CSCH、EOS、EXT、FRR、HSCH、IO、MSCH、PGM、PI、SSCH、
STAE、SVC
CSCH、EOS、EXT、FRR、HSCH、IO、MSCH、PGM、PI、SSCH、
STAE、SVC
CSCH、EOS、EXT、FRR、HSCH、IO、MSCH、PGM、PI、SSCH、
STAE、SVC
該当なし
USR
USR
XSCH
図 10-3. GTF トレース・オプションおよび関連トレース・レコード ID
第 10 章 汎用トレース機能 (GTF)
10-45
汎用トレース機能
定様式の GTF トレース出力
このトピックでは、IPCS GTFTRACE サブコマンドによってフォーマット設定され
た GTF トレース出力レコードについて説明します。各定様式レコードにおいて、
各フィールドの長さは文字の数で表されます。これらの文字は、次のようにフィー
ルド内のデータのタイプを示します。
c
文字
d
10 進数
h
16 進数
x
可変情報
y
可変情報
CCW トレース・レコード・フォーマットでは、フィールドの各部分を区別するため
に追加の文字が使用されます。
トレース・レコードには標識が含まれることがあり、これらの標識は GTF がその
レコードを求めてイベントをトレースしていたときに発生した、通常と異なる条件
を表します。使用される標識は以下のとおりです。
N/A
U/A
PPPPPPPP
SSSSSSSS
********
X'EEEE'
該当なし。フィールドは、このレコードには適用されません。2 バイト・フ
ィールドでは、該当なしは N/ と示されます。
使用不能。GTF が情報を収集できませんでした。2 バイト・フィールドで
は、使用不能は U/ と示されます。
GTF がデータを収集していたときにページ不在が発生したために、使用不能
(SVC のみ)。
セキュリティー考慮事項のために、使用不能 (SVC のみ)。
GTF がデータを収集していたときに発生したエラーまたはデータのページア
ウトのために、使用不能。
GTF がデータを収集していたときに発生した重大エラーのために、使用不
能。この値は、トレース・レコードの最初の 2 つのデータ・バイトに表示
されます。トレース・レコードの内容は予測できません。
トレース・レコード ID
各トレース・レコードには、そのレコードのタイプを示す ID が含まれます。次の
表には、ID がアルファベット順に並べられ、該当レコードのフォーマットが示され
ているページが記載されています。
トレース・レコード
ID
GTF トレース・レコード
SYS1.PARMLIB
メンバーまたは
オペレーター応答
のパラメーター
フォーマットについては下記を参照
****
タイム・スタンプ
10-50
****
消失イベント
10-51
CCW
チャネル・プログラム
CCW
10-52
CSCH
サブチャネル切断操作
CSCH、SYS、
SYSM、SYSP
10-54
DSP
タスク・ディスパッチ
DSP
10-55
10-46
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
トレース・レコード
ID
GTF トレース・レコード
SYS1.PARMLIB
メンバーまたは
オペレーター応答
のパラメーター
フォーマットについては下記を参照
EOS
センス終わりの割り込み
IO、IOP、SYS、
SYSM、SYSP
10-57
EXT
汎用外部割り込み
EXT、SYS、
SYSM、SYSP
10-59
FRR
機能リカバリー・ルーチンの戻り
RR、SYS、
SYSM、SYSP
10-61
HEXFORMAT
不定様式トレース・イベント
HSCH
サブチャネル停止操作
HSCH、SYS、
SYSM、SYSP
10-54
IO
入出力割り込み
IO、IOP、SYS、
SYSM、SYSP
10-57
IOX
入出力割り込み要約レコード・フォーマ
ット
IOX、IOXP、
SYS、SYSM、
SYSP
10-64
LSR
ローカル監視プログラム・ルーチン・デ
ィスパッチ
DSP
10-66
MSCH
サブチャネル修正操作
MSCH、SYS、
SYSM、SYSP
10-67
10-63
PCI
プログラム制御入出力割り込み
PCI
10-57
PGM
プログラム割り込み
PI、PIP、SYS、
SYSM、SYSP
10-69
PI
プログラム割り込み
PI、PIP、SYS、
SYSM、SYSP
10-69
RNIO
VTAM リモート・ネットワーク入出力イ RNIO
ベント
10-70
RSCH
サブチャネル再開
10-71
SSCH、SSCHP
SDSP
タスク再ディスパッチ
DSP
10-55
SLIP
SLIP プログラム・イベント割り込み
SLIP
10-72
SRB
サービス要求ブロック・ルーチンのディ
スパッチまたは再ディスパッチ
DSP
10-78
SRM
システム・リソース・マネージャーの戻
り
SRM
10-79
SSCH
サブチャネル開始操作
SSCH、SSCHP、
SYS、SYSM、
SYSP
10-80
STAE
STAE または ESTAE リカバリー・ルー
チンの戻り
RR、SYS、
SYSM、SYSP
10-82
SUBSYS
不定様式トレース・イベント
SVC
監視プログラム呼び出し割り込み
SVC、SVCP、
SYS、SYSM、
SYSP
10-83
SVCR
監視プログラム呼び出し出口
SVC、SVCP、
SYS、SYSM、
SYSP
10-83
SYSTEM
不定様式トレース・イベント
USR
ユーザー・イベント
10-63
10-63
USR、USRP
10-85
第 10 章 汎用トレース機能 (GTF)
10-47
汎用トレース機能
トレース・レコード
ID
GTF トレース・レコード
XSCH
サブチャネル取り消し操作
SYS1.PARMLIB
メンバーまたは
オペレーター応答
のパラメーター
XSCH、SYS、
SYSM、SYSP
フォーマットについては下記を参照
10-91
定様式 GTF トレース出力の例
以下の画面は、GTF レコードを示しています。IPCS は、サンプル・ダンプから画
面を作成します。これらのレコードは、広範囲フォーマットになっていて、タイ
ム・スタンプが示されています。
2 番目の画面は、サブチャネル開始操作 (SSCH) イベントのレコードを示していま
す。
3 番目の画面は、2 つの入出力割り込み (IO) イベントに関するレコードを示してい
ます。
4 番目の画面は、以下のイベントのレコードを示しています。
CSCH: サブチャネル切断操作
EOS: センス終わりの割り込み
HSCH: サブチャネル停止操作
PCI: プログラム制御入出力割り込み
IPCS サブコマンド入力パネルから発行されたコマンドは、次のとおりです。
GTFTRACE
IPCS OUTPUT STREAM ------------------------------------------ LINE 0 COLS 1 78
COMMAND ===>
SCROLL ===> CSR
****************************** TOP OF DATA ***********************************
**** GTFTRACE DISPLAY OPTIONS IN EFFECT ****
SSCH=ALL IO=ALL CCW=SI
SVC=ALL PI=ALL
EXT RNIO SRM RR DSP SLIP
**** GTF DATA COLLECTION OPTIONS IN EFFECT: ****
Minimum tracing for IO, SSCH, SVC, PI, EXT, and FRR events
All GTRACE events requested
All events associated with the execution should be traced
All DISPATCHER events traced
PCI events are to be traced
System resource manager events traced
**** GTF TRACING ENVIRONMENT ****
Release: SP4.1.0 FMID: HBB4410 System name: FIRST
CPU Model: 3090 Version: FF Serial no. 170067
10-48
SDSP
ASCB.... 00F49600 CPU..... 0001
PSW..... 070C0000 82200ED2
TCB..... 00AF2880 R15..... 00000000 R0...... A9000000
R1...... 02200FB0
GMT-07/02/89 00:29:08.154586
LOC-07/01/89 20:29:08.060378
SVC
CODE.... 047
ASCB.... 00F49600 CPU..... 0001
PSW..... 070C002F 82200ED2
TCB..... 00AF2880
R15..... 00000000 R0...... A9000000 R1...... 02200FB0
GMT-07/02/89 00:29:08.154677
LOC-07/01/89 20:29:08.060469
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
IPCS OUTPUT STREAM ------------------------------------------ LINE 0 COLS 1 78
COMMAND ===>
SCROLL ===> CSR
SRB
ASCB.... 00F44680 CPU..... 0001
PSW..... 070C0000 82045B48
R15..... 82045B48 SRB..... 01AC1520 R1...... 01AC3380
TYPE.... INITIAL DISPATCH OF SRB
GMT-07/02/89 00:29:08.154932
LOC-07/01/89 20:29:08.060724
DSP
ASCB.... 00F44680 CPU..... 0001
PSW..... 070C1000 82360BA2
TCB..... 00AF2370 R15..... 80AF2858 R0...... 00000001
R1...... FDC9E5D4
GMT-07/02/89 00:29:08.155169
LOC-07/01/89 20:29:08.060961
SSCH.... 10223
DSP
ASCB....
RST.....
CC......
SEEKA...
OPT.....
IOSLVL..
GMT-07/02/89
00F44680 CPUID...
00A4EB00 VST.....
00
ORB.....
00000002 7B000506
00
FMSK....
01
UCBLVL..
00:29:08.156738
0001
JOBN.... GTFCBM
00AF0B00 DSID.... 00AF1A0C
00F684B8 0000E000 00FEC630
GPMSK... 00
18
DVRID... 02
01
LOC-07/01/89 20:29:08.062530
ASCB.... 00FD3300 CPU..... 0001
PSW..... 070E0000 00000000
TCB..... 00000000 R15..... ****
R0...... ****
R1...... ****
GMT-07/02/89 00:29:08.157022
LOC-07/01/89 20:29:08.062814
IO...... 10223
ASCB.... 00F44680 CPUID... 0001
JOBN.... GTFCBM
PSW..... 070E0000 00000000
IRB..... 00004007 00A4EB38 0C000000 0040002E
TCB..... 00AF2958 SENSE... N/A
FLA..... 00
OPT..... 00
DVRID... 02
IOSLVL.. 01
UCBLVL.. 01
GMT-07/02/89 00:29:08.167605
LOC-07/01/89 20:29:08.073397
**** GTFTRACE DISPLAY OPTIONS IN EFFECT ****
SSCH=ALL IO=ALL CCW=SI
SVC=ALL PI=ALL
EXT RNIO SRM RR DSP SLIP
**** GTF DATA COLLECTION OPTIONS IN EFFECT: ****
IO filtering requested
CCW trace prompting
IO CCW records
SSCH CCW records
All records timestamped
SSCH prompting
*** DATE/TIME: GMT-10/02/90 21:14:10
LOC-10/02/90 21:14:10.009827
IO...... 10000
ASCB.... 00000000 CPUID... 0000
JOBN.... ........
PSW..... 00000000 00000000
IRB..... 00000000
00000000 00000000 00000000 TCB..... 00000000
SENSE... 0000
FLA..... 00
OPT..... 00
DVRID... 00
IOSLVL.. 00
UCBLVL.. 00
第 10 章 汎用トレース機能 (GTF)
10-49
汎用トレース機能
GMT-10/02/90 21:14:10.009803
LOC-10/02/90 21:14:10.009803
ASCB.... 00000000 CPUID... 0000
JOBN.... ........
PSW..... 00000000 00000000
IRB..... 00000000
00000000 00000000 00000000 TCB..... 00000000
SENSE... 0000
FLA..... 00
OPT..... 00
DVRID... 00
IOSLVL.. 00
UCBLVL.. 00
GMT-10/02/90 21:14:10.009955
LOC-10/02/90 21:14:10.009955
EOS..... 10000
ASCB.... 00000000 CPUID... 8861
JOBN.... ........
PSW..... 00000000 00000000
IRB..... 00000000
00000000 00000000 00000000 TCB..... 00000000
SENSE... 0000
FLA..... 00
OPT..... 00
DVRID... 00
IOSLVL.. 00
UCBLVL.. 00
GMT-10/02/90 21:14:10.078486
LOC-10/02/90 21:14:10.078486
CSCH.... 10000
ASCB.... 00000000 CPUID... 0000
JOBN.... ........
DEV..... 0000
SFLS.... 0000
SID..... 00000000
CC...... 00
DVRID... 00
ARDID... 00
IOSLVL.. 00
UCBLVL.. 00
GMT-10/02/90 21:14:10.099752
LOC-10/02/90 21:14:10.099752
HSCH.... 10000
ASCB.... 00000000 CPUID... 8861
JOBN.... ........
DEV..... 0000
SFLS.... 0000
SID..... 00000000
CC...... 00
DVRID... 00
ARDID... 00
IOSLVL.. 00
UCBLVL.. 00
GMT-10/02/90 21:14:10.119803
LOC-10/02/90 21:14:10.119803
****************************** END OF DATA ***********************************
PCI..... 0000
イベントに関する定様式トレース・レコード
タイム・スタンプ・レコード
目的
タイム・スタンプ・レコードは、あるイベントが発生した時刻をマークします。
各トレース・レコードの後のレコード・フォーマット
GMT-mm/dd/yy hh:mm:ss:dddddd
LOC-mm/dd/yy hh:mm:ss.dddddd
GMT-mm/dd/yy hh:mm:ss
月 / 日 / 年、および 時:分:秒 形式のグリニッジ標準時刻。
LOC-mm/dd/yy hh:mm:ss.dddddd
月 / 日 / 年、および 時:分:秒.マイクロ秒形式のローカル時刻。
ソース索引レコード
目的
ソース索引レコードは、IPCS COPYTRC サブコマンドによって GTF トレース・レ
コードが統合されるときに追加されます。これらのレコードは、GTF トレース・レ
コードを作成したシステムを識別します。
IPCS COPYTRC サブコマンドによって GTF トレース・レコードが統合された場
合の、各トレース・レコードの後のレコード・フォーマット
SOURCE INDEX: 01
10-50
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
このソース索引レコードは、GTF トレース・レコードが ID 01 のシステムによっ
て作成されたことを示しています。ID には、システム名と、そのシステムに関して
有効になっているトレース・オプションが含まれています。ID は IPCS レポートの
最初にリストされます。
消失イベント・レコード
目的
消失イベント・レコードは、エラーまたはトレース・バッファーのオーバーフロー
によって、 1 つまたは複数のイベントに関する GTF のトレース・レコードが失わ
れていることを示します。
エラーによって GTF トレース・バッファーが失われたときのレコード・フォーマ
ット
**** ONE TRACE BUFFER LOST TIME hh.mm.ss.dddddd
hh.mm.ss.dddddd
GTF が最初のトレース・レコードをバッファーに入れたときの時刻 (時.分.秒.マ
イクロ秒)。
GTF トレース・バッファーのサイズは次のとおりです。
v GTF が直接アクセス記憶装置 (DASD) 上のデータ・セットにトレース・レコー
ドを書き込んでいる場合には、トレース・データの書き込み中に GTF が使用す
るブロック・サイズと同じ。システムはこのブロック・サイズをメッセージ
AHL906I で表示します。レコードがデータ・セットに書き込まれる場合、システ
ムは、GTF を開始したあとでメッセージ AHL906I を発行します。
v GTF がテープ上のデータ・セットにトレース・レコードを書き込んでいる場合に
は、 32,760 バイト。
v GTF が内部トレース・バッファーだけにトレース・レコードを書き込んでいる場
合には、 32,768 バイト。
エラーまたはトレース・バッファーのオーバーフローによって失われたトレース・
イベント数のレコード・フォーマット
****** LOST EVENTS NUM ddddddddddddd LOCAL TIME mm/dd/yyyy hh.mm.ss.nnnnnn ***
dddddddddd
消失イベントの数。
mm/dd/yyyy
GTF が最初のトレース・レコードを現行トレース・バッファーに入れたときの
日付 (月 / 日 / 年の形式)。
hh.mm.ss.dddddd
GTF が最初のトレース・レコードを現行トレース・バッファーに入れたときの
時刻 (時.分.秒.マイクロ秒)。
第 10 章 汎用トレース機能 (GTF)
10-51
汎用トレース機能
CCW トレース・レコード
目的
CCW レコードは、チャネル・プログラムの処理状況を表します。
CCW トレース・レコードは EOS、IO、PCI、RSCH、または SSCH トレース・レ
コードの後に表示されるもので、独立して表示されることはありません。1 つの
CCW トレース・レコードで、任意のフォーマットを任意の組み合わせで使用できま
す。
レコード・フォーマット
CCW CHAIN
FORMAT d
ASCB.... hhhhhhhh CPU.....
Fhhhhhhh ---CCW-- ---CCW-Fhhhhhhh ---CCW-- ---CCW-Fhhhhhhh ---CCW-- ---CCW--
ccc
DEV..... hhhh
hhhh
JOBN.... cccccccc
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
.
--Back half of split data-.
dddddddd dddddddd | cccccccc |
dddddddd dddddddd | cccccccc |
Fhhhhhhh ---CCW-- ---CCW-- dddddddd dddddddd | cccccccc |
IDAW hhhhhhhh_hhhhhhhh hhhh hhhhhhhh hhhhhhhh | cccccccc |
hhhhhhhh hhhhhhhh | cccccccc |
MIDAW hhhhhhhh hhhhhhhh hhhh hhhhhhhh hhhhhhhh | cccccccc |
hhhhhhhh_hhhhhhhh
hhhhhhhh hhhhhhhh | cccccccc |
IOSB hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
EWAx hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
FORMAT d ccc
トレース・イベントのフォーマット (d) およびタイプ (ccc): EOS、IO、
PCI、RSCH、または SSCH。フォーマットは、ゼロか 1 です。
DEV shhhh
DEV snnnn
UCB の UCBCHAN フィールドから得られた装置番号。この番号は、サブチャ
ネル ID (UCBSID) で修飾されます。
ASCB hhhhhhhh
IO、SSCH、RSCH、PCI、または EOS 基底レコードの ASCB フィールドと同
じ。
CPU hhhh
IO、SSCH、RSCH、PCI、または EOS 基底レコードの CPU ID フィールドと
同じ。
JOBN cccccccc
IO、SSCH、RSCH、PCI、または EOS 基底レコードで名前が指定されたジョブ
(JOBN) フィールドと同じ。
10-52
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
Fhhhhhhh
CCW のフルワード・アドレス。アドレスの上位ビットがオンである場合、これ
は CCW の実アドレスです。オフである場合、これは CCW のアドレスの仮想
アドレスです。
---CCW-CCW コマンドです。コマンドは、フォーマット 0 またはフォーマット 1
CCW のいずれかです。
フォーマット 0 CCW は、フォーマット ooaaaaaa ffuubbbb
フォーマット 1 CCW は、フォーマット ooffbbbb aaaaaaaa
ここで、
oo
命令コード。
aaaaaa
CCW に関連するデータの実アドレス。間接アドレス・ワード
(IDAW) が存在する場合、これは IDAW リストのアドレスです。
aaaaaaaa
CCW に関連するデータのフルワード実アドレス。IDAW が存在す
る場合、これは IDAW リストのアドレスです。
ff
CCW フラグ。フラグが .....1.. の場合、IDAW リストが存在してい
ることを表します。フラグが ......1. の場合、チャネル・プログラム
の延期が要求されています。フラグが .......1 の場合、変更間接アド
レッシング・ワードのリストが存在します。
uu
ハードウェアでは使用されません。非ゼロ文字が含まれることがあ
ります。
bbbb
バイト・カウント。
dddddddd dddddddd | cccccccc |
CCW によって転送された情報。このフィールドが連続したダッシュになってい
ない場合には、転送されたすべてのデータが 4 バイト・セクションに表示され
ます。
--Back half of split data-START コマンドで指定されたバイト数を超える情報が転送されたことを示しま
す。デフォルト値は 20 バイトですが、表示したいバイト数を指定できます。指
定された値は半分に分けられます。奇数の場合には大きいほうのセクションが最
初に表示されます。表示されるデータのうちの最初のセクションは、データの転
送元のバッファーの最初の部分から得られます。最後のセクションは、バッファ
ーの終わりの部分から得られます。
IDAW hhhhhhhh または hhhhhhhh_hhhhhhhh hhhh
IDAW の内容、31 ビット IDAW のフルワード実アドレス または 64 ビット
IDAW のダブルワード実アドレスで、そのアドレスにあるデータの長さを指定
するハーフワードが続きます。そのアドレスのデータは、このハーフワードの長
さに続きます。このパラメーターの hhhhhhhh_hhhhhhhh バージョンは、64 ビッ
トを指定します。
MIDAW hhhhhhhh hhhhhhhh hhhh
hhhhhhhh_hhhhhhhh
変更間接アドレッシング・ワード (MIDAW) は 16 バイトで、GTF トレース内
第 10 章 汎用トレース機能 (GTF)
10-53
汎用トレース機能
にフォーマット設定され、最初の行の上の 8 バイトにはフラグとデータ長が入
り、2 番目の行には 64 ビットのデータ・アドレスが入ります。データの長さ
は、MIDAW データの最初の 8 バイトを過ぎた部分から複製され、データの読
み取りと、IDAW フォーマットとの整合性を維持しやすくしています。そのア
ドレスのデータは、このハーフワードの長さに続きます。スキップ・インディケ
ーターがオンになっている場合は、MIDAW のデータはフォーマット設定され
ません。
IOSB hhhhhhhh
IOSB のフルワードの仮想アドレスに IOSB の内容が続きます。
IOSB のオフセット X'34' にあるフルワードは、エラー・リカバリー・プロシー
ジャー作業域 (EWA) を指し示すか、ゼロです。 EWA は、トレースされて
IOSB のすぐ下で文書化され、IOSB と同じようにフォーマット設定されます。
EWAx hhhhhhhh
エラー・リカバリー・プロシージャー作業域のフルワードの仮想アドレスで、
EWA の内容が続きます。
CSCH および HSCH トレース・レコード
目的
CSCH および HSCH レコードは、サブチャネル切断操作とサブチャネル停止操作を
表します。
レコード・フォーマット
CSCH.... shhhh
ASCB.... hhhhhhhh CPUID... hhhh
DEV..... hhhh
SFLS.... hhhh
CC...... hh
DVRID... hh
IOSLVL.. hh
UCBLVL.. hh
UCBWGT.. hh
BASE.... hhhh
JOBN.... cccccccc
SID..... hhhhhhhh
ARDID... hh
HSCH.... shhhh
ASCB.... hhhhhhhh CPUID... hhhh
DEV..... hhhh
SFLS.... hhhh
CC...... hh
DVRID... hh
IOSLVL.. hh
UCBLVL.. hh
UCBWGT.. hh
BASE.... hhhh
JOBN.... cccccccc
SID..... hhhhhhhh
ARDID... hh
CSCH shhhh
HSCH shhhh
UCB の UCBCHAN フィールドから得られた装置番号。必要な場合には、サブ
チャネル・セット ID が含まれます。
ASCB hhhhhhhh
入出力操作を開始させたアドレス・スペースの ASCB のアドレス。
CPUID hhhh
入出力操作が開始されたプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
入出力操作を要求したタスクと関連するジョブの名前。
N/A
要求された入出力と関連するジョブはありません。
10-54
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
DEV hhhh
UCB の UCBCHAN フィールドから得られた装置番号。
SFLS hhhh
UCB の UCBSFLS フィールドから得られた開始フラグ。
SID hhhhhhhh
UCB の UCBSID フィールドから得られたサブチャネル ID。
CC hh
ビット 2 から 3 までに入っている CSCH または HSCH 条件コード。
DVRID hh
IOSB の IOSDVRID フィールドから得られたドライバー ID。
ARDID hh
次のいずれかです。
hh
IOSB の IOSDVRID フィールドから得られた、関連する要求ド
ライバー ID。
U/
IOQ が使用不能であったために使用不能。
IOSLVL hh
入出力要求の逐次化を行う機能レベル。この値は、IOSB の IOSLEVEL フィー
ルドから得られます。
UCBLVL hh
UCB の UCBLEVEL フィールドから得られた UCB レベル値。
UCBWGT hh
UCB の UCBWGT フィールドから得られたフラグ。
BASE hhhh
UCB の UCBCHAN フィールドから得られた装置番号 (DEV hhhh と同じ)。
DSP および SDSP トレース・レコード
目的
DSP レコードは、タスクのディスパッチングを表します。SDSP レコードは、SVC
割り込み後のタスクの再ディスパッチを表します。また、SDSP 割り込みは、ラベ
ル SDSP の SVC 出口レコードも作成します。DSP オプションと SVC オプション
の両方が有効な場合は、 IPCS によって SVCR フォーマットのトレース・レコード
が生成されます。
トレース・データに SVC 出口レコードが含まれている場合、定様式出力に表示さ
れるラベルは、IPCS の間に選択されたオプションによって異なります。
1. IPCS ダイアログ内で SVC オプションを選択すると、SVC 出口レコードと
SVC 番号はラベル SVCR とともに表示されます。
2. IPCS ダイアログで DSP オプションのみを選択しても、定様式出力レコードに
変化はありません。つまり、定様式出力には DSP ラベルと SDSP ラベルが表示
され、 SVC 番号は表示されません。
3. IPCS で DSP オプションと SVC オプションの両方がアクティブである場合
は、SVCR および SVC 番号が表示されます。
第 10 章 汎用トレース機能 (GTF)
10-55
汎用トレース機能
つまり、IPCS のフォーマット設定時に選択されたオプションの 1 つが SVC であ
る場合、すべての SVC 出口レコードはラベル SVCR および SVC 番号とともに表
示されることになります。
最小限のトレース・レコード・フォーマット
DSP
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh hhhhhhhh
TCB..... hhhhhhhh R15..... hhhhhhhh R0...... hhhhhhhh
R1...... hhhhhhhh
SDSP
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh hhhhhhhh
TCB..... hhhhhhhh R15..... hhhhhhhh R0...... hhhhhhhh
R1...... hhhhhhhh
広範囲のトレース・レコード・フォーマット
DSP
ASCB.... hhhhhhhh CPU..... hhhh
DSP-PSW. hhhhhhhh hhhhhhhh
MODN.... yyyyyyyy
JOBN.... cccccccc
TCB..... hhhhhhhh
SDSP
ASCB.... hhhhhhhh CPU..... hhhh
DSP-PSW. hhhhhhhh hhhhhhhh
MODN.... yyyyyyyy
JOBN.... cccccccc
TCB..... hhhhhhhh
ASCB hhhhhhhh
アドレス・スペース制御ブロックのアドレス。
CPU hhhh
タスクがディスパッチされるプロセッサーのアドレス。
PSW hhhhhhhh hhhhhhhh
DSP-PSW hhhhhhhh hhhhhhhh
タスクがディスパッチされる際のプログラム状況ワード。
JOBN cccccccc
次のいずれかです。
cccccccc
ディスパッチされるタスクに関連したジョブの名前。
N/A
このレコードはシステム・タスクまたは開始済みタスク用で
す。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
TCB hhhhhhhh
タスク制御ブロックのアドレス。
R15 hhhhhhhh
R0 hhhhhhhh
R1 hhhhhhhh
タスクがディスパッチされるときに汎用レジスター 15、0、および 1 に入るデ
ータ。
MODN cccccccc
cccccccc は次のいずれかです。
10-56
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
mod_name
タスクがディスパッチされるときに制御を受け取るモジュールの名前。
WAITTCB
システム待機タスクがディスパッチされようとしていることを示します。
SVC-T2
中核に入っているタイプ 2 の SVC ルーチンがディスパッチされようとし
ていることを示します。
SVC-RES
タイプ 3 の SVC ルーチン、またはタイプ 4 の SVC ルーチンの最初のロ
ード・モジュールがディスパッチされようとしていることを表します。この
ルーチンは、ページング可能リンク・パック域 (PLPA) に入っています。
SVC-cccc
タイプ 4 の SVC ルーチンの 2 番目以降のロード・モジュールがディスパ
ッチされようとしていることを表します。このモジュールは、固定またはペ
ージング可能なリンク・パック域 (LPA) に入っています。モジュール名の
最後の 4 文字は cccc です。
**IRB***
関連する割り込み要求ブロック (IRB) のある非同期ルーチンがディスパッ
チされようとしていることを示します。モジュール名は使用不能です。
*ccccccc
エラー取り出しにより、エラー・リカバリー・モジュールがロードされてい
る途中であることを示します。モジュール名の最後の 7 文字は ccccccc で
す。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
EOS、CS、IO、および PCI トレース・レコード
目的
EOS レコードはセンス終わりの割り込みを表し、CS レコードは装置が並行的セン
ス機能を持つ場合のセンス終わりの割り込みを表し、IO レコードは入出力 (I/O) 割
り込みを表し、PCI レコードはプログラム制御割り込みを表します。
レコード・フォーマット
EOS..... shhhh
ASCB.... hhhhhhhh CPUID... hhhh
PSW..... hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh hhhhhhhh
SENSE... hhhh
FLA..... hh
DVRID... hh
IOSLVL.. hh
UCBWGT.. hh
BASE.... hhhh
JOBN.... cccccccc
IRB..... hhhhhhhh
TCB..... hhhhhhhh
OPT..... hh
UCBLVL.. hh
第 10 章 汎用トレース機能 (GTF)
10-57
汎用トレース機能
CS...... shhhh
ASCB.... hhhhhhhh CPUID... hhhh
PSW..... hhhhhhhh hhhhhhhh
SENSE... hhhh
FLA..... hh
DVRID... hh
IOSLVL.. hh
IRB..... hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh
UCBWGT.. hh
BASE.... hhhh
JOBN.... cccccccc
TCB..... hhhhhhhh
OPT..... hh
UCBLVL.. hh
hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh
IO...... shhhh
ASCB.... hhhhhhhh CPUID... hhhh
PSW..... hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh hhhhhhhh
SENSE... hhhh
FLA..... hh
DVRID... hh
IOSLVL.. hh
UCBWGT.. hh
BASE.... hhhh
JOBN.... cccccccc
IRB..... hhhhhhhh
TCB..... hhhhhhhh
OPT..... hh
UCBLVL.. hh
PCI..... hhhh
ASCB.... hhhhhhhh CPUID...
PSW..... hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh
SENSE... hhhh
FLA.....
DVRID... hh
IOSLVL..
UCBWGT.. hh
BASE....
hhhh
JOBN....
IRB.....
hhhhhhhh TCB.....
hh
OPT.....
hh
UCBLVL..
hhhh
cccccccc
hhhhhhhh
hhhhhhhh
hh
hh
EOS hhhh
CS hhhh
IO hhhh
PCI hhhh
装置制御ブロック (UCB) の UCBCHAN フィールドから得られた装置番号。
ASCB {hhhhhhhh|U/A}
次のいずれかです。
hhhhhhhh
入出力操作を開始させたアドレス・スペースのアドレス・スペ
ース制御ブロック (ASCB) のアドレス。
U/A
入出力監視プログラム (IOSB) の制御ブロックが使用不能なた
め、使用不能。
CPU hhhh
割り込みが発生したプロセッサーのアドレス。
JOBN {cccccccc|N/A|U/A}
次のいずれかです。
cccccccc
入出力操作を要求したタスクと関連するジョブの名前。
N/A
該当なし。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
PSW hhhhhhhh hhhhhhhh
割り込み発生時のプログラム状況ワード (PSW)
IRB (see explanation)
EOS、IO、および PCI トレース・レコードの場合、このフィールドには、サブ
チャネル・テスト (TSCH) 命令の割り込み応答ブロック・オペランドの最初の
4 ワードが 16 進数で入ります。CS トレース・レコードの場合、このフィール
ドには、TSCH 命令の割り込み応答ブロック・オペランドの最初の 16 ワード
が 16 進数で入ります。(この IRB は、DSP トレース・レコードの **IRB***
で示される割り込み要求ブロックではありませんので、ご注意ください。)
10-58
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
TCB {hhhhhhhh|N/A|U/A}
次のいずれかです。
hhhhhhhh
入出力操作を要求したタスクの TCB のアドレス。
N/A
該当なし。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
SENSE {hhhh|N/A|U/A}
次のいずれかです。
hhhh
IOSB の IOSSNS フィールドから得られた最初の 2 つのセン
ス・バイト。
N/A
該当なし。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
FLA {hh|U/A}
次のいずれかです。
hh
IOSB の IOSFLA フィールドから得られたフラグ・バイト。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
OPT {hh|U/A}
次のいずれかです。
hh
IOSB の IOSOPT フィールドから得られた IOSB オプション・
バイト。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
DVRID {hh|U/A}
次のいずれかです。
hh
IOSB の IOSDVRID フィールドから得られたドライバー ID。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
IOSLVL {hh|U/A}
次のいずれかです。
hh
入出力要求の逐次化を行う機能レベル。この値は、IOSB の
IOSLEVEL フィールドから得られます。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
UCBLVL hh
UCB の UCBLEVEL フィールドから得られた UCB レベル値。
UCBWGT hh
UCB の UCBWGT フィールドから得られたフラグ。
BASE hhhh
UCB の UCBCHAN フィールドから得られた装置番号 (DEV hhhh と同じ)。
EXT トレース・レコード
目的
EXT レコードは、汎用外部割り込みを表します。
最小限のトレース・レコード・フォーマット
EXT
CODE.... hhhh
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh
hhhhhhhh TCB..... hhhhhhhh ccc-TCB. hhhhhhhh
第 10 章 汎用トレース機能 (GTF)
10-59
汎用トレース機能
広範囲のトレース・レコード・フォーマット
EXT..... hhhh
ASCB.... hhhhhhhh CPU..... hhhh
OLD-PSW. hhhhhhhh hhhhhhhh
TQE FIELDS:
FLAGS... hhhh
TCB..... hhhhhhhh
EXT..... hhhh
ASCB.... hhhhhhhh
OLD-PSW. hhhhhhhh
TQE FIELDS:
ASCB.... hhhhhhhh
EXT..... hhhh
ASCB.... hhhhhhhh CPU..... hhhh
OLD-PSW. hhhhhhhh hhhhhhhh
PARM.... hhhhhhhh SIG-CPU. hhhh
JOBN.... cccccccc
TCB..... hhhhhhhh
EXTADDR. hhhhhhhh
CPU..... hhhh
JOBN.... cccccccc
hhhhhhhh
TCB..... hhhhhhhh
FLAGS... hhhh
EXTADDR. hhhhhhhh
TCB..... hhhhhhhh
JOBN.... cccccccc
TCB..... hhhhhhhh
EXT CODE hhhh
EXT hhhh
外部割り込みコード。
ASCB hhhhhhhh
割り込み発生時点の現行アドレス・スペースの ASCB のアドレス。
CPU hhhh
割り込みが発生したプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
割り込みを受けたタスクに関連したジョブの名前。
N/A
このレコードはシステム・タスクまたは開始済みタスク用で
す。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
PSW hhhhhhhh hhhhhhhh
OLD-PSW hhhhhhhh hhhhhhhh
割り込み発生時のプログラム状況ワード。
TCB hhhhhhhh
次のいずれかです。
hhhhhhhh
割り込みを受けたタスクの TCB のアドレス。
N/A
該当なし (割り込みを受けた SRB ルーチンの場合と同じ)。
INT-TCB hhhhhhhh
TQE-TCB hhhhhhhh
TCB のアドレス。この割り込みは、割り込みコード 12hh によって示されま
す。
TQE FIELDS
時刻比較機構または CPU タイマーの割り込みを示します。これらの割り込み
は、割り込みコード X'1004' または X'1005' によって示されます。以下のフィ
ールドには、タイマー・キュー・エレメント (TQE) から得られた情報が含まれ
ます。
FLAGS hhhh
TQEFLGS フィールドから得られたフラグ。
10-60
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
EXTADDR hhhhhhhh
最初の 4 桁の 16 進数は TQEFLGS フィールドの内容であり、最後の 4
桁の 16 進数は TQEEXIT フィールドの内容です。
ASCB hhhhhhhh
次のいずれかです。
hhhhhhhh
TQEASCB フィールドの内容。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
TQEASCB フィールドは、時刻比較機構割り込みの場合にだけ現れます。
TQEASCB には、タイマー出口ルーチンが実行されるアドレス・スペースの
ASCB のアドレスが入ります。
TCB hhhhhhhh
次のいずれかです。
hhhhhhhh
TQETCB フィールドの内容。
N/A
このレコードはシステム・タスクまたは開始済みタスク用で
す。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
TQETCB には、タイマー出口ルーチンが実行されるタスクの TCB のアド
レスが入ります。
PARM hhhhhhhh
プロセッサー信号割り込みで渡される信号。割り込みコード 12hh によって示さ
れます。
SIG-CPU hhhh
プロセッサー信号割り込みが発生したプロセッサーのアドレス。
FRR トレース・レコード
目的
FRR レコードは、機能リカバリー・ルーチン (FRR) からリカバリー終了マネージ
ャー (RTM) への戻りを表します。プロセッサー・アドレス・フィールド以外のす
べてのフィールドは、FRR に渡されたシステム診断作業域 (SDWA) から収集され
ます。
最小限のトレース・レコード・フォーマット
FRR
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh hhhhhhhh
CC...... hhhhhhhh FLG1.... hhhhhhhh FLG2.... hhhhhhhh
RETRY... hhhhhhhh RTCA.... hhhhhhhh
広範囲のトレース・レコード・フォーマット
FRR
ASCB....
NAME....
ABCC....
RC......
hhhhhhhh
cccccccc
hhhhhhhh
hh
CPU.....
PSW.....
ERRT....
RTRY....
hhhh
JOBN.... cccccccc
hhhhhhhh hhhhhhhh
hhhhhhhh FLG..... hhhhhh
hhhhhhhh
第 10 章 汎用トレース機能 (GTF)
10-61
汎用トレース機能
ASCB hhhhhhhh
次のいずれかです。
hhhhhhhh
エラーが発生したアドレス・スペースの ASCB のアドレス。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
CPU hhhh
エラーに関連したプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
エラーに関連したジョブの名前。
N/A
このレコードはシステム・タスクまたは開始済みタスク用で
す。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
NAME cccccccc
FRR ルーチンの名前。
PSW hhhhhhhh hhhhhhhh
次のいずれかです。
hhhhhhhh hhhhhhhh
エラー発生時点でのプログラム状況ワード。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
CC hhhhhhhh
ABCC hhhhhhhh
次のいずれかです。
hhhhhhhh
最初の 3 桁はシステム完了コードであり、最後の 3 桁はユー
ザー完了コードです。
U/A
システム診断作業域 (SDWA) が使用不能なために、使用不能。
********
内部エラーが発生しました。
FLG1 hhhhhhhh
FLG hhhhhh
ERRT hhhhhhhh
SDWA の SDWAFLGS フィールドのエラー・タイプ・フラグ。
FLG2 hhhhhh
SDWA の SDWAMCHD および SDWAACF2 フィールドから得られた追加フラ
グ。これらのフラグは、この印刷フィールドの低位 2 バイトに含まれます。最
高位バイトには意味がありません。
RC hh
戻りコード
RETRY hhhhhhhh
RTRY hhhhhhhh
次のいずれかです。
hhhhhhhh
FRR によって提供された再試行アドレス。
N/A
該当なし。4 以外の FRR 戻りコードを示します。
PPPPPPPP
ページ不在が発生しました。
10-62
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
********
内部エラーが発生しました。
RTCA hhhhhhhh
リカバリー・ルーチンが STAE または ESTAE のいずれであったのかを示しま
す。
HEXFORMAT、SUBSYS、および SYSTEM トレース・レコード
目的
HEXFORMAT、SUBSYS、および SYSTEM レコードは、GTF がレコードをフォー
マット設定できなかったイベントを表します。
レコード・フォーマット
HEXFORMAT
AID hh FID hh EID hh hhhhhhhh hhhhhhh ...
SUBSYS
AID hh FID hh EID hh hhhhhhhh hhhhhhh ...
SYSTEM
AID hh FID hh EID hh hhhhhhhh hhhhhhh ...
HEXFORMAT
GTRACE マクロによって通知されたイベントを示しています。このマクロでは
フォーマット設定ルーチンは指定されていません (FID=00)。
SUBSYS
GTRACE マクロによって通知されたイベントを示しています。このマクロでは
フォーマット設定ルーチンが指定されていますが (FID=hh)、そのルーチンは検
出できませんでした。
SYSTEM
システム・イベントを示しています。トレース・レコードは、次のいずれかの理
由により、フォーマット設定できませんでした。
v 記録されたデータのバイト 0-1 または 8-9 に 16 進数の EEEE が入ってい
るときには、 GTF データ収集ルーチンでリカバリー不能エラーが発生してい
ます。メッセージ AHL118I がコンソールに書き出され、エラーの原因となっ
たモジュールと、取られたアクションが示されます。(このメッセージは、
GTF がこのタイプのイベントをトレースしなくなることを示しています。こ
のタイプのイベントに関するレコードはトレース出力に示されなくなりま
す。)
v 記録されたデータのバイト 0-1 または 8-9 に 16 進数の EEEE が入ってい
ないときには、 GTF フォーマット設定ルーチンが検出できなかったためにレ
コードがフォーマット設定できていません。
AID hh
アプリケーション ID。これは常に AID FF になっているはずです。
FID hh
このレコードをフォーマット設定したルーチン (AMDUSRhh または
AMDSYShh) のフォーマット ID。
第 10 章 汎用トレース機能 (GTF)
10-63
汎用トレース機能
EID hh
レコードを作成したイベントを固有に識別するイベント ID。
hhhhhhhh hhhhhhhh ...
記録されたデータ (最大 256 バイト)。
IOX トレース・レコード
目的
IOX レコードは、完了したチャネル・プログラムの入出力割り込みおよび入出力操
作に関する完全なチャネル・プログラム要約を表しています。
レコード・フォーマット
IOX....shhhh ASCB.... hhhhhhhh CPU..... hhhh
JOBN.... cccccccc
DEVN.... hhhh
SID..... hhhh
DRID.... hh
TVSN.... hh
ECNO.... hhhh
DVCLS... hh
DSTAT... hh
AERRC... hh
FLAG0... hh
VOLSER.. cccccc
UCBTYP.. hhhhhhhh
DSNAME.. cccc.cccccc.cccccc.ccccc
NSSCH... hhhhhhhh DSSCH... hhhhhhhh SDCON... hhhhhhhh
SRPEN... hhhhhhhh SDISC... hhhhhhhh SCUQU... hhhhhhhh
IODTS... hhhhhhhh hhhhhhhh
AONLY... hhhhhhhh DVBSY... hhhhhhhh ICMR.... hhhhhhhh
CCW SECTION
SQNO....
RCNT....
BTRD....
CCHN....
hh
hh
hhhhhhhh
hhhh
FGS1....
BLKR....
BTWR....
DEGA....
hh
hhhh
hhhhhhhh
hh
FGS2....
BLKW....
DCHN....
DEGE....
hh
hhhh
hhhh
hh
IOX shhhh
IOX は、IOX レコードの先頭を示します。ここで、hhhh は装置番号で、s はサ
ブチャネル・セット ID です。
ASCB {hhhhhhhh|U/A}
次のいずれかです。
hhhhhhhh
入出力操作を開始させたアドレス・スペースのアドレス・スペ
ース制御ブロック (ACSB) のアドレス。
U/A
入出力監視プログラム (IOSB) の制御ブロックが使用不能なた
め、使用不能。
CPU hhhh
割り込みが発生したプロセッサーのアドレス。
JOBN {cccccccc|N/A|U/A}
次のいずれかです。
cccccccc
入出力操作を要求したタスクと関連するジョブの名前。
N/A
該当なし。
U/A
IOSB 制御ブロックが使用不能なため、使用不能。
DEVN shhhh
必要に応じてサブチャネル・セット ID がある装置番号。
SID hhhh
システム ID
10-64
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
DRID hh
IOSB から得たドライバー ID
TVSN hh
トレース・バージョン
ECNO hhhh
レコード・カウント
DVCLS hh
装置クラス
DSTAT hh
装置状況
AERRC hh
CCW 分析中に発見されたエラー・コード詳しくは 10-105 ページの『CCW エラ
ー・コード』 を参照してください。
FLAG0 hh
フラグ・バイト
VOLSER ccccccc
ボリューム通し番号
UCBTYP hhhhhhhh
UCB タイプ
DSNAME cccc.cccccc.cccccc.ccccc
44 バイトのデータ・セット名
NSSCH hhhh
SSCH 命令の数
DSSCH hhhh
データが収集される SSCH 命令の数このフィールドは、2 バイト・フィールド
から 4 バイト・フィールドに変更されました。
SDCON hhhhhhhh
装置接続回数の合計
SRPEN hhhhhhhh
SSCH 要求の保留回数の合計
SDISC hhhhhhhh
サブチャネル切断回数の合計
SCUQU hhhhhhhh
制御装置キュー数の合計
IODTS hhhhhhhh
IOD から得たタイム・スタンプ
AONLY hhhhhhhh
装置がアクティブのときだけの時間
DVBSY hhhhhhhh
装置使用中数の合計
第 10 章 汎用トレース機能 (GTF)
10-65
汎用トレース機能
ICMR hhhhhhhh
初期コマンド応答回数の合計
SQNO hh
方向付けシーケンス番号
FGS1 hh
フラグ・バイト 1
FGS2 hh
フラグ・バイト 2
RCNT hh
クリアの数
BLKR hhhh
読み取りブロック数
BLKW hhhh
書き込みブロック数
BTRD hhhhhhhh
読み取りバイト数
BTWR hhhhhhhh
書き込みバイト数
DCHN hhhh
データ・チェーン CCW の数
CCHN hhhh
COM チェーン CCW の数
DEGA hh
外部グローバル属性の定義
DEGE hh
拡張外部グローバル属性の定義
DEEE hhhhhhh
拡張 CCH の外部終了の定義
SEEKLOCC hh
検索/位置指定コード
CCHHR hhhhhhhh
CCHHR 検索または検索アドレス
LSR トレース・レコード
目的
LSR レコードは、アドレス・スペースにおけるローカル監視プログラム・ルーチン
のディスパッチングを表します。
10-66
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
最小限のトレース・レコード・フォーマット
LSR
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh hhhhhhhh
TCB..... hhhhhhhh R15..... hhhhhhhh R0...... hhhhhhhh
R1...... hhhhhhhh
広範囲のトレース・レコード・フォーマット
LSR
ASCB.... hhhhhhhh CPU..... hhhh
LSR-PSW. hhhhhhhh hhhhhhhh
JOBN.... cccccccc
TCB..... hhhhhhhh
ASCB hhhhhhhh
アドレス・スペース制御ブロックのアドレス。
CPU hhhh
ルーチンがディスパッチされるプロセッサーのアドレス。
PSW hhhhhhhh hhhhhhhh
LSR-PSW hhhhhhhh hhhhhhhh
ルーチンが制御を受け取る際のプログラム状況ワード。
JOBN cccccccc
次のいずれかです。
cccccccc
ディスパッチされるルーチンに関連したジョブの名前。
N/A
該当なし。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
TCB hhhhhhhh
次のいずれかです。
hhhhhhhh
このルーチンに関連したタスク制御ブロックのアドレス (ルー
チンがタスクの一部として実行される場合)。
N/A
該当なし。
R15 hhhhhhhh
R0 hhhhhhhh
R1 hhhhhhhh
次のいずれかです。
hhhhhhhh
ローカル監視プログラム・ルーチンがディスパッチされるとき
に汎用レジスター 15、0、および 1 に入るデータ。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
MSCH トレース・レコード
目的
MSCH レコードは、サブチャネル修正操作を表します。
第 10 章 汎用トレース機能 (GTF)
10-67
汎用トレース機能
レコード・フォーマット
MSCH.... shhhh ASCB.... hhhhhhhh CPUID... hhhh
SID..... hhhhhhhh CC...... hh
OPT2.... hh
IOSLVL.. hh
hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh UCBLVL.. hh
hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh
hhhhhhhh UCBWGT.. hh
JOBN....
OPT.....
SCHIB1..
hhhhhhhh
SCHIB2..
hhhhhhhh
cccccccc
hh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
BASE.... hhhh
MSCH shhhh
UCB の UCBCHAN フィールドから得られた装置番号。必要な場合には、サブ
チャネル・セット ID が含まれます。
ASCB hhhhhhhh
サブチャネル修正操作を開始させたアドレス・スペースの ASCB のアドレス。
CPU hhhh
サブチャネル修正操作が開始されたプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
サブチャネル修正操作を要求したタスクと関連するジョブの名
前。
N/A
該当なし。
SID hhhhhhhh
UCB の UCBSID フィールドから得られたサブチャネル ID。
CC hh
ビット 2 および 3 の MSCH 条件コード。
OPT hh
IOSB の IOSOPT フィールドから得られた IOSB オプション・バイト。
OPT2 hh
IOSB の IOSOPT フィールドから得られた IOSB オプション・バイト。
IOSLVL hh
入出力要求の逐次化を行う機能レベル。この値は、IOSB の IOSLEVEL フィー
ルドから得られます。
SCHIB1 hhhhhhhh ... hhhhhhhh
サブチャネル情報ブロックの最初の 7 ワード。サブチャネル修正命令の呼び出
し側から得られた入力。IOSB の IOSSCHIB フィールドから得られた SCHIB
アドレス。
UCBLVL hh
UCB の UCBLEVEL フィールドから得られた UCB レベル値。
SCHIB2 hhhhhhhh ... hhhhhhhh
サブチャネル修正命令によって作成されたサブチャネル情報ブロックの最初の 7
ワード。
UCBWGT hh
UCB の UCBWGT フィールドから得られたフラグ。
10-68
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
BASE hhhh
UCB の UCBCHAN フィールドから得られた装置番号 (DEV hhhh と同じ)。
PGM および PI トレース・レコード
目的
PGM および PI レコードはプログラム割り込みを表します。
最小限のトレース・レコード・フォーマット
PI
CODE.... hhh
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh
hhhhhhhh TCB..... hhhhhhhh VPH..... hhhhhhhh
VPA..... hhhhhhhh R15..... hhhhhhhh R1...... hhhhhhhh
広範囲のトレース・レコード・フォーマット
PGM..... hhh
ASCB....
OLD-PSW.
VPH.....
R0......
R3......
R6......
R9......
R12.....
R15.....
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
CPU.....
hhhhhhhh
VPA.....
R1......
R4......
R7......
R10.....
R13.....
hhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
JOBN....
TCB.....
MODN....
R2......
R5......
R8......
R11.....
R14.....
cccccccc
hhhhhhhh
cccccccc
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
PI CODE hhh
PGM hhh
10 進数のプログラム割り込みコード。
ASCB hhhhhhhh
割り込みが発生したアドレス・スペースの ASCB のアドレス。
CPU hhhh
割り込みが発生したプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
割り込みに関連したジョブの名前。
N/A
該当なし。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
PSW hhhhhhhh hhhhhhhh
OLD-PSW hhhhhhhh hhhhhhhh
割り込み発生時のプログラム状況ワード。
TCB hhhhhhhh
次のいずれかです。
hhhhhhhh
割り込みを受けたタスクの TCB のアドレス。
N/A
該当なし (割り込みを受けた SRB ルーチンの場合と同じ)。
VPH hhhhhhhh
VPA hhhhhhhh
64 ビット変換例外 (X'FFFFFFFF' よりも大きいアドレス (TEA) が格納される)
第 10 章 汎用トレース機能 (GTF)
10-69
汎用トレース機能
の場合、仮想ページ・アドレスの高位半分。ページ参照の結果として変換処理例
外の場合、仮想ページアドレス。このエリアは、その他のタイプのプログラム割
り込みの場合には意味をもちません。
MODN cccccccc
cccccccc は次のいずれかです。
mod_name
タスクがディスパッチされるときに制御を受け取るモジュールの名前。
WAITTCB
システム待機タスクが割り込みを受けたことを示します。
SVC-T2
中核に入っているタイプ 2 の SVC ルーチンが割り込みを受けたことを示
します。
SVC-RES
タイプ 2 の SVC ルーチン、またはタイプ 4 の SVC ルーチンの最初のロ
ード・モジュールが割り込みを受けたことを表します。このルーチンは、ペ
ージング可能リンク・パック域 (PLPA) に入っています。
SVC-ccc
タイプ 4 の SVC ルーチンの 2 番目以降のロード・モジュールが割り込み
を受けたことを表します。このモジュールは、固定またはページング可能な
リンク・パック域 (LPA) に入っています。ロード・モジュール名の最後の
4 文字は cccc です。
**IRB***
関連する割り込み要求ブロックのある非同期ルーチンが割り込みを受けたこ
とを示します。モジュール名は使用不能です。
*ccccccc
エラー・リカバリー・モジュールが制御権を得ていたことを示します。モジ
ュール名の最後の 7 文字は ccccccc です。
********
内部エラーが発生しました。
Rdd hhhhhhhh
割り込みが発生したときの汎用レジスターの内容。
RNIO トレース・レコード
目的
RNIO レコードは、VTAM リモート・ネットワーク入出力イベントを表します。ト
レース情報については、 z/OS Communications Server: SNA Diagnosis Vol 1,
Techniques and Procedures を参照してください。
最小限のトレース・レコード・フォーマット
RNIO
10-70
ASCB.... hhhhhhhh CPU..... hhhh
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
R0...... hhhhhhhh
汎用トレース機能
広範囲のトレース・レコード・フォーマット
RNIO
ASCB.... hhhhhhhh CPU..... hhhh
JOB..... cccccccc
IN...... hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
R0...... hhhhhhhh
RNIO
ASCB.... hhhhhhhh CPU..... hhhh
JOB..... cccccccc
OUT..... hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
R0...... hhhhhhhh
ASCB hhhhhhhh
イベントと関連したアプリケーションのアドレス・スペースの ASCB のアドレ
ス。
CPU hhhh
入出力命令を実行したプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
IO イベントに関連したジョブの名前。
N/A
該当なし。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
IN hhhhhhhh ... hhhhhhhh
OUT hhhhhhhh ... hhhhhhhh
IN はその入出力が NCP から VTAM への方向で行われたことを示し、OUT は
VTAM から NCP への方向で行われたことを示します。この 16 進数データ
は、次のとおりです。
v IN イベントの場合: 伝送ヘッダー、応答ヘッダー、および応答単位。
v OUT イベントの場合: 伝送ヘッダー、要求ヘッダー、および要求単位。
R0 hhhhhhhh
イベントが発生したときの汎用レジスター 1 の内容。
RSCH トレース・レコード
目的
RSCH レコードは、サブチャネル再開操作を表します。
レコード・フォーマット
RSCH.... shhhh ASCB....
RST.....
CC......
GPMSK...
DVRID...
UCBWGT..
hhhhhhhh
hhhhhhhh
hh
hh
hh
hh
CPUID...
VST.....
SEEKA...
OPT.....
IOSLVL..
BASE....
hhhh
hhhhhhhh
hhhhhhhh
hh
hh
hhhh
JOBN....
DSID....
hhhhhhhh
FMSK....
UCBLVL..
cccccccc
hhhhhhhh
hh
hh
RSCH shhhh
UCB の UCBCHAN フィールドから得られた装置番号。必要な場合には、サブ
チャネル・セット ID が含まれます。
ASCB hhhhhhhh
入出力操作を開始させたアドレス・スペースの ASCB のアドレス。
第 10 章 汎用トレース機能 (GTF)
10-71
汎用トレース機能
CPU hhhh
入出力操作が再開されたプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
入出力操作に関連したジョブの名前。
N/A
該当なし。
RST hhhhhhhh
チャネル・プログラムのアドレス。この値は、IOSB の IOSRST フィールドの
内容から得られます。
VST hhhhhhhh
チャネル・プログラムの仮想アドレス。この値は、IOSB の IOSVST フィール
ドの内容から得られます。
DSID hhhhhhhh
パージで使用される要求 ID。IOSB の IOSDID フィールドの内容 (DEB、また
はパージで使用されるその他の制御ブロックのアドレス)。
CC hh
ビット 2 および 3 の RSCH 条件コード。
SEEKA hhhhhhhh hhhhhhhh
IOSB の IOSEEKA フィールドの動的シーク・アドレス。
GPMSK hh
IOSB の IOSEEKA フィールドからの GDP 要求の場合の保証された装置パ
ス・マスク。
OPT hh
IOSB の IOSOPT フィールドから得られた IOSB オプション・バイト。
FMSK hh
IOSB の IOSFMSK フィールドから得られたモード設定/ファイル・マスク。
DVRID hh
IOSB の IOSDVRID フィールドから得られたドライバー ID。
IOSLVL hh
入出力要求の逐次化を行う機能レベル。この値は、IOSB の IOSLEVEL フィー
ルドから得られます。
UCBLVL hh
UCB の UCBLEVEL フィールドから得られた UCB レベル値。
UCBWGT hh
UCB の UCBWGT フィールドから得られたフラグ。
BASE hhhh
UCB の UCBCHAN フィールドから得られた装置番号 (DEV hhhh と同じ)。
SLIP トレース・レコード
目的
SLIP レコードは、SLIP プログラム・イベント割り込みを表します。GTF は、次の
4 つのタイプの SLIP レコードを書き込みます。
10-72
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
v
v
v
v
SLIP
SLIP
SLIP
SLIP
標準トレース・レコード
標準 / ユーザー・トレース・レコード
ユーザー・トレース・レコード
デバッグ・トレース・レコード
SLIP 標準トレース・レコード
目的
SLIP 標準 (STD) トレース・レコードは、SLIP コマンドで ACTION=TRACE また
は ACTION=TRDUMP が指定された場合のスリップ・トラップの一致を表します。
レコード・フォーマット
SLIP STD
ASCB....
TID.....
TCB.....
SFLG....
OFFS....
EXSIAD..
BRNGH...
OPSW....
PERC....
SASID...
ASC.....
hhhhhhhh
cccc
hhhhhhhh
hh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hh
hhhh
c
CPU.....
ASID....
MFLG....
DAUN....
IADR....
EXSINS..
BRNGD...
hhhhhhhh
TYP.....
AX......
SA-SPACE
hhhh
hhhh
hhhh
hhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
JOBN....
JSP.....
EFLG....
MODN....
INS.....
BRNGA...
cccccccc
cccccccc
hhhh
cccccccc
hhhhhhhh
hhhhhhhh
hhhh
PIC/ILC. hhhhhhhh
hh
PKM..... hhhh
hhhh
PASID... hhhh
ccccccccc
cccc
ASCB hhhhhhhh
現行アドレス・スペースの ASCB のアドレス。
CPU hhhh
プロセッサー ID (ID)。
JOBN cccccccc
次のいずれかです。
cccccccc
SLIP トラップに関連したジョブの名前。
N/A
該当なし。
TID cccc
トラップ ID。
ASID hhhh
現行アドレス・スペースの ID。
JSP cccccccc
次のいずれかです。
cccccccc
ジョブ・ステップ・プログラム名。
N/A
該当なし。
U/A
使用不能。
TCB hhhhhhhh
次のいずれかです。
hhhhhhhh
TCB アドレス。
N/A
該当なし。
|
MFLG hhhh
システムの状況を示すシステム・モード標識。これらの標識は、SLWA の
第 10 章 汎用トレース機能 (GTF)
10-73
汎用トレース機能
SLWACW フィールドに対応しています。SLWA の説明は、「z/OS MVS Data
Areas, Vol 4 (RD-SRRA)」を参照してください。
EFLG hhhh
システムのエラー状況を示すエラー・バイト。これらのバイトは、SDWA 内の
SDWAERRA に対応しています。SDWA の説明については、「z/OS MVS Data
Areas, Vol 4 (RD-SRRA)」を参照してください。
SFLD hh
SLIP 状況フラグ
DAUN hhhhhhhh
回数データを表すカウンターが、DATA キーワード・テスト用に使用できませ
んでした。
以下のフィールドは、PER 割り込みだけに適用されます。PER 割り込み以外の場
合、これらのフィールドは適用されず、N/A、N/、または N が入ります。
MODN cccccccc
次のいずれかです。
cccccccc
割り込みが発生したロード・モジュール名。
N/A
該当なし。
U/A
使用不能。
OFFS hhhhhhhh
次のいずれかです。
hhhhhhhh
割り込みの原因となった命令を含むロード・モジュールへのオ
フセット。
N/A
該当なし。
U/A
使用不能。
IADR hhhhhhhh
割り込みの原因となった命令のアドレス。
INS hhhhhhhhhhhh
命令の内容: PER 割り込みの原因となった命令。
EXSIAD hhhhhhhh
次のいずれかです。
hhhhhhhh
INS フィールドが実行命令になっている場合には、ターゲット
命令アドレス。
N/A
該当なし。
U/A
使用不能。
EXSINS hhhhhhhhhh
次のいずれかです。
hhhhhhhh
INS フィールドが実行命令になっている場合のターゲット命令
の内容: ターゲット命令アドレスの最初の 6 バイトのデータ。
N/A
該当なし。
U/A
使用不能。
BRNGA hhhhhhhh
BRNGH hhhhhhhh
次のいずれかです。
10-74
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
hhhhhhhh
N/A
SLIP コマンドで SA が指定されている範囲の開始仮想アドレ
ス。
該当なし。
BRNGD hhhhhhhh
次のいずれかです。
hhhhhhhh
SA が指定された場合の範囲の開始仮想アドレスから開始する 4
バイトのストレージ。
N/A
該当なし。
U/A
使用不能。
OPSW hhhhhhhh hhhhhhhh
プログラムの旧 PSW。
PIC/ILC hhhhhhhh
プログラム割り込みコードおよび命令長コード。
PERC hh
PER 割り込みコード。
TYP hh
PER トラップ・モード。
PKM hhhh
PSW キー・マスク。
SASID hhhh
2 次アドレス・スペースの ID。
AX hhhh
許可インデックス。
PASID hhhh
1 次アドレス・スペースの ID。
ASC c
PSW の ASC モード標識。
c
0
1
2
3
意味
1 次アドレッシング・モード。
アクセス・レジスター・アドレッシング・モード。
2 次アドレッシング・モード。
ホーム・アドレッシング・モード。
SA-SPACE ccccccccccccc
以下のストレージ変更スペース ID。
v アドレス・スペースの場合には、ASID。
v データ・スペースの場合には、所有側 ASID とデータ・スペース名。
SLIP 標準/ユーザー・トレース・レコード
目的
SLIP 標準 / ユーザー・トレース・レコードは、SLIP コマンドで ACTION=TRACE
または ACTION=TRDUMP と TRDATA=パラメーターが指定された場合のスリッ
プ・トラップの一致を表します。
第 10 章 汎用トレース機能 (GTF)
10-75
汎用トレース機能
レコード・フォーマット
SLIP S+U
ASCB.... hhhhhhhh CPU..... hhhh
TID..... cccc
ASID.... hhhh
TCB..... hhhhhhhh MFLG.... hhhh
SFLG.... hh
DAUN.... hhhh
OFFS.... hhhhhhhh IADR.... hhhhhhhh
EXSIAD.. hhhhhhhh EXSINS.. hhhhhhhh
BRNGD... hhhhhhhh OPSW.... hhhhhhhh
PIC/ILC. hhhhhhhh PERC.... hh
PKM..... hhhh
SASID... hhhh
PASID... hhhh
ASC..... c
GENERAL PURPOSE REGISTER VALUES
0-3..... hhhhhhhh hhhhhhhh hhhhhhhh
4-7..... hhhhhhhh hhhhhhhh hhhhhhhh
8-11.... hhhhhhhh hhhhhhhh hhhhhhhh
12-15... hhhhhhhh hhhhhhhh hhhhhhhh
GPR HIGH HALF VALUES
0-3..... hhhhhhhh hhhhhhhh hhhhhhhh
4-7..... hhhhhhhh hhhhhhhh hhhhhhhh
8-11.... hhhhhhhh hhhhhhhh hhhhhhhh
12-15... hhhhhhhh hhhhhhhh hhhhhhhh
ACCESS REGISTER VALUES
0-3..... hhhhhhhh hhhhhhhh hhhhhhhh
4-7..... hhhhhhhh hhhhhhhh hhhhhhhh
8-11.... hhhhhhhh hhhhhhhh hhhhhhhh
12-15... hhhhhhhh hhhhhhhh hhhhhhhh
JOBN....
JSP.....
EFLG....
MODN....
INS.....
BRNGA...
hhhhhhhh
TYP.....
AX......
SA-SPACE
cccccccc
cccccccc
hhhh
cccccccc
hhhhhhhh
hhhhhhhh
hh
hhhh
ccccccccc
hhhh
cccc
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
ASCB hhhhhhhh .. . SA-SPACE ccccccccccccc
これらのフィールドは、SLIP 標準トレース・レコードの場合と同じです。
GENERAL PURPOSE REGISTER VALUES
GPR HIGH HALF VALUES
ACCESS REGISTER VALUES
SLIP コマンドの TRDATA で REGS が指定されていた場合、エラーまたは割
り込み発生時点の汎用レジスターまたはアクセス・レジスターの内容。GPR の
上位半分の値 (high half values) は z/Architecture モードでのみトレースされま
す。
SLIP ユーザー・トレース・レコード
目的
SLIP ユーザー・レコードは、SLIP コマンドで ACTION=TRACE または
ACTION=TRDUMP と TRDATA=パラメーターが指定された場合の SLIP トラップ
突き合わせを表します。
レコード・フォーマット
SLIP USR
hhhh
CPU..... hhhh
EXT..... hhhh
CNTLN... hh
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh | cccccccccccccccc |
CPU hhhh
プロセッサー ID。
EXT hhhh
拡張番号
10-76
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
CNTLN hh
継続の長さ
hhhh
SLIP コマンド内の単一範囲の長さ。hhhh がゼロの場合、範囲が使用不能であ
ったか、あるいは範囲が無効であったために、 GTF が範囲のデータを収集して
いません。GTF は、たとえば終了範囲アドレスが開始範囲アドレスよりも前に
なっている場合などには、範囲が無効であるものと見なします。
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh | cccccccccccccccc |
SLIP コマンドの TRDATA で指定されたユーザー定義のデータ・フィールド。
長さとデータのフィールドは反復することがあります。
SLIP コマンドの場合のトレースには、SLIP コマンドの TRDATA パラメーターで
指定されたデータ範囲をトレースするために必要な数だけ、ユーザー・レコードお
よびユーザー継続レコードが含まれます。各レコードのヘッダーには、プロセッサ
ー ID と拡張番号が含まれます。レコードがいっぱいになって次のデータ範囲が入
りきらない場合、 GTF は部分的にいっぱいになったそのレコードを GTF トレー
ス・テーブルに書き込みます。そして、GTF は別のレコードを作成します。このレ
コードには、前のレコードよりも 1 だけ大きな拡張番号が付けられ、継続の長さは
ゼロに設定されます。
ある範囲のデータの長さが 249 バイトを超えた場合、超過分のデータはユーザー継
続レコードに入ります。GTF は、SLIP USR レコードを書き込んだあとでユーザー
継続レコードを作成します。GTF は拡張番号を 1 だけ大きくし、継続の長さを、
連結レコードに入れるデータのバイト数に設定します。251 バイトを超えるデータ
が残っている場合、GTF は 248 バイトをそのレコードにコピーし、さらにそれを
GTF トレース・テーブルに収めます。 GTF は、範囲内のすべてのデータがトレー
スされるまでユーザー連結レコードを作成します。
SLIP デバッグ・トレース・レコード
目的
SLIP デバッグ・レコードは、SLIP コマンドで DEBUG が指定されていた場合の
SLIP トラップの一致を表します。
レコード・フォーマット
SLIP S+U
ASCB....
TID.....
TCB.....
SFLG....
OFFS....
EXSIAD..
BRNGD...
PIC/ILC.
hh00
hhhhhhhh
cccc
hhhhhhhh
hh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
CPU.....
ASID....
MFLG....
DAUN....
IADR....
EXSINS..
OPSW....
PERC....
hhhh
hhhh
hhhh
hhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
hh
JOBN....
JSP.....
EFLG....
MODN....
INS.....
BRNGA...
hhhhhhhh
TYP.....
cccccccc
cccccccc
hhhh
cccccccc
hhhhhhhh
hhhhhhhh
hhhh
hh
ASCB hhhhhhhh .. . TYP hh
これらのフィールドは、SLIP 標準トレース・レコードの場合と同じです。
SFLG フィールドの最高位ビットは、デバッグ・レコードを表すために 1 に設
定されています。
第 10 章 汎用トレース機能 (GTF)
10-77
汎用トレース機能
hh00
デバッグで作成された 2 バイトのデータ。最初のバイトには障害が起こったキ
ーワードが示され、2 番目のバイトにはゼロが入ります。
バイト 1 (10 進数)
...1
3
4
5
6
7
8
9
..10 ....
13
14
20
22
23
24
26
失敗したキーワード
DATA テストの失敗
ASID
JOBNAME
JSPGM
PVTMOD
LPAMOD
ADDRESS
MODE
ERRTYP
RANGE
DATA
ASIDSA
REASON CODE
NUCMOD
PSWASC
DSSA
SRB トレース・レコード
目的
SRB レコードは、サービス要求ブロック (SRB) で表される非同期ルーチンのディ
スパッチングを表します。
最小限のトレース・レコード・フォーマット
SRB
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh hhhhhhhh
R15..... hhhhhhhh SRB..... hhhhhhhh R1...... hhhhhhhh
TYPE.... ccccccccccccccccccccccccccc
広範囲のトレース・レコード・フォーマット
SRB
ASCB.... hhhhhhhh CPU..... hhhh
JOBN.... cccccccc
SRB-PSW. hhhhhhhh hhhhhhhh
SRB..... hhhhhhhh
TYPE.... ccccccccccccccccccccccccccc
ASCB hhhhhhhh
SRB ルーチンがディスパッチされたアドレス・スペースの ASCB のアドレ
ス。これは、SRB が作成されたアドレス・スペースとは異なる場合がありま
す。
CPU hhh
SRB ルーチンがディスパッチされたプロセッサーのアドレス。
PSW hhhhhhhh hhhhhhhh
SRB-PSW hhhhhhhh hhhhhhhh
SRB ルーチンが制御を受け取る際のプログラム状況ワード。
10-78
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
JOBN cccccccc
次のいずれかです。
cccccccc
ディスパッチされる SRB に関連したジョブの名前。
N/A
グローバル SRB (TYPE フィールドで示されます) の場合な
ど、該当なし。
********
内部エラーが発生しました。
SRB hhhhhhhh
次のいずれかです。
hhhhhhhh
サービス要求ブロック (SRB) のアドレス。
********
内部エラーが発生しました。
R15 hhhhhhhh
R1hhhhhhhh
次のいずれかです。
hhhhhhhh
SRB ルーチンがディスパッチされるときに汎用レジスター 15
および 1 に入るデータ。
********
内部エラーが発生しました。
PARM hhhhhhhh
次のいずれかです。
hhhhhhhh
SRB ルーチンに渡される 4 バイトのパラメーターまたはパラ
メーター・フィールドのアドレス。
N/A
中断された SRB (TYPE フィールドで示されます) の場合な
ど、適用外。
TYPE ccccccccccccccccccccccccccc
次のような SRB ルーチンのタイプを示します。
SUSPENDED
前にディスパッチされてその後 (たとえば、入出力操作またはロック要求に
よって) 割り込みを受けた SRB ルーチンを示します。このルーチンは再デ
ィスパッチされようとしています。
INITIAL DISPATCH OF SRB
サービス優先リストから選択された、初めてディスパッチされようとしてい
る SRB ルーチンを示します。
REDISPATCH OF SUSPENDED SRB
前にディスパッチされてその後 (たとえば、入出力操作またはロック要求に
よって) 割り込みを受けた SRB ルーチンを示します。このルーチンは再デ
ィスパッチされようとしています。
SRM トレース・レコード
目的
SRM レコードは、システム・リソース・マネージャー (SRM) への入り口を表しま
す。
第 10 章 汎用トレース機能 (GTF)
10-79
汎用トレース機能
最小限のトレース・レコード・フォーマット
SRM
ASCB.... hhhhhhhh CPU..... hhhh
R15..... hhhhhhhh R0...... hhhhhhhh
R1...... hhhhhhhh
広範囲のトレース・レコード・フォーマット
SRM
ASCB.... hhhhhhhh CPU..... hhhh
JOBN.... cccccccc
R15..... hhhhhhhh R0...... hhhhhhhh R1...... hhhhhhhh
ASCB hhhhhhhh
次のいずれかです。
hhhhhhhh
SRM に入った時点の現行アドレス・スペースの ASCB のアド
レス。
********
内部エラーが発生しました。
CPU hhhh
システム・リソース・マネージャーによって使用されるプロセッサーのアドレ
ス。
JOBN cccccccc
次のいずれかです。
cccccccc
SRM に入ることに関連したジョブの名前。
N/A
該当なし。
********
内部エラーが発生しました。
R15 hhhhhhhh
R0 hhhhhhhh
R1 hhhhhhhh
システム・リソース・マネージャーが GTF に制御を渡したときに汎用レジスタ
ー 15、0、および 1 に入っていたデータ。このデータには、レジスター 0 の下
位バイトに入っている SYSEVENT コードが含まれます。
SSCH トレース・レコード
目的
SSCH レコードは、サブチャネル開始操作を表します。
レコード・フォーマット
SSCH.... shhhh ASCB....
RST.....
CC......
GPMSK...
DVRID...
UCBWGT..
ORB.....
hhhhhhhh
hhhhhhhh
hh
hh
hh
hh
hhhhhhhh
hhhhhhhh
CPUID...
VST.....
SEEKA...
OPT.....
IOSLVL..
BASE....
hhhhhhhh
hhhhhhhh
hhhh
hhhhhhhh
hhhhhhhh
hh
hh
hhhh
hhhhhhhh
hhhhhhhh
JOBN....
DSID....
hhhhhhhh
FMSK....
UCBLVL..
cccccccc
hhhhhhhh
hh
hh
hhhhhhhh hhhhhhhh
SSCH shhhh
UCB の UCBCHAN フィールドから得られた装置番号。必要な場合には、サブ
チャネル・セット ID が含まれます。
ASCB hhhhhhhh
入出力操作を開始させたアドレス・スペースの ASCB のアドレス。
10-80
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
CPU hhhh
入出力操作が開始されたプロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
入出力操作に関連したジョブの名前。
N/A
該当なし。
RST hhhhhhhh
チャネル・プログラムのアドレス。この値は、IOSB の IOSRST フィールドの
内容から得られます。
VST hhhhhhhh
チャネル・プログラムの仮想アドレス。この値は、IOSB の IOSVST フィール
ドの内容から得られます。
DSID hhhhhhhh
パージで使用される要求 ID。この ID は IOSB の IOSDID フィールドに入っ
ているもので、PURGE によって使用される DEB またはその他の制御ブロック
のアドレスです。
CC hh
ビット 2 および 3 の SSCH 条件コード。
SEEKA hhhhhhhh hhhhhhhh
IOSB の IOSEEKA フィールドの動的シーク・アドレス。
GPMSK hh
IOSB の IOSGPMSK フィールドからの GDP 要求の場合の保証された装置パ
ス・マスク。
OPT hh
IOSB の IOSOPT フィールドから得られた IOSB オプション・バイト。
FMSK hh
IOSB の IOSFMSK フィールドから得られたモード設定 / ファイル・マスク。
DVRID hh
IOSB の IOSDVRID フィールドから得られたドライバー ID。
IOSLVL hh
入出力要求の逐次化を行う機能レベル。この値は、IOSB の IOSLEVEL フィー
ルドから得られます。
UCBLVL hh
UCB の UCBLEVEL フィールドから得られた UCB レベル値。
UCBWGT hh
UCB の UCBWGT フィールドから得られたフラグ。
BASE hhhh
UCB の UCBCHAN フィールドから得られた装置番号 (DEV hhhh と同じ)。
ORB hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
hhhhhhhh hhhhhhhh
操作要求ブロック (ORB) の内容。
第 10 章 汎用トレース機能 (GTF)
10-81
汎用トレース機能
STAE トレース・レコード
目的
STAE レコードは、STAE または ESTAE ルーチンからリカバリー終了マネージャ
ー (RTM) への戻りを表します。
最小限のトレース・レコード・フォーマット
STAE
PSW..... hhhhhhhh hhhhhhhh CC...... hhhhhhhh RF...... hhhhhhhh
TYCA.... hhhhhhhh hhhhhhhh
広範囲のトレース・レコード・フォーマット
STAE
ASCB....
ESTN....
ABCC....
RC......
hhhhhhhh
cccccccc
hhhhhhhh
hh
CPU.....
ERR-PSW.
ERRT....
RTRY....
hhhh
hhhhhhhh
hhhhhhhh
hhhhhhhh
JOBN.... cccccccc
hhhhhhhh
FLG..... hhhhhh
RTCA.... hhhhhhhh
ASCB hhhhhhhh
リカバリーに関与したアドレス・スペースの ASCB のアドレス。
CPU hhhh
プロセッサーのアドレス。
JOBN cccccccc
次のいずれかです。
cccccccc
リカバリーに関連したジョブの名前。
N/A
該当なし。
********
内部エラーが発生しました。
ESTN cccccccc
次のいずれかです。
cccccccc
ESTAE ルーチン名。
U/A
ルーチンで名前が提供されていないため使用不能。
********
内部エラーが発生しました。
PSW hhhhhhhh hhhhhhhh
ERR-PSW hhhhhhhh hhhhhhhh
次のいずれかです。
hhhhhhhh hhhhhhhh
エラー発生時点でのプログラム状況ワード。
U/A
システム診断作業域 (SDWA) が使用不能なために、使用不能。
********
内部エラーが発生しました。
CC hhhhhhhh
ABCC hhhhhhhh
次のいずれかです。
hhhhhhhh
最初の 4 桁はシステム完了コードで、最後の 4 桁はユーザー
完了コードです。
U/A
システム診断作業域 (SDWA) が使用不能なために、使用不能。
********
内部エラーが発生しました。
10-82
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
TYCA hhhhhhhh hhhhhhhh
再試行アドレス (下記の RTRY hhhhhhhh を参照)、およびルーチンが STAE ま
たは ESTAE のどちらであるのかを示す標識 (下記の RTCA hhhhhhhh を参
照)。
RF hhhhhhhh
FLG hhhhhh
ERRT hhhhhhhh
SDWA の SDWAFLGS フィールドから得られたエラー・フラグ。
RC hh
戻りコード
RTRY hhhhhhhh
次のいずれかです。
hhhhhhhh
FRR によって提供されたアドレス。
N/A
該当なし。4 以外の FRR 戻りコードを示します。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
RTCA hhhhhhhh
リカバリー・ルーチンが STAE または ESTAE のいずれであったのかを示しま
す。
SVC および SVCR トレース・レコード
目的
SVC レコードは監視プログラム呼び出し (SVC) 割り込みを表します。 SVCR レコ
ードは、監視プログラム呼び出しからの出口を表します。また、SDSP 割り込み
は、ラベル SDSP の SVC 出口レコードも作成します。DSP オプションと SVC オ
プションの両方が有効な場合は、 IPCS によって SVCR フォーマットのトレース・
レコードが生成されます。
トレース・データに SVC 出口レコードが含まれている場合、定様式出力に表示さ
れるラベルは、IPCS の間に選択されたオプションによって異なります。
1. IPCS ダイアログ内で SVC オプションを選択すると、SVC 出口レコードと
SVC 番号はラベル SVCR とともに表示されます。
2. IPCS ダイアログで DSP オプションのみを選択しても、定様式出力レコードに
変化はありません。つまり、定様式出力には DSP ラベルと SDSP ラベルが表示
され、 SVC 番号は表示されません。
3. IPCS で DSP オプションと SVC オプションの両方がアクティブである場合
は、SVCR および SVC 番号が表示されます。
つまり、IPCS のフォーマット設定時に選択されたオプションの 1 つが SVC であ
る場合、すべての SVC 出口レコードはラベル SVCR および SVC 番号とともに表
示されることになります。
SVC および SVCR トレース・レコードのフォーマットは、トレースされる SVC
割り込みによって決まります。各 SVC について GTF が収集する情報の分類につ
いては、「z/OS MVS 診断: 解説書」の SVC Summary の章を参照してください。
ここで示されているフォーマットは典型的なものです。
第 10 章 汎用トレース機能 (GTF)
10-83
汎用トレース機能
最小限のトレース・レコード・フォーマット
SVC
CODE.... hhh
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh
hhhhhhhh TCB..... hhhhhhhh R15..... hhhhhhhh
R0...... hhhhhhhh R1...... hhhhhhhh
SVCR
CODE.... hhh
ASCB.... hhhhhhhh CPU..... hhhh
PSW..... hhhhhhhh
hhhhhhhh TCB..... hhhhhhhh R15..... hhhhhhhh
R0...... hhhhhhhh R1...... hhhhhhhh
広範囲のトレース・レコード・フォーマット
SVC..... hhh
SVCR..... hhh
ASCB.... hhhhhhhh CPU..... hhhh
OLD-PSW. hhhhhhhh hhhhhhhh
MODN.... yyyyyyyy
JOBNAME. cccccccc
TCB..... hhhhhhhh
ASCB.... hhhhhhhh CPU..... hhhh
JOBNAME. cccccccc
OLD-PSW. hhhhhhhh hhhhhhhh
TCB..... hhhhhhhh
MODN.... yyyyyyyy R15..... hhhhhhhh R0..... hhhhhhhh
R1..... hhhhhhhh
SVC CODE hhh
SVC hhh
SVC 割り込みコード (SVC 番号とも呼ばれます)。
ASCB hhhhhhhh
割り込みが発生したアドレス・スペースの ASCB のアドレス。
CPU hhhh
割り込みが発生したプロセッサーのアドレス。
JOBNAME cccccccc
次のいずれかです。
cccccccc
SVC 割り込みに関連したジョブの名前。
SSSSSSSS
使用不能。セキュリティーを考慮し、GTF は SVC に関するデ
ータを提供できません。
********
内部エラーが発生しました。
PSW hhhhhhhh hhhhhhhh
OLD-PSW hhhhhhhh hhhhhhhh
割り込み発生時のプログラム状況ワード。
TCB hhhhhhhh
割り込みを受けたタスクの TCB のアドレス、すなわち SVC 命令を出したタス
ク。
R15 hhhhhhhh
R0 hhhhhhhh
R1 hhhhhhhh
SVC 命令を実行したときの汎用レジスター 15、0、および 1 の中のデータ。
MODN cccccccc
cccccccc は次のいずれかです。
mod_name
タスクがディスパッチされるときに制御を受け取るモジュールの名前。
10-84
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
SVC-T2
中核に入っているタイプ 2 の SVC ルーチンを示します。
SVC-RES
タイプ 3 の SVC ルーチン、またはタイプ 4 の SVC ルーチンの最初のロ
ード・モジュールを示します。このルーチンは、ページング可能リンク・パ
ック域 (PLPA) に入っています。
SVC cccc
タイプ 4 の SVC ルーチンの 2 番目以降のロード・モジュールを示しま
す。このルーチンは、固定またはページング可能リンク・パック域 (LPA)
に入っています。ロード・モジュール名の最後の 4 文字は cccc です。
**IRB****
関連する割り込み要求ブロックのある非同期ルーチンを示します。モジュー
ル名は使用不能です。
*cccccc
エラー・リカバリー・モジュールを示します。ロード・モジュール名の最後
の 7 文字は cccccc です。
PPPPPPPP
ページ不在が発生しました。
********
内部エラーが発生しました。
DDNAM cccccc
SVC に関連した DD ステートメントの名前 (該当するものがある場合)。
追加フィールド
SVC 番号によって異なります。これらのフィールドについては、「z/OS
MVS 診断: 解説書」の SVC の説明を参照してください。
USR トレース・レコード
目的
USR レコードは、GTRACE マクロの処理を表します。このレコードは、ユーザー
提供のフォーマット設定ルーチン (AMDUSRhh) によってフォーマット設定されま
す。ルーチンが提供されていない場合には、GTF はフォーマット設定を行わずにレ
コードを印刷します。
このトピックでは、不定様式および定様式のレコードを示し、さらに GTRACE マ
クロによって IBM コンポーネント内に作成される以下の USR レコードの例を示
します。
v VSAM 用の USRF9 トレース・レコード
v BSAM、QSAM、BPAM、および BDAM 用の USRFE トレース・レコード
v オープン、クローズ、およびボリュームの終わり (EOV) 用の USRFF トレー
ス・レコード
VTAM 用の USRFD トレース・レコードは、「z/OS Communications Server: SNA
Diagnosis Vol 1, Techniques and Procedures」に説明されています。
第 10 章 汎用トレース機能 (GTF)
10-85
汎用トレース機能
USR レコードには、レコードをフォーマット設定するために使用できるレコードと
ルーチンを作成するユーザー・プログラム、MVS コンポーネント、または IBM プ
ロダクトを識別するために役立つ、以下の情報が含まれています。
v イベント ID (EID) は、レコードを作成したイベントを識別します。 USR トレ
ース・レコード用の EID および関連プロダクトのリストについては、 10-92 ペ
ージの『USR トレース・レコード用のイベント ID (EID)』を参照してくださ
い。USR レコード用の各 EID は E で始まるため、不定様式の USR レコードで
は、 EID のうちの E の後の最後の 3 文字だけが示されます。
v フォーマット ID (FID) は、システムが USR トレース・レコードのフォーマッ
ト設定に使用したルーチンを識別します。FID および関連のルーチンのリストに
ついては、 10-93 ページの『USR トレース・レコード用のフォーマット ID
(FID)』を参照してください。
不定様式 USR トレース・レコード
目的
不定様式ユーザー・トレース・レコードは、フォーマット設定ルーチンが提供され
なかった場合の GTRACE マクロの処理を表します。
レコード・フォーマット
USR AID hh FID hhhh EID hhhh hhhhhhhh hhhhhhhh ....
AID hh
アプリケーション ID。これは常に AID FF になっているはずです。
FID hhhh
このレコードをフォーマット設定したルーチン (AAMDUSRhh) のフォーマット
ID。ユーザー・トレース・レコード用の FID および関連のフォーマット設定ル
ーチンのリストについては、 10-93 ページの『USR トレース・レコード用のフ
ォーマット ID (FID)』を参照してください。
EID hhhh
レコードを作成したイベントを識別するイベント ID。 USR トレース・レコー
ド用の EID および関連プロダクトのリストについては、 10-92 ページの『USR
トレース・レコード用のイベント ID (EID)』を参照してください。
hhhhhhhh hhhhhhhh ....
記録されたデータ (最大 268 バイト)。データは以下のとおりです。
v バイト 0-3: ASCB アドレス
v バイト 4-11: ジョブ名
v バイト 12-256: ユーザー・データ
定様式 USR トレース・レコード
目的
定様式ユーザー・トレース・レコードは、AMDUSRhh フォーマット設定ルーチンが
提供された場合の GTRACE マクロの処理を表します。
10-86
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
レコード・フォーマット
USRhh hhh ASCB hhhhhhhh JOBN cccccccc
xxxx ...
USRhh
ユーザー提供のフォーマット設定ルーチン (AMDUSRhh) を識別します。下記の
USR レコードはシステム・コンポーネントによって生成およびフォーマット設
定されるもので、この後のトピックで説明されています。
v VSAM 用の USRF9 トレース・レコード
v VTAM 用の USRFD トレース・レコード
v BSAM、QSAM、BPAM、および BDAM 用の USRFE トレース・レコード
v オープン/クローズ/EOV 用の USRFF トレース・レコード
hhh
GTRACE マクロで指定されたイベント ID (EID) の最後の 3 桁。USR トレー
ス・レコード用の EID および関連プロダクトのリストについては、 10-92 ペー
ジの『USR トレース・レコード用のイベント ID (EID)』を参照してください。
ASCB hhhhhhhh
レコードを作成したアドレス・スペースの ASCB のアドレス。
JOBN cccccc
アドレス・スペースに関連したジョブの名前。
xxxx ...
ユーザーがフォーマット設定したトレース・データ。
VSAM 用の USRF9 トレース・レコード
目的
USRF9 トレース・レコードは、VSAM データ・セットのオープンまたはクローズ
を表します。
レコード・フォーマット
USRF9 FF5
ASCB hhhhhhhh JOBN cccccc
JOB NAME cccccc STEP NAME cccccc
TIOT ENT hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
ACB
hhhhhhhh hhhhhhhh hhhhhhhh...
hhhhhhhh hhhhhhhh hhhhhhhh...
AMBL
hhhhhhhh hhhhhhhh hhhhhhhh...
hhhhhhhh hhhhhhhh hhhhhhhh...
AMB
hhhhhhhh hhhhhhhh hhhhhhhh...
hhhhhhhh hhhhhhhh hhhhhhhh...
AMDSB
hhhhhhhh hhhhhhhh hhhhhhhh...
hhhhhhhh hhhhhhhh hhhhhhhh...
AMB
hhhhhhhh hhhhhhhh hhhhhhhh...
hhhhhhhh hhhhhhhh hhhhhhhh...
AMDSB
hhhhhhhh hhhhhhhh hhhhhhhh...
hhhhhhhh hhhhhhhh hhhhhhhh...
第 10 章 汎用トレース機能 (GTF)
10-87
汎用トレース機能
USRF9
VSAM のトレース・レコード・フォーマット設定ルーチン (AMDUSRF9) を識
別します。
FF5
GTRACE マクロで指定されたイベント ID (EID) の最後の 3 桁。USR トレー
ス・レコード用の EID および関連プロダクトのリストについては、 10-92 ペー
ジの『USR トレース・レコード用のイベント ID (EID)』を参照してください。
ASCB hhhhhhhh
イベントが発生したアドレス・スペースの ASCB のアドレス。
JOBN cccccc
JOB NAME cccccc
ジョブの名前。
STEP NAME cccccc
イベントが発生したジョブ・ステップの名前。
TIOT ENT hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
タスク入出力テーブル (TIOT) から得られたデータ・セット項目。
ACB hhhhhhhh ...
データ・セットのアクセス方式制御ブロック (ACB) の内容。
AMBL hhhhhhhh ...
AMB リスト (AMBL) の内容。
AMB hhhhhhhh ...
アクセス方式ブロックの (AMB) の内容。最初の AMB はデータを表し、2 番
目の AMB は索引を表します。
AMDSB hhhhhhhh ...
アクセス方式統計ブロックの (AMDSB) の内容。最初の AMDSB はデータを表
し、2 番目の AMDSB は索引を表します。
VTAM 用の USRFD トレース・レコード
参照
USRFD トレース・レコードの例については、「z/OS Communications Server: SNA
Diagnosis Vol 1, Techniques and Procedures」を参照してください。
BSAM、QSAM、BPAM、および BDAM 用の USRFE トレース・レコード
目的
USRFE トレース・レコードは、BSAM、QSAM、BPAM、または BDAM に関する
アクセス方式ルーチンの異常終了を表します。
10-88
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
レコード・フォーマット
USRFE hhh ASCB hhhhhhhh JOBN cccccc
BSAM/QSAM/BPAM/BDAM TRACE RECORD DDNAME cccccc ABEND CODE hh
cccc...[AT LOCATION hhhhhhhh]
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh ...
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh ...
USRFE
トレース・レコード・フォーマット設定ルーチン (AMDUSRFE) を識別しま
す。
hhh
GTRACE マクロで指定されたイベント ID (EID) の最後の 3 桁。USR トレー
ス・レコード用の EID および関連プロダクトのリストについては、 10-92 ペー
ジの『USR トレース・レコード用のイベント ID (EID)』を参照してください。
イベント ID (EID) は、以下のように、システム完了コードと対応しています。
EID
FF3
FF4
FF6
FF7
FF8
FF9
FFA
FFB
FFC
FFD
FFE
コード
002
008
112
215
119
235
239
145
251
451
169
ASCB hhhhhhhh
異常終了が発生したアドレス・スペースの ASCB のアドレス。
JOBN cccccc
アドレス・スペースに関連したジョブの名前。
BSAM/QSAM/BPAM/DBAM TRACE RECORD
AMDUSRFE フォーマット設定ルーチンで提供されたレコード識別。
DDNAME cccccc
処理されるデータ・セットに関する DD ステートメントの名前。
ABEND CODE hhh
タスクの異常終了に関するシステム完了コード。
RETURN CODE hh
エラー条件が検出されたモジュールからの戻りコード。
TIME=dd.dd.dd
GTRACE マクロが処理されたときの時刻 (時間.分.秒)、または、時刻が使用不
能な場合にはブランク。
ccc...[AT LOCATION hhhhhhhh]
第 10 章 汎用トレース機能 (GTF)
10-89
汎用トレース機能
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh ...
データ・エリアの名前、または名前とアドレスに、データ・エリアの内容が続い
たもの。
オープン/クローズ/EOV 異常終了用の USRFF トレース・レコード
目的
この USRFF トレース・レコードは、オープン、クローズ、またはボリュームの終
わり (EOV) のときに発生した異常終了を表します。
レコード・フォーマット
USRFF
FFF
ASCB hhhhhhhh JOBN cccccc
xxxx ...
USRFF
オープン/クローズ/EOV トレース・レコードのフォーマット設定ルーチン
(IMDUSRFF) を識別します。
FFF
GTRACE マクロで指定されたイベント ID (EID) の最後の 3 桁。USR トレー
ス・レコード用の EID および関連プロダクトのリストについては、 10-92 ペー
ジの『USR トレース・レコード用のイベント ID (EID)』を参照してください。
xxxx ...
不定様式 RRCBSA (リカバリー・ルーチン制御ブロック保管域)。
ユーザー要求作業域用の USRFF トレース・レコード
目的
USRFF トレース・レコードは、作業域トレースに関するユーザー要求を表します。
レコード・フォーマット
USRFF
DCB
WKAREA1
WKAREA2
WKAREA3
WKAREA4
WKAREA5
WTG TBL
FFF
xxxx
xxxx
xxxx
xxxx
xxxx
xxxx
xxxx
ASCB hhhhhhhh JOBN cccccc
...
...
...
...
...
...
...
USRFF
オープン/クローズ/EOV トレース・レコードのフォーマット設定ルーチン
(IMDUSRFF) を識別します。
FFF
GTRACE マクロで指定されたイベント ID (EID) の最後の 3 桁。ユーザー・ト
レース・レコード用の EID および関連プロダクトのリストについては、 10-92
ページの『USR トレース・レコード用のイベント ID (EID)』を参照してくださ
い。
10-90
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
DCB
データ制御ブロック。
WKAREA1
ボリューム・ラベル、ファイル・ラベル、DSCB、またはメッセージ領域。z/OS
DFSMS Using Magnetic Tapesを参照してください。
WKAREA2
ジョブ・ファイル制御ブロック。
WKAREA3
オープン/クローズ/EOV 用の内部制御ブロック。これらのブロックは、データ
制御ブロック (DCB)、データ・エクステント・ブロック (DEB)、および入出力
ブロック (IOB) です。
WKAREA4
WKAREA5
オープン/クローズ/EOV の CSECT 間での制御権移動に使用される移動先テー
ブル。
XSCH トレース・レコード
目的
XSCH レコードは、サブチャネル取り消し操作を表します。
レコード・フォーマット
XSCH.... ddddd
ASCB.... aaaaaaaa CPUID... cccc
SID..... ssssssss CC...... cc
IOSLVL.. ll
UCBLVL.. ll
BASE.... bbbb
JOBN.... jjjjjjjj
DVRID... dd
UCBWGT.. ww
XSCH sdddd
XSCH が実行されたサブチャネル・セット ID がある装置番号。 ASCB aaaaaaaa
ASCB のアドレス。
CPU cccc
プロセッサーのアドレス。
JOBN jjjjjjjj
入出力操作に関連するジョブの名前。
SID ssssssss
UCB の UCBSID フィールドからのサブチャネル ID。
CC cc
XSCH 要求の条件コード。
DVRID dd
取り消しが試みられている要求の IOSB ドライバー ID フィールド
(IOSDVRID)。
IOSLVL ll
入出力要求の逐次化を行う機能レベル。この値は、IOSB の IOSLEVEL フィー
ルドから得られます。
第 10 章 汎用トレース機能 (GTF)
10-91
汎用トレース機能
UCBLVL ll
UCB の UCBLEVEL フィールドから得られた UCB レベル値。
UCBWGT ww
UCB の UCBWGT フィールドから得られたフラグ。
BASE bbbb
装置が PAV の場合は基本装置番号。
USR トレース・レコード用のイベント ID (EID)
GTF トレース・レコード内のイベント ID (EID) は、レコードを作成したイベント
を識別する 2 バイトの 16 進数です。この ID を使用して、レコードを作成した製
品を識別することができます。
次の表は、完全な 2 バイト EID を表していますが、USR レコード用の EID は E
で始まるため、多くの不定様式 USR レコードでは EID のうちの、E の後の最後の
3 桁の EID だけが示されています。FF5 などの 3 桁の EID がある場合には、下
の表から EFF5 を探してください。
EID
(16 進数)
E000-E3FF
E400-E5F0
E5F1
E5F2-E5F3
E5F4-E5F5
E5F6-EF43
E544-EF45
EF1D-EF1F
EF46-EF47
EF48
EF49
EF4F
EF50-EF52
EF53
EF54-EF5D
EF5E
EF5F
EF60
EF61
EF62
EF63
記号名
EF64
EF65
EF66-EF6A
EF6C
EFAA
EFAB-EFAE
EFAF-EFE0
EFE1
10-92
IMDGPD01IMDGPD50
ISTVIEID
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
発行元
GTF ユーザー・プログラム
IBM が使用するために予約済みです
PVM
IBM が使用するために予約済みです
NetView® System Monitor
IBM が使用するために予約済みです
RACF
MVS ジョブ管理 - 動的割り振り (SVC 99)
IBM が使用するために予約済みです
IOS
BDT
OSAM
IBM が使用するために予約済みです
OSI
FSI
IBM が使用するために予約済みです
DB2
JES3
VSAM バッファー・マネージャー
動的出力 SVC インストール・システム出口
コンバーター / インタープリター・インスト
ール・システム出口
APPC/VM VTAM サポート (AVS)
GETMAIN FREEMAIN STORAGE トレース
(MVS)
VTAM
CICS
VTAM VM/SNA コンソール・サービス
(VSCS)
IBM が使用するために予約済みです
IBM
VTAM
汎用トレース機能
EID
(16 進数)
EFE2
EFE3
EFE4
EFE5-EFEE
EFEF
EFEF
EFF0
EFF1
EFF2
EFF3
EFF4
EFF5
EFF6
EFF7
EFF8
EFF9
EFFA
EFFB
EFFC
EFFC
EFFE
EFFF
記号名
ISTTHEID
ISTTREID
ISTTDEID
ISTTPEID
ISTTPEID
ISTRPEID
ISTCLEID
ISTLNEID
IGGSP002
IGGSP008
IDAAM01
IGGSP112
IGGSP215
IGGSP119
IGGSP235
IGGSP239
IGGSP145
IGGSP251
IGGSP451
IGGSP169
IHLMDMA1
発行元
VTAM
VTAM
VTAM
JES2
VTAM
VTAM
VTAM
VTAM
VTAM
SAM/PAM/DAM
SAM/PAM/DAM
VSAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
SAM/PAM/DAM
OPEN/CLOSE/EOV
USR トレース・レコード用のフォーマット ID (FID)
GTF トレース・レコード内のフォーマット ID (FID) は、USR レコードのフォーマ
ット設定に使用できる GTFTRACE モジュールの名前を決めるために使用される、1
バイトの 16 進数です。USR トレース・レコードのフォーマット設定についての
GTFTRACE フォーマット設定の付加に関する情報は、「z/OS MVS IPCS カスタマ
イズ 」を参照してください。
FID
(16 進数)
EID
発行元
オプションのフォーマット設定モジュール
00
E000-EFE4
ユーザー / コンポーネン
ト
AHLFINIT 内の CSECT AHLFFILT
01-50
E000-E3FF
ユーザー
IMDUSR または AMDUSR (01-50)
57
EF44-EF45
RACF
AMDUSR57
81
VMSI
IMDUSR81 または AMDUSR81
84
VMSI/VTAM
IMDUSR84 または AMDUSR84
DC
PVM
IMDUSRDC または AMDUSRDC
E2-E3
PSF/MVS
IMDUSRE2-IMDUSER3 または
AMDUSRE2-AMDUSER3
E6
OSI
IMDUSRE6 または AMDUSRE6
E8
FSI
IMDUSRE8 または AMDUSRE8
E9
DB2/VSAM
IMDUSRE9 または AMDUSRE9
第 10 章 汎用トレース機能 (GTF)
10-93
汎用トレース機能
FID
(16 進数)
発行元
EID
オプションのフォーマット設定モジュール
EB
APPC/VM VTAM サポー IMDUSREB または AMDUSREB
ト (AVS)
EC
VTAM
IMDUSREC または AMDUSREC
F5
VTAM/VSCS
IMDUSRF5 または AMDUSR5
F9
EFF5
VSAM
IMDUSRF9 または AMDUSRF9
FD
EFEF-EFF2
VTAM
IMDUSRFD または AMDUSRFD
FE
EFF3-EFF4
SAM/PAM/DAM
IMDUSRFE または AMDUSRFE
OPEN/CLOSE/EOV
IMDUSRFF または AMDUSRFF
EFF6-EFFE
FF
EFFF
不定形式の GTF トレース出力
このトピックでは、IPCS またはその他のルーチンによってフォーマット設定されて
いない GTF 出力レコードについて説明します。この情報を使用して、ユーザー独
自のフォーマット設定ルーチンまたは分析ルーチンを作成できます。
注: GTF が以下のレコードのフィールドに通常入っているデータを入手できないと
きには、そのフィールドに以下の値のいずれかを入れることによって、次のこ
とを知らせます。
v C’U/A’。フィールドを埋めるために右側にブランクが追加されています。
v C’*’。フィールドを埋めるためにアスタリスクが繰り返されています。
出力レコードには、次のようないくつかのタイプがあります。
v 制御レコード ( 10-95 ページの『制御レコード』を参照)。
v データ脱落レコード ( 10-96 ページの『不定様式の消失イベント・レコード』を参
照)。
v ユーザー・データ・レコード ( 10-97 ページの『ユーザー・データ・レコード』を
参照)。
v システム・データ・レコード ( 10-99 ページの『システム・データ・レコード』を
参照)。
データ脱落レコード、ユーザー・データ・レコード、およびシステム・データ・レ
コードは、すべてオプションのフィールドを含んでいます。これらのフィールド
は、特定の条件のもとでのみ示されます。それらの条件については、該当フィール
ドの説明を参照してください。ユーザーのフォーマット設定ルーチンまたは分析ル
ーチンでは、これらの変数フィールドを考慮するようにしてください。
このセクションでは、個々のイベントに関する GTF システム・データ・レコード
についても説明します。 10-101 ページの『CCW トレース・レコード』から
10-115 ページの『SVC の最小限トレース・レコード』までを参照してください。
10-94
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
制御レコード
GTF は、トレース出力の各ブロックの最初の部分に制御レコードを作成します。制
御レコードの後には、データ脱落レコード、ユーザー・データ・レコード、および
システム・データ・レコードを続けることができます。このトレース出力が IPCS
COPYTRC サブコマンドによって複数のシステムからのトレース・データを組み合
わせたものである場合、制御レコードはすべてのシステムから得られた有効な GTF
オプションの結合を反映しています。
参照
COPYTRC サブコマンドについての詳細は、「z/OS MVS IPCS コマンド」を参照し
てください。
図 10-4 は、制御レコードのフォーマットを示しています。
┌─────┬─────┬─────┬─────┬────────┬────────────────┬──────────┐
│長さ │予約 │ AID │ FID │ 時間帯 │タイム・スタンプ│オプション│ ... ソース記述子 ...
└──┬──┴──┬──┴──┬──┴──┬──┴────┬───┴────────┬───────┴────┬─────┘
2
2
1
1
4
8
8
バイト バイト バイト バイト バイト
バイト
バイト
図 10-4. 不定形式制御レコード
制御レコード内のフィールドには、以下の情報が含まれています。
長さ
レコードの全長 (バイト単位)。
予約
2 バイトのゼロ。IBM が使用するために予約済み。
AID
アプリケーション ID。制御レコードの場合には、常にゼロです。
FID
このレコードをフォーマット設定するルーチンのフォーマット ID。制御レコー
ドの場合には、常に X'01' です。
時間帯
ローカル時刻とグリニッジ標準時 (GMT) の差を示す、1.048576 秒刻みの 2 進
単位の値。
タイム・スタンプ
制御レコードが作成されたときのグリニッジ標準時 (GMT) を示す、8 バイトの
タイム・スタンプ。
オプション
以下の情報を含む 8 バイト・フィールド。
最初の 5 バイトは、トレース出力のブロックに関して有効な GTF オプション
を識別します。マッピング・マクロ AHLZGTO については、 z/OS MVS Data
Areas, Vol 2 (DCCB-ITZYRETC) を参照してください。
残りの 3 バイトには、以下の重要なフラグがビット範囲 0 から 7 までで示さ
れます。
第 10 章 汎用トレース機能 (GTF)
10-95
汎用トレース機能
GTWCFSID - バイト 6、ビット 6
1 - 個々のトレース・レコードに、複数のシステムから得られた GTF トレ
ース・データが IPCS COPYTRC コマンドで組み合わされたことを示す
SID (システム ID) がある場合。この場合、システムごとに 1 つずつ、複
数のソース記述子が作られます。ソース記述子は、システム ID (SID) 別に
順に範囲が決められています。SID フィールド内の値を配列指標として使用
し、特定システムのソース記述子を見付けてください。
ソース記述子の情報は、単一トレース・データ・セットのすべての制御レコ
ードで同一です。
0 - トレース・レコードに SID が含まれていない場合。
GTWCFNEW - バイト 6、ビット 7
1 - トレース・データのこのブロックが MVS/ESA SP™ バージョン 4 以降
のシステムによって書き込まれた場合。
0 - データのこのブロックが MVS/ESA バージョン 4 よりも前のシステム
で書き込まれた場合。
ソース記述子
トレース・データのこのブロックに入っているレコードの起源に関する情報 (た
とえば、トレース・データを発行したシステムのリリース・レベルや有効な
GTF オプション) を示す、1 つまたは複数の配列。 GTF トレース・データが
複数のシステムからのトレース・データを組み合わせたものである場合には、シ
ステムごとに 1 つずつ、複数のソース記述子が作られます。SID フィールド内
の値を配列指標として使用し、特定システムのソース記述子を見付けてくださ
い。
マッピング・マクロ AHLZGTS のソース記述子のフォーマットに関する情報に
ついては、「z/OS MVS Data Areas, Vol 2 (DCCB-ITZYRETC) 」を参照してくだ
さい。
不定様式の消失イベント・レコード
消失イベント・レコードは、エラーまたはトレース・バッファーのオーバーフロー
によって、 1 つまたは複数のイベントに関する GTF のトレース・レコードが失わ
れていることを示します。 図 10-5 は、消失イベント・レコードのフォーマットを
示しています。
┌─────┬─────┬─────┬─────┬────────┬────────────────┬────────┬──────┐
│長さ │ 予約│ AID │ FID │ 時間帯 │タイム・スタンプ│カウント│ SID │
└──┬──┴──┬──┴──┬──┴──┬──┴────┬───┴───────┬────────┴───┬────┴───┬──┘
2
2
1
1
4
8
4
2
バイト バイト バイト バイト バイト
バイト
バイト
バイト
(オプション)
図 10-5. 不定様式の消失イベント・レコード
消失イベント・レコード内のフィールドには、以下の情報が含まれます。
長さ
レコードの全長 (バイト単位)。
予約
2 バイトのゼロ。IBM が使用するために予約済み。
10-96
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
AID
アプリケーション ID。消失イベント・レコードの場合は、常にゼロです。
FID
フォーマット ID。FID の値は、次のいずれかです。
v X'02' (エラーまたはトレース・バッファーのオーバーフローが原因でいくつか
のトレース・レコードが脱落している場合)。
v X'03' (エラーまたはトレース・バッファーのオーバーフローが原因でトレー
ス・レコードのブロック全体が脱落している場合)。
時間帯
ローカル時刻とグリニッジ標準時 (GMT) の差を示す、1.048576 秒刻みの 2 進
単位の値。
タイム・スタンプ
制御レコードが作成されたときのグリニッジ標準時 (GMT) を示す、8 バイトの
タイム・スタンプ。
カウント
FID が X'02' の場合 (いくつかのトレース・レコードが脱落していることを示
しています)、このフィールドには、脱落したトレース・イベントの数が入りま
す。
FID が X'03' の場合 (トレース・データのブロック全体が脱落していることを
示しています)、このフィールドにはゼロが入ります。
SID
このトレース・レコードが作成されたシステムのシステム ID。
この 2 バイト・フィールドは、複数のシステムから得られた GTF トレース・
データが IPCS COPYTRC コマンドによって組み合わされた場合にだけ表示さ
れます。SID が存在する場合、それは特定システムに関するソース記述子情報
を見付けるために使用できる配列指標です。たとえば、あるレコードの SID 値
が 3 になっている場合、そのレコードを発行したシステムのソース記述子情報
は、制御レコード内の 3 番目のソース記述子です。
出力のブロックのトレース・データが複数のシステムから得られたものであるの
かどうかを調べるには、制御レコードのオプション・フィールドで GTWCFSID
ビットがオンに設定されているかどうかを調べてください。オプション・フィー
ルドについては、10-95 ページを参照してください。
ユーザー・データ・レコード
このトピックでは、GTRACE マクロを使用して要求されるユーザー・トレース・レ
コードのフォーマットについて説明します。
GTRACE を使用するアプリケーションで 256 バイトを超えるデータが指定されて
いる場合には、ユーザー・レコードは分割されることがあります。ユーザー・トレ
ース・レコードが分割レコードの場合、AID の値は X'F0'、X'F1'、または X'F2' に
なっています。分割レコードには、オプションのシーケンス・フィールドと全長フ
ィールドが含まれます。
このレコードの一般フォーマットは、 10-98 ページの図 10-6 のとおりです。
第 10 章 汎用トレース機能 (GTF)
10-97
汎用トレース機能
┌──────┬─────┬─────┬─────┬────────────────┬─────┬──────────┬──────────┬─────────┬─────┬────────┐
│ 長さ │ 予約│ AID │ FID │タイム・スタンプ│ EID │
SID
│シーケンス│
全長 │ ASCB│ジョブ名│ ... データ ...
└──┬───┴──┬──┴──┬──┴──┬──┴───────┬────────┴──┬──┴────┬─────┴────┬─────┴─────┬───┴──┬──┴───┬────┘
2
2
1
1
8
2
2
2
4
4
8
バイト バイト バイト バイト
バイト
バイト バイト
バイト
バイト バイト バイト
(オプション)(オプション)(オプション)
図 10-6. 不定様式ユーザー・トレース・レコードのフォーマット
レコード内のフィールドには、以下の情報が含まれます。
長さ
レコードの全長 (バイト単位)。
予約
2 バイトのゼロ。IBM が使用するために予約済み。
AID
次のいずれかのアプリケーション ID。
v X'FF'-- 非分割レコード
v X'F0'-- 一連の分割レコードのうちの最初のレコード
v X'F1'-- 一連の分割レコードのうちの中間のレコード
v X'F3'-- 一連の分割レコードのうちの最後のレコード
FID
トレース・レコードをフォーマット設定するルーチンのフォーマット ID。 FID
および関連のフォーマット設定ルーチンのリストについては、 10-93 ページの
『USR トレース・レコード用のフォーマット ID (FID)』を参照してください。
タイム・スタンプ
レコードが作成されたときのグリニッジ標準時 (GMT) を示す、8 バイトのタイ
ム・スタンプ。
EID
トレース・レコードを作成したイベントを識別するイベント ID。ユーザー・ト
レース・レコード用の EID および関連プロダクトのリストについては、 10-92
ページの『USR トレース・レコード用のイベント ID (EID)』を参照してくださ
い。
SID
レコードが作成されたシステムを識別するシステム ID。この 2 バイト・フィ
ールドは、以下の場合にだけ示されます。
v 複数のシステムから得られた GTF トレース・データが IPCS COPYTRC コ
マンドで組み合わされた場合。
v そのレコードが分割レコードである場合。この分割レコードを含んでいるト
レース・データが複数のシステムから組み合わされたものでない場合には、
分割レコードに関する SID フィールドにはゼロが入ります。
組み合わされたトレース・データから得られた SID を配列指標として使用し、
特定システムのソース記述子情報を見付けることができます。たとえば、あるレ
コードの SID 値が 3 になっている場合、そのレコードを発行したシステムの
ソース記述子情報は、制御レコード内の 3 番目のソース記述子です。
出力のブロックのトレース・データが複数のシステムから得られたものであるの
かどうかを調べるには、制御レコードのオプション・フィールドで GTWCFSID
10-98
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
ビットがオンに設定されているかどうかを調べてください。オプション・フィー
ルドについては、10-95 ページを参照してください。
シーケンス
この分割レコードのシーケンス番号 (16 進数)。このフィールドは分割レコード
の場合にだけ示されます。
全長
分割トレース・データの全長。このフィールドは分割レコードの場合にだけ示さ
れます。
ASCB
GTRACE マクロを発行したアドレス・スペースのアドレス・スペース制御ブロ
ック (ASCB) のアドレス。
ジョブ名
GTRACE マクロが発行されたタスクと関連するジョブの名前。
データ
要求されたイベントに関して収集されたトレース・データが入っています。この
フィールドの長さは、トレースされるイベントに応じて異なります。ユーザー・
レコードのデータ・フィールド内のデータのバイト数は、GTRACE マクロで指
定されたバイト数と同じです。
システム・データ・レコード
GTF は、GTF トレースの要求時にユーザーが選択した各システム・イベントのトレ
ース・レコードを作成します。イベントのシステム・データ・レコードのヘッダー
部分は、 図 10-7 に示されています。個々のシステム・データ・レコードのフォー
マットは、 10-100 ページの『イベントの不定様式トレース・レコード』でアルファ
ベット順に示されています。このセクションには、必ずしもすべてのシステム・イ
ベントは含まれていませんので、ご注意ください。
┌─────┬─────┬─────┬─────┬─────────────────┬─────┬──────────┐
│長さ │ 予約│ AID │ FID │ タイム・スタンプ│ EID │
SID
│ ... データ ...
└──┬──┴──┬──┴──┬──┴──┬──┴────────┬────────┴──┬──┴────┬─────┘
2
2
1
1
8
2
2
バイト バイト バイト バイト
バイト
バイト バイト
(オプション)
図 10-7. 不定様式システム・トレース・レコード・フォーマットのヘッダー
レコード内のフィールドには、以下の情報が含まれます。
長さ
レコードの全長 (バイト単位)。
予約
2 バイトのゼロ。IBM が使用するために予約済み。
AID
アプリケーション ID。システム・データ・レコードの場合には、常に X'FF' で
す。
FID
トレース・レコードをフォーマット設定するルーチンのフォーマット ID。
第 10 章 汎用トレース機能 (GTF)
10-99
汎用トレース機能
タイム・スタンプ
レコードが作成されたときのグリニッジ標準時 (GMT) を示す、8 バイトのタイ
ム・スタンプ。
EID
トレース・レコードを作成したイベントを識別するイベント ID。
SID
レコードが作成されたシステムを識別するシステム ID。レコードが分割レコー
ドの場合には SID フィールドにはゼロが入ります。この 2 バイト・フィール
ドは、複数のシステムから得られた GTF トレース・データが IPCS COPYTRC
コマンドによって組み合わされた場合にだけ作成されます。SID が存在する場
合、それは特定システムに関するソース記述子情報を見付けるために使用できる
配列指標です。たとえば、あるレコードの SID 値が 3 になっている場合、そ
のレコードを発行したシステムのソース記述子情報は、制御レコード内の 3 番
目のソース記述子です。
出力のブロックのトレース・データが複数のシステムから得られたものであるの
かどうかを調べるには、制御レコードのオプション・フィールドで GTWCFSID
ビットがオンに設定されているかどうかを調べてください。オプション・フィー
ルドについては、10-95 ページを参照してください。
データ
要求されたイベントに関して収集されたトレース・データ。このフィールドの長
さは、トレースされるイベントに応じて異なります。
個々のシステム・トレース・レコードのデータ部分は、『イベントの不定様式ト
レース・レコード』以降に示されています。
イベントの不定様式トレース・レコード
このトピックでは、特定のシステム・イベントのレコードをアルファベット順に示
します。ここでは、個々のイベント・レコードに関するデータの不定様式レイアウ
トを示します。レコードのヘッダー・セクションについては、 10-99 ページの『シ
ステム・データ・レコード』を参照してください。このトピックでは、必ずしもす
べてのシステム・イベントが含まれていないことにご注意ください。
トレース・レコード内のフィールドには、以下の特殊標識が含まれることがありま
す。
該当なし
U/A
該当なし。フィールドは、このレコードには適用されません。2 バイト・フ
ィールドでは、該当なしは N/ と示されます。
使用不能。GTF が情報を収集できませんでした。2 バイト・フィールドで
は、使用不能は U/ と示されます。
すべてのデータ・レコードのオフセットは、相対的であって、各フィールドのレコ
ード内の実際のバイト数を反映するものではありません。ヘッダー・セクションの
長さはオプションの SID フィールドが存在するかどうかによって異なるため、オフ
セットは各レコードのデータ部分の先頭部分から始まります。
10-100
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
CCW トレース・レコード
AHLMCWRC データ域の完全なマッピングについては、「z/OS MVS Data Areas,
Vol 3 (IVT-RCWK)」を参照してください。
DSP の広範囲トレース・レコード
TRACE=DSP が GTF オプションとして有効になっている場合、作業単位をディス
パッチするためのタスク・ディスパッチング・プログラムに入ると、GTF は DSP
レコードを作成します。
DSP の広範囲トレース・レコードの FID は X'00' です。この EID は、次のいずれ
かです。
v X'0001' - SRB ディスパッチング機能を表します。
v X'0002' - LSR ディスパッチング機能を表します。
v X'0003' - TCB ディスパッチング機能を表します。
v X'0004' - 終了プロローグのディスパッチング機能を表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
22 (16)
サイズ
4
2
8
8
4
説明
ASCB
CPUID
ジョブ名
新規タスクのための再開 PSW
新規 TCB (LSR および TCB の場合、SRB の場合には
SRB)
8
CDE 名
4
1
パラメーター・アドレス
SRB の場合に限り、SRB ルーチン・タイプ標識
TCB の場合のみ:
26 (1A)
SRB の場合のみ:
26 (1A)
30 (1E)
再ディスパッチされようとしている中断された SRB の
場合には、S
初めてディスパッチされようとしている SRB の場合に
は、I
DSP の最小限トレース・レコード
GTF オプションとして TRACE=SYSM と TRACE=DSP の両方が有効になっている
場合、作業単位をディスパッチするためのディスパッチ・プログラムに入ると、
GTF は DSP 最小限レコードを作成します。
DSP 最小限トレース・レコードの FID は X'03' です。この EID は、次のいずれか
です。
v X'0001' - SRB ディスパッチング機能を表します。
v X'0002' - LSR ディスパッチング機能を表します。
v X'0003' - TCB ディスパッチング機能を表します。
第 10 章 汎用トレース機能 (GTF)
10-101
汎用トレース機能
v X'0004' - 終了プロローグのディスパッチング機能を表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
18 (12)
22 (16)
26 (1A)
30 (1E)
サイズ
4
2
8
4
4
4
4
1
説明
ASCB
CPUID
ディスパッチされる作業単位の再開 PSW
現行 TCB または N/A (TCB および LSR の場合のみ)
レジスター 15
レジスター 0 または SRB
レジスター 1
SRB の場合に限り、SRB ルーチン・タイプ標識
再ディスパッチされようとしている中断された SRB の
場合には、S
初めてディスパッチされようとしている SRB の場合に
は、I
EXT の広範囲トレース・レコード
GTF オプションとして TRACE=SYS または TRACE=EXT のいずれかが有効にな
っている場合、外部割り込みが発生すると GTF は EXT 広範囲レコードを作成し
ます。
EXT の広範囲トレース・レコードの FID は X'02' です。 EID は X'6201' です。
割り込み。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
22 (16)
サイズ
4
2
8
8
4
説明
ASCB
CPUID
ジョブ名
外部旧 PSW
旧 TCB
4
2
PARMFIELD
CPUID
SIGP 割り込みの場合:
26 (1A)
30 (1E)
時刻比較機構割り込みの場合:
26 (1A)
28 (1C)
32 (20)
2
4
4
IBM が使用するために予約済み。
TQE 出口
TQE ASCB
CPU タイマー割り込みの場合:
26 (1A)
28 (1C)
10-102
2
4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
IBM が使用するために予約済み。
TQE 出口
汎用トレース機能
EXT の最小限トレース・レコード
GTF オプションとして TRACE=SYSM が有効になっている場合、外部割り込みが
発生すると、 GTF は EXT 最小限レコードを作成します。
EXT 最小限トレース・レコードの FID は X'03' です。X'6201' という EID は外部
割り込みを表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
18 (12)
サイズ
4
2
8
4
4
説明
ASCB
CPUID
外部旧 PSW
割り込みを受けたタスクの TCB または N/A
NTQE TCB または INT CPU または N/A
入出力要約トレース・レコード
GTF オプションとして TRACE=IOX または TRACE=IOXP が有効になっている場
合、入出力割り込みが発生すると、GTF は入出力要約レコードを作成します。PCI
入出力割り込みをトレースするには、TRACE=PCI も有効になっていなければなり
ません。
入出力要約レコードの FID は X’08’ です。この EID は、次のいずれかです。
v X’2100’ - PCI 入出力割り込みを表します。
v X’5107’ - EOS 入出力割り込みを表します。
v X’5202’ - 有効な UCB が指定された入出力割り込みを表します。
v X’5203’ - CS 入出力割り込みを表します。これは、並行検知機能を持つ装置の場
合検知終わりの割り込みを表します。
入出力要約レコードには、常にヘッダー・セクションがあり、それにセクション・
ヘッダーと共通セクションが続いています。セクション・ヘッダーは、以下のセク
ションのタイプと長さを説明し、これがレコードの最後のセクションである場合に
は標識が入ります。
DASD 装置の場合の典型的な入出力要約レコードには、ヘッダー・セクション、共
通セクション、データ・セット・セクション、CMB セクションがあり、それに多く
の場合 1 つまたは複数の CCW セクションがあります。入出力要約レコードが拡張
される場合、続く拡張レコードは 1 より大きいヘッダー・レコード番号をもつヘッ
ダー・セクション、共通セクションおよび 1 つまたは複数の CCW セクションから
構成されます。
ヘッダー・セクション:
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
16 (10)
20 (14)
21 (15)
22 (16)
サイズ
4
2
8
2
4
1
1
2
説明
ASCB
CPUID
ジョブ名
装置番号
システム ID
ドライバー ID
トレース・バージョン
レコード・カウント
第 10 章 汎用トレース機能 (GTF)
10-103
汎用トレース機能
セクション・ヘッダー:
オフセット
0 (0)
サイズ
1
1(1)
1
1... ....
2
2 (2)
説明
セクション・タイプ:
FL1’0’: 共通セクション
FL1’1’: CMB セクション
FL1’3’: CCW オリエンテーション・セクション
FL1’4’: データ・セット・セクション
フラグ ID
このレコードの最後のセクション
セクションの長さ
共通セクション:
オフセット
0 (0)
1(1)
2 (2)
サイズ
1
1
1
3(3)
1
1...
.1..
..1.
...1
6
4
4 (4)
10 (A)
....
....
....
....
説明
装置クラス
装置の状況
エラー・コード: CCW 分析中に発見されたエラーを示
す。詳しくは 10-105 ページの『CCW エラー・コー
ド』 を参照してください。
フラグ・バイト
この入出力イベントの最後のトレース・レコード
予約 (条件付きまたは無条件の)
解放
少なくとも 1 つの検索 CCW
ボリューム通し番号
装置タイプ
データ・セット・セクション:
オフセット
0 (0)
1(1)
2 (2)
サイズ
1
1
44
説明
データ・セット・タイプ
名前の長さ
データ・セット名
サイズ
2
2
4
4
4
4
8
4
4
4
4
4
説明
SSCH 命令の数
データが収集される SSCH 命令の数
装置接続回数の合計
SSCH 要求の保留回数の合計
サブチャネル切断回数の合計
制御装置キュー数の合計
この入出力要求の開始のタイム・スタンプ
装置がアクティブのときだけの時間
SSCH 命令の数
データの収集が行われた SSCH 命令の数
装置使用中回数の合計
初期コマンド応答回数の合計
CMB セクション:
オフセット
0 (0)
2 (2)
4 (4)
8 (4)
12(C)
16 (10)
20 (14)
28 (1C)
32 (20)
36 (24)
40 (28)
44 (2C)
10-104
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
CCW オリエンテーション・セクション:
オフセット
0 (0)
1(1)
2 (2)
3(3)
4 (4)
6 (6)
8(8)
12(C)
16 (10)
18 (12)
20 (14)
21
22
26
27
32
33
34
35
(15)
(16)
(1A)
(1B)
(20)
(21)
(22)
(23)
サイズ
1
1
1... ....
.1.. ....
..1. ....
...1 ....
.... 1...
.... .1..
.... ..1.
.... ...1
1
1... ....
.1.. ....
1
2
2
4
4
2
2
1
11......
..1. ....
...1 ....
.... ..1.
.... ...1
1
4
1
5
1
1
1
2
説明
オリエンテーション・シーケンス番号
フラグ・バイト 1
少なくとも 1 つの SILI ビットがオン
少なくとも 1 つの延期ビットがオン
少なくとも 1 つの PCI
少なくとも 1 つのスキップ・ビットがオン
レコード・ゼロの読み取りまたはホーム・アドレスの読
み取り
予約済み
複数 CKD またはトラックの読み取り
少なくとも 1 つのクリア CCW
フラグ・バイト 2
読み取られたまたは書き込まれたファイルの終わり
少なくとも 1 つのフォーマット書き込み
MCKD のクリア、読み取りの数
読み取りブロック数
書き込みブロック数
読み取りバイト数
書き込みバイト数
データ・チェーン CCW の数
COM チェーン CCW の数
外部グローバル属性
’11’ (唯一の指定可能値)
CKD 変換モード
サブシステム動作モード
キャッシュ高速書き込み
DASD 高速書き込みの禁止
外部グローバル拡張属性
外部エクステント終了 CCH
シーク / ロケート・コード
CCHHR (サーチ ID が等しい)
位置指定パラメーターからの命令コード
パラメーターからのセクター番号
拡張命令コード
拡張パラメーター
CCW エラー・コード:
表 10-5. CCW エラー・コード
エラー・コード
(16 進数)
モジュール名
説明
03
IONOCCW
不良 CCW
04
IOINSPAC
テーブル内のスペースが不十分
05
IOX4K
ターゲットが 4 K 境界をクロスしている
06
IOLASTCC
トレースしない最後の CCW
07
IOSRCHCD
データ・チェーンがあるサーチ CCW
08
IOINSCNT
不十分なカウント
09
IOCPUNAV
チャネル・プログラムが利用不可
0A
IORCKD8
カウント <8 での CKD の読み取り
第 10 章 汎用トレース機能 (GTF)
10-105
汎用トレース機能
表 10-5. CCW エラー・コード (続き)
エラー・コード
(16 進数)
モジュール名
説明
0B
IONOIDAW
必要なところに IDAW がない
0C
IOCSWINV
無効な CSW
0D
IOTICBAD
無効な TIC アドレス
0E
IOEBIDA
ページ境界をクロスした IDAL
0F
IOEBIDAL
IDAL が正しい境界に位置合わせされていない
10
IOMIDNOQ
MIDAW が正しい境界に位置合わせされていない
11
IOMIDZCT
MIDAW にゼロ・カウントがある
12
IOMIDPBD
MIDAW がページ境界をクロスしている (スキッ
プ・ビットがオンの場合は無視される)
13
IOMIDIDA
IDAW と MIDAW のビットが両方オン
入出力トレース・レコード
GTF オプションとして TRACE=SYSM、TRACE=SYS、TRACE=IO、または
TRACE=IOP が有効になっている場合、入出力割り込みが発生すると、GTF は入出
力レコードを作成します。PCI 入出力割り込みをトレースするには、TRACE=PCI
も有効になっていなければなりません。
入出力トレース・レコードの FID は X'07' です。この EID は、次のいずれかで
す。
v X'2100' - PCI 入出力割り込みを表します。
v X'5101' - EOS 入出力割り込みを表します。
v X'5200' - 有効な UCB が指定された入出力割り込みを表します。
v X'5201' - CS 入出力割り込みを表します。これは、並行検知機能を持つ装置の場
合検知終わりの割り込みを表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
16 (10)
24 (18)
44 (2C)
48 (30)
50 (32)
51 (33)
52 (34)
53 (35)
54 (36)
55 (37)
56 (38)
58 (3A)
10-106
サイズ
4
2
8
2
8
20
4
2
1
1
1
1
1
1
2
44
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
説明
ASCB
CPUID
ジョブ名
装置番号
入出力の旧 PSW
IRB ワード 1-5
TCB
センス・バイト
IOSB フラグ (IOSFLA)
IOSB オプション (IOSOPT)
IOS ドライバー ID
IOS レベル
UCB レベル
フラグ (UCBGWT)
基本装置番号
IRB ワード 6-16 (EID X’5201’ の場合のみ)
汎用トレース機能
PI の広範囲トレース・レコード
GTF オプションとして TRACE=PI または TRACE=SYS のいずれかが有効になって
いる場合、プログラム割り込みが発生すると GTF は PI 広範囲レコードを作成しま
す。
PI の広範囲トレース・レコードの FID は X'00' です。この EID は、次のいずれか
です。
v X'6101' - コード 1-17、19、および 128 のプログラム割り込みを表します。
v X'6200' - コード 18 のプログラム割り込みを表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
22 (16)
26 (1A)
30 (1E)
38 (26)
102 (66)
サイズ
4
2
8
8
4
4
8
64
4
説明
ASCB
CPUID
ジョブ名
プログラムの旧 PSW
INT TCB
仮想ページ・アドレス
RB または CDE の名前
IBM が使用するために予約済み。
仮想ページ・アドレスの高位半分。
PI の最小限トレース・レコード
GTF オプションとして TRACE=SYSM が有効になっている場合、プログラム割り
込みが発生すると、 GTF は PI 最小限レコードを作成します。
PI 最小限トレース・レコードの FID は X'03' です。この EID は、次のいずれかで
す。
v X'6101' - コード 1-17、19、および 128 のプログラム割り込みを表します。
v X'6200' - コード 18 のプログラム割り込みを表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
18 (12)
22 (16)
26 (1A)
30 (1E)
サイズ
4
2
8
4
4
4
4
4
説明
ASCB
CPUID
プログラムの旧 PSW
旧 TCB
仮想ページ・アドレス
レジスター 15
レジスター 1
仮想ページ・アドレスの高位半分。
RR の広範囲トレース・レコード
GTF オプションとして TRACE=SYS または TRACE=RR のいずれかが有効になっ
ている場合、リカバリー・ルーチンが呼び出されると GTF は RR 広範囲レコード
を作成します。
RR の広範囲トレース・レコードの FID は X'04' です。この EID は、次のいずれ
かです。
v X'4002' - STAE/ESTAE 呼び出しを表します。
v X'4003' - FRR 呼び出しを表します。
第 10 章 汎用トレース機能 (GTF)
10-107
汎用トレース機能
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
22 (16)
30 (1E)
34 (22)
42 (2A)
46 (2E)
サイズ
4
2
8
8
8
4
8
4
4
説明
ASCB
CPUID
ジョブ名
リカバリー・ルーチンの名前または U/A
エラー発生時の現行 PSW
完了コード
IBM が使用するために予約済み。
再試行アドレスまたは N/A
SDWA のアドレス (STAE/ESTAE のみ)
RR の最小限トレース・レコード
GTF オプションとして TRACE=SYS が有効になっている場合、リカバリー・ルー
チンが呼び出されると、 GTF は RR 最小限レコードを作成します。
RR 最小限トレース・レコードの FID は X'03' です。この EID は、次のいずれか
です。
v X'4002' - STAE/ESTAE 呼び出しを表します。
v X'4003' - FRR 呼び出しを表します。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
18 (12)
22 (16)
25 (19)
サイズ
4
2
8
4
4
3
1
26 (1A)
4
30 (1E)
4
説明
ASCB
CPUID
エラー PSW
完了コード
IBM が使用するために予約済み。
IBM が使用するために予約済み。
リカバリー・ルーチンからの戻りコード (STAE/ESTAE
のみ)
再試行アドレスまたは N/A 注: オフセット 41 に戻
りコードがない場合には、戻りアドレスがオフセット
41 で始まります。
SDWA のアドレス (STAE/ESTAE のみ) 注: オフセッ
ト 41 で戻りアドレスが始まる場合には、SDWA アド
レスがオフセット 45 で始まります。
SLIP トレース・レコード
GTF オプションとして TRACE=SLIP が有効になっている場合、以下のことが発生
すると、 GTF は SLIP トレース・レコードを作成します。
v SLIP トラップが一致し、SLIP コマンドで TRACE または TRDUMP のいずれか
が指定されている。
v SLIP トラップが DEBUG モードになっていて (SLIP コマンドで指定されま
す)、なんらかの SLIP イベントの結果として SLIP プロセッサーによって検査さ
れる。
SLIP トレース・レコードには以下のものがあります。
v SLIP 標準トレース・レコード
v SLIP 標準 / ユーザー・トレース・レコード
v SLIP ユーザー・トレース・レコード
10-108
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
汎用トレース機能
v SLIP DEBUG トレース・レコード
SLIP 標準トレース・レコード:
す。EID は X'4004' です。
SLIP 標準トレース・レコードの FID は X'04' で
データを入手しようとしていたときにエラーが発生した場合、またはページアウト
のためにデータが使用不能である場合には、フィールドにアスタリスクが入りま
す。
オフセット
0 (0)
4 (4)
サイズ
4
2
6 (6)
8
14 (E)
18 (12)
20 (14)
4
2
8
28 (1C)
32 (20)
4
1
1... ....
.1.. ....
..1. ....
...1 ....
.... 1...
.... .1
.... ..1.
.... ...1
1
1... ....
33 (21)
36 (24)
.1.. ....
..1. ....
...1 ....
.... 1...
.... .1..
.... ..1.
1
35 (23)
1... ....
.1.. ....
..1. ....
...1 ....
.... 1...
.... .1..
.... ..1.
.... ...1
1
36 (24)
1... ....
1
1... ....
.1.. ....
説明
ASCB アドレス
CPUID (注: RTM2 から SLIP に入った場合、記録され
る CPUID は RTM2 が実行されていたときの CPUID
とは異なります。)
現行アドレス・スペースから得られたジョブ名 (または
N/A)
SLIP トラップ ID
現行アドレス・スペースの ASID
ジョブ・ステップ・プログラム名 (または U/A または
N/A)
TCB アドレス (または N/A)
システム・モード標識、バイト 1:
監視プログラム制御モード
入出力および外部割り込みでは割り込み不能
グローバル・スピン・ロックの保持
グローバル中断ロックの保持
ローカル・ロックの保持
タイプ 1 の SVC が制御
SRB モード
TCB モード
システム・モード標識、バイト 2:
リカバリー・ルーチンが制御 (PER 割り込みの場合に
は常にゼロ)
問題プログラム状態
監視プログラム状態
システム・キー
問題プログラム・キー
なんらかのグローバル・ロックの保持
なんらかのロックの保持
エラー・バイト 1 (または、PER 割り込みの場合には
ゼロ):
プログラム・チェック割り込み
再始動割り込み
SVC エラー
異常終了。タスクが SVC 13 を発行。
ページ入出力エラー
動的アドレス変換エラー
マシン・チェックによるソフトウェア・エラー
アドレス・スペースの異常終了
エラー・バイト 2 (または、PER 割り込みの場合には
ゼロ):
メモリー終了
SLIP フラグ:
DEBUG レコード
収集されたレジスター
第 10 章 汎用トレース機能 (GTF)
10-109
汎用トレース機能
オフセット
37 (25)
サイズ
2
説明
データ使用不能カウンター (または、トラップに関して
DATA が指定されていない場合にはゼロ)
以下のフィールドは PER 割り込みにだけ適用されます (それ以外の場合には N/A
(1 バイト・フィールドの場合には N) に設定されます)。
オフセット
39 (27)
サイズ
8
47 (2F)
4
55 (37)
6
61 (3D)
4
65 (41)
66
71 (47)
4
75 (4B)
4
79 (4F)
87 (57)
91 (5B)
93 (5D)
95 (5F)
97 (61)
99 (63)
101 (65)
8
4
1
1......
.1.. ....
..1. ....
1
1... ....
.1.. ....
..1. ....
...x ....
.... 1...
.... .1..
.... ..1.
.... ...1
2
2
2
2
1
102 (66)
13
92 (5C)
10-110
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
説明
割り込みが発生したロード・モジュール名 (または
U/A または N/A)
ロード・モジュール内のオフセット (または U/A また
は N/A)
命令の内容 (PER 割り込みの原因となった命令のアド
レスから始まる 6 バイトのデータ)
EXECUTE 命令の場合にはターゲット命令アドレス (ま
たは N/A または U/A)
EXECUTE 命令の場合にはターゲット命令の内容 (ター
ゲット命令アドレスから始まる 6 バイトのデータ)、ま
たは N/A または U/A
SLIP コマンドで SA (ストレージ変更) が指定されてい
る場合には開始範囲仮想アドレス (または N/A)
SA が指定された場合には開始範囲仮想アドレスから始
まる 4 バイトのストレージ (または N/A または U/A)
プログラムの旧 PSW
プログラム割り込みコード (PIC) および命令長コード
PER 割り込みコード:
成功分岐イベント (SB)
命令取り出しイベント (IF)
ストレージ変更イベント (SA)
PER トラップ・モード:
成功分岐モニター (SB)
命令取り出しモニター (IF)
ストレージ変更モニター (SA)
予約済み
PER トラップ
リカバリー指定
メッセージ・フラグ
メッセージ・フラグ
キー・マスク
SASID
許可インデックス
PASID
PSW の ASC モード標識
F0: 1 次アドレッシング・モード
F1: アクセス・レジスター・アドレッシング・モー
ド
F2: 2 次アドレッシング・モード
F3 ホーム・アドレッシング・モード
ストレージ変更空間 ID
アドレス・スペースの場合: ASID が入ります
データ・スペースの場合: 所有側 ASID およびデー
タ・スペース名が入ります
汎用トレース機能
オフセット
115 (73)
119 (77)
サイズ
4
1
1
説明
PER 割り込みコード
予約済み
予約済み
SLIP 標準 + ユーザー・トレース・レコード: SLIP 標準 + ユーザー・トレー
ス・レコードの FID は X'04' です。 EID は X'4005' です。
オフセット
0 (0)
から 3
115 (73)
120 (78)
122 (7A)
サイズ
4
5
2
可変
説明
フィールドは SLIP 標準レコードの場合と同じです。
予約済み
ユーザー定義データの長さ
ユーザー定義データ (SLIP コマンドの TRDATA パラ
メーターによって指定)
SLIP ユーザー・トレース・レコード: SLIP ユーザー・トレース・レコードの FID
は X'04' です。EID は X'4006' です。
オフセット
0 (0)
2 (2)
4 (4)
5 (5)
7 (7)
サイズ
2
2
1
2
可変
説明
CPUID
拡張番号
継続の長さ
ユーザー定義データの長さ
ユーザー定義データ (SLIP コマンドの TRDATA パラ
メーターによって指定)
注:
1. SLIP ユーザー要求で、レジスターを SLIP ユーザー・レコードに含める場合に
は、これらのレジスターがレコード内の最初のフィールドになります。
2. 長さフィールドがゼロになっている場合には、ユーザー定義データが使用不能で
す (たとえば、データがページアウトになっています)。
3. SLIP コマンドの TRDATA パラメーターでは、1 つまたは複数のデータ範囲が
指定されます。これらの範囲をトレースするのに必要なレコードの数は、指定さ
れた範囲のサイズによって異なります。トレースには、標準レコードのほかに
(+) 次の範囲から得られたユーザー・レコード、または指定された範囲のトレー
スに必要な数のユーザー連結レコードがユーザー・レコードの後に続いたものが
含まれます。各レコードのヘッダーには、CPUID、および出力を相関させるのに
必要な拡張部分番号が含まれます (拡張番号は、ユーザー・レコードとユーザー
継続レコードにだけ適用されます)。レコードが部分的にいっぱいになって、次
の範囲から得られたデータが残りのスペースに入りきらない場合には、部分的に
いっぱいになったレコードがトレース・データ・セットに書き込まれます。別の
ユーザー・レコードが作成され、拡張番号が 1 増やされ、継続長がゼロに設定
されます。そして、データ長とデータがこのレコードにコピーされます。
ある範囲のデータの長さが 249 バイトを超えた場合、超過分のデータは次のよ
うにユーザー継続レコードに入ります。データ長および最初の 248 バイトがユ
ーザー・レコードに入ります。そのレコードが書き込まれたあとで、ユーザー継
続レコードが作成されます。拡張番号が 1 増やされ、継続長が、このレコード
第 10 章 汎用トレース機能 (GTF)
10-111
汎用トレース機能
に入るデータのバイト数に設定されます。251 バイトを超えるデータが残ってい
る場合、248 バイトがレコードにコピーされ、そのレコードが書き込まれます。
そして、その範囲から得られたすべてのデータがトレースされるまでユーザー継
続レコードが作成されます。
SLIP DEBUG トレース・レコード:
X'04' です。EID は X'4005' です。
オフセット
0 (0)
から 3
93 (5D)
120 (78)
サイズ
4
121 (79)
1
SLIP DEBUG トレース・レコードの FID は
説明
フィールドは SLIP 標準レコードの場合と同じです。
27
1
DEBUG バイト。障害が起こったキーワードを示しま
す。
10 進数 2 は COMP キーワードを表します
10 進数 3 は ASID キーワードを表します
10 進数 4 は JOBNAME キーワードを表します
10 進数 5 は JSPGM キーワードを表します
10 進数 6 は PVTMOD キーワードを表します
10 進数 7 は LPAMOD キーワードを表します
10 進数 8 は ADDRESS キーワードを表します
10 進数 9 は MODE キーワードを表します
10 進数 10 は ERRTYP キーワードを表します
10 進数 13 は RANGE キーワードを表します
10 進数 14 は DATA キーワードを表します
10 進数 20 は ASIDSA キーワードを表します
10 進数 22 は REASON CODE キーワードを表し
ます
10 進数 23 は NUCMOD キーワードを表します
10 進数 24 は PSWASC キーワードを表します
10 進数 26 は DSSA キーワードを表します
予約済み
注: SLIP フラグ (SFLG) フィールド (オフセット X'34') の高位ビットは、DEBUG
レコードを表すためにオンに設定されています。
SRM の広範囲トレース・レコード
トレース・オプションとして TRACE=SYS または TRACE=SRM のいずれかが有効
になっている場合、システム・リソース・マネージャーが呼び出されると GTF は
SRM 広範囲レコードを作成します。
SRM トレース・レコードの FID は X'04' です。EID は X'4001' です。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
18 (12)
22 (16)
10-112
サイズ
4
2
8
4
4
4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
説明
ASCB
CPUID
ジョブ名
レジスター 15
レジスター 0
レジスター 1
汎用トレース機能
SRM の最小限トレース・レコード
GTF オプションとして TRACE=SYSM が有効になっている場合、システム・リソ
ース・マネージャーが呼び出されると、GTF は SRM 最小限レコードを作成しま
す。
SRM 最小限トレース・レコードの FID は X'03' です。EID は X'4001' です。
オフセット
0 (0)
4 (4)
6 (6)
10 (A)
14 (E)
サイズ
4
2
4
4
4
説明
ASCB
CPUID
レジスター 15
レジスター 0
レジスター 1
SSCH トレース・レコード
GTF オプションとして TRACE=SYSM、TRACE=SYS、TRACE=SYSP、
TRACE=SSCH、または TRACE=SSCHP が有効になっている場合、SSCH イベント
が発生すると、GTF は SSCH レコードを作成します。
SSCH トレース・レコードの FID は X'00' です。EID は X'5105' です。
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
16 (10)
20 (14)
24 (18)
28 (1C)
29 (1D)
41 (29)
49 (31)
50 (32)
51 (33)
52 (34)
53 (35)
54 (36)
サイズ
4
2
8
2
4
4
4
1
12
8
1
1
1
1
1
1
説明
ASCB
CPUID
ジョブ名
装置番号
チャネル・プログラムの実アドレス
チャネル・プログラムの仮想アドレス
IBM が使用するために予約済み。
条件コード
IBM が使用するために予約済み。
動的シーク・アドレス
IBM が使用するために予約済み。
IBM が使用するために予約済み。
IBM が使用するために予約済み。
IBM が使用するために予約済み。
IBM が使用するために予約済み。
IBM が使用するために予約済み。
SVC の広範囲トレース・レコード
GTF オプションとして TRACE=SYS または TRACE=SVC のいずれかが有効にな
っている場合、SVC 割り込みが発生すると、GTF は SVC 広範囲レコードを作成し
ます。すべての SVC レコードには、以下に示される基本データが含まれます。た
だし、多くの SVC 番号では、基本データの後に説明されている追加データ記録が
呼び出されます。
SVC の広範囲トレース・レコードの FID は X'010' です。EID は X'1000' です。
第 10 章 汎用トレース機能 (GTF)
10-113
汎用トレース機能
基本 SVC の広範囲トレース・レコード
オフセット
0 (0)
4 (4)
6 (6)
14 (E)
サイズ
4
2
8
8
22
26
34
38
42
4
8
4
4
4
(16)
(1A)
(22)
(26)
(2A)
説明
ASCB
CPUID
ジョブ名
SVC の旧 PSW。3 番目と 4 番目のバイトには SVC
番号が入ります。
旧 TCB
CDE 名
レジスター 15
レジスター 0
レジスター 1
GTF は、以下の SVC に関しては基本広範囲トレース・レコードだけを作成しま
す。
名前
EXIT
GETMAIN/FREEMAIN
TIME
SYNCH
MGCR
WTL
TTROUTER
CIRB
TTIMER
TTOPEN
NOP
OLTEP
TSAV
CHATR
(IFBSTAT)
STATUS
SMFWTM
(IGC084)
SWAP
EMSERV
VOLSTAT
TPUT/TGET
TSO 端末制御
SYSEVENT
番号
3
10
11
12
34
36
38
43
46
49
50
59
61
72
76
79
83
84
85
89
91
93
94
95
名前
TEST
SUBMIT
QTIP
XLATE
TOPCTL
IMBLIB
REQUEST
MODESET
なし
DSTATUS
JECS
RELEASE
SIR
BLKPAGE
なし
なし
DSSPATCH
TESTAUTH
GETMAIN/FREEMAIN
なし
LINK、LOAD、XCTL
PURGEDQ
TPIO
番号
97
100
101
103
104
105
106
107
109
110
111
112
113
115
116
117
118
119
120
121
122
123
124
パラメーター・リスト情報を伴う基本 SVC 広範囲トレース・レコード: 以下の
SVC について収集されるデータの詳細については、 z/OS MVS 診断: 解説書 を参
照してください。
名前
EXCP
WAIT/WAITR
POST
GETMAIN
FREEMAIN
LINK
10-114
番号
0
1
2
4
5
6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
名前
STIMER
DEQ
SNAP
RESTART
RELEX
DISABLE
番号
47
48
51
52
53
54
汎用トレース機能
名前
XCTL
LOAD
DELETE
ABEND
SPIE
ERREXCP
PURGE
RESTORE
BLDL/FIND
OPEN
CLOSE
STOW
番号
7
8
9
13
14
15
16
17
18
19
20
21
OPEN TYPE = J
CLOSE TYPE = T
DEVTYPE
TRKBAL
CATLG
OBTAIN
SCRATCH
RENAME
FEOB
ALLOC
WTO/WROR
SEGLD/SEGWT
LABEL
EXTRACT
IDENTIFY
ATTACH
CHAP
OVLYBRCH
22
23
24
25
26
27
29
30
31
32
35
37
39
40
41
42
44
45
名前
EOV
ENQ/RESERVE
FREEDBUF
RELBUF/REQBUF
STAE
DETACH
CHKPT
RDJFCB
BTAMTEST
BSP
GSERV
ASGNBFR/BUFINQ/
RLSEBFR
SPAR
DAR
DQUEUE
LSPACE
GJP
SETPRT
ATLAS
DOM
MOD88
TCBEXCP
PROTECT
動的割り振り
EXCPVR
番号
55
56
57
58
60
62
63
64
66
69
70
71
73
74
75
78
80
81
86
87
88
92
98
99
114
SVC の最小限トレース・レコード
GTF オプションとして TRACE=SYSM が有効になっている場合、SVC 割り込みが
発生すると、 GTF は SVC 最小限レコードを作成します。
SVC 最小限トレース・レコードの FID は X'010' です。EID は X'1000' です。
オフセット
0 (0)
4 (4)
6 (6)
サイズ
4
2
8
14
18
22
26
4
4
4
4
(E)
(12)
(16)
(1A)
説明
ASCB
CPUID
SVC の旧 PSW。3 番目と 4 番目のバイト
には SVC 番号が入ります。
旧 TCB
レジスター 15
レジスター 0
レジスター 1
第 10 章 汎用トレース機能 (GTF)
10-115
汎用トレース機能
10-116
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 11 章 コンポーネント・トレース
コンポーネント・トレース・サービスは、MVS コンポーネントがイベントに関する
問題データを収集するための手段となります。コンポーネント・トレース・サービ
スを使用する各コンポーネントのトレースは、そのコンポーネントに必要な固有の
データを提供するように設定されています。
コンポーネント・トレースは、コンポーネントで発生するイベントに関するデータ
を提供します。トレース・データは、IBM サポートが、次のことを行うために使用
します。
v コンポーネントにおける問題を診断する
v コンポーネントがどのように実行されているのかを調べる。
通常は、問題の再現の際にコンポーネント・トレースが使用されます。
システム・リソースの使用: いくつかのコンポーネント・トレースでは、(特に、少
数のイベントをトレースする場合には) 最小限のシステム・リソースだけしか使用
されません。これらの最小限トレースは、多くの場合コンポーネントの実行中にい
つでも実行されます。トレースによっては、かなり多くのシステム・リソースを使
用することもあります (特に、多くの種類のイベントがトレースされる場合)。これ
らの大規模トレースの実行は、IBM サポートが依頼した場合にだけ要求されます。
並行トレースの実行: 以下のような複数のコンポーネント・トレースを同時に実行
することができます。
v 1 つのシステム上のいくつかのコンポーネントに関する並行トレース
v シスプレックス内の一部またはすべてのシステム上の 1 つ以上のコンポーネント
に関する並行トレース
v システム上の 1 つのコンポーネントに関する並行トレース。 1 つのコンポーネ
ントに関して並行して行われる複数のトレースは、サブレベル・トレース です。
v シスプレックス内の一部またはすべてのシステム上のいくつかのコンポーネント
に関する並行トレースおよびサブレベル・トレース
主要トピック
以下のトピックで、コンポーネント・トレースのタスクについて説明します。
v
11-3 ページの『コンポーネント・トレースの計画』では、コンポーネント・トレ
ースの計画に必要なタスクについて説明します。
v
11-12 ページの『コンポーネント・トレースの獲得』では、問題の診断に必要な
特定のコンポーネント・トレースを要求する方法を説明します。これらのタスク
は、トレース出力を収める場所により、またシスプレックス内の複数のシステム
でトレースを実行するのかによって異なります。したがって、トレースの要求に
ついては次の 3 つのトピックで説明します。
–
11-12 ページの『アドレス・スペースまたはデータ・スペース・トレース・バ
ッファーに対するコンポーネント・トレースの要求』
–
11-16 ページの『トレース・データ・セットへのコンポーネント・トレース・
データ書き込みの要求』
© Copyright IBM Corp. 1988, 2008
11-1
コンポーネント・トレース
–
11-22 ページの『シスプレックス内のシステムに関するコンポーネント・トレ
ースの要求』
v
11-25 ページの『コンポーネント・トレースの検査』では、要求したトレースが
実行されていること、およびコンポーネント・トレース書き込み機能が実行され
ていることをオペレーターが検査するための方法を示しています。
v
11-28 ページの『コンポーネント・トレース・データの表示』では、トレース出
力をフォーマット設定する方法を示しています。
このトピックでは、さまざまなコンポーネントから得られる個々のトレースの類似
点と相違点を表で示します。また、コンポーネント・トレース・サービスを使用す
る以下の各 BCP コンポーネント・トレースについても説明します。
|
11-2
コンポーネント
トレース名
トピックを参照
拡張プログラム間通信/MVS
(APPC/MVS)
SYSAPPC
11-31
システム間カップリング・フ
ァシリティー (XCF)
SYSXCF
11-159
システム間拡張サービス
(XES)
SYSXES
11-164
VLF のデータ索引機能
(DLF)
SYSDLF
11-51
SOMobjects® の分散機能
SYSDSOM
11-53
グローバル・リソース逐次化
SYSGRS
11-55
割り振りコンポーネント
SYSIEFAL
11-67
IOS コンポーネント・トレー SYSIOS
ス
11-73
JES 共通結合サービス
SYSJES
11-80
JES2 ローリング・トレー
ス・テーブル
SYSjes2
11-93
内容監視のライブラリー索引
機能 (LLA)
SYSLLA
11-96
z/OS UNIX System Services
(z/OS UNIX)
SYSOMVS
11-105
操作サービス (OPS)
SYSOPS
11-118
リソース・リカバリー・サー
ビス (RRS)
SYSRRS
11-123
実記憶管理プログラム (RSM) SYSRSM
11-132
サービス・プロセッサー・イ
ンターフェース (SPI)
SYSSPI
11-151
システム・ロガー
SYSLOGR
11-97
System REXX
SYSAXR
11-47
トランザクション・トレース
(TTRC)
SYSTTRC
11-152
仮想索引機能 (VLF)
SYSVLF
11-152
ワークロード管理機能
(WLM)
SYSWLM
11-156
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
許可されたプログラム・プロダクトまたはアプリケーションでも、コンポーネン
ト・トレース・サービスを使用してアプリケーション・トレース を行うことができ
ます。このトレースについては、該当プログラム・プロダクトまたはアプリケーシ
ョンの文書を参照してください。
参照
v CTncccxx parmlib メンバーについては、「z/OS MVS 初期設定およびチューニン
グ 解説書」を参照してください。
v TRACE CT® コマンドについては、「z/OS MVS システム・コマンド」を参照し
てください。
v COPYDUMP、COPYTRC、CTRACE、GTFTRACE および MERGE サブコマンド
については、「z/OS MVS IPCS コマンド」を参照してください。
v これらのメッセージの説明については、LookAt を使用するか、「MVS System
Messages」を参照してください。
v アプリケーション・トレース の作成に関する情報については、「z/OS MVS
Programming: Authorized Assembler Services Guide」を参照してください。
コンポーネント・トレースの計画
コンポーネント・トレースの計画は、以下のタスクからなります。
v 『いくつかのコンポーネントに関する CTncccxx parmlib メンバーの作成』:
– 11-6 ページの『バッファーの指定』
v 11-9 ページの『コンポーネント・トレースのトレース・オプションの選択』
v 11-11 ページの『トレース・レコードの収集場所の決定』
これらのタスクは、システム・プログラマーが実行します。
いくつかのコンポーネントに関する CTncccxx parmlib メンバーの作成
次の表は、あるコンポーネントに関する parmlib メンバーがあるかどうか、そのメ
ンバーがシステムまたはコンポーネントの初期設定の際に必要なデフォルト・メン
バーであるのかどうか、およびそのコンポーネントについてデフォルトのトレース
が行われるのかを示しています。一部のコンポーネントでは、実行中常にデフォル
ト・トレースが実行されます。デフォルト・トレースは、通常は最小限のもので、
予期しないイベントだけを対象としています。その他のコンポーネントでは、要求
されたときにだけトレースが実行されます。
実動 SYS1.PARMLIB システム・ライブラリーを作成するときには、次のようにし
てください。
1. 表で識別されたすべてのデフォルト・メンバーが parmlib に含まれるようにしま
す。初期設定のときに parmlib にデフォルト・メンバーが含まれていない場合、
システムはメッセージを発行します。
IBM 提供の CTIITT00 メンバーが parmlib に含まれるようにしてください。
parmlib メンバーが含まれないコンポーネント・トレースについては、TRACE
CT コマンドで PARM=CTIITT00 を指定できます。CTIITT00 を指定すると、
TRACE CT コマンドのあとでシステムが REPLY を求めてこなくなります。シ
スプレックスで CTIITT00 を使用すると、各システムで応答を求められることが
なくなります。
第 11 章 コンポーネント・トレース
11-3
コンポーネント・トレース
2. 各デフォルト・メンバーがインストール・システムの要求を満たしているかどう
かを判別します。インストール・システムの要求が満たされていない場合には、
デフォルト・メンバーをカスタマイズしてください。
3. デフォルト・メンバーで指定されたバッファー・サイズが、インストール・シス
テムの要求を満たしているかどうかを判別してください。一部のコンポーネン
ト・トレースでは、初期化の後では、バッファー・サイズを変更できません。必
要な場合には、バッファー・サイズを変更してください。
多くのコンポーネントでは、一度に 1 つのコンポーネント・トレースだけしか実行
できませんが、一部のコンポーネントでは並行トレースを実行できます。これをサ
ブレベル・トレース と呼びます。各サブレベル・トレースは、サブレベル・トレー
ス名によって識別されます。
トレース
parmlib メンバー
デフォルト・メンバー 初期設定で開始される サブレベル・トレース
デフォルト・トレース
SYSAPPC
CTnAPPxx
いいえ
11-32 ページの
『CTnAPPxx parmlib
メンバー』を参照して
ください。
|
SYSAXR
|
|
|
|
いいえ
なし。CTnAPPxx で
はトレースを ON ま
たは OFF にできませ
ん。
CTIAXR00 あり
CTIAXRnn
いいえ
11-48 ページの
『CTIAXRnn parmlib
メンバー』を参照して
ください。
SYSDLF
なし
該当なし
あり。DLF の実行中
は常にオン。
いいえ
SYSDSOM
なし
該当なし
いいえ
はい
SYSGRS
CTnGRSxx
SYSIEFAL
CTIIEFxx
あり (グローバル・リ いいえ
CTIGRS00
(GRSCNF00 メンバー ソース逐次化が活動状
11-56 ページの
態の場合)。
で指定)
『CTnGRSxx parmlib
CONTROL および
メンバー』を参照して
MONITOR オプショ
ください。
ン。
CTIIEFAL
はい
いいえ
いいえ
あり。最小限。予期し いいえ
ないイベントが対象。
11-67 ページの
『CTIIEFxx parmlib
メンバー』を参照して
ください。
SYSIOS
CTnIOSxx
11-75 ページの
『CTnIOSxx parmlib
メンバー』を参照して
ください。
11-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
トレース
parmlib メンバー
デフォルト・メンバー 初期設定で開始される サブレベル・トレース
デフォルト・トレース
SYSJES
CTnJESxx
SYSjes2
なし
該当なし
あり。JES2 の実行中
は常にオン。
はい
SYSLLA
なし
該当なし
あり。LLA の実行中
は常にオン。
いいえ
SYSLOGR
CTnLOGxx
CTILOG00
あり。最小限。予期し いいえ
ないイベントが対象。
はい
CTIJES01、CTIJES02、 あり。サブレベル
CTIJES03、CTIJES04 XCFEVT および
11-83 ページの
FLOW の場合には完
SYS1.SAMPLIB で提 全トレース、サブレベ
『CTnJESxx parmlib
メンバー』を参照して 供されるメンバー
ル USRXIT および
IXZCTION および
ください。
MSGTRC の場合には
IXZCTIOF を受信し
予期しないイベントに
て、 CTIJESON およ 関する最小限のトレー
び CTIJESOF に名前 ス。
変更してください。
11-101 ページの
『CTnLOGxx parmlib
メンバー』を参照して
ください。
SYSOMVS
CTnBPXxx
11-106 ページの
『CTnBPXxx parmlib
メンバー』を参照して
ください。
SYSOPS
CTnOPSxx
11-119 ページの
『CTnOPSxx parmlib
メンバー』を参照して
ください。
SYSRRS
CTnRRSxx
あり。最小限。予期し いいえ
CTIBPX00
(BPXPRM00 メンバー ないイベントが対象。
で指定しなければなり
ません)。
あり。最小限。予期し いいえ
CTIOPS00
(CONSOLxx メンバー ないイベントが対象。
で指定しなければなり
ません)。
いいえ
あり。最小限。予期し いいえ
ないイベントが対象。
いいえ
いいえ
いいえ
11-124 ページの
『CTnRRSxx parmlib
メンバー』を参照して
ください。
SYSRSM
CTnRSMxx
11-133 ページの
『CTnRSMxx parmlib
メンバー』を参照して
ください。
SYSSPI
なし
該当なし
いいえ
いいえ
SYSTTRC
該当なし
該当なし
いいえ
いいえ
SYSVLF
なし
該当なし
あり。最小限。予期し いいえ
ないイベントが対象。
第 11 章 コンポーネント・トレース
11-5
コンポーネント・トレース
トレース
parmlib メンバー
デフォルト・メンバー 初期設定で開始される サブレベル・トレース
デフォルト・トレース
SYSWLM
なし
該当なし
SYSXCF
CTnXCFxx
あり。最小限。予期し いいえ
CTIXCF00
(COUPLE00 メンバー ないイベントが対象。
で指定することができ
ます)。
11-160 ページの
『CTnXCFxx parmlib
メンバー』を参照して
ください。
SYSXES
CTnXESxx
11-166 ページの
『CTnXESxx parmlib
メンバー』を参照して
ください。
あり。最小限。予期し いいえ
ないイベントが対象。
あり。最小限。予期し はい
CTIXES00
(COUPLE00 メンバー ないイベントが対象。
で指定することができ
ます)。
コンポーネントによっては、別の parmlib メンバーでそのコンポーネントの
CTncccxx メンバーを識別しなければならないことがあります。この要件を備えたコ
ンポーネントについては、前記の表のデフォルト・メンバー列に別の parmlib メン
バーがリストされています。
例: CTncccxx メンバーの指定
XCF の場合には、COUPLExx parmlib メンバーの CTRACE パラメーターで
CTIXCF00 を指定します。
COUPLE SYSPLEX( ...
CTRACE(CTIXCF00)
...
バッファーの指定
各コンポーネントにより、バッファー・サイズとその指定方法が識別されます。コ
ンポーネントによって、バッファー・サイズを変更できる場合と変更できない場合
があります。システムまたはコンポーネントの初期設定のときにだけサイズを変更
できる場合、トレースの開始時に変更できる場合、あるいはトレースの実行中を含
めていつでも変更できる場合があります。次の表は、バッファーの指定方法を示し
ています。
バッファー・サイズにより、診断に必要なすべてのレコードが得られるかどうかが
決まります。バッファーがいっぱいになるとシステムはバッファーを折り返し、最
も古いレコードに対して上書きが行われます。バッファーのサイズを変更するに
は、TRACE CT オペレーター・コマンドで nnnnK または nnnnM パラメーターを
指定するか、あるいは parmlib メンバーで BUFSIZE パラメーターを指定してくだ
さい。
通常、トレースの量を増やす場合にはトレース・バッファーのサイズを大きくして
ください。ただし、コンポーネントのトレース・レコードをトレース・データ・セ
ットに入れる場合には、バッファーを元のサイズのままにしておいてかまわないと
11-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
思われます。多くのコンポーネント・トレースでは、初期設定のあとではバッファ
ー・サイズを変更できません。表では、これらのコンポーネント・トレースが識別
されています。それらのコンポーネント・トレースのいずれかに関するトレースの
量を増やす場合、コンポーネントでトレース・データ・セットの使用がサポートさ
れているときには、このデータ・セットを使用するように指定してください。
トレース
デフォルト・サイズ
およびサイズ範囲
サイズの設定方法
IPL 後のサイズ変更
SYSAPPC
512KB
CTnAPPxx メンバー
または TRACE CT
コマンドに対する
REPLY
あり (トレースの実行 データ・スペース。
中)
TRACE CT,OFF コマ
ンドが要求するダンプ
にトレース・バッファ
ーが含まれる。
64KB - 32MB
|
|
||
|
バッファーの位置
1MB - 2GB
CTIAXRnn parmlib メ あり (トレース停止後 AXR 専用; AXR トレ
ースのデータ・スペー
ンバーまたは TRACE に再始動するとき)
ス。
CT コマンドに対する
REPLY
SYSDLF
該当なし
MVS システム
いいえ
データ・スペース。
DUMP コマンドに対
する REPLY で
DSPNAME=
(’DLF’.CCOFGSDO)
を指定する。
SYSDSOM
該当なし
MVS システム
いいえ
専用アドレス・スペー
ス
SYSGRS
128KB
CTnGRSxx メンバー
はい。
コンポーネント・アド
レス・スペース内
CTIIEFxx メンバー
はい。
コンポーネント・アド
レス・スペース内
SYSAXR
2MB
128KB - 16MB (シス
テムが最も近い 64KB
単位の境界にサイズを
切り上げる)。
SYSIEFAL
4M
256KB - 8MB
36KB - 1.5MB
CTnIOSxx メンバーま はい
たは TRACE CT コ
マンドに対する
REPLY
データ・スペース。拡
張システム・キュー・
エリア (ESQA)
SYSJES
該当なし
MVS システム
いいえ
コンポーネント・アド
レス・スペース内
SYSjes2
該当なし
JES2
いいえ
コンポーネント・アド
レス・スペース内
SYSLLA
該当なし
MVS システム
いいえ
コンポーネント・アド
レス・スペース内
SYSIOS
36KB
第 11 章 コンポーネント・トレース
11-7
コンポーネント・トレース
トレース
デフォルト・サイズ
およびサイズ範囲
サイズの設定方法
IPL 後のサイズ変更
バッファーの位置
SYSLOGR
2MB
MVS システム、
CTnLOGxx メンバ
ー、または TRACE
CT コマンドの
REPLY
はい
データ・スペース。
DUMP コマンド対す
る REPLY で
DSPNAME=
(’IXLOGR’.*) を指定
する。 11-98 ページの
『システム・ロガー情
報のダンプの入手』を
参照してください。
CTxBPXxx メンバー
または TRACE CT
コマンドに対する
REPLY
あり (z/OS UNIX の
初期設定時)
データ・スペース。
DUMP コマンドに対
する REPLY で
DSPNAME=
(asid.SYSZBPX2) を指
定する (asid は z/OS
UNIX の ASID)。
CTnOPSxx メンバー
または TRACE CT
コマンドに対する
REPLY
あり (トレースの実行 コンソール・アドレ
中)
ス・スペース (専用)
CTxRRSxx メンバー
または TRACE CT
コマンドに対する
REPLY
あり (トレース停止後 データ・スペースおよ
に再始動するとき)
びコンポーネント・ア
ドレス・スペース。
DUMP コマンドの
REPLY に、
DSPNAME=(’RRS’
.ATRTRACE) および
SDATA=RGN を指定
する。
2MB - 2047MB
SYSOMVS
4MB
16KB - 64MB
SYSOPS
2M
64KB - 16MB
SYSRRS
1MB
1MB - 2045MB
SYSRSM
32 ページの 3 つのバ CTnRSMxx メンバー
ッファー
または TRACE CT
コマンドに対する
2 - 7 のアドレス・ス REPLY
ペース・バッファー、
バッファー当り 4 262,144 ページ
あり (トレース開始
時)
共通サービス・エリア
(CSA) または、
CTnRSMxx で指定さ
れた場合にはデータ・
スペース。メッセージ
IAR007I でデータ・
スペース名が示され
る。
データ・スペース・バ
ッファーの場合には 1
から 2047MB
SYSSPI
64KB
MVS システム
あり (トレース開始
時)
コンポーネント・アド
レス・スペース内
SYSTTRC
1 MB
MVS システム
はい
システム・トレース・
アドレス・スペースが
所有するデータ・スペ
ース
16K - 999K
1MB - 32MB
11-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
トレース
デフォルト・サイズ
およびサイズ範囲
サイズの設定方法
IPL 後のサイズ変更
バッファーの位置
SYSVLF
該当なし
MVS システム
いいえ
データ・スペース。
VLF データ・スペー
スを識別するために
DISPLAY J,VLF と入
力。 DUMP コマンド
に対する REPLY で
DSPNAME=
(’VLF’.Dclsname,
’VLF’.Cclsname) を指
定する (clsname は
VLF クラス名)。
SYSWLM
64KB
MVS システム
あり (トレース開始
時)
拡張共通サービス・エ
リア (ECSA)
CTnXCFxx メンバー
いいえ
XCF アドレス・スペ
ースの拡張ローカル・
システム・キュー・エ
リア (ELSQA)
CTnXESxx メンバー
または TRACE CT
コマンドに対する
REPLY
あり (トレースの実行 データ・スペース。
中)
DUMP コマンドに対
する REPLY で
SDATA=XESDATA
および DSPNAME=
(asid.IXLCTCAD) を
指定する (asid はアド
レス・スペース
XCFAS の ASID)。
64KB - 16M
SYSXCF
72KB
16KB - 16MB (シス
テムが最も近い 72 バ
イトの倍数にサイズを
切り上げる)。
SYSXES
168KB
16KB - 16MB
例: IPL 時に使用される CTIXCF00 parmlib メンバー
XCF の場合、デフォルト・バッファー・サイズは 72KB です。このサイズは
XCF 最小限トレース以外では不十分なため、追加の XCF コンポーネント・ト
レースが必要な場合には、1 つまたは 2 つのオプションを指定できるよう
に、このサイズを 2 倍の 144KB に増やします。この 2 倍のサイズは、
CTIXCF00 parmlib メンバーで指定してください。CTIXCF00 により最小限
XCF トレースが開始されます。
TRACEOPTS
ON
BUFSIZE(144K)
コンポーネント・トレースのトレース・オプションの選択
IBM サポートがトレースを要求する場合、そのコンポーネント・トレースが
parmlib メンバー内の OPTIONS パラメーターまたは TRACE CT コマンドに対す
る REPLY を使用するときには、センターがオプションを指定することがありま
第 11 章 コンポーネント・トレース
11-9
コンポーネント・トレース
す。これらのオプションは以下のとおりです。
|
トレース
トレース要求の OPTIONS パラメーター
SYSAPPC
11-32 ページの『OPTIONS パラメーター』を参照。
SYSAXR
11-49 ページの『OPTIONS パラメーター』を参照。
SYSDLF
なし
SYSDSOM
なし
SYSGRS
11-58 ページの『OPTIONS パラメーター』を参照。
SYSIEFAL
11-69 ページの『OPTIONS パラメーター』を参照。
SYSIOS
11-76 ページの『OPTIONS パラメーター』を参照。
SYSJES
なし
SYSjes2
なし
SYSLLA
なし
SYSLOGR
11-103 ページの『OPTIONS パラメーター』を参照。
SYSOMVS
11-108 ページの『OPTIONS パラメーター』を参照。
SYSOPS
11-120 ページの『OPTIONS パラメーター』を参照。
SYSRRS
11-125 ページの『OPTIONS パラメーター』を参照。
SYSRSM
11-135 ページの『OPTIONS パラメーター』を参照。
SYSTTRC
なし
SYSSPI
なし
SYSVLF
なし
SYSWLM
なし
SYSXCF
11-161 ページの『OPTIONS パラメーター』を参照。
SYSXES
11-167 ページの『OPTIONS パラメーター』を参照。
トレースを開始するときに有効にしたいすべてのオプションを指定する必要があり
ます。同じコンポーネントに関する直前のトレースで指定されたオプションは、ト
レースを再度開始したときには有効になりません。
OPTIONS パラメーターの含まれていない parmlib メンバーで初期設定を行ないコ
ンポーネントでデフォルト・トレースが開始された場合には、次のいずれかの方法
によってデフォルトに戻すことができます。
v TRACE CT,OFF コマンドを使用してトレースを停止する。
v TRACE CT コマンドに対する REPLY または CTncccxx メンバーで OPTIONS()
を指定する。
例: XCF トレース・オプション
XCF の場合、IBM サポートは、特定の問題の診断に必要な次の両方のオプシ
ョンを識別します。
SERIAL
STATUS
11-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
トレース・レコードの収集場所の決定
コンポーネントによってトレース・データが入る場所は異なり、以下の場所があり
ます。
v アドレス・スペース・バッファー (ダンプから得られます)
v データ・スペース・バッファー (ダンプから得られます)
v 1 つまたは複数のトレース・データ・セット (コンポーネント・トレースでサポ
ートされる場合)
|
コンポーネント
アドレス・スペー
ス・バッファー
データ・スペース・
バッファー
トレース・データ・
セット
SYSAPPC
いいえ
はい
いいえ
SYSAXR
あり
はい
あり
SYSDLF
はい
はい
いいえ
SYSDSOM
はい
いいえ
はい
SYSGRS
はい
いいえ
はい
SYSIEFAL
はい
いいえ
はい
SYSIOS
はい
はい
はい
SYSJES
はい
いいえ
はい
SYSjes2
はい
いいえ
いいえ
SYSLLA
はい
いいえ
いいえ
SYSLOGR
はい
はい
はい
SYSOMVS
いいえ
はい
はい
SYSOPS
はい
いいえ
はい
SYSRRS
はい
はい
はい
SYSRSM
はい
はい
はい
SYSTTRC
いいえ
はい
いいえ
SYSSPI
はい
いいえ
いいえ
SYSVLF
はい
はい
いいえ
SYSWLM
はい
いいえ
はい
SYSXCF
はい
いいえ
はい
SYSXES
いいえ
はい
はい
実行したいトレースのトレース・レコードを複数の場所に入れることが可能な場合
には、場所を指定する必要があります。トレース・データ・セットをサポートする
コンポーネントの場合には、以下の理由によりトレース・データ・セットを選択す
るようにしてください。
v トレース・レコードの数が多くなることが予想される
v トレース・データのダンプによる割り込み処理を回避するため
v バッファー・サイズによってトレース・データの量が制約されることを回避する
ため
v バッファー・サイズの増大を回避するため
コンポーネントに応じて、アドレス・スペース・トレース・バッファーとデータ・
スペース・トレース・バッファーのダンプを行うこともできます。
第 11 章 コンポーネント・トレース
11-11
コンポーネント・トレース
注: データ・スペース・バッファーに戻すのに必要となる補助記憶域の量を考慮し
ておく必要があります。一般に、データ・スペース・バッファーを使用するコ
ンポーネントのほとんどは、500 K バイトの仮想記憶域よりも小さなデフォル
ト値を設定します。一部のコンポーネントでは、2 G バイトまでの値を指定で
きるようになっています。 SYSIOS コンポーネント・トレースは、データ・ス
ペース・バッファー用に、512 メガバイトのデフォルトを使用します。
SYSIOS および他のコンポーネントのデータ・スペース・バッファーに注意を
払って、割り振られたローカル・ページ・データ・セットによってシステムの
すべての CTRACE データ・スペース・バッファーの潜在的な蓄積作用に対応
できることを確認する必要があります。補助ストレージについて詳しくは、
「z/OS MVS 初期設定およびチューニング ガイド」を参照してください。
コンポーネント・トレースの獲得
特定のコンポーネント・トレースを得るには、次のいずれかの手順に従ってくださ
い。
v 『アドレス・スペースまたはデータ・スペース・トレース・バッファーに対する
コンポーネント・トレースの要求』
v 11-16 ページの『トレース・データ・セットへのコンポーネント・トレース・デ
ータ書き込みの要求』
v 11-22 ページの『シスプレックス内のシステムに関するコンポーネント・トレー
スの要求』
アドレス・スペースまたはデータ・スペース・トレース・バッファーに対す
るコンポーネント・トレースの要求
このトピックでは、コンポーネント・トレース・レコードをダンプ内に得るための
方法を説明します。トレース・レコードはアドレス・スペースまたはデータ・スペ
ース・トレース・バッファーに入っています。このトピックでは、以下のことを実
行する方法について説明します。
v 『トレース・バッファーに対する特定コンポーネント・トレースの準備』
v 11-14 ページの『トレース・バッファーに対するコンポーネント・トレースの実
行』
トレース・バッファーに対する特定コンポーネント・トレースの準備
これらのタスクは、システム・プログラマーが実行します。
1. オペレーターによるトレースの要求方法を選択します: 多くのコンポーネント・
トレースでは、以下の方法で要求を行います。
v PARM パラメーターを指定しないで TRACE CT オペレーター・コマンドを発行
し、そのあとでオプションを指定する応答を行う
v オプションを含む CTncccxx parmlib メンバーを指定する PARM パラメーターを
指定して、TRACE CT オペレーター・コマンドを発行する
parmlib メンバーを使用しない場合には、オペレーターにオプションを指示してくだ
さい。
2. parmlib メンバーを使用する場合には parmlib メンバーを作成してください:
parmlib メンバーを使用する場合には、メンバーを作成して、SYS1.PARMLIB に入
11-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
れてください。オプションが複雑で、しかも SYS1.PARMLIB データ・セットに対
するアクセス権限がある場合、コンポーネントが parmlib メンバーを必要とする場
合、または必要なオプションを指定する parmlib メンバーをすでに設定してある場
合には、parmlib メンバーを使用してください。単純なオプションの場合には、
REPLY を使用してください。
11-3 ページの『いくつかのコンポーネントに関する CTncccxx parmlib メンバーの
作成』を参照してください。
例: CTWXCF03 parmlib メンバー
XCF の場合には、オプションを指定するために CTWXCF03 を作成してくだ
さい。
TRACEOPTS
ON
OPTIONS(’SERIAL’,’STATUS’)
3. トレース・レコードを得るために使用するダンプを決定します: 次の表は、コン
ポーネント・トレースを得るための SVC ダンプの要求方法を示しています。 SVC
ダンプを要求する方法としては、以下の方法が考えられます。
v DUMP オペレーター・コマンド
v SLIP トラップ
v コンポーネントによって行う
以下の障害については、別のタイプのダンプを使用します。
v アプリケーション・プログラムまたはプログラム・プロダクトの障害: プログラ
ムが SYSMDUMP ダンプを要求します。
v システムの待機、停止、またはループ状態: オペレーターがスタンドアロン・ダ
ンプを要求します。
|
トレース
SVC ダンプの要求
SYSAPPC
オペレーターが TRACE CT,OFF コマンドによって SYSAPPC トレ
ースを停止したときにコンポーネントによって行う
SYSAXR
DUMP または SLIP コマンドによって行う
SYSDLF
DUMP または SLIP コマンドによって行う
SYSDSOM
DUMP または SLIP コマンドによって行う
SYSGRS
DUMP または SLIP コマンドによって行う
SYSIEFAL
DUMP または SLIP コマンドによって行う
SYSIOS
DUMP または SLIP コマンドまたはコンポーネントによって行う
v DUMP コマンドの REPLY に、ダンプされる IOS アドレス・ス
ペースを指定する
SYSJES
コンポーネントによって行う
SYSjes2
DUMP または SLIP コマンドまたはコンポーネントによって行う
SYSLLA
コンポーネントによって行う
SYSLOGR
DUMP または SLIP コマンドによって行う
SYSOMVS
DUMP または SLIP コマンドによって行う
第 11 章 コンポーネント・トレース
11-13
コンポーネント・トレース
トレース
SVC ダンプの要求
SYSOPS
DUMP または SLIP コマンドによって行う
SYSRRS
DUMP または SLIP コマンドによって行う
SYSRSM
v DUMP または SLIP コマンドによって行う
v CTnRSMxx parmlib メンバーまたは TRACE CT コマンドに対す
る REPLY で DMPREC オプションを指定することにより、RSM
がリカバリー処理に入ったときに行なう (デフォルト)
v CTnRSMxx の DMPOFF オプション または TRACE CT の応答
により、SYSRSM トレースがオフになったときに行なう
SYSTTRC
調整した SVC ダンプ出口機能によって自動的にダンプされる
SYSSPI
コンポーネントによって行う
SYSVLF
DUMP または SLIP コマンドにより、あるいは SYSVLF の完全ト
レースがオフになったとき
SYSWLM
DUMP または SLIP コマンドによって行う
SYSXCF
DUMP または SLIP コマンドによって行う
SYSXES
DUMP または SLIP コマンドによって行う
4. コンポーネント・トレース・バッファーがダンプされることを確認する: アドレ
ス・スペース・バッファーおよびデータ・スペース・バッファーの位置は、トレー
スするコンポーネントに依存しています。バッファーの場所については、 11-6 ペー
ジの『バッファーの指定』の表を参照してください。トレースされるコンポーネン
トが SVC ダンプを要求している場合は、ダンプにはアドレス・スペース・トレー
ス・バッファーおよび/またはデータ・スペース・トレース・バッファーが含まれま
す。
トレース・バッファーに対するコンポーネント・トレースの実行
これらのタスクはオペレーターが実行します。これらのタスクは、初期設定時にシ
ステムが開始するトレース用ではなく、特定のコンポーネント用のタスクであるこ
とにご注意ください。
1. コンポーネント・トレースの開始: オペレーターは MVS マスター権限を備えた
コンソールから TRACE オペレーター・コマンドを入力します。オペレーターは、
指定されたオプションを指定する応答を行います。
例: parmlib メンバーを指定しない TRACE CT コマンド
trace ct,on,comp=sysxcf
* 21 ITT006A ....
r 21,options=(serial,status),end
11-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例: parmlib メンバーを指定する TRACE CT コマンド
この例では、parmlib メンバー CTWXCF03 を使用して同じトレースを要求し
ます。TRACE CT で parmlib メンバーを指定した場合、システムはメッセー
ジ ITT006A を発行しません。
trace ct,on,comp=sysxcf,parm=ctwxcf03
2. トレースが実行されていることを確認します: 11-25 ページの『コンポーネン
ト・トレースの検査』を参照してください。
3. コンポーネント・トレース・レコードを含むダンプを入手してください: オペレ
ーターが、コンポーネント・トレース・レコードを含むダンプ (SVC ダンプ、スタ
ンドアロン・ダンプ、または問題の発生時またはオペレーターがトレースを停止し
たときに要求されたダンプ) を入手します。
例: DUMP コマンドおよび応答
この例は、MVS マスター権限を備えたコンソールから入力される DUMP オ
ペレーター・コマンドを示しています。システムは、DUMP コマンドに応答し
てメッセージ IEE094D を発行します。ユーザーの要求に応じて、オペレータ
ーは IEE094D に対する応答でダンプ・オプションを入力します。SDATA オ
プションは、トレース・バッファーを獲得するために必要なオプションです。
XCF アドレス・スペースを表すアドレス・スペース ID (ASID) を指定する必
要があります (この例では、 XCF はアドレス・スペース 6 に入っていま
す)。
dump comm=(dump for xcf component trace)
* 32 IEE094D ...
r 32,sdata=(couple,sqa,lsqa),asid=6,end
.
.
.
IEA911E ...
システムは、メッセージ IEA911E で、ダンプが入っているデータ・セットを示しま
す。インストール・システム出口によってダンプが移動されている場合には、オペ
レーターに依頼して、移動されたダンプを含むデータ・セットを示すメッセージを
探して、ダンプの名前とそれを含むデータ・セットを調べてもらう必要がありま
す。
必要に応じて、オペレーターはコンポーネント・トレースの実行中に複数のダンプ
を要求できます。
4. コンポーネント・トレースの停止: オペレーターは MVS マスター権限を備えた
コンソールから TRACE CT,OFF コマンドを入力します。いくつかのコンポーネン
ト・トレースでは、このコマンドによってダンプが要求され、そのダンプにトレー
ス・レコードが含まれていることがあります。
第 11 章 コンポーネント・トレース
11-15
コンポーネント・トレース
例: TRACE CT,OFF コマンド
trace ct,off,comp=sysxcf
トレース・データ・セットへのコンポーネント・トレース・データ書き込み
の要求
このトピックでは、トレース・データ・セットに書き込むことができるコンポーネ
ント・トレースについてだけ説明します。このトピックには以下の項目が含まれま
す。
v 『トレース・データ・セットに対する特定コンポーネント・トレースの準備』
v 11-20 ページの『トレース・データ・セットに対するコンポーネント・トレース
の実行』
トレースを停止しないで、使用中のトレース・データ・セットを変更することもで
きます。 11-21 ページの『トレース・データ・セットの変更』を参照してくださ
い。
トレース・データ・セットに対する特定コンポーネント・トレースの
準備
システム・プログラマーは次のタスクを行います。
1. 外部書き出しプログラムの開始タスク (コンポーネントのトレース用のサーバー
のアドレス・スペース) に必要なディスパッチング優先順位を決定してください:
コンポーネント・トレースがマスター・スケジューラー・アドレス・スペースで実
行中に、外部書き出しプログラムの優先順位がトレースしているコンポーネントの
優先順位と少なくとも等しいか、できればそれよりも高いことを確かめる必要があ
ります。たとえば、JOBNAME(IRLMA) の COMP(SYSXES) をトレースしている場
合、外部書き出しプログラムのディスパッチング優先順位は、IRLMA に割り当てら
れた優先順位に等しいかまたはそれよりも高くする必要があります。優先順位の設
定については、z/OS MVS 初期設定およびチューニング ガイド を参照してくださ
い。
2. オペレーターによるトレースの要求方法を選択します:
多くのコンポーネント・トレースでは、以下の方法で要求を行うことができます。
v PARM パラメーターを指定しないで TRACE CT オペレーター・コマンドを発行
し、そのあとでオプションを指定する応答を行う
v オプションを含む CTncccxx parmlib メンバーを指定する PARM パラメーターを
指定して、TRACE CT オペレーター・コマンドを発行する
parmlib メンバーを使用しない場合には、オペレーターにオプションを指示してくだ
さい。
11-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
3. 外部書き出しプログラムのソース JCL を作成します:
外部書き出しプログラムを呼び出すためのソース JCL を作成します。このプログラ
ムは、 1 つまたは複数のトレース・データ・セットにコンポーネント・トレース出
力を送信します。プロシージャーを SYS1.PROCLIB システム・ライブラリーに追
加するか、あるいは IEFJOBS または IEFPDSI 連結のデータ・セットのメンバーと
してジョブを追加してください。
外部書き出しプログラムはコンポーネントに特有のものではなく、どのアプリケー
ションでも使用することができます。したがって、必要な場合には、同じソース
JCL をあとで別のトレースで再び使用できます。
異なるコンポーネントに関する並行トレースでは、別個のソース JCL を使用して別
個のデータ・セットにトレースを収めるようにしなければなりません。
書き出しプログラムのソース JCL でデータ・セットが指定されるため、シスプレッ
クス内の各システムには別のソース JCL のセットを使用してください。複数のシス
テムで同じデータ・セットを共用することはできません。同じデータ・セットを共
用しようとすると、競合の問題が発生します。シスプレックスで共通の
SYS1.PROCLIB を使用する場合に、複数のシステム上の同じコンポーネントをトレ
ースするときには、各システムに固有の書き出しプログラム・プロシージャーを指
定するか、あるいは固有のジョブをソース JCL として使用する必要があります。
例: 外部書き出しプログラム用のカタログ式プロシージャー
このプロシージャーは、トレース・データを 2 つの DASD データ・セットに
入れます。このプロシージャーは SYS1.PROCLIB のメンバー WTRD2 に入っ
ています。
//WTDASD2
//IEFPROC
//TRCOUT01
//
//TRCOUT02
//
PROC
EXEC PGM=ITTTRCWR,REGION=32M
DD DSNAME=SYS1.CTRACE1,VOL=SER=TRACE6,UNIT=DASD,
SPACE=(CYL,10),DISP=(NEW,KEEP),DSORG=PS
DD DSNAME=SYS1.CTRACE2,VOL=SER=TRACE7,UNIT=DASD,
SPACE=(CYL,10),DISP=(NEW,KEEP),DSORG=PS
外部書き出しプログラム用のソース JCL に関する規則:
v TRACE CT コマンドまたは CTncccxx parmlib メンバーで指定する名前は、ソー
ス JCL のメンバー名であり、前の例では WTRD2 です。この名前は 1 文字から
7 文字までの英数字または国別文字で、最初の文字は英字または国別文字です。
国別文字は、次の 16 進数コードで表されます。
コード
米国英語の EBCDIC 文字
X'5B'
$
X'7B'
#
X'7C'
@
他の言語では、これらのコードは別の文字を表します。
第 11 章 コンポーネント・トレース
11-17
コンポーネント・トレース
v プロシージャーでは外部書き出しプログラム ITTTRCWR を呼び出す必要があり
ます。 EXEC ステートメントに REGION= キーワードをコーディングして、外
部書き出しプログラムが必要とする最大ストレージ・サイズを指定します。
v ソース JCL では、16 までのトレース・データ・セットを指定できます。DD ス
テートメントの DD 名は TRCOUTxx であり、xx は 01 から 16 までです。
v トレース・データ・セットは順次データ・セットでなければなりません。
v トレース・データ・セットを管理しやすくするためには、データ・セット名がコ
ンポーネント・トレースやデータなどを表すように命名規則を設定してくださ
い。
v すべてのデータ・セットは DASD またはテープ上になければなりません。テー
プと DASD の両方を使用するなど、装置クラスを混合しないでください。
IBM では、装置クラスで、たとえば 3380 と 3390 といった複数のタイプの装置
を混合しないようお勧めしています。装置タイプが混合されている場合は、シス
テムはそのうちの最小のブロック・サイズをすべてのデータ・セットに使用しま
す。
v 以下の DCB パラメーターは指定しないでください。
– BLKSIZE。システムは最適のブロック・サイズ (4096 またはそれ以上) を使用
します。
– RECFM。システムは VB を使用します。
– LRECL。システムは BLKSIZE から 4 を引いた値を使用します。
v DISP=SHR を指定しないでください。
v トレース・データ・セットを連結しないでください。
v 複数のトレースを同じメンバーに接続することができます が、各コンポーネント
のトレースには別個のメンバーを使用してください。
v あるコンポーネントのすべてのサブレベル・トレースには、同じメンバーを使用
してください。この方法により、管理する必要のあるデータ・セットの数を減ら
すことができます。
v コンポーネント・トレースがシスプレックス内の複数のシステムで実行される場
合には、各システムのコンポーネント・トレースに別個のメンバーを使用してく
ださい。コンポーネント・トレースで共用 SYS1.PROCLIB 内の同じカタログ式
プロシージャーを指定すると、これらのプロシージャーは同じデータ・セットま
たはデータ・セットのグループを使用します。この場合、1 つまたは複数のデー
タ・セットに関して競合が起こることがあります。
v システム・セキュリティーの観点から、トレース・データ・セットにアクセスす
るには RACF SYSHIGH 権限が必要なことがあります。
z/OS V1R7 は、以下のタイプの外部メディアをサポートします。
v DSNTYPE=LARGE データ・セット
v VSAM 線形データ・セット
トレース・データ・セットの折り返し: CTncccxx parmlib メンバーまたは TRACE
CT オペレーター・コマンドの WTRSTART パラメーターでは以下の値を指定しま
す。
11-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
v WRAP またはパラメーターの省略: システムがデータ・セットまたはデータ・セ
ットのグループの終わりに達すると、システムはそのデータ・セットまたはグル
ープ内の最初のデータ・セットの先頭部分にある最も古いデータの上に上書きし
ます。
システムはまた、1 つまたは複数のデータ・セットの (1 つまたは複数の) 1 次エ
クステントだけを使用します。スペースが割り振られるトレース項目数を最大限
に制御できるようにするためには、スペース割り振りを、2 次スペースなしで、
トレース・データ・セットの BLKSIZE の単位で指定し、連続割り振りのオプシ
ョンを使用してください。たとえば、BLKSIZE が 8192 の場合、SPACE キーワ
ードを次のようにコーディングしてください。
SPACE=(8192,(500,0),,CONTIG)
v NOWRAP: 1 つまたは複数のデータ・セットがいっぱいになると、システムはそ
のデータ・セットへのトレース・レコードの書き込みを停止します。システム
は、引き続きアドレス・スペース・バッファーにトレース・レコードを書き込み
ます。
システムはまた、1 つまたは複数のデータ・セットの 1 次エクステントと 2 次
エクステントだけを使用します。
複数のトレース・データ・セット: 活動のピーク時にもすべてのトレース・レコー
ドを捕そくするには、複数のデータ・セットを使用してください。SYSRSM トレー
スの場合、一般的に多数のトレース・レコードが作成されるため、レコードが失わ
れるのを防ぐために複数のデータ・セットを使用してください。複数のトレース・
データ・セットで異なる DASD 装置を使用すると、パフォーマンスを向上させるこ
とができます。トレース・レコードを発生順に表示するために、システム・プログ
ラマーは次のようにできます。
v IPCS COPYTRC サブコマンドを使用し、トレース・レコードを結合して 1 つの
データ・セットを作成してから、CTRACE サブコマンドを使用してそのデータ・
セットのレコードをフォーマット設定する。
v IPCS MERGE サブコマンドを使用して、複数のデータ・セットから得られたレコ
ードをフォーマット設定する。
システムは、コンポーネント・トレース・レコードを各トレース・データ・セット
に順に収めます。たとえば、データ・セットが 3 つある場合、システムはレコード
を次のように配置します。
v レコード 1 をデータ・セット 1 に
v レコード 2 をデータ・セット 2 に
v レコード 3 をデータ・セット 3 に
v レコード 4 をデータ・セット 1 に
v レコード 5 をデータ・セット 2 に
v 以下同様
トレース・データ脱落: Ctrace は、出力メディアに到達しないトレース・データが
あった場合に、次に正常に書き込まれたレコードでそれを示します。そのデータの
あとでレコードが書き込まれない場合には、外部書き出しプログラムが停止したと
きに次のメッセージが表示されます。
第 11 章 コンポーネント・トレース
11-19
コンポーネント・トレース
ITT120I SOME CTRACE DATA HAS BEEN LOST.
LAST nnn BUFFERS NOT WRITTEN.
parmlib メンバーの作成
parmlib メンバーを使用する場合には、そのメンバーを作成して SYS1.PARMLIB に
入れてください。オプションが複雑で、しかも SYS1.PARMLIB データ・セットに
対するアクセス権限がある場合、コンポーネントが parmlib メンバーを必要とする
場合、または必要なオプションを指定する parmlib メンバーをすでに設定してある
場合には、parmlib メンバーを使用してください。単純なオプションの場合には、
REPLY を使用してください。
11-3 ページの『いくつかのコンポーネントに関する CTncccxx parmlib メンバーの
作成』を参照してください。
例: CTWXCF04 parmlib メンバー
XCF の場合、CTWXCF04 を作成してください。書き出しプログラムの 2 つ
のステートメントに注意してください。WTRSTART ステートメントは書き出
しプログラムを開始し、WTR ステートメントは書き出しプログラムをコンポ
ーネントに接続します。
TRACEOPTS
WTRSTART(WTDASD2)
ON
WTR(WTDASD2)
OPTIONS(’SERIAL’,’STATUS’)
トレース・データ・セットに対するコンポーネント・トレースの実行
これらのタスクはオペレーターが実行します。これらのタスクは、初期設定時にシ
ステムが開始するトレース用ではなく、特定のコンポーネント用のタスクであるこ
とにご注意ください。
1. 書き出しプログラムおよびコンポーネント・トレースの開始: オペレーターは
MVS マスター権限を備えたコンソール上で、TRACE オペレーター・コマンドを入
力し、システム・プログラマーが指定したオプションを指定して、応答します。
例: parmlib メンバーを指定しない TRACE CT コマンド
2 番目の TRACE CT コマンドで SYSXCF トレースを開始します。そのトレ
ース・オプションは、前の例で選択されたものです。書き出しプログラムの 2
つのオペランドに注意してください。WTRSTART オペランドは書き出しプロ
グラムを開始し、WTR オペランドは書き出しプログラムをコンポーネントに
接続します。
trace ct,wtrstart=wtdasd2
trace ct,on,comp=sysxcf
* 44 ITT006A ....
r 44,wtr=wtdasd2,options=(serial,status),end
11-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例: parmlib メンバーを指定する TRACE CT コマンド
この例では、parmlib メンバー CTWXCF04 を使用して、同じトレースを要求
します。
trace ct,on,comp=sysxcf,parm=ctwxcf04
2. トレースと書き出しプログラムが実行されていることを確認します: 11-25 ペー
ジの『コンポーネント・トレースの検査』を参照してください。
3. コンポーネント・トレースの停止: オペレーターは TRACE CT コマンドを
MVS マスター権限を備えたコンソールから入力します。
例 1: TRACE CT,OFF コマンド
trace ct,off,comp=sysxcf
* 56 ITT006A ....
r 56,end
例 2: 書き出しプログラムを切断するための TRACE CT コマンド
トレース・データ・セットへのトレース・レコードの送信だけを停止して、ト
レースの実行を続けたい場合、オペレーターはトレースが実行されているとき
に次のように入力できます。
trace ct,on,comp=sysxcf
* 56 ITT006A ....
r 56,wtr=disconnect,end
オペレーターは、外部書き出しプログラムを停止する必要があります。
4. 外部書き出しプログラムの停止: オペレーターは TRACE CT コマンドを MVS
マスター権限を備えたコンソールから入力します。
例: TRACE CT,WTRSTOP コマンド
trace ct,wtrstop=wtdasd2
トレース・データ・セットの変更
コンポーネント・トレースを 1 つまたは複数のトレース・データ・セットに対して
実行している場合、必要なレコードが得られているかどうかを、トレースを停止し
ないで判別できます。オペレーターに対して、次のことを行うように指示してくだ
さい。
1. トレース・データ・セットに書き出しを行うそれぞれの外部書き出しプログラム
について、異なるソース JCL のセットを指定して TRACE CT,WTRSTART コ
マンドを入力してください。
第 11 章 コンポーネント・トレース
11-21
コンポーネント・トレース
2. 書き出しプログラムに対応する異なるソース JCL を使用して、トレースを開始
するための TRACE CT コマンドを入力してください。
新しいソース JCL により、トレース・レコードが新しい 1 つまたは複数のデー
タ・セットに送信されます。若干のトレース・レコードが失われることがありま
す。
直前の 1 つまたは複数のデータ・セットを見て、収集されたトレース・レコードを
調べ、そのあとで必要に応じてトレースを続行または停止することができます。
例: トレース・データ・セットの変更
元のコマンドは次のとおりです。
trace ct,wtrstart=wtdasd2
trace ct,on,comp=sysxcf
* 67 ITT006A ...
r 67 wtr=wtdasd2,options(serial,status),end
このトレース・データ・セットを変更するためのコマンドは次のとおりです。
trace ct,wtrstart=wtdasd4
trace ct,on,comp=sysxcf
* 67 ITT006A ...
r 67 wtr=wtdasd4,options(serial,status),end
シスプレックス内のシステムに関するコンポーネント・トレースの要求
このトピックでは、シスプレックス内の複数のシステム上の、1 つのコンポーネン
トに関するトレースを獲得する方法を説明します。この方法では、各システムのダ
ンプにトレースを獲得し、IPCS MERGE サブコマンドを使用してそれらのダンプ・
トレースをマージします。診断に役立てるためには、これらのトレースは同じ期間
を対象とする必要があり、また同時に終了する必要があります。このトピックには
以下の項目が含まれます。
v 『シスプレックス内のシステムでのコンポーネント・トレースの準備』
v 11-23 ページの『シスプレックス内のシステムでのコンポーネント・トレースの
実行』
各システムが外部書き出しプログラムごとに固有のソース JCL を使用している場合
には、データ・セットに対するトレースを行って、各システムに関するトレースが
独自のデータ・セットに送られるようにすることもできます。インストール・シス
テムで共有 SYS1.PROCLIB システム・ライブラリーを使用している場合には、各
システムに固有の parmlib メンバーを使用してください。それぞれの固有 parmlib
メンバーでは固有のソース JCL を指定しなければなりません。ソース JCL が共有
されている場合と、すべてのシステムはトレース・レコードを 1 つのデータ・セッ
トに書き込むため、競合の問題が発生することがあります。
シスプレックス内のシステムでのコンポーネント・トレースの準備
これらのタスクは、システム・プログラマーが実行します。
1. トレースを開始するための parmlib メンバーを作成してください: コンポーネン
トのトレースを開始するための parmlib メンバーを作成してください。このメンバ
11-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
ーをシスプレックスの共有 SYS1.PARMLIB またはトレース対象の各システムの
parmlib に入れてください。各システムごとに parmlib メンバーを使用する場合に
は、それらのメンバーに同じ名前を指定して、システム上のすべてのコンポーネン
ト・トレースを 1 つの TRACE CT コマンドで開始できるようにしてください。
11-3 ページの『いくつかのコンポーネントに関する CTncccxx parmlib メンバーの
作成』を参照してください。
例: XCF トレースを開始するための CTWXCF33
XCF の場合には、トレースを開始するために CTWXCF33 を作成してくださ
い。
TRACEOPTS
ON
OPTIONS(’SERIAL’,’STATUS’)
このタスクに関する指示では、parmlib メンバーが使用できることを想定していま
す。トレース対象のコンポーネントに parmlib メンバーが含まれない場合、オペレ
ーターは、ROUTE コマンドで TRACE CT コマンドを使用して開始できます。オ
ペレーターは、システムごとに応答を入力する必要があります。(ROUTE コマンド
は JES2 がインストールされた MVS システムだけで使用できます。)
2. コンポーネント・トレース・バッファーがダンプされることを確認してください:
アドレス・スペース・トレース・バッファーおよびデータ・スペース・トレース・
バッファーの位置は、トレースするコンポーネントに依存しています。XCF では、
XCF アドレス・スペースの拡張ローカル・システム・キュー・エリア (ELSQA) に
はコンポーネント・トレース・バッファーが含まれます。XES では、IXLCTCAD
(XCF アドレス・スペースに関連するデータ・スペース) には、XES コンポーネン
ト・トレース・バッファーが含まれます。
例: XCF および XES トレース・バッファーの獲得
v XCF では、オペレーターは DUMP コマンドに対する REPLY で SQA お
よび LSQA を指定しなければなりません。
v XES では、オペレーターは DUMP コマンドに対する REPLY で
SDATA=(XESDATA) および DSPNAME=(asid.IXLCTCAD) を指定しなけれ
ばなりません。この場合、asid は ‘XCFAS’ または 6 です。
シスプレックス内のシステムでのコンポーネント・トレースの実行
これらのタスクはオペレーターが実行します。これらのタスクは、初期設定時にシ
ステムが開始するトレース用ではなく、特定のコンポーネント用のタスクであるこ
とにご注意ください。
1. コンポーネント・トレースの開始: オペレーターはシスプレックス内のシステム
上の MVS マスター権限を備えたコンソールから TRACE CT コマンドを含む
ROUTE コマンドを入力します。 (ROUTE コマンドは JES2 がインストールされた
MVS システムだけで使用できます。)
第 11 章 コンポーネント・トレース
11-23
コンポーネント・トレース
このコマンドでは、トレース対象の各システムについて同じ名前の parmlib メンバ
ーを指定します。parmlib メンバーを指定しない場合には、すべてのシステムでメッ
セージ ITT006A が発行され、オプション入力を示すプロンプト指示が出されます。
トレース対象のコンポーネントに parmlib メンバーが含まれない場合、IBM 提供の
CTIITT00 メンバーを指定して、プロンプト指示が出されないようにしてください。
例 1: すべてのシステムでトレースを開始するためのコマンド
このコマンドは、シスプレックス内のすべてのシステムでトレースを開始しま
す。
route *all,trace ct,on,comp=sysxcf,parm=ctwxcf33
例 2: 一部のシステムでトレースを開始するためのコマンド
このコマンドは、シスプレックス内のシステムのサブセットでトレースを開始
します。どちらのコマンドでも、トレース対象の各システムで CTWXCF33
parmlib メンバーが指定されています。
route subs2,trace ct,on,comp=sysxcf,parm=ctwxcf33
例 3: parmlib メンバーを指定しないコンポーネントのためのコマンド
次のコマンドは、TRACE コマンドに対する応答を求めるプロンプト指示なし
で、シスプレックス内のシステムで SYSVLF トレースをオンにします。
SYSVLF コンポーネント・トレースでは parmlib メンバーは使用されません。
route *all,trace ct,on,comp=sysvlf,parm=ctiitt00
2. トレースが実行されていることを確認してください: 11-25 ページの『コンポー
ネント・トレースの検査』を参照してください。
3. コンポーネント・トレース・レコードを含むダンプを入手してください: オペレ
ーターは、トレース対象のシステムごとに SVC ダンプを要求します。
11-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例: シスプレックス内のシステムに関する DUMP コマンド
この例は、シスプレックス内の 1 つのシステムにある MVS マスター権限を
備えたコンソールから入力された DUMP オペレーター・コマンドを示してい
ます。応答では、名前が S* のパターンになっているすべてのシステムのダン
プを要求しています。この例では、トレース対象のシステムの名前が
S1、S2、 S3、および S4 になっていることを想定しています。シスプレック
ス内にあるその他のシステムの名前は、B1 または T2 などのように、このパ
ターンに適合しません。
dump comm=(dump for xcf component trace)
* 32 IEE094D ...
r 32,remote=(syslist=(s*)),end
.
.
.
IEA911E ...
システムは、メッセージ IEA911E で、ダンプが入っているデータ・セットを示しま
す。出口によってダンプが移動した場合には、オペレーターに依頼して、移動した
ダンプを含むデータ・セットを示すメッセージを探して、ダンプの名前とそれを含
むデータ・セットを調べてもらう必要があります。
4. コンポーネント・トレースの停止: オペレーターはシスプレックス内のシステム
で MVS マスター権限を備えたコンソールから TRACE CT,OFF コマンドを含む
ROUTE コマンドを入力してトレースを停止します。 (ROUTE コマンドは JES2 が
インストールされた MVS システムだけで使用できます。)
例 1: すべてのシステムでトレースを停止するためのコマンド
次のコマンドを入力すると、シスプレックス内のすべてのシステムでトレース
が停止します。
route *all,trace ct,off,comp=sysxcf
例 2: 一部のシステムでトレースを停止するためのコマンド
次のコマンドを入力すると、シスプレックス内のシステムのサブセットでトレ
ースが停止します。
route subs2,trace ct,off,comp=sysxcf
コンポーネント・トレースの検査
オペレーターは、コンポーネント・トレースを開始したあとでこのタスクを実行
し、トレースが正常に開始したことを確認する必要があります。タスクの実行方法
は、コンポーネント・トレースにサブレベルがあるかどうかおよび外部書き出しプ
ログラムを使用するかどうかで決まります。このトピックには以下の項目が含まれ
ます。
第 11 章 コンポーネント・トレース
11-25
コンポーネント・トレース
v 『サブレベルのないコンポーネント・トレースの場合のトレースの検査』
v 『サブレベルのあるコンポーネント・トレースの場合のトレースの検査』
v 11-28 ページの『書き出しプログラムが活動状態であることの検査』
サブレベルのないコンポーネント・トレースの場合のトレースの検査
オペレーターは、次のいずれかを行う必要があります。
v MVS マスター権限を備えたコンソールから以下の DISPLAY TRACE コマンドを
入力して、すべての現行トレースを表示する。メッセージ IEE843I で示される応
答は、すべての現行コンポーネント・トレースの状況を単形式で示します。
display trace
IEE843I ...
v MVS マスター権限を備えたコンソールから以下のいずれかの DISPLAY TRACE
コマンドを入力して、現行トレースおよびトレースのオプションを表示する。最
初のコマンドはすべての現行コンポーネント・トレースに関する状況を要求し、
2 番目のコマンドは XCF などの 1 つのコンポーネント・トレースに関する状況
を要求します。メッセージ IEE843I で示される応答は、状況に関する詳しい情報
を示します。
display trace,comp=all
IEE843I ...
display trace,comp=sysxcf
IEE843I ...
サブレベルのあるコンポーネント・トレースの場合のトレースの検査
検査のためのコマンドは、コンポーネント・トレースによって異なります。
SYSJES コンポーネント・トレースの検査: SYSJES トレースを検査するには、オ
ペレーターは以下のコマンドを入力します。
display trace,comp=sysjes,sublevel,n=4
システムは 4 つのサブレベル・トレースを表示します。
SYSXES コンポーネント・トレースの検査: SYSXES コンポーネント・トレースに
複数のサブレベル・トレースがある場合、DISPLAY コマンドはサブレベルのうちの
1 つだけを表示します。オペレーターは、複数のサブレベルを調べるためには複数
の DISPLAY コマンドを入力する必要があります。
SYSXES コンポーネント・トレースには、構造体、アドレス・スペース、および接
続が含まれます。以下の例はオペレーターが入力した DISPLAY (D) コマンドと、
システムが戻す情報のタイプを示しています。
1. SYSXES コンポーネント・トレースが設定される方法を参照するための例。
D TRACE,COMP=SYSXES
IEE843I 15.24.40 TRACE DISPLAY 213
SYSTEM STATUS INFORMATION
ST=(ON,0064K,00128K) AS=ON BR=OFF EX=ON MT=(ON,024K)
COMPONENT
MODE BUFFER HEAD SUBS
-------------------------------------------------------SYSXES
ON
0168K HEAD
2
11-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
ASIDS
JOBNAMES
OPTIONS
WRITER
*NOT SUPPORTED*
*NOT SUPPORTED*
LOCKMGR
*NONE*
2. 各構造の構造レベル・トレースと使用可能なサブトレースの数を表示するための
例。
D TRACE,COMP=SYSXES,SUB=(LT01),N=99
IEE843I 15.25.00 TRACE DISPLAY 216
SYSTEM STATUS INFORMATION
ST=(ON,0064K,00128K) AS=ON BR=OFF EX=ON MT=(ON,024K)
TRACENAME
=========
SYSXES
MODE BUFFER HEAD SUBS
=====================
ON
0168K HEAD
2
ASIDS
*NOT SUPPORTED*
JOBNAMES *NOT SUPPORTED*
OPTIONS
LOCKMGR
WRITER
*NONE*
SUBTRACE
MODE BUFFER HEAD SUBS
---------------------------------------------------------LT01
HEAD
1
LIKEHEAD
----------------------------------------------------GLOBAL
LIKEHEAD
3. 各構造のアドレス・スペース・レベル・トレースを表示するための例。(指定さ
れている ASID は、コネクターのアドレス・スペースの asid を 16 進数で指定
したものです。)
D TRACE,COMP=SYSXES,SUB=(LT01.ASID(19)),N=99
IEE843I 15.25.39 TRACE DISPLAY 221
SYSTEM STATUS INFORMATION
ST=(ON,0064K,00128K) AS=ON BR=OFF EX=ON MT=(ON,024K)
TRACENAME
=========
SYSXES.LT01
MODE BUFFER HEAD SUBS
=====================
ON
0168K HEAD
1
LIKEHEAD
ASIDS
*NOT SUPPORTED*
JOBNAMES *NOT SUPPORTED*
OPTIONS
LOCKMGR
WRITER
*NONE*
SUBTRACE
MODE BUFFER HEAD SUBS
-------------------------------------------------------------ASID(0019)
HEAD
8
LIKEHEAD
4. 外部書き出しプログラム、バッファー・サイズ、および接続と関連するオプショ
ンを表示するための例。
D TRACE,COMP=SYSXES,SUB=(LT01.ASID(19).A1),N=99
IEE843I 15.25.56 TRACE DISPLAY 224
SYSTEM STATUS INFORMATION
ST=(ON,0064K,00128K) AS=ON BR=OFF EX=ON
TRACENAME
=========
SYSXES.LT01.ASID(0019)
MT=(ON,024K)
第 11 章 コンポーネント・トレース
11-27
コンポーネント・トレース
MODE BUFFER HEAD SUBS
=====================
ON
0168K HEAD
8
LIKEHEAD
ASIDS
*NOT SUPPORTED*
JOBNAMES
*NOT SUPPORTED*
OPTIONS
LOCKMGR
WRITER
*NONE*
SUBTRACE
MODE BUFFER HEAD SUBS
-------------------------------------------------------------A1
ON
0100K
ASIDS
*NOT SUPPORTED*
JOBNAMES
*NOT SUPPORTED*
OPTIONS
CONNECT,RECOVERY
WRITER
*NONE*
書き出しプログラムが活動状態であることの検査
外部書き出しプログラムが使用されている場合、オペレーターは、MVS マスター権
限を備えたコンソールで以下のいずれかの DISPLAY TRACE コマンドを入力し
て、そのトレースに関して書き出しプログラムが活動状態になっているかどうかを
検査する必要があります。最初のコマンドはすべての現行コンポーネント・トレー
スに関する書き出しプログラムの状況を要求し、2 番目のコマンドは書き出しプロ
グラムのソース JCL のメンバー名 (たとえば、 WTDASD2 など) を指定して 1 つ
の書き出しプログラムの状況を要求します。応答はメッセージ IEE843I で示されま
す。
display trace,wtr=all
IEE843I ...
display trace,wtr=wtdasd2
IEE843I ...
オペレーターは、ここで表示される書き出しプログラムのソース JCL が、そのトレ
ース用に開始された書き出しプログラムのソース JCL と同じになっていることを検
査する必要があります。メンバー名が一致していない場合、コンポーネント・トレ
ース・データは失われます。オペレーターは、DISPLAY コマンドで表示された書き
出しプログラムのジョブと、コンポーネント・トレースを停止したうえで、正しい
書き出しプログラムのソース JCL を開始して、トレースを開始し直す必要がありま
す。
コンポーネント・トレース・データの表示
診断中に、システム・プログラマーは IPCS を使用して以下のタスクを実行しま
す。
参照
COPYDUMP、COPYTRC、CTRACE、GTFTRACE および MERGE サブコマンドに
ついては、「z/OS MVS IPCS コマンド」を参照してください。
1. トレースが SYS1.DUMPxx データ・セット内のダンプに入っている場合には、
COPYDUMP サブコマンドを入力してダンプを別のデータ・セットに移動させてく
ださい。 COPYDUMP サブコマンドを選択するには、IPCS ダイアログのオプショ
ン 5.3 を使用してください。
11-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
2. トレース・データ・セット内のすべてのトレースについて、COPYTRC サブコマ
ンドを使用し、 発生順になっていないコンポーネント・トレース・レコードの順序
を変更してください。 COPYTRC サブコマンドを選択するには、IPCS ダイアログ
のオプション 5.3 を使用してください。
3. トレースが複数のデータ・セットに入っている場合には、 以下のいずれかのこ
とを行って、トレース・レコードを発生順に 1 つにまとめて表示してください。こ
れは、問題の発生時に起こったことを理解するために必要です。入力データ・セッ
トは、コンポーネント・トレース・データ・セット、SVC ダンプ、またはスタンド
アロン・ダンプのいずれかです。
v COPYTRC サブコマンドを使用して、複数のデータ・セットに入っているレコー
ドを結合し、1 つのデータ・セットに発生順に収めてください。このデータ・セ
ットを CTRACE サブコマンドの入力として使用し、このサブコマンドによりト
レース・レコードをフォーマット設定してください。COPYTRC サブコマンドを
選択するには、IPCS ダイアログのオプション 5.3 を使用してください。
v MERGE サブコマンドを使用して、1 つまたは複数の入力データ・セットから得
られたトレース・レコードをフォーマット設定してください。MERGE を使用す
ると、以下のトレースを結合およびフォーマット設定できます。
– コンポーネント・トレース
– GTF トレース
– 1 つのトレース・データ・セット上の 1 つのコンポーネントから得られたサ
ブレベル・トレース
– 別個の複数のトレース・データ・セット上の 1 つのコンポーネントから得ら
れたサブレベル・トレース
サブレベル・トレースの場合、MERGE は各サブレベルに関するトレース・レコ
ードをグループにまとめます。
MERGE サブコマンドを選択するには、IPCS ダイアログのオプション 2.7 を使
用してください。MERGE を使用すると、各入力データ・セットごとに個別の
CTRACE または GTFTRACE サブコマンドを発行できます。
4. コンポーネント・トレース・レコードをフォーマット設定するときには、以下の
サブコマンドを使用してください。SHORT、SUMMARY、FULL および TALLY レ
ポート・タイプ・キーワード、および CTRACE サブコマンドのためのその他のキ
ーワードについては、「z/OS MVS IPCS コマンド 」を参照してください。
|
|
|
トレース
IPCS サブコマンド
CTRACE OPTIONS パラメーター
SYSAPPC
CTRACE COMP(SYSAPPC)
11-36 ページの『SYSAPPC トレー
スのフォーマット設定』を参照。
SYSAXR
CTRACE COMP(SYSAXR)
11-50 ページの『SYSAXR トレー
スのフォーマット設定』を参照。
SYSDLF
CTRACE COMP(SYSDLF)
なし
SYSDSOM
CTRACE COMP(SYSDSOM)
11-53 ページの『SYSDSOM コン
ポーネント・トレース』を参照。
SYSGRS
CTRACE COMP(SYSGRS)
なし
SYSHZS
CTRACE COMP(SYSHZS)
11-62 ページの『SYSHZS コンポ
ーネント・トレース』を参照。
第 11 章 コンポーネント・トレース
11-29
コンポーネント・トレース
トレース
IPCS サブコマンド
CTRACE OPTIONS パラメーター
SYSIEFAL
CTRACE COMP(SYSIEFAL)
なし
SYSIOS
CTRACE COMP(SYSIOS)
11-78 ページの『SYSIOS トレース
のフォーマット設定』を参照。
SYSJES
CTRACE COMP(SYSJES)
11-86 ページの『SYSJES トレース
のフォーマット設定』を参照。
SYSjes2
CTRACE COMP(SYSjes2)
なし
SYSLLA
CTRACE COMP(SYSLLA)
なし
SYSLOGR
CTRACE COMP(SYSLOGR)
11-104 ページの『SYSLOGR トレ
ースのフォーマット設定』を参照。
SYSOMVS
CTRACE COMP(SYSOMVS)
11-109 ページの『SYSOMVS トレ
ースのフォーマット設定』を参照。
SYSOPS
CTRACE COMP(SYSOPS)
11-121 ページの『SYSOPS トレー
スのフォーマット設定』を参照。
SYSRRS
CTRACE COMP(SYSRRS)
11-128 ページの『SYSRRS トレー
スのフォーマット設定』を参照。
SYSRSM
CTRACE COMP(SYSRSM)
なし
SYSSPI
CTRACE COMP(SYSSPI)
なし
SYSTTRC
CTRACE COMP(SYSTTRC)
なし
SYSVLF
CTRACE COMP(SYSVLF)
なし
SYSWLM
CTRACE COMP(SYSWLM)
なし
SYSXCF
CTRACE COMP(SYSXCF)
11-162 ページの『SYSXCF トレー
スのフォーマット設定』を参照。
SYSXES
CTRACE COMP(SYSXES)
11-168 ページの『SYSXES トレー
スのフォーマット設定』を参照。
結合またはマージされたトレース・データ・セットに GTF トレース用の出力を含
まれている場合、GTFTRACE サブコマンドを使用して GTF レコードをフォーマッ
ト設定し、 CTRACE サブコマンドを使用してコンポーネント・トレース・レコー
ドをフォーマット設定してください。
参照
GTF トレースについては 10-1 ページの『第 10 章 汎用トレース機能 (GTF)』を参
照。
例: IPCS CTRACE サブコマンド
この例は、OPTIONS パラメーターで SERIAL および STATUS オプションを
要求した場合の、 SYSXCF コンポーネント・トレース用の CTRACE サブコ
マンドを示しています。
ctrace comp(sysxcf) options((serial,status))
11-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SYSAPPC コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、APPC/MVS 用の SYSAPPC コンポーネント・トレースを要求するための情
報を要約します。
情報
SYSAPPC の場合
parmlib メンバー
CTnAPPxx
デフォルト・メンバーはありません
デフォルトのトレース
なし。CTnAPPxx では ON または OFF にできませ
ん。
トレース要求の OPTIONS パラメー CTnAPPxx または TRACE コマンドの REPLY で指
ター
定します。
|
バッファー
v デフォルト: 512KB
v 範囲: 64KB - 32MB
v サイズの設定: CTnAPPxx メンバーまたは TRACE
コマンドの REPLY で指定
v IPL 後のサイズ変更: トレースの実行中に可能
v 場所: データ・スペース内。TRACE CT,OFF コマ
ンドが要求するダンプにトレース・バッファーが含
まれる。
トレース・レコードの場所
データ・スペース・バッファー
SVC ダンプの要求
オペレーターが TRACE CT,OFF コマンドによって
SYSAPPC トレースを停止したときにコンポーネント
によって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSAPPC)
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSAPPC トレースの要求
SYSAPPC コンポーネント・トレースを要求するオプションは、CTnAPPxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
第 11 章 コンポーネント・トレース
11-31
コンポーネント・トレース
CTnAPPxx parmlib メンバー
次の表は、CTnAPPxx parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTnAPPxx で指定可能かどうか
ON または OFF
いいえ
ASID
はい
JOBNAME
はい
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
いいえ
WTRSTART または WTRSTOP
いいえ
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnM、または OFF
1 つ必要
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
はい
OPTIONS
はい
WTR
いいえ
自動ダンプ: オペレーターがトレースを停止すると、コンポーネントが SVC ダンプ
を要求します。
OPTIONS パラメーター
APPC トレース要求オプションは階層構造になっています。 11-33 ページの図 11-1
は SYSAPPC トレース・オプションの階層を示しています。各オプションはそれぞ
れ独自のイベントと、その下にあるオプションのイベントをトレースします。たと
えば、SCHEDULE トレース・オプションを指定すると、システムは ENQWORK、
DEQWORK、および ASMANAGE イベントもトレースします。
11-32
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
┌────────────────────────┬──────────────┐
│
│
│
┌───┴──┐
┌──┴────┐
┌──┴───┐
│GLOBAL│
│USERID │
│NODUMP│
└───┬──┘
└───────┘
└──────┘
│
┌─────┴────────────────┐
│
│
┌───┴────┐
│
│GLOBALQK│
│
└────────┘
│
│
┌────────────────────────┬────────┴───────────┬─────────┬───────────┬──────────┐
│
│
│
│
│
│
┌───┴───┐
┌───┴────┐
┌──┴──┐ ┌───┴────┐ ┌───┴───┐ ┌───┴──┐
│INBOUND│
│SCHEDULE│
│VERBS│ │CONVCLUP│ │TRANSCH│ │SERVER│
└───┬───┘
└───┬────┘
└──┬──┘ └────────┘ └───────┘ └──────┘
│
│
│
┌────┴────┐
┌─────────┼─────────┐
│
│
│
│
│
│
│
┌───┴───┐ ┌───┴──┐ ┌───┴───┐ ┌───┴───┐ ┌───┴────┐ ┌──┴──┐
│ FMH5 │ │ FMH7 │ │ENQWORK│ │DEQWORK│ │ASMANAGE│ │ PBI │
└───┬───┘ └──────┘ └───────┘ └───────┘ └────────┘ └─────┘
│
┌───┴───┐
│BADFMH5│
└───────┘
図 11-1. SYSAPPC コンポーネント・トレース・オプションの階層
SYSAPPC トレースには、常にすべての例外 (エラー) イベントが含まれます。トレ
ース・オプションがなにも指定されていない場合、トレース出力には例外イベント
だけが含まれます。
エラーの発生場所が分からない場合には、GLOBAL トレース・オプションを指定し
て全範囲の APPC/MVS イベントを捕そくしてください。GLOBAL を指定するとパ
フォーマンスが低下しますが、1 回の再現でエラーを捕そくできます。
CTnAPPxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下に英字順で示します。
ASMANAGE
APPC/MVS トランザクション・スケジューラーの従属アドレス・スペースの作
成および削除に関連するイベントをトレースします。ASMANAGE は
SCHEDULE イベントのサブセットです。
BADFMH5
誤った FMH-5 に関連するイベントをトレースします。BADFMH5 は FMH-5
イベントのサブセットです。
CONVCLUP
会話終結処置に関連するイベントをトレースします。CONVCLUP は GLOBAL
イベントのサブセットです。
DEQWORK
APPC/MVS スケジューラー・キューから作業要求を除去する処理をトレースし
ます。DEQWORK は SCHEDULE イベントのサブセットです。
第 11 章 コンポーネント・トレース
11-33
コンポーネント・トレース
ENQWORK
APPC/MVS スケジューラー・キューに作業要求を追加する処理をトレースしま
す。ENQWORK は SCHEDULE イベントのサブセットです。
FMH5
FMH-5 イベントをトレースします。FMH5 は INBOUND イベントのサブセッ
トです。
FMH7
FMH-7 イベントをトレースします。FMH7 は INBOUND イベントのサブセッ
トです。
GLOBAL
APPC/MVS イベントの全範囲をトレースします。
GLOBALQK
重要な GLOBAL トレース・イベントのサブセットをトレースします。
INBOUND
インバウンド・トランザクション・プロセッサー (TP) 要求をトレースします。
INBOUND は GLOBAL イベントのサブセットです。
NODUMP
オペレーターが SYSAPPC コンポーネント・トレースを停止したときにダンプ
を取らないことを指定します。これを指定しない場合、オペレーターが TRACE
CT,OFF コマンドを使用してトレースを停止すると、コンポーネント・トレース
はトレース・データを含む SVC ダンプを要求します。
IBM では、NODUMP オプションを使用するとトレース・バッファーの取得が
困難となるため、これをお勧めしていません。 NODUMP オプションを使用す
ると、オペレーターが、バッファーを含むデータ・スペースを識別して、SLIP
コマンドまたは DUMP コマンドへの応答でそれを指定することが必要になりま
す。
PBI
プロトコル境界に関連するイベントをトレースします。PBI は VERBS イベン
トのサブセットです。
RR
保護された会話に関するリソース・リカバリーで APPC/MVS の参加に関連する
イベントをトレースします。 RR は VERBS イベントのサブセットです。
SERVER
APPC/MVS サーバーに関連するイベントをトレースします。SERVER は
GLOBAL イベントのサブセットです。
SCHEDULE
APPC/MVS トランザクション・スケジューラーに関連するイベントをトレース
します。SCHEDULE は GLOBAL イベントのサブセットです。
TRANSCH
APPC/MVS トランザクション・スケジューラーのインターフェース・サポート
に関連するイベントをトレースします。 TRANSCH は GLOBAL イベントのサ
ブセットです。
11-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
USERID=(userid,userid)
指定した 1 つまたは複数の特定のユーザー ID だけに関するイベントをトレー
スします。APPC/MVS アプリケーションに関する問題を報告する担当者の
TSO/E ユーザー ID を指定してください。ユーザー ID は 1 つから 9 つまで
指定できます。
VERBS
アウトバウンド TP または LU サービスに関連するイベントをトレースしま
す。VERBS は GLOBAL イベントのサブセットです。
SYSAPPC トレースの要求の例
例 1: CTnAPPxx メンバー
このメンバーは、JOHNDOE という TSO/E ユーザー ID に関する 1 つまた
は複数のアドレス・スペースについて、SERVER および VERBS オプション
を要求しています。
TRACEOPTS
OPTIONS(’SERVER’,’VERBS’,’USERID=(JOHNDOE)’)
例 2: parmlib メンバーを指定する TRACE コマンド
この例では、parmlib メンバー CTWAPP03 からオプションを獲得するように
指定しています。
trace ct,on,comp=sysappc,parm=ctwapp03
例 3: REPLY でオプションを指定する TRACE コマンド
この例では例 2 と同じトレースを要求していますが、すべてのオプションを
REPLY で指定しています。
trace ct,on,comp=sysappc
* 15 ITT006A ...
reply 15,options=(server,verbs,userid=(johndoe)),end
例 4: GLOBAL オプションを要求する TRACE コマンド
この例では、APPC/MVS を使用するすべてのアドレス・スペースについて
GLOBAL オプションを要求しています。
trace ct,on,comp=sysappc
* 14 ITT006A ...
reply 14,options=(global),end
第 11 章 コンポーネント・トレース
11-35
コンポーネント・トレース
SYSAPPC トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSAPPC) サブコマンドを
使用して行います。このサブコマンドの OPTIONS パラメーターでは、フォーマッ
ト設定するトレース・レコードを選択するためのオプションを指定します。ユーザ
ーが指定するフォーマット設定オプションは、要求されたトレース・オプションに
応じて大きく異なります。オプションを使用して表示されるレコードの範囲を狭く
して、エラーを見付けやすくしてください。CTRACE サブコマンドでオプションを
なにも指定しなかった場合、IPCS はすべてのトレース・レコードを表示します。
オプションは以下のとおりです。最初のオプションは FILTER または CORRELATE
のいずれかです。これらは相互に排他的なオプションです。最初に指定したオプシ
ョンにより、他のオプションによるレコードの選択方法が制御されます。
FILTER
FILTER オプションを指定すると、指定されたオプションのいずれかに一致する
トレース・レコードだけが選択されます。FILTER オプションを指定した場合に
有効なオプションは以下のとおりです。
AQTOKEN
CONVCOR
CONVID
FUNCID
INSTNUM
LUNAME
LUWID
NETNAME
SEQNUM
SESSID
TPIDPRI
TPIDSEC
URID
USERID
FILTER を指定した場合の OPTION パラメーターのフォーマットは、次のとお
りです。
OPTION((FILTER,option))
OPTION((FILTER,option,option, ... ,option))
CORRELATE
CORRELATE オプションを指定すると、指定されたオプションと一致するトレ
ース・レコードが選択され、指定されなかったオプションについては、オプショ
ンのデフォルト値が使用されます。指定しなかったオプションのデフォルト値の
検出方法は、DEFAULTS キーワードで定義します。CORRELATE オプションを
指定した場合に有効なオプションは以下のとおりです。
AQTOKEN
CONVCOR
CONVID
DEFAULTS
INSTNUM
LUNAME
LUWID
11-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
NETNAME
SEQNUM
SESSID
TPIDPRI
TPIDSEC
URID
CORRELATE を指定した場合の OPTION パラメーターのフォーマットは、次
のとおりです。
OPTION((CORRELATE,option))
OPTION((CORRELATE,option,option, ... ,option))
AQTOKEN(allocate-queue-token)
FILTER または CORRELATE のいずれかのオプションとともに使用して、割り
振りキュー・トークンを指定します。allocate-queue-token は 8 バイトの 16 進
数ストリングです。
CONVCOR(conversation-correlator)
FILTER または CORRELATE のいずれかのオプションとともに使用して、会話
相関を指定します。conversation-correlator は 8 バイトの 16 進数ストリングで
す。
CONVID(conversation-id)
FILTER または CORRELATE のいずれかのオプションとともに使用して、会話
ID を指定します。conversation-id は 4 バイトの 16 進数ストリングです。
||DEFAULTS(NONEANYEXACT)
CORRELATE オプションを指定したときにだけ使用して、指定されなかったオ
プションのマッチングに使用する値を指定します。
NONE
指定されたオプションのうちの 1 つまたは複数に一致するトレース・レコ
ードだけをフォーマット設定するように、コンポーネント・トレースに指示
します。NONE はデフォルトです。
ANY
以下のトレース・レコードをフォーマット設定するように、コンポーネン
ト・トレースに指示します。
v 指定されたオプションのうちの 1 つまたは複数に一致するトレース・レ
コード
v 指定されていないオプションについて設定されたデフォルト値に一致する
関連トレース・レコード。コンポーネント・トレースは、指定されたオプ
ションのいずれかに一致する最初のレコードから検出された未指定オプシ
ョンの値を、デフォルトとして使用します。
EXACT
以下のトレース・レコードをフォーマット設定するように、コンポーネン
ト・トレースに指示します。
v 指定されたオプションのうちの 1 つまたは複数に一致するトレース・レ
コード
v 指定されていないオプションについて設定されたデフォルト値に一致する
関連トレース・レコード。コンポーネント・トレースは、指定されたオプ
第 11 章 コンポーネント・トレース
11-37
コンポーネント・トレース
ションのすべてに一致する最初のレコードから検出された未指定オプショ
ンの値を、デフォルトとして使用します。
FUNCID(function-id)
FILTER オプションを指定したときにだけ使用して、フォーマット設定する
APPC/MVS サブコンポーネント・トレース・レコードを指定します。
function-id には、次のいずれかの値を指定します。
01
リカバリー
02
Verb サービス
03
FMH-5 管理機能
04
会話管理機能
05
システム・データ・ファイル管理機能 (SDFM)
06
VTAM 出口
07
LU 管理機能
08
状態マシン
09
テスト使用可能性
10
APPC/MVS スケジューラー (ASCH)
11
トランザクション・スケジューラー・インターフェース
12
割り振りキュー・サービス
INSTNUM(instance-number)
FILTER または CORRELATE のいずれかのオプションとともに使用して、論理
作業単位のインスタンス番号を指定します。instance-number は 6 バイトの 16
進数ストリングです。
LUNAME(local-luname)
FILTER または CORRELATE のいずれかのオプションとともに使用して、論理
作業単位の LU 名を指定します。local-luname は 8 バイトの EBCDIC 文字ス
トリングです。
LUWID(logical-unit-of-work-id)
FILTER または CORRELATE オプションのいずれかを使用して作業論理単位
ID を指定します。作業論理単位 ID は、1 つの同期点から次の同期点へプログ
ラムが行う処理を表します。logical-unit-of-work-id を指定するためには、16 進
数ストリングを、CTRACE レポートに表示されているとおりに、ブランク・ス
ペースを含めずに入力してください。
NETNAME(network-name)
FILTER または CORRELATE のいずれかのオプションとともに使用して、論理
作業単位のネットワーク名を指定します。network-name は 8 バイトの EBCDIC
文字ストリングで、ネットワーク修飾 LU 名のネットワーク ID 部分と同じで
す。
SEQNUM(sequence-number)
FILTER または CORRELATE のいずれかのオプションとともに使用して、論理
作業単位のシーケンス番号を指定します。sequence-number は 2 バイトの 16
進数ストリングです。
11-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SESSID(session-id)
FILTER または CORRELATE のいずれかのオプションとともに使用して、セッ
ション ID を指定します。session-id は 8 バイトの 16 進数ストリングです。
TPIDPRI(tp-id)
FILTER または CORRELATE のいずれかのオプションとともに使用して、1 次
TP ID を指定します。tp-id は 8 バイトの 16 進数ストリングです。
TPIDSEC(tp-id)
FILTER または CORRELATE のいずれかのオプションとともに使用して、複数
トランザクション TP 用の 2 次 TP ID を指定します。tp-id は 8 バイトの 16
進数ストリングです。
URID(unit-of-recovery-id)
FILTER または CORRELATE のいずれかのオプションとともに使用して、リカ
バリー単位を指定します。リカバリー単位は保護された会話の TP 処理の一部
を表します。unit-of-recovery-id は 32 バイトの 16 進数ストリングです。
USERID(userid)
FILTER オプションを指定したときにだけ使用して、フィルターとして使用され
るユーザー ID を指定します。userid は 8 バイトの EBCDIC 文字ストリング
です。
SYSAPPC トレースをフォーマット設定するサブコマンドの例
例 1: すべてのトレース項目を表示するための CTRACE サブコマンド
すべての SYSAPPC トレース・レコードを表示するには、次のサブコマンドを
入力してください。
CTRACE COMP(SYSAPPC)
例 2: 例外項目を表示するための CTRACE サブコマンド
異常終了または VTAM 戻りコードなどの異常な SYSAPPC イベントをフォー
マット設定するには、次のサブコマンドを入力してください。
CTRACE COMP(SYSAPPC) EXCEPTION
例 3: サブコンポーネントに関する CTRACE サブコマンド
1 つの APPC/MVS サブコンポーネントに関するすべてのレコードをフォーマ
ット設定するには、次のサブコマンドを入力してください。このサブコマンド
は、問題を 1 つのサブコンポーネントに特定したあとでエラーを見付けるた
めに使用してください。
CTRACE COMP(SYSAPPC) OPTIONS((FILTER,FUNCID(nn)))
第 11 章 コンポーネント・トレース
11-39
コンポーネント・トレース
例 4: ユーザー ID に関連する項目を表示するための CTRACE サブコマンド
問題が発生している JOHNDOE というユーザー ID に関するすべてのレコー
ドをフォーマット設定するには、次のサブコマンドを入力してください。トレ
ースの要求時に USERID オプションを指定した場合には、このフォーマット
設定オプションは冗長になります。
CTRACE COMP(SYSAPPC) OPTIONS((FILTER,USERID(JOHNDOE)))
SYSAPPC トレースからの出力
CTRACE COMP(SYSAPPC) SHORT サブコマンドの出力
SHORT パラメーターを指定すると、各トレース・レコードの出力が 1 行ずつ表示
されます。SHORT パラメーターを指定してフォーマット設定された SYSAPPC コ
ンポーネント・トレース出力の例を次に示します。
VEFMH5XT
VEFMH5ER
00004101
00000101
155705.182844
155705.367233
VEFMH-5 RECEIVED
VEFMH-5 IN TPEND
各 SHORT 報告書の行のフィールドは、次のとおりです。
Mnemonic
たとえば、VEFMH5XT。
Entry ID
トレース・レコードの ID。たとえば、00004101。
Time
hh:mm:ss.tttttt フォーマットによる時刻。たとえば、15:57:05.182844。
Title
レコードの表題。たとえば、VE:FMH-5 RECEIVED。各表題は、そのトレー
ス・レコードを書いた APPC/MVS サブコンポーネントを示す接頭部で始まりま
す。たとえば、VE は VTAM 出口サブコンポーネントを表します。表題の接頭
部と APPC/MVS サブコンポーネントの関係を次に示します。
11-40
接頭部
サブコンポーネント
AMI
ASCH
CM
ERROR
FMH5
LUM
PC
SDFM
SF
SM
TE
TSI
VC
VE
Verb サービス
APPC/MVS スケジューラー (ASCH)
会話管理機能
リカバリー
FMH-5 管理機能
LU 管理機能
保護された会話
MVS システム・データ・ファイル管理機能 (SDFM)
割り振りキュー・サービス
状態マシン
テスト使用可能性
トランザクション・スケジューラー・インターフェース
Verb サービス
VTAM 出口
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
接頭部
サブコンポーネント
VS
Verb サービス
CTRACE COMP(SYSAPPC) SUMMARY サブコマンドの出力
SUMMARY パラメーターを指定すると、SHORT 報告書で示される行のほかに、各
トレース・レコードのほとんどのフィールドが表示されます。SUMMARY パラメー
ターを指定してフォーマット設定された SYSAPPC コンポーネント・トレース出力
の例を次に示します。
SY1
PCESC
00007802 13:07:29.491950 PC:ENTRY STATE CHECK EXIT
FUNCID... 02
USERID... IBMUSER
JOBNAME.. APPC
ASIDHOME. 001C
ASIDPRI.. 001C
TPIDPRI.. 00000000 TPIDSEC.. 00000000
SESSID... E723ED63 AAB04BDF CONVID... 01000014
CONVCOR.. 063313F8 0000000D AQTOKEN.. 00000000
LUWID.... 10E4E2C9 C2D4E9F0 4BE9F0C3 F0C1D7F0 F36FDB2A C0220700 01
NETNAME.. USIBMZ0
LUNAME... Z0C0AP03
INSTNUM.. 6FDB2AC0 2207
SEQNUM... 0001
URID..... AD355FDB 7EEFB000 00000007 01010000
SUMMARY 報告書の最初の行以外のフィールドは以下のとおりです。最初の行につ
いては SHORT 報告書を参照してください。
FUNCID
そのトレース・レコードを書き込んだ APPC/MVS サブコンポーネントの ID。
ID については FUNCID オプションを参照してください。
USERID
トレース・レコード・イベントの発生時に、システムはこのユーザー ID に関
する作業を処理していました。
JOBNAME
トレース・レコード・イベントの発生時にシステムが処理していたジョブの名
前。
ASIDHOME
トレース・レコード・イベントの発生時にシステムが処理していた 1 次アドレ
ス・スペースのアドレス・スペース ID (ASID)。
TPIDPRI
1 次 TP の TP ID。(複数トランザクション TP には 1 次 TP と 2 次 TP が
あります。)
TPIDSEC
2 次 TP の TP ID。(複数トランザクション TP には 1 次 TP と 2 次 TP が
あります。)
SESSID
セッションの ID。
CONVID
会話の ID。
AQTOKEN
割り振りキューの ID。
第 11 章 コンポーネント・トレース
11-41
コンポーネント・トレース
LUWID
論理作業単位の ID。以下のフィールドは作業論理単位を参照します。LUWID
がすべてゼロであるかあるいは無効な場合、これらのフィールドにはアスタリス
ク (*) が入ります。
NETNAME
論理作業単位のネットワーク名。
LUNAME
ローカル LU の名前。
INSTNUM
論理作業単位のインスタンス番号。
SEQNUM
論理作業単位のシーケンス番号。
URID
リカバリー単位の ID
CTRACE COMP(SYSAPPC) FULL サブコマンドの出力
FULL パラメーターを指定すると、トレース・レコード内のすべてのデータが表示
されます。この報告書には SHORT 報告書で示される行、SUMMARY 報告書で示
されるフィールド、および KEY フィールドと ADDR フィールドが含まれます。
FULL パラメーターを指定してフォーマット設定された SYSAPPC コンポーネン
ト・トレース出力の例を次に示します。
SY1
PCESC
00007802 13:07:29.491950 PC:ENTRY STATE CHECK EXIT
FUNCID... 02
USERID... IBMUSER
JOBNAME.. APPC
ASIDHOME. 001C
ASIDPRI.. 001C
TPIDPRI.. 00000000 TPIDSEC.. 00000000
SESSID... E723ED63 AAB04BDF CONVID... 01000014
CONVCOR.. 063313F8 0000000D AQTOKEN.. 00000000
LUWID.... 10E4E2C9 C2D4E9F0 4BE9F0C3 F0C1D7F0 F36FDB2A C0220700 01
NETNAME.. USIBMZ0
LUNAME... Z0C0AP03
INSTNUM.. 6FDB2AC0 2207
SEQNUM... 0001
URID..... AD355FDB 7EEFB000 00000007 01010000
KEY...... 0015
ADDR..... 066F26DA
E4E2C9C2 D4E9F04B E9F0C3F0 C1D7F0F3 | USIBMZ0.Z0C0AP03 |
KEY...... 001A
ADDR..... 066F26EB
E4E2C9C2 D4E9F04B E9F0C3F0 C1D7F0F4 | USIBMZ0.Z0C0AP04 |
KEY...... 0039
ADDR..... 066F26A8
E3D9C1D5 D7C1D940
| TRANPAR
|
KEY...... 0054
ADDR..... 064162E4
00000000
| ....
|
KEY...... 00A1
ADDR..... 066F2640
00000000
| ....
|
KEY...... 00A3
ADDR..... 055683D4
00000000
| ....
|
KEY...... 00A3
ADDR..... 066F263C
00000000
| ....
|
KEY...... 00A2
ADDR..... 066F263A
00
| .
|
この報告書のフィールドについては、SHORT 報告書および SUMMARY 報告書を
参照してください。 IBM が診断を行う場合に、KEY フィールドと ADDR フィー
ルドが必要になることがあります。
FMH-5 トレース・データ
FMH-5 トレース・レコードには、TP の流れをトレースし、以下のタイプの問題を
診断するために役立つ情報が含まれます。
11-42
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
v 持続的な検査の問題
v パスワード保守の問題
v APPC/MVS セキュリティーの問題
FMH-5 データを獲得するには、FMH5、INBOUND、または GLOBAL オプション
を指定した SYSAPPC コンポーネント・トレースを要求してください。トレース出
力内の FMH-5 レコードを分離するには、次の IPCS サブコマンドを入力してくだ
さい。
CTRACE COMP(SYSAPPC) OPTIONS((FILTER,FUNCID(03))) FULL
表 11-1 では、各 FMH-5 トレース・レコードの簡略記号と表題を示し、それらのレ
コードを説明しています。ほとんどのトレース・レコードの FMH-5 は KEY フィ
ールド X'0012' でフォーマット設定されています。
参照
FMH-5 のフォーマットについては、以下を参照してください。
v z/OS Communications Server: SNA Programmer’s LU 6.2 Guide
v z/OS Communications Server: SNA Programmer’s LU 6.2 Reference.
表 11-1. SYSAPPC コンポーネント・トレースの FMH-5 トレース項目
簡略記号
表題
説明/アクション
FMH5BDSC
FMH5:BAD SECURITY COMBINATION
APPC/MVS が、誤ったセキュリティー・オプ
ションまたはセキュリティー・サブフィール
ド、あるいはその両方を検出しました。IBM
サポートに連絡してください。
FMH5ERCV
FMH5:FMH-5 RECEIVE FAILURE
FMH-5 がローカル MVS LU によって正常に
受信されませんでした。IBM サポートに連絡
してください。
FMH5INCD
FMH5:FMH-5 COMMAND IS NOT VALID
APPC/MVS が誤った FMH-5 コマンドを検出
しました。IBM サポートに連絡してくださ
い。
FMH5LUNA
FMH5:LU IS NOT ACTIVE
LU が活動状態になっていません。トレース
出力の LUNAME フィールドを調べてくださ
い。この LU の状況を調べるには、DISPLAY
APPC コマンドを入力してください。
FMH5NOTP
FMH5:TP NAME IS NOT RECOGNIZED
この TP 名は FMH-5 で正しく指定されてい
ません。
FMH5NSCH
FMH5:NOT SERVED AND NO SCHEDULER LU と関連したスケジューラーがないため、
TP をスケジュールできません。
FMH5PFST
FMH5:FMH-5 PROFILE IS NOT VALID
FMH-5 プロファイルが正しくありません。長
さが 8 文字を超えています。
FMH5PIP
FMH5:PIP DATA PRESENT IN FMH-5
APPC/MVS が、FMH-5 からプロファイル初
期設定パラメーター (PIP) データを検出しま
した。この PIP データは APPC/MVS 用の
FMH-5 では無効です。
FMH5PWCC
FMH5:PW CONV CLEANUP FAILED
内部エラー。 IBM サポートに連絡してくだ
さい。
第 11 章 コンポーネント・トレース
11-43
コンポーネント・トレース
表 11-1. SYSAPPC コンポーネント・トレースの FMH-5 トレース項目 (続き)
簡略記号
表題
説明/アクション
FMH5PWDE
FMH5:PW DEALLOCATE FAILED
内部エラー。 IBM サポートに連絡してくだ
さい。
FMH5PWDF
FMH5:PW DEQUE REQUEST FAILED
SIGNON/パスワード変更 TP への接続の試み
が失敗しました。IBM サポートに連絡してく
ださい。
FMH5PWQF
FMH5:PW QUEUE REQUEST FAILED
内部エラー。 IBM サポートに連絡してくだ
さい。
FMH5PWRF
FMH5:QW RACF REQUEST REJECTED
内部エラー。 IBM サポートに連絡してくだ
さい。
FMH5PWR1
FMH5:PW RECEIVE DATA FAILED 1
FMH5PWR2
FMH5:PW RECEIVE DATA FAILED 2
SIGNON/ パスワード TP が、GDS 変数への
ReceiveandWait 呼び出し実行をしようと試み
ました。以下の KEY フィールドを調べてく
ださい。
v KEY X'007E' には、ReceiveandWait によ
って SIGNON/ パスワード変更 TP に戻さ
れた受信状況値が含まれています。
v KEY X'007F' には、ReceiveandWait によ
って SIGNON/ パスワード変更 TP に戻さ
れた受信データ値が含まれています。
v KEY X'003F' には、ReceiveandWait から
戻された戻りコードが含まれています。
GDS 変数が正しく送信されていることを確認
してください。問題を解決できない場合に
は、IBM サポートに連絡してください。
FMH5PWSD
FMH5:PW SEND DATA FAILED
SIGNON/ パスワード変更 TP の SendData
呼び出しに失敗しました。TP で SIGNON/パ
スワード変更 TP を指定して有効な会話が設
定されていることを確認してください。問題
を解決できない場合には、IBM サポートに連
絡してください。
FMH5PWSF
FMH5:PW SEND MESSAGE FAILED
パートナー LU への持続検査サインオフの流
れが失敗しました。パートナー LU の
SIGNEDONTO リストがローカルの
SIGNEDONFROM リストと同期していない可
能性があります。以下の KEY フィールドを
調べてください。
v KEY X'0026' には TCB アドレスが含まれ
ています。
v KEY X'001A' にはパートナー LU の名前
が含まれています。
v Key X'002F' には SIGNOFF が失敗したユ
ーザーのユーザー ID が含まれています。
問題を解決できない場合には、IBM サポート
に連絡してください。
11-44
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
表 11-1. SYSAPPC コンポーネント・トレースの FMH-5 トレース項目 (続き)
簡略記号
表題
説明/アクション
FMH5PWSM
FMH5:PW SEND MESSAGE
APPC/MVS が、パートナー・システムのユー
ザーにそのユーザーのパスワードが失効した
ことを通知するために、X'30F0F5F2' 失効パ
スワード通知プログラムに接続することがで
きませんでした。以下の KEY フィールドを
調べてください。
v KEY X'0026' には TCB アドレスが含まれ
ています。
v KEY X'001A' にはパートナー LU の名前
が含まれています。
v KEY X'002F' には付加要求が失敗したユー
ザーの USERID が含まれています。
問題を解決できない場合には、IBM サポート
に連絡してください。
FMH5PWSR
FMH5:PW SIF RESERVE FAILURE
内部エラー。 IBM サポートに連絡してくだ
さい。
FMH5PWST
FMH5:FMH-5 PASSWORD IS NOT VALID
FMH-5 パスワードが正しくありません。長さ
が 8 文字を超えています。
FMH5QMFL
FMH5:FMFP QUEUE MANAGER FAILURE
内部エラー。 IBM サポートに連絡してくだ
さい。
FMH5RECV
FMH5:FMH-5 SUCCESSFULLY RECEIVED
FMH-5 がローカル MVS LU によって正常に
受信されました。
FMH5RFRJ
FMH5:RACF REQUEST REJECTED
システムが RACF サービスのうちの 1 つか
ら不良戻りコードを受信しました。 KEY
X'0053' を参照して、失敗した RACF サービ
スを識別するコードを調べてください。この
コードは次のいずれかです。
1
RACROUTE REQUEST=VERIFY
2
RACROUTE REQUEST=SIGNON
TYPE=SIGNIN
3
RACROUTE REQUEST=SIGNON
TYPE=QSIGNON
4
RACROUTE REQUEST=SIGNON
TYPE=SIGNOFF
以下の KEY フィールドを調べてください。
v KEY X'0054' には RACF サービス要求か
ら戻された戻りコードが含まれています。
v KEY X'0055' には RACF サービス要求か
ら戻された理由コードが含まれています。
v KEY X'0021' には、このサービスのセキュ
リティー許可機能 (SAF) 戻りコードが含
まれています。
第 11 章 コンポーネント・トレース
11-45
コンポーネント・トレース
表 11-1. SYSAPPC コンポーネント・トレースの FMH-5 トレース項目 (続き)
簡略記号
表題
説明/アクション
FMH5SERF
FMH5:APPC/MVS SERVICE FAILURE
APPC/MVS の内部エラー。IBM サポートに
連絡してください。
FMH5SFAL
FMH5:SEND MESSAGE FAILED
パートナー LU への持続検査サインオフの流
れが失敗しました。有効なセッションが確立
されていることを確認してください。以下の
KEY フィールドを調べてください。
v KEY X'0026' には TCB アドレスが含まれ
ています。
v KEY X'001A' にはパートナー LU の名前
が含まれています。
FMH5SOFF
FMH5:SIGNOFF FLOW
パートナー LU への持続検査サインオフの流
れが完了しました。以下の KEY フィールド
を調べてください。
v KEY X'0026' には TCB アドレスが含まれ
ています。
v KEY X'001A' にはパートナー LU の名前
が含まれています。
FMH5SVFC
FMH5:ACCEPTED BY SRVR FACILITIES
APPC/MVS がインバウンド要求を、あとで
APPC/MVS サーバーで処理するために割り振
りキューに入れました。
FMH5TEST
FMH5:FMH5 ACCEPTED FOR TESTING
FMH-5 がテストのために受け入れられまし
た。
FMH5TPAD
FMH5:TP PROFILE ACCESS DENIED
TP プロファイルへのアクセスが否定されま
した。Request=AUTH が失敗しました。
FMH5TPNA
FMH5:TP PROFILE IS NOT ACTIVE
TP プロファイルが活動状態になっていませ
ん。このトレース・レコードの KEY X'0012'
でフォーマット設定された FMH-5 から TP
名を入手してください。そのうえで、SDFM
ユーティリティーを使用して TP プロファイ
ルを調べてください。
FMH5TPRQ
FMH5:TP PROFILE IS REQUIRED
システムが、要求された TP に関する TP プ
ロファイルを検出できませんでした。この
TP に関連したスケジューラーには、TP プロ
ファイルが必要です。このエラーは、おそら
く SDFM の問題が原因となっています。
SDFM という接頭部のトレース・レコードを
調べてください。
FMH5UIST
FMH5:FMH-5 USERID IS NOT VALID
FMH-5 のユーザー ID が正しくありません。
長さが 8 文字を超えています。
FMH5VALD
FMH5:FMH5 SUCCESSFULLY VALIDATED
FMH-5 の妥当性検査が正常に行われました。
FMH5XLNF
FMH5:EXCHANGE LOG NAME FAILED
APPC/MVS は、必須のログ名交換処理が起こ
らなかったため、保護された会話をリジェク
トしました。
QMANFAIL
FMH5:FMAX QUEUE MANAGER FAILURE
内部エラー。 IBM サポートに連絡してくだ
さい。
11-46
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
表 11-1. SYSAPPC コンポーネント・トレースの FMH-5 トレース項目 (続き)
|
簡略記号
表題
説明/アクション
RESVFAIL
FMH5:SIF RESERVE FAILURE
内部エラー。 IBM サポートに連絡してくだ
さい。
SYSAXR コンポーネント・トレース
|
|
|
|
|
|
|
|
|
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
|
|
以下に、System REXX コンポーネント用の SYSAXR コンポーネント・トレースを
要求するための情報を要約します。
||
情報
SYSAXR の場合:
|
parmlib メンバー
CTIAXRnn
|
デフォルト・メンバー: CTIAXR00
|
デフォルトのトレース
|
|
トレース要求の OPTIONS パラメー CTIAXRxx および TRACE コマンドに対する REPLY
ター
で指定
|
|
|
|
|
|
|
|
バッファー
v デフォルト: 2MB
v 範囲: 1MB から 2GB
v サイズの設定: CTIAXRnn parmlib メンバーまたは
TRACE CT コマンドの REPLY で指定
v IPL 後のサイズ変更: トレースの停止後の再始動時
に可能
v 場所: System REXX トレース・データ・スペース
内。
|
|
|
トレース・レコードの場所
アドレス・スペース・バッファー ; System REXX ト
レース・データ・スペース、トレース・データ・セッ
ト
|
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
|
|
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSAXR)
|
|
|
トレース・フォーマット設定の
OPTIONS パラメーター
はい
あり。エラー; エラー・イベント。
第 11 章 コンポーネント・トレース
11-47
コンポーネント・トレース
|
SYSAXR トレースの要求
|
|
|
|
SYSAXR コンポーネント・トレースを要求するオプションは、CTIAXRxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。AXR 開始
後の SYSAXR トレース・オプションの変更には、トレースの停止および再開が必
要です。
|
CTIAXRnn parmlib メンバー
|
|
次の表は、CTIAXRnn parmlib メンバーで指定できるパラメーターを示していま
す。
||
パラメーター
CTIAXRnn で指定可能かどうか
|
ON または OFF
いいえ
|
ASID
はい
|
JOBNAME
はい
|
BUFSIZE
はい
|
OPTIONS
はい
|
MOD
いいえ
|
SUB
いいえ
|
PRESET
いいえ
|
LIKEHEAD
いいえ
|
WTR
はい
|
|
WTRSTART または WTRSTOP
はい
|
|
|
|
注: バッファー・サイズは IPL 後に変更できます。有効にするためには、 System
REXX アドレス・スペース (AXR) を再始動する必要があります。新しいバッ
ファー・サイズは、使用する CTIAXRnn メンバーの BUFSIZE パラメーターで
指定してください。
|
|
IBM 提供の CTIAXR00 parmlib メンバーは、System REXX アドレス・スペースが
始動するとすぐに、エラー・トレースを初期化します。
|
CTIAXR00 の内容は次のとおりです。
|
|
|
|
TRACEOPTS
ON
OPTIONS(’ERROR’)
BUFSIZE(2M)
|
TRACE および REPLY コマンド
|
|
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
||
|
パラメーター
トレース用の TRACE CT で
指定可能かどうか
|
ON、OFF または nnnnM
1 つ必要
|
nnnnK または nnnnM
いいえ
|
SUB
いいえ
|
PARM
はい
11-48
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
|
||
|
パラメーター
書き込み用に TRACE CT で
指定可能かどうか
|
|
|
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
||
パラメーター
トレース用の REPLY で指定可能かどうか
|
ASID
はい
|
JOBNAME
はい
|
OPTIONS
はい
|
|
WTR
はい
|
OPTIONS パラメーター
|
|
CTIAXRxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を以下に示します。
|
|
ALL
すべてをトレースします。
|
|
AXRCMD
コマンド機能のパッケージのイベントをトレースします。
|
|
AXRMLWTO
複数行 WTO 機能のパッケージのイベントをトレースします。
|
|
AXRWTO
WTO 機能のパッケージのイベントをトレースします。
|
|
CANCEL
AXREXX REQUEST=CANCEL イベントをトレースします。
|
|
COMMAND
System REXX コマンドのイベントをトレースします。
|
|
ERROR
エラー・イベントをトレースします。
|
|
EXEC
指定された exec 名のもとで起きるイベントのみをトレースします。
|
|
REXXARGS
REXX 引数と関連するイベントすべてをトレースします。
|
|
REXXVARS
REXX 変数と関連するイベントすべてをトレースします。
|
|
RXCLIENT
AXREXX の呼び出し側のもとで起きるイベントをトレースします。
|
|
RXSERVER
サーバーのイベントすべてをトレースします。
第 11 章 コンポーネント・トレース
11-49
コンポーネント・トレース
|
SYSAXR トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSAXR) サブコマンドを使
用して行います。
|
|
|
SYSAXR 変数トレースからの出力
|
各トレース・レコードには、それに関連するヘッダーがあります。
|
|
|
|
|
|
|
|
|
|
|
DSECT
TracePrefixType
TracePrefixASID
TracePrefixAXREXXInvokersASID
TracePrefixJobname
TracePrefixAXREXXInvokersJobname
TracePrefixTcb@
TracePrefixExecName
TracePrefixAXREXXInvokersHomeAsid
|
|
|
このヘッダーは、すべてのトレース・レコードで一貫していますが、すべてのフィ
ールドが埋められているとは限りません (たとえば、コマンド処理には
TracePrefixReqToken がありません)。
|
注: これはインターフェースであり、診断目的でのみ使用します。
|
|
|
|
以下に示すのは、CTRACE REXXVARS オプションを有効にして AXREXX プログ
ラミング・インターフェースを使用して起動した REXX exec を実行した後に、
CTRACE COMP(SYSAXR) サブコマンドから作成されてフォーマット設定された
IPCS 出力です。
|
|
|
|
|
|
SY1
|
|
ヘッダーに続く最初の 4 バイトには、変数リスト (AXRArgLst) の変数の索引が含
まれています。トレース項目の残りの部分には、変数名の値が含まれています。
|
|
|
|
|
|
|
SY1
|
|
|
ヘッダーに続く最初の 4 バイトには、変数リスト (AXRArgLst) の変数の索引が含
まれています。次の 4 バイトには、値の長さが含まれています。残りの部分には、
exec への入力の変数の値が含まれています。
|
|
|
|
|
|
SY1
TracePrefixReqToken
REXXVARS
00330032
C1C9D540
00320000
95690DB8
C1E7D9D4
006EAE88
00005000
00000001
C1E7D9D4
C9E2E540
BF8C7970
D94BF1
|
|
|
|
C1E7D9D4
C9E2E540
BF8C7970
40404040
|
|
|
|
|
22:01:15.525516
C1C9D540
C8C1D9D9
00000000
00000003
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Primary ASID when trace record cut
Primary ASID when AXREXX invoked
Jobname when trace record cut
Jobname when AXREXX was invoked
TCB Address when AXREXX was invoked
REXX exec name
Home ASID when AXREXX was invoked
Reserved
Trace request token type
20:40:59.969292
C1C9D540
C8C1D9D9
00000001
0000000B
04140D04
OD
H
H
D
D
A
D
A
CL2
4F
20:40:59.969289
C1C9D540
C8C1D9D9
00000001
D4E8E5C1
04130D02
C1E7D9D4
006EAE88
00005000
00000001
4040F1
REXXVARS
00150032
C1C9D540
00320000
09A8845A
11-50
C1E7D9D4
006EAE88
00005000
00000001
REXXVARS
00330032
C1C9D540
00320000
95690DB8
40404040
04130D06
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
C1E7D9D4
C9E2E540
BF8C8B61
F1F0F1
|
|
|
|
REXX VAR NAME
....AXRMAIN AXRM
AIN .>.hHARRISV
......&.......`.
n.......MYVAR.1
|
|
|
|
REXX VAR BEFORE EXEC
....AXRMAIN AXRM
AIN .>.hHARRISV
......&.......`.
n...........
1
|
|
|
|
|
REXX VAR AFTER EXEC
....AXRMAIN AXRM
AIN .>.hHARRISV
......&......../
.yd!........101
|
|
|
|
コンポーネント・トレース
|
|
|
|
ヘッダーに続く最初の 4 バイトには、変数リスト (AXRArgLst) の変数の索引が含
まれています。次の 4 バイトには、出力の長さが含まれています。次のセットのバ
イトには、出力変数が含まれています。結果が切り捨てられている場合は、切り捨
てられた結果が含まれています。
|
|
入出力変数は exec への入力に 1 を含んでおり、exec が完了したときの最終値は
101 でした。
SYSDLF コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、データ索引機能 (DLF) 用の SYSDLF コンポーネント・トレースを要求す
るための情報を要約します。
情報
SYSDLF の場合
parmlib メンバー
なし
デフォルトのトレース
あり。DLF の実行中は常にオン。
トレース要求の OPTIONS パラメー なし
ター
バッファー
v
v
v
v
v
デフォルト: 適用外
範囲: 適用外
サイズの設定方法: MVS システム
IPL 後のサイズ変更: 不可
場所: データ・スペース内。DUMP コマンド対する
REPLY で DSPNAME=(’DLF’.CCOFGSDO) を指定
する。
トレース・レコードの場所
アドレス・スペース・バッファー、データ・スペー
ス・バッファー
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSDLF)
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSDLF トレースの要求
このトレースは、DLF が制御を行っているときには常に実行されます。トレースを
要求するためのアクションは不要です。
第 11 章 コンポーネント・トレース
11-51
コンポーネント・トレース
SYSDLF トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSDLF) サブコマンドを使
用して行います。このサブコマンドには OPTIONS 値はありません。
SYSDLF トレースからの出力
CTRACE COMP(SYSDLF) FULL サブコマンドの出力
CTRACE COMP(SYSDLF) FULL サブコマンドを指定してフォーマット設定された
DLF コンポーネント・トレース・レコードの例を次に示します。このレコードで
は、トレース・バッファーから得られた定様式例外レコードが表示されています。
DLF COMPONENT TRACE FULL FORMAT
COFRCVRY 00000000 15:47:40.397545 DLF RECOVERY ENTRY
HASID... 000E
SASID... 000E
CPUID... FF170067 30900000
MODNAME. COFMCON2 ABEND... 840C1000 REASON.. 00000001
EPTABLE. CON2 EST2 .... .... .... .... .... .... .... ....
COFRCVRY 00000001 15:47:40.397625 DLF RECOVERY EXIT
HASID... 000E
SASID... 000E
CPUID... FF170067 30900000
MODNAME. COFMCON2 ABEND... 840C1000 REASON.. 00000001
RETCODE. 0000002C RSNCODE. 0000C200 FTPRTS.. C0000000 DATA.... 00000000
報告書のフィールドは次のとおりです。
COFRCVRY
トレース・レコードの名前または ID。
00000000
16 進数による ID。
15:47:40.397545
このレコードがトレース・テーブルに入った時刻を示すタイム・スタンプ。
HASID... 000E
ホーム・アドレス・スペース ID。
SASID... 000E
2 次アドレス・スペース ID。
CPUID... FF170067 30900000
このレコードをトレース・テーブルに入れたプロセッサーの ID。
CALLER
DLF サービス要求を発行したルーチンのアドレス。
MODNAME COFMCON2
実行されていたモジュールの名前。
ABEND... 840C1000
DLF がリカバリー機能に入る原因となった異常終了。
REASON..00000001
異常終了に関連した理由コード。
EPTABLE.CON2 EST2
IBM による診断で使用される情報。
11-52
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
RETCODE.0000002C
終了しようとしているモジュールによって発行された戻りコード。
RSNCODE.0000C200
終了しようとしているモジュールによって発行された理由コード。
FTPRTS..C0000000
IBM による診断で使用される情報。
DATA....00000000
IBM による診断で使用される情報。
SYSDSOM コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、分散 SOMobjects (DSOM) の SYSDSOM コンポーネント・トレースを要求
するための情報を要約します。
情報
SYSDSOM の場合:
parmlib メンバー
なし
デフォルトのトレース
いいえ
トレース要求の OPTIONS パラメー TRACE コマンドに対する REPLY
ター
バッファー
v
v
v
v
v
デフォルト: 適用外
範囲: 適用外
サイズの設定方法: MVS システム
IPL 後のサイズ変更: 不可
ロケーション: アドレス・スペース
トレース・レコードの場所
アドレス・スペース・バッファー
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSDSOM)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSDSOM トレースの要求
SOMDTRACELEVEL DSOM 環境変数でゼロ以外の値を指定してトレースを要求し
ます。
第 11 章 コンポーネント・トレース
11-53
コンポーネント・トレース
SYSDSOM トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSDSOM) サブコマンドを
使用して行います。このサブコマンドには以下の OPTIONS 値があります。
SKIPID
出力から、ジョブ名、ASID およびスレッド ID を省略します。
LONGFORM
システムに詳細な出力を表示させます。出力では、各トレース機能に複数のトレ
ース・コンポーネントが含まれている場合があります。これらは、それぞれ別々
の行に表示されます。LONGFORM を指定しない場合は、SHORTFORM がデフ
ォルトの値です。OPTIONS パラメーターには、LONGFORM と SHORTFORM
の両方を指定しないでください。
SHORTFORM
システムに省略出力を表示させます。出力では、各トレース機能が 1 行に表示
されます。SHORTFORM がデフォルトの値です。OPTIONS パラメーターに
は、LONGFORM と SHORTFORM の両方を指定しないでください。
SYSDSOM トレースからの出力
CTRACE COMP(SYSDSOM) FULL サブコマンドの出力
次の例は、CTRACE COMP(SYSDSOM) FULL OPTIONS((SKIPID,SHORTFORM)) サ
ブコマンドによりフォーマット設定された DSOM コンポーネント・トレース・レ
コードの例です。このレコードでは、トレース・バッファーから得られた定様式例
外レコードが表示されています。
DSOM COMPONENT TRACE FULL FORMAT
KESYS522 METRETRN 00000004 21:31:34.864277 Return from method
Entry to method:
ImplRepository::somInit
次の例は、CTRACE COMP(SYSDSOM) FULL サブコマンドによりフォーマット設
定された DSOM コンポーネント・トレース・レコードの例です。このレコードで
は、トレース・バッファーから得られた定様式例外レコードが表示されています。
COMPONENT TRACE FULL FORMAT
SYSNAME(KESYS522)
COMP(SYSDSOM)
**** 09/29/1995
SYSNAME
MNEMONIC ENTRY ID
TIME STAMP
DESCRIPTION
-------------- -------- --------------- ------------KESYS522 GETBUFF 00000001 21:31:30.198289 Get new trace buffer
JOBNAME. KREPROC ASID.... 0029
THREADID 04233100 00000000
Buffer address:
7F672508
KESYS522 METDEBUG 00000004 21:31:39.410681 Method debug
JOBNAME. KREPROC ASID.... 0029
THREADID 04233100 00000000
Entry to method:
SOMOA::somInit
KESYS522 METRETRN 00000005 21:31:40.000019 Return from method
JOBNAME. KREPROC ASID.... 0029
THREADID 04233100 00000000
Exiting method:
SOMOA::somInit, RC(hex)=00000000, RSN=00000000
次の例は、CTRACE COMP(SYSDSOM) FULL OPTIONS((SKIPID))
DSN(’dsom.trace.dsn’) サブコマンドによりフォーマット設定された DSOM コンポー
ネント・トレース・レコードの例です。このレコードでは、トレース・バッファー
11-54
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
から得られた定様式例外レコードが表示されています。
COMPONENT TRACE FULL FORMAT
SYSNAME(KESYS522)
COMP(SYSDSOM)
OPTIONS((SKIPID))
**** 09/29/1995
SYSNAME
MNEMONIC ENTRY ID
TIME STAMP
DESCRIPTION
-------------- -------- --------------- ------------KESYS522 GETBUFF
00000001 21:31:30.198289 Get new trace buffer
Buffer address:
7F672508
KESYS522 METDEBUG 00000004 21:31:39.410681 Method debug
Entry to method:
SOMOA::somInit
KESYS522 METRETRN 00000005 21:31:40.000019 Return from method
Exiting method:
SOMOA::somInit, RC(hex)=00000000, RSN=00000000
報告書のフィールドは次のとおりです。
KESYS522
システム名。
METDEBUG
トレース・イベントの名前。
00000004
トレース・イベントの 10 進数の ID。
21:31:39.410681
このレコードがトレース・テーブルに入った時刻を示すタイム・スタンプ。
ASID
JOBNAME フィールドにリストされているジョブの ASID。
JOBNAME.KREPROC
ジョブ名。
THREADID 04233100 00000000
POSIX スレッド ID。
Entry to method
クラス SOMOA 中の somInit 方式への入り口。
Exiting Method
クラス SOMOA 中の somInit 方式からの出口。
SYSGRS コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
第 11 章 コンポーネント・トレース
11-55
コンポーネント・トレース
以下に、グローバル・リソース逐次化用の SYSGRS コンポーネント・トレースを要
求するための情報を要約します。
情報
SYSGRS の場合
parmlib メンバー
CTnGRSxx
デフォルト・メンバー: GRSCNF00 メンバーで指定さ
れた CTIGRS00
デフォルトのトレース
あり。グローバル・リソースの逐次化リングがアクテ
ィブの場合、CONTROL および MONITOR オプショ
ン。
デフォルトのトレース
あり。グローバル・リソースの逐次化スターがアクテ
ィブの場合、CONTROL1、CONTROL2、SIGNAL0 お
よび MONITOR オプション。
トレース要求の OPTIONS パラメー CTnGRSxx および TRACE コマンドに対する REPLY
ター
で指定
バッファー
v デフォルト: 128KB
v 範囲: 128KB - 16MB (システムにより、最も近い
64KB 境界に切り上げられます。)
v サイズの設定方法: CTnGRSxx メンバー
v IPL 後のサイズ変更: トレースの停止後の再始動時
に可能
v 場所: コンポーネント・アドレス・スペース内
トレース・レコードの場所
アドレス・スペース・バッファー、トレース・デー
タ・セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSGRS)
トレース・フォーマット設定の
OPTIONS パラメーター
FLOW、CONTROL、MONITOR、REQUEST、
SIGNAL、および RSA
SYSGRS トレースの要求
SYSGRS コンポーネント・トレースを要求するオプションは、CTnGRSxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
SYSGRS トレースのオプションは、トレースの実行中に変更できます。
CTnGRSxx parmlib メンバー
次の表は、CTnGRSxx parmlib メンバーで指定できるパラメーターを示していま
す。
11-56
パラメーター
CTnGRSxx で指定可能かどうか
ON または OFF
はい
ASID
いいえ
JOBNAME
いいえ
BUFSIZE
はい
OPTIONS
はい
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
パラメーター
CTnGRSxx で指定可能かどうか
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
IBM により、CTIGRS00 parmlib メンバーが提供されています。これには、IPL 時
に GRS トレースを開始するように指定されています。CTIGRS00 の内容は次のと
おりです。
TRACEOPTS
OFF
このパラメーターは、最小オプション (MINOPS) を除くすべての SYSGRS トレー
ス・オプションをオフにします。
他の SYSGRS トレース・オプションをオンにする場合には、バッファー・スペース
を追加する必要がある可能性があります。 FLOW または MONITOR オプションを
使用する場合には、バッファー・サイズを最小 16 MB にすることをお勧めしま
す。これらのオプションは、予期しない、あるいは重要なグローバル・リソース逐
次化イベントを要求します。
デフォルトのトレース・バッファー・サイズは 128KB です。IBM 提供の
GRSCNF00 parmlib メンバーでは、CTRACE パラメーターでデフォルトとして
CTIGRS00 が指定されています。
IBM サポートからグローバル・リソース逐次化用に別のトレースを要求された場合
を除き、CTIGRS00 parmlib メンバーを使用することをお勧めします。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnnnM、または OFF
1 つ必要
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
第 11 章 コンポーネント・トレース
11-57
コンポーネント・トレース
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
いいえ
JOBNAME
いいえ
OPTIONS
はい
WTR
はい
SYSGRS トレースのオプションは、トレースの実行中に変更できます。ただし、バ
ッファー・サイズを変更する場合には、トレースを停止し、新しいバッファー・サ
イズを指定して再始動しなければなりません。
OPTIONS パラメーター
CTnGRSxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下にリストします。CONTROL、 REQUEST、
MONITOR、 SIGNAL および FLOW にサブオプションを指定すると、主オプショ
ンでトレースする一連のイベントをさらに限定して指定できます。主オプションを
指定すると、そのオプションに関係するすべてのイベントがトレースされます。し
かし、主オプションの代わりに、1 つまたは複数のサブオプションを選択すると、
指定したサブオプションに含まれるイベントだけにトレースを限定できます。
MONITOR などの主オプションおよびそのサブオプションのすべて (この場合、
MONITOR0、MONITOR1、および MONITOR2 から MONITORF まで) をオプショ
ン・グループと呼びます。英字順で、OPTIONS パラメーターの値は次のとおりで
す。
CONTROL
異常なイベントおよび以下のような処理に必要な制御構造の設定、変更、または
終了に関連するイベントをトレースします。
v 動的な RNL 変更
v エラー・イベント
v 処理のための設定時に使用される XCF サービス
CONTROL を指定すると、以下のサブオプションすべてがトレースされます。
CONTROL0
動的な RNL 変更だけをトレースします。
CONTROL1
グローバル・リソースの逐次化カップリング・ファシリティー構造体へのグ
ローバル・リソースの逐次化グループの接続でのメンバーシップの設定また
は終了に関連するイベントをトレースします。
CONTROL2
グローバル・リソースの逐次化リカバリー処理だけをトレースします。
CONTROL3
異常タスクおよび ASID 終了に関連するグローバル・リソースの逐次化リ
ソース・マネージャー・イベントだけをトレースします。
CONTROL4-CONTROLE
IBM が使用するために予約済み。
11-58
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CONTROLF
サブオプション CONTROL0 から CONTROL3 までに含まれていない他の
異常イベントすべてをトレースします。
FLOW
1 つのエントリー・ポイントから別のエントリー・ポイントまでの制御のフロー
をトレースします。
FLOW0
GRS スター・システム・サーバー処理だけをトレースします。
FLOW1
GQSCAN 処理だけをトレースします。
FLOW2
システム間通信処理だけをトレースします。
FLOW3
コマンド処理だけをトレースします。
FLOW4
ストレージ・マネージャー・サービスだけをトレースします。
FLOW5
カップリング・ファシリティーの処理だけをトレースします。
FLOW6
初期設定処理だけをトレースします。
FLOW7
コンテンション・モニター処理だけをトレースします。
FLOW8
汎用 ENQ/DEQ 処理だけをトレースします。
FLOW9-FLOWD
IBM が使用するために予約済み。
FLOWE
GRS ストレージ・マネージャー用の拡張トレースをアクティブにします。
IBM サービス技術からの指示なしにはこのオプションをオンにしないでく
ださい。
FLOWF
IBM が使用するために予約済み。
Monitor
他のコンポーネントが提供するモニターおよび通信サービスについての選択済み
グローバル・リソースの逐次化呼び出しのイベントをトレースします。
MONITOR0
XES サービスの使用をトレースします。
MONITOR1
XCF サービスの使用をトレースします。
MONITOR2-MONITORF
IBM が使用するために予約済み。
第 11 章 コンポーネント・トレース
11-59
コンポーネント・トレース
REQUEST
グローバル ENQ、DEQ、GQSCAN、および RESERVE マクロ要求、および
GRS コマンド処理に関するイベントをトレースします。
REQUEST0
ENQ/RESERVE 要求だけをトレースします。
REQUEST1
DEQ 要求だけをトレースします。
REQUEST2
GQSCAN だけをトレースします。
REQUEST3
IXLLOCK だけをトレースします。
REQUEST4
コマンド処理だけをトレースします。
REQUEST5
ロック構造体 (ISGLOCK) 再構築処理だけをトレースします。
REQUEST6-REQUESTF
IBM が使用するために予約済み。
RSA
RSA 制御情報に関するイベントをトレースします。
SIGNAL
システム間カップリング・ファシリティー (XCF) の信号サービス処理の、特定
のグローバル・リソース逐次化呼び出しに関するイベントをトレースします。
SIGNAL0
マイグレーション・シグナルだけをトレースします。
SIGNAL1
GQSCAN シグナルだけをトレースします。
SIGNAL2
RNL 変更シグナルを含む、ENQ/DEQ シグナルだけをトレースします。
SIGNAL3
コンテンション・モニター・シグナルだけをトレースします。
SIGNAL4-SIGNALF
IBM が使用するために予約済み。
SYSGRS トレースの要求の例
例 1: CTnGRSxx メンバー
このメンバーは CONTROL、MONITOR、および RSA オプションを要求し、
デフォルトのバッファー・サイズを 2 倍にします。
TRACEOPTS
ON
OPTIONS(’CONTROL’,’MONITOR’,’RSA’)
BUFSIZE(256K)
11-60
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例 2: TRACE コマンド
この例は、CONTROL、MONITOR、および REQUEST トレース・イベントの
トレースを要求しています。
trace ct,on,comp=sysgrs
* 17 ITT006A ...
reply 17,options=(control,monitor,request),end
SYSGRS トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSGRS) サブコマンドを使
用して行います。COMP (SYSGRS) の場合、フィルター操作のために、FLOW、
CONTROL、 REQUEST、 MONITOR、 SIGNAL、および RSA の値を OPTIONS
サブコマンドに指定することができます。
SYSGRS トレースからの出力
CTRACE COMP(SYSGRS) SHORT サブコマンドの出力
CTRACE COMP(SYSGRS) SHORT サブコマンドを指定してフォーマット設定され
た SYSGRS コンポーネント・トレース・レコードの例を次に示します。
SYSGRS COMPONENT TRACE SHORT FORMAT
GRPXCNTL
DISRUPT
MAINRF1
CEXBCI1
SETUS
GRPXCNTL
STAXIN
.
.
.
00000030
0000000E
0000000B
0000000C
00000035
00000030
00000033
13:05:59.858746
13:05:59.858780
13:05:59.860196
13:05:59.860324
13:06:00.031243
13:06:00.141669
13:06:00.160559
GROUP EXIT IN CONTROL
RING DISRUPTION TRIGGERED
MAIN RING FAILURE
CONTROL EXITED FROM ISGBCI
CALL TO XCF SETUS SERVICE
GROUP EXIT IN CONTROL
STATUS EXIT IN CONTROL
CTRACE COMP(SYSGRS) TALLY サブコマンドの出力
CTRACE COMP(SYSGRS) TALLY サブコマンドを指定してフォーマット設定され
た SYSGRS コンポーネント・トレース・レコードの例を次に示します。
第 11 章 コンポーネント・トレース
11-61
コンポーネント・トレース
COMPONENT TRACE TALLY REPORT
COMP(SYSGRS)
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
-------00000001
00000002
00000003
00000004
00000005
00000006
00000007
00000008
00000009
0000000A
0000000B
0000000C
0000000D
.
.
.
COUNT
-------0
0
0
0
0
898
0
8
5
0
4
13
0
00000058
00000059
0000005A
0
0
0
Total trace entries:
INTERVAL
------------
2,037,854
149,924,356
328,792,726
490,847,959
149,346,135
MNEMONIC
-------RSAIN1
RSAIN2
RSAIN3
RSAIN4
RSAOUT1
RSAOUT2
RSAOUT3
RSAOUT4
INVBBE1
INVBBE2
MAINRF1
CEXBCI1
CLNQSCD
.
.
.
DESCRIBE
-------------------------------RSA has no CMD area no QWB data
RSA has QWB data but no CMD area
RSA has CMD area but no QWB data
RSA has CMD area and QWB data
RSA has no CMD area no QWB data
RSA has QWB data but no CMD area
RSA has CMD area but no QWB data
RSA has CMD area and QWB data
ISGBBE - QMERGE
ISGBBE - not QMERGE
Main Ring Failure
Control Exited from ISGBCI
Cleanup after Quiesced from ring
.
.
.
UEVENT8
UEVENT9
UEVENTA
Recovery during write
Recovery during read
Remote discarded message
1,120
SYSHZS コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、IBM Health Checker for z/OS 用の SYSHZS コンポーネント・トレースを
要求するための情報を要約します。
情報
SYSHZS の場合
parmlib メンバー
CTIHZS00
デフォルトのトレース
はい
トレース要求の OPTIONS パラメー CTIHZS00 および TRACE コマンドに対する REPLY
ター
で指定
11-62
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
情報
SYSHZS の場合
バッファー
v デフォルトの値: 4MB
v 範囲: 16KB - 4MB (システムにより、最も近い
64KB 境界に切り上げられます。)
v サイズの設定方法: CTIHZS00 メンバー
v IPL 後のサイズ変更: トレースの再始動時に可能
v 場所: IBM Health Checker for z/OS アドレス・スペ
ース内
トレース・レコードの場所
アドレス・スペース・バッファー
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSHZS) - 11-65 ページの
『SYSHZS トレースからの出力』を参照
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSHZS トレースの要求
SYSHZS コンポーネント・トレースを要求するオプションは、CTIHZS00 parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
SYSHZS トレースのオプションは、トレースの実行中に変更できます。
CTIHZS00 parmlib メンバー
次の表は、CTIHZS00 parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTIHZS00 で指定可能かどうか
ON または OFF
はい
ASID
いいえ
JOBNAME
いいえ
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
IBM により、CTIHZS00 parmlib メンバーが提供されています。これには、IPL 時
に開始された IBM Health Checker for z/OS トレースが指定されています。
CTIHZS00 の内容は次のとおりです。
TRACEOPTS
OFF
このパラメーターによって、すべての SYSHZS トレース・オプションがオフにされ
ます。
第 11 章 コンポーネント・トレース
11-63
コンポーネント・トレース
他の SYSHZS トレース・オプションをオンにする場合には、バッファー・スペース
を追加する必要がある可能性があります。
デフォルトのトレース・バッファー・サイズは 4MB です。
IBM は、IBM サポートが IBM Health Checker for z/OS 用に別のトレースを要求
している場合を除き、CTIHZS00 parmlib メンバーを使用することをお勧めします。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnnnM、または OFF
1 つ必要
COMP
必須
SUB
いいえ
PARM
いいえ
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
いいえ
JOBNAME
いいえ
OPTIONS
はい
WTR
はい
SYSHZS トレースのオプションは、トレースの実行中に変更できます。ただし、バ
ッファー・サイズを変更する場合には、トレースを停止し、新しいバッファー・サ
イズを指定して再始動しなければなりません。
OPTIONS パラメーター
CTnHZSxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下にリストします。
CHECKS
異常なイベント、および、IBM Health Checker for z/OS の検査に関連したイベ
ントをトレースします。
COMMANDS
F hzsproc コマンド、HZSPRMxx parmlib メンバー、および HZSCHECK マク
ロについての情報をトレースします。
11-64
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
STORAGE
IBM Health Checker for z/OS のアドレス・スペースで使用されるストレージに
ついての情報をトレースします。
LOGGER
IBM Health Checker for z/OS のログ・ストリームについての情報をトレースし
ます。
MISC
各種情報をトレースします。
ALL
IBM Health Checker for z/OS のすべてのイベントをトレースします。ALL はデ
フォルト値です。
SYSHZS トレースの要求の例
例 1: CTIHZS00 メンバー
メンバーは、IBM Health Checker for z/OS のコンポーネント・トレースのす
べて (ALL) を要求します。
TRACEOPTS
ON
OPTIONS(’ALL’)
BUFSIZE(4M)
例 2: TRACE コマンド
この例では、ALL トレース・イベントのトレースを要求します。
trace ct,on,comp=syshzs
* 17 ITT006A ...
reply 17,options=(all),end
SYSHZS トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSHZS) FULL サブコマン
ドを使用して行います。
SYSHZS トレースからの出力
CTRACE COMP(SYSHZS) FULL サブコマンドの出力
CTRACE COMP(SYSHZS) FULL サブコマンドを指定してフォーマット設定された
SYSHZS コンポーネント・トレース・レコードの例を次に示します。
第 11 章 コンポーネント・トレース
11-65
コンポーネント・トレース
B7VB0038
CHECKS
00000001
21:23:37.960765
ASID..0028
ModID..0201
TCB..004E3B58
Stack..7F11A000
Event..Candidat Function..N/A
Owner..IBMRSM
Name...RSM_MEMLIMIT
PQEAddr..7FFD4000 Result..00000000 Diag..00000000 00000000
B7VB0038
STORAGE
00000003
21:23:37.960793
GET/FREE
ASID..0028
ModID..0105
TCB..004E3B58
Stack..7F11A000
Oper..Get
Type..PQE
CModID..0201 [email protected]
IPCS OUTPUT STREAM ----------------------------------- FOUND: LINE 5367 COL 12
Command ===>
SCROLL ===> CSR
B7VB0038 STORAGE
00000003 21:24:09.757964 GET/FREE
ASID..0028
Oper..Get
B7VB0038
COMMANDS
ModID..0105
Type..CMDI
00000002
TCB..004E3B58
CModID..0116
Stack..7EEDA000
[email protected]
21:24:09.757966
ASID..0028
ModID..0116
TCB..004E3B58
Stack..7EEDA000
Command..Display
Keywords..00000100 00000010 00000000 00000000
Owner..................
Name...................................
PolStmt..N/A
B7VB0038
STORAGE
ASID..0028
Oper..Free
00000003
B7VB0038
STORAGE
ModID..0105
Type..CMDI
21:28:25.209146
ModID..0105
Type..CMDI
COMMANDS
00000002
GET/FREE
TCB..004E38C8
CModID..0703
00000003
ASID..0028
Oper..Get
B7VB0038
21:24:09.762583
Stack..7F13E000
[email protected]
GET/FREE
TCB..004E3B58
CModID..0116
Stack..7EEDA000
[email protected]
21:28:25.209148
ASID..0028
ModID..0116
TCB..004E3B58
Stack..7EEDA000
Command..Display
Keywords..00040100 00000000 00000000 00000000
Owner..................
Name...................................
PolStmt..N/A
B7VB0038
MISC
00000004
21:28:41.204631
ASID..0028
ModID..0304
TCB..004E38C8
+0000 D9C5C3E5 C8E9E2E3 D2C4C9E2 840E0000
+0010 00000028
11-66
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Stack..7F13E000
| RECVHZSTKDISd... |
コンポーネント・トレース
SYSIEFAL コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
割り振りに対して SYSIEFAL コンポーネント・トレースを要求する場合の情報を以
下に要約します。
情報
SYSIEFAL の場合
parmlib メンバー
CTIIEFxx
デフォルト・メンバー: CTIIEFAL
デフォルトのトレース
あり。
FLOW0、FLOW1、FLOW6、DATA、CONTROL0、
CONTROL1、CONTROL6、および SERIAL1 オプショ
ン
トレース要求の OPTIONS パラメー CTIIEFxx または TRACE コマンドの REPLY で指定
ター
バッファー
v
v
v
v
v
デフォルトの値: 8M
範囲: 256KB - 64MB
サイズの設定方法: CTIIEFxx メンバー
IPL 後のサイズ変更: 可能
場所: コンポーネント・アドレス・スペース内
トレース・レコードの場所
アドレス・スペース・バッファー
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSIEFAL)
トレース・フォーマット設定の
OPTIONS パラメーター
あり。FLOW、CONTROL、SERIAL、および DATA
SYSIEFAL トレースの要求
SYSIEFAL コンポーネント・トレースを要求するオプションは、CTIIEFxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
SYSIEFAL トレースのオプションは、トレースの実行中に変更できます。
CTIIEFxx parmlib メンバー
次の表は、CTIIEFxx parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTIIEFxx で指定可能かどうか
ON または OFF
はい
第 11 章 コンポーネント・トレース
11-67
コンポーネント・トレース
パラメーター
CTIIEFxx で指定可能かどうか
ASID
はい
JOBNAME
はい
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
IBM により、CTIIEFAL parmlib メンバーが提供されています。これには、割り振
りトレースを IPL 時に開始するように指定されています。CTIIEFAL の内容は次の
とおりです。
TRACEOPTS
ON
OPTIONS(
’FLOW0’
,’FLOW1’
,’FLOW6’
,’SERIAL1’
,’DATA’
,’CONTROL0’
,’CONTROL1’
,’CONTROL6’
)
BUFSIZE(8M)
他の SYSIEFAL トレース・オプションをオンにする場合には、追加のバッファー・
スペースが必要となる可能性があります。
デフォルトのトレース・バッファー・サイズは 8M です。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnnnM、または OFF
1 つ必要
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
11-68
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
書き出しプログラムが使用されている場合、
1 つ必要
コンポーネント・トレース
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
はい
OPTIONS
はい
WTR
はい
SYSIEFAL トレースのオプションは、トレースの実行中に変更できます。しかし、
バッファー・サイズを即時に変更する場合には、トレースを停止し、新しいバッフ
ァー・サイズで再始動する必要があります。トレースを停止し再始動しなければ、
現行セットのバッファーがいっぱいになり、新しいセットが獲得されるときにバッ
ファー・サイズが変更されます。
OPTIONS パラメーター
CTIIEFxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS パ
ラメーターの値を、以下にリストします。CONTROL、DATA、FLOW および
SERIAL にサブオプションを指定すると、主オプションでトレースする一連のイベ
ントをさらに限定して指定できます。主オプションを指定すると、そのオプション
に関係するすべてのイベントがトレースされます。しかし、主オプションの代わり
に、1 つまたは複数のサブオプションを選択すると、指定したサブオプションに含
まれるイベントだけにトレースを限定できます。 DATA などの主オプションおよび
そのサブオプションのすべて (この場合、DATA0、DATA1 など) をオプション・グ
ループと呼びます。英字順で、OPTIONS パラメーターの値は次のとおりです。
CONTROL
モジュール内の制御をトレースします。
CONTROL0
共通割り振り処理だけをトレースします。
CONTROL1
割り振りサービス 1 の処理だけをトレースします。
CONTROL2
割り振り解除処理だけをトレースします。
CONTROL3
ボリューム・マウント処理と検証処理だけをトレースします。
CONTROL4
割り当て/割り当て解除処理だけをトレースします。
CONTROL5
IBM が使用するために予約済み。
CONTROL6
割り振り装置管理の処理だけをトレースします。
CONTROL7
動的割り振りの処理だけをトレースします。
CONTROL8-CONTROLE
IBM が使用するために予約済み。
第 11 章 コンポーネント・トレース
11-69
コンポーネント・トレース
CONTROLF
モジュール内の予期できない、または異常な制御をトレースします。
DATA
データが処理されるか、または変更されるときにトレースします。
DATA0
ATSP 装置タイプ・アレイを処理しているときにだけトレースします。
DATA1
ATSP 装置アレイを処理しているときにだけトレースします。
DATA2
IGDE が XCF メッセージングを通過しているときだけ、トレースします。
DATA3
IGDE が状態変更を通過するときだけ、トレースします。
DATA4
UCB の変更だけをトレースします。
DATA5
DDR SWAP の ENQ 変更の処理だけをトレースします。
DATA6
装置管理データだけをトレースします。
DATA7
動的割り振りの処理だけをトレースします。
DATA8
割り振りが発生したときだけトレースします。
DATA9-DATAE
IBM が使用するために予約済み。
DATAF
データが予期されない場合か、または異常な場合にトレースします。
FLOW
1 つのエントリー・ポイントから別のエントリー・ポイントまでの制御のフロー
をトレースします。
FLOW0
共通割り振り処理だけをトレースします。
FLOW1
割り振りサービス 1 の処理だけをトレースします。
FLOW2
割り振り解除処理だけをトレースします。
FLOW3
ボリューム・マウント処理と検証処理だけをトレースします。
FLOW4
割り当て/割り当て解除処理だけをトレースします。
FLOW5
割り振りサービス 2 の処理だけをトレースします。
11-70
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
FLOW6
装置管理データだけをトレースします。
FLOW7
動的割り振りの処理だけをトレースします。
FLOW8-FLOWE
IBM が使用するために予約済み。
FLOWF
1 つのエントリー・ポイントから別のエントリー・ポイントまでの予期でき
ない、または異常なフローをトレースします。
SERIAL
逐次化イベントをトレースします。
SERIAL0
ロック (SETLOCK) 逐次化イベントだけをトレースします。
SERIAL1
ENQ/DEQ 逐次化イベントだけをトレースします。
SERIAL2
ラッチ・マネージャーの逐次化イベントだけをトレースします。
SERIAL3
「Compare and sap」命令の逐次化イベントだけをトレースします。
SERIAL4-SERIALE
IBM が使用するために予約済み。
SERIALF
予期しないか、または異常な逐次化イベントをトレースします。
SYSIEFAL トレースの要求の例
例 1: CTIIEFxx メンバー
このメンバーは、FLOW と DATA オプションを要求し、8 メガバイトのバッ
ファー・サイズを要求します。
TRACEOPTS
ON
OPTIONS(’FLOW’,’DATA’)
BUFSIZE(8M)
例 2: TRACE コマンド
この例では、DATA1 と CONTROL1 トレース・イベントのトレースを要求し
ます。
trace ct,on,comp=sysiefal
* 17 ITT006A ...
reply 17,options=(data1,control1),end
第 11 章 コンポーネント・トレース
11-71
コンポーネント・トレース
SYSIEFAL トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSIEFAL) サブコマンドを
使用して行います。 COMP (SYSIEFAL) の場合、フィルター操作のために、
FLOW、DATA、および SERIAL の値を OPTIONS サブコマンドに指定することが
できます。
SYSIEFAL トレースからの出力
CTRACE COMP(SYSIEFAL) SHORT サブコマンドの出力
CTRACE COMP(SYSIEFAL) SHORT サブコマンドを指定してフォーマット設定さ
れた SYSIEFAL コンポーネント・トレース・レコードの例を次に示します。
COMPONENT TRACE SHORT FORMAT
COMP(SYSIEFAL)
**** 09/13/2001
SYSNAME
------N67
N67
N67
N67
N67
N67
N67
.
.
.
MNEMONIC
-------FLOW0
CONTROL0
CONTROL0
CONTROL0
FLOW0
FLOW0
FLOW0
ENTRY ID
-------00000100
00000200
00000200
00000200
00000100
00000100
00000100
TIME STAMP
--------------15:40:34.104633
15:40:34.104639
15:40:34.104693
15:40:34.104852
15:40:34.104859
15:40:34.106631
15:40:34.125582
DESCRIPTION
------------Common Allocation
Common Allocation
Common Allocation
Common Allocation
Common Allocation
Common Allocation
Common Allocation
Flow
Control
Control
Control
Flow
Flow
Flow
CTRACE COMP(SYSIEFAL) FULL サブコマンドの出力
CTRACE COMP(SYSIEFAL) FULL サブコマンドを指定してフォーマット設定され
た SYSIEFAL コンポーネント・トレース・レコードの例を次に示します。
11-72
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
COMPONENT TRACE FULL FORMAT
COMP(SYSIEFAL)
**** 09/13/2001
SYSNAME MNEMONIC ENTRY ID TIME STAMP
DESCRIPTION
------- -------- -------- --------------- ------------N67
FLOW0
00000100 15:40:47.306228 Common Allocation Flow
ASID..007A
TCB..008E1980
MODNAME..IEFAB492
JOBNAME..T015067
EBCDIC Data...
ENTR
N67
FLOW0
ASID..007A
00000100 15:40:47.306231 Common Allocation Flow
TCB..008E1980
EBCDIC Data...
EXIT
Hex Data...
00000000
MODNAME..IEFAB492
JOBNAME..T015067
| ....
|
.
.
.
SYSIOS コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
IOS コンポーネント・トレースは、以下の属性によって説明されます。
v トレース・バッファーは、共通 ESQA サブプール 248 に常駐します。サイズ
は、TRACE CT オペレーター・コマンドによって制御されます。バッファーがい
っぱいになると、専用の IOS データ・スペースにコピーされます。
v 最小限の予期しないイベントのトレースが IOS NIP 処理の間にアクティブにさ
れます。
v コンポーネント・トレース・バッファーは、以下を使用して作成されます。
– DUMP または SLIP オペレーター・コマンド (IOS アドレス・スペースのダン
プが要求されたとき)
– IOS が出した SVC ダンプ、動的装置再構成 (DDR)、またはチャネル実行プロ
グラム (EXCP) コンポーネント・リカバリー
– MVS コンポーネント・トレース (CTRACE) 外部書き出しプログラム
第 11 章 コンポーネント・トレース
11-73
コンポーネント・トレース
v オペレーターがトレースをオフにすると、トレース・オプションは最小限のイベ
ントと例外トレースに戻ります。
以下に、IOS 用の SYSIOS コンポーネント・トレースを要求するための情報を要約
します。
情報
SYSIOS の場合
parmlib メンバー
CTRACE(CTnIOSxx) ステートメントで IECIOSxx メ
ンバーに指定した CTnIOSxx。
デフォルト・メンバー: なし
デフォルトのトレース
あり、IOS NIP 処理の間にアクティブにされる
トレース要求の OPTIONS パラメー CTnIOSxx または TRACE コマンドの REPLY で指定
ター
バッファー
v デフォルト: 324KB
v 範囲: 324KB から 1.5M
v サイズの設定: CTnIOSxx メンバーまたは TRACE
コマンドの REPLY で指定。
v IPL 後のサイズの変更: あり、コンポーネント・ト
レース (CTRACE) がアクティブの場合、可能
v 位置: 共通 ESQA サブプール 248 および SYSIOS
専用 IOS データ・スペース
トレース・レコードの場所
共通 ESQA サブプール 248 および SYSIOS 専用
IOS データ・スペースとトレース・データ・セット
DUMP または SLIP オペレーター・コマンドで指定
(IOS アドレス・スペースのダンプが要求されたと
き)。DUMP コマンドの REPLY に、ダンプされる
IOS アドレス・スペースを指定してください。
SLIP コマンドで指定。
IOS、DDR、または EXCP コンポーネント・リカバリ
ーが出した SVC ダンプの間にコンポーネントで指
定。
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSIOS)
トレース・フォーマット設定の
OPTIONS パラメーター
いいえ
最小限の予期しないイベント・トレースの一部としてトレースされる IOS の分野に
は、以下が含まれます。
v 動的構成の変更
v 並行アクセス・ボリューム (PAV) 処理
v 動的チャネル・パス管理 (DCM) 処理
v 無条件予約 (U/R) リカバリー処理
v チャネル・サブシステム呼び出し (CHSC) 処理
v チャネル・レポート・ワード (CRW) 処理
v 未着割り込みハンドラー (MIH) リカバリー処理
11-74
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
v 制御装置開始済み再構成 (C.U.I.R.) リカバリー処理
v 動的パス指定サポート (DPS) 検証
v 動的装置再構成 (DDR) 処理
v 自己説明処理
注: その他の分野は、IOS コンポーネント・トレース用に OPTIONS を設定する
と、トレースされます。 11-76 ページの『OPTIONS パラメーター』を参照し
てください。
SYSIOS トレースの要求
SYSIOS トレースを要求する場合にはアクションは不要です。最小限の予期しない
イベントのトレースは、IOS NIP 処理の間にアクティブにされて、常にアクティブ
です。このトレースに加えて、以下を行うことによって、特定のオプションを使用
して SYSIOS トレースを要求することができます。
v IECIOSxx SYS1.PARMLIB メンバーに CTRACE(CTnIOSxx) ステートメントを指
定することによって、NIP 処理の間に CTnIOSxx SYS1.PARMLIB メンバーを使
用する。
v TRACE システム・コマンドを出すことによって NIP の後で CTnIOSxx
SYS1.PARMLIB メンバーを使用する。
v TRACE システム・コマンドを使用して、CTRACE によって出されるプロンプト
指示に応答してオプションを指定する。
CTnIOSxx parmlib メンバー
次の表は、CTnIOSxx parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTnIOSxx で指定可能かどうか
ON または OFF
1 つ必要
ASID
はい
JOBNAME
はい
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
他の SYSIOS トレース・オプションをオンにする場合には、追加のバッファー・ス
ペースが必要となる可能性があります。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
第 11 章 コンポーネント・トレース
11-75
コンポーネント・トレース
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON または OFF
1 つ必要
nnnnK, nnnnM
はい
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
はい
OPTIONS
はい
WTR
はい
WTR および WTRSTART パラメーターは、TRACE CT コマンドに指定した
parmlib メンバーで使用できます。これらのパラメーターは、IOS コンポーネントを
定義するときに外部書き出しプログラムが使用できないため、IPL で読み込まれる
parmlib メンバーには指定できません。
OPTIONS パラメーター
CTnIOSxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下にリストします。
DCM
動的チャネル・パス管理に関連したイベントをトレースします。
注: DCM がアクティブで、このオプションが設定されていると、大量のトレー
ス・データが記録されます。このオプション設定時は、ユーザーは外部書き
出しプログラムの使用を考慮する必要が生じます。
サブチャネルの取り消し (XSCH) 命令の結果をトレースします。
EXTEND
IOS アドレス・スペースに付加されるすべての機能をトレースします。
注: IOS アドレス・スペースに付加される一部の機能には、最小限または予期し
ないイベント・トレースの間にトレースされるものもあります。
サブチャネルの取り消し (XSCH) 命令の結果をトレースします。
STORAGE
IOS または EXCP ストレージ管理に関連したイベントをトレースします。
STORAGE オプションを指定するとき、NOFILTER オプションまたは
ASID/JOBNAME キーワードも設定する必要があります。
11-76
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CAPTURE
UCB のキャプチャーおよびアンキャプチャーのトレース。 CAPTURE オプシ
ョンを指定するときは、NOFILTER オプションまたは ASID/JOBNAME キーワ
ードも設定する必要があります。
NOFILTER
ASID または JOBNAME のフィルター操作を指定せずに、STORAGE オプショ
ンを設定できるようにします。
DS=nnnn
この指定により IOS トレースのデータ・スペースを調整できます。ここで、
nnnn はメガバイト単位のデータ・スペース・サイズです。
注:
1. nnnn は 1 ∼ 1024 の範囲内の有効な 10 進数である必要があります。
2. このオプションは、IPL 時に 1 回のみ指定可能で、TRACE CT コマンドを
使用して変更することはできません。
3. IOS トレース・データ・スペースのデフォルト・サイズは 512M です。この
場合、使用可能な補助記憶域容量が少ないシステム上では追加の補助記憶域
が必要となる可能性があります。 CTRACE データ・スペース・バッファー
の補助記憶域については、 11-11 ページの『トレース・レコードの収集場所
の決定』 を参照してください。 STORAGE および DCM などの一部のオプ
ションを指定すると、より多くの CTRACE 項目を記録することになるの
で、それらのオプションを指定しない場合よりも、IOS トレース・データ・
セットはより速く充てんされる可能性があります。データ・スペース全体を
処理するのに十分な補助記憶域容量がない場合は、DS=nnnn オプションを使
用してデフォルト・サイズよりも小さいサイズの IOS トレース・データ・
スペースをセットアップできます。同様に、フル・データ・スペースを処理
するのに十分な補助記憶域容量がある場合は、DS=nnnn オプションを使用し
てデフォルト・サイズよりも大きなサイズの IOS トレース・データ・スペ
ースをセットアップすることができます。大きなサイズの IOS トレース・
データ・スペースを指定すると、折り返しが原因で重要なデバッグ情報が失
われるのを防ぎます。トレース・データ・セットに含まれるレコード数は非
常に変動しやすく、トレース設定とシステム使用に依存します。
4. DS=nnnn オプションを複数回指定すると、その要求はリジェクトされて、以
下のメッセージが出力されます。
IOS622I IOS COMPONENT TRACE OPTION xxxxxxxx IS NOT VALID THE TRACE DATA SPACE SIZE HAS ALREADY BEEN SET
FOR THIS IPL
5. 指定したサイズが無効な場合、その要求はリジェクトされ、デフォルトの
IOS トレース用データ・スペース・サイズが使用されて、以下のメッセージ
が出力されます。
IOS622I IOS COMPONENT TRACE OPTION xxxxxxxx IS NOT VALID THE REQUESTED SIZE FOR THE TRACE DATA SPACE IS
INCORRECT
第 11 章 コンポーネント・トレース
11-77
コンポーネント・トレース
SYSIOS トレースの要求の例
例 1: CTnIOSxx メンバー
この SYS1.PARMLIB メンバーは、JOB001 のための JOBNAME フィルター
操作を使用して STORAGE オプションを設定し、バッファー・サイズを 600K
に設定します。
TRACEOPTS
ON
BUFSIZE(600K)
OPTIONS(STORAGE)
JOBNAME(JOB001)
SYSIOS トレースのフォーマット設定
IPCS CTRACE フォーマット設定サービスを使用して、CTRACE トレース項目の内
容をフォーマット設定できます。次の IPCS サブコマンドを使用してトレースをフ
ォーマット設定してください。
IPCS CTRACE COMP(SYSIOS) SUMMARY|FULL|SHORT|TALLY
ここで、
SUMMARY
トレース項目ごとにトレース項目ヘッダーおよびフォーマット済み
データを示します。
FULL
トレース項目ごとにトレース項目ヘッダーおよび不定様式の (16
進) データを示します。
SHORT
トレース項目ごとにトレース項目ヘッダーを示します。
TALLY
各トレース項目およびトレースされた回数を示します。
このサブコマンドにはオプションはありません。
CTRACE COMP(SYSIOS) サブコマンドの出力
CTRACE COMP(SYSIOS) SUMMARY サブコマンドを指定してフォーマット設定さ
れた SYSIOS コンポーネント・トレース・レコードの例を次に示します。
11-78
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CTRACE COMP(SYSIOS) SUMMARY
**** 03/28/1996
SYSNAME MNEMONIC ENTRY ID
------- -------- --------
TIME STAMP
---------------
DESCRIPTION
-------------
S530
19:42:42.220726
MIH Recovery Halt/Clear Block
MIH
00080001
Trace Record Function: MIH
MIH condition detected: Start Pending
Record ID: IOSDMHCB.MHCBSHIB
+0000
+0010
+0020
+0030
00F168E8
3868B8E8
3885DA88
00000000
289B0180
FFFFFFFF
00000000
Length: 0034
F00000F0
00000000
00000000
Record ID: IOSDMHCB.MHCBUCB
+0000
+0010
+0020
+0030
+0040
+0050
+0060
+0070
00000940
00000000
00040040
28980027
01000040
0088FF84
80062024
C1D21000
20200000
00FCC8B4
00FC3800
F00080F0
00000001
01800800
00F168C0
00000000
Length: 0080
01E13480
00F16890
00FC3100
3868B8E8
00000041
00F16968
00010100
00000000
Record ID: IOSDMHCB.MHCBTMJB
+0000
+0010
ACA29DF9
5CD4C1E2
49B6E706
E3C5D95C
Record ID: IOSDMHCB.MHCBADDL
+0000
S530
BCBC2010
01000040
U/R
000C0001
0027FFF0 | .1.Y....0..0...0 |
00804400 | ...Y............ |
| .e.h............ |
| ....
|
00000000 | ... ............
00000000 | ......H..1......
0001001F | ... ............
FFFFFFFF | .q..0..0...Y....
00FC3800 | ... ............
00F1F8F0 | .h.d.....1...180
F1F8F0D7 | .....1.{....180P
| AK.............. |
|
|
|
|
|
|
|
Length: 0018
F0F0F0F0
F1F5F0F0
| .s.9..X.00001500 |
| *MASTER*
|
Length: 0008
| .......
19:42:52.885939
|
Unconditional Reserve Sense
Device: 0180 Channel Path: 38
U/R Sense issued by: Missing Interrupt Handler
U/R Sense completion code: 52
第 11 章 コンポーネント・トレース
11-79
コンポーネント・トレース
S530
U/R
000C0002
19:43:13.927140
Unconditional Reserve I/O
Device: 0180
Recovery I/O issued: Reset Allegiance
Return code from IOSRRRSV: 04
Record ID: IOSDRESV.RESS
+0000
+0010
+0020
+0030
+0040
S530
Length: 0044
D9C5E2E2
00000000
00000000
00000000
4000C000
05000052
00000000
00000000
F0000000
00800000 00000000 | RESS............ |
| ................ |
| ................ |
80000500 00010760 | ....0..........- |
| .{.
|
U/R
000C0002
17:40:50.336526
Unconditional Reserve I/O
Device: 0160 Channel Path: 65
Recovery I/O issued: Sense Path Group ID
Return code from IOSRRRSV: 00
Record ID: IOSDICCW.SNID
+0000
S530
Length: 000C
C0000111
13214381
AC9EB2D4
| {......a...M
U/R
000C0002
22:51:49.169701
|
Unconditional Reserve I/O
Device: 0180 Channel Path: 0B
Recovery I/O issued: Reset Allegiance
Return code from IOSRRRSV: 00
Record ID: IOSDICCW.RSTA
+0000
+0010
S530
Length: 0020
80000000
00000000
00000000
00000000
00000000 | ................ |
| ................ |
U/R
000C0002
19:43:39.951626
Unconditional Reserve I/O
Device: 0180 Channel Path: 38
Recovery I/O issued: Unconditional Reserve with release
Return code from IOSRRRSV: 00
SYSJES コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
11-80
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
JES 共通結合サービス・コンポーネント (JES XCF とも呼ばれます) に関する
SYSJES コンポーネント・トレースの要求に必要な情報を以下に要約します。
情報
SYSJES の場合
parmlib メンバー
CTnJESxx
デフォルトのメンバー: CTIJES01、CTIJES02、
CTIJES03、CTIJES04
デフォルトのトレース
あり。サブレベル FLOW に関する詳細なトレース。
サブレベル MSGTRC、USRXIT、XCFEVT に関する
予期しないイベントの最小限のトレース。
トレース要求の OPTIONS パラメー なし
ター
バッファー
v
v
v
v
v
デフォルト: 適用外
範囲: 適用外
サイズの設定方法: MVS システム
IPL 後のサイズ変更: 不可
場所: コンポーネント・アドレス・スペース内
トレース・レコードの場所
アドレス・スペース・バッファー、トレース・デー
タ・セット
SVC ダンプの要求
コンポーネントによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSJES)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
注: JES XCF に関する完全なダンプを入手するには、JES および JES XCF のアド
レス・スペースとデータ・スペース、および SDATA オプション RGN、
SQA、および CSA も要求してください。
SYSJES トレースは初期設定の際に開始されます。SYSJES には、並行して実行され
る 4 つのサブレベル・トレースが含まれます。各サブレベルは個別に開始しなけれ
ばなりません。
サブレベルは次のとおりです。
v MSGTRC、メッセージ・トレース: MSGTRC は、IXZXIXSM サービスによって
送信されたメッセージ・データを記録します。このサブレベルのデフォルト・ト
レースは、予期しないイベントだけの最小限トレースです。オプションにより、
詳細な MSGTRC トレースを開始および停止できます。このサブレベルから得ら
れたデータを USRXIT トレース・データと合わせて使用すると、インストール・
システム出口 IXZXIT01 または IXZXIT02 によって修正されたメッセージ・デー
タに関する情報を獲得できます。
v USRXIT、インストール・システム出口トレース: USRXIT は、インストール・シ
ステム出口 IXZXIT01、IXZXIT02、および IXZXIT03 の処理に渡したり、これら
の処理から戻されたりした出口パラメーター・リスト (SPELL) を記録します。こ
のサブレベルのデフォルト・トレースは、予期しないイベントだけの最小限トレ
ースです。オプションにより、詳細な USRXIT トレースを開始および停止できま
す。このサブレベルから得られたデータを MSGTRC トレース・データと合わせ
第 11 章 コンポーネント・トレース
11-81
コンポーネント・トレース
て使用すると、インストール・システム出口 IXZXIT01、IXZXIT02 または
IXZXIT03 によるメッセージ処理に関する情報を獲得できます。
v FLOW、モジュール・フットプリント・トレース: FLOW は、JES 共通結合サー
ビス・コンポーネントを流れるメッセージおよびイベントを記録します。デフォ
ルトでは、FLOW は常に活動状態で詳細なトレース情報を生成します。
注: IBM では、エラー、システム状態の変更、または処理イベントなどの診断情
報を記録するためにこのトレースをいつも活動状態にしておくことをお勧め
しています。
v XCFEVT、システム・イベント (SYSEVENT) トレース: XCFEVT は、JES 共通
結合サービス・コンポーネントによって処理される SYSEVENT データを記録し
ます。デフォルトでは、XCFEVT は常に最小限度のトレースを行います。
SYSJES のトレースは、4 つのすべてのサブレベルで並行して実行することができ
ます。USRXIT および MSGTRC は、デフォルトではエラー・イベントだけをトレ
ースします。これらの 2 つのレベルに関して詳細なトレースをオンにすることがで
きます。
SYSJES トレースの要求
IBM では SYSJES TRACING を要求する場合には、以下のことをお勧めしていま
す。
v 1 つのシステムに関する 4 つのすべてのサブレベルを、1 つの parmlib メンバー
で一度に開始および停止します。SYSJES コンポーネント・トレースの要求は、
TRACE CT コマンドで指定できる CTnJESxx parmlib メンバーで要求してくださ
い。
SYSJES サブレベルの開始および停止方法の例として、IBM により 2 つの
parmlib メンバー IXZCTION および IXZCTIOF が SYS1.SAMPLIB で提供され
ています。これらのメンバーを parmlib にコピーし、CTIJESON および
CTIJESOF に名前変更してください。 CTIJESON parmlib メンバーはすべてのサ
ブレベルを開始し、それらを外部書き出しプログラムに接続します。CTIJESOF
parmlib メンバーはすべてのサブレベルのトレースを停止し、それらを外部書き出
しプログラムから切断します。
v SYSJES トレースではボリュームの大きなデータが作成されるため、トレース・
レコードの収集には外部書き出しプログラムを使用します。以下の指針に従っ
て、外部書き出しプログラムのソース JCL を作成してください。
– SYSJES トレース・データのボリュームを収められるように、SPACE パラメ
ーターとして少なくとも 10 シリンダーを指定してすべての TRCOUTnn DD
ステートメントをコーディングします。
– 10 シリンダーを超えるトレースの場合、1 つのボリュームでの入出力競合を
回避したいときには、各 TRCOUTnn ステートメントごとに固有のボリューム
通し番号を指定します。
– TRCOUT01 DD ステートメントで定義するデータ・セット名は、各システムで
固有でなければなりません。
– IPCS COPYTRC コマンドを使用して、複数の TRCOUTnn DD ステートメン
トから得られるレコードを 1 つのデータ・セットにマージします。情報につ
いては、z/OS MVS IPCS コマンド を参照してください。
11-82
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例: SYSJES 用のカタログ式プロシージャー
次の例は、SYSJES トレース出力をトレース・データ・セットに送信する外
部書き出しプログラム・プロシージャー IXZCTW を示しています。
//CTWDASD
PROC
//IEFPROC
EXEC PGM=ITTTRCWR
//SYSPRINT DD
SYSOUT=A
//TRCOUT01 DD
DSN=SYS1.JESXCF1,VOL=SER=TRACE6,UNIT=DASD,
//
SPACE=(CYL,10),DISP=(NEW,KEEP),DSORG=PS
//TRCOUT02 DD
DSN=SYS1.JESXCF2,VOL=SER=TRACE7,UNIT=DASD,
//
SPACE=(CYL,10),DISP=(NEW,KEEP),DSORG=PS
v シスプレックス環境でトレースを行っている場合、TRCOUTnn DD ステートメン
トで指定するデータ・セット名はシスプレックス全体を通じて固有でなければな
りません。これらのデータ・セット名が固有でない場合には、ENQUEUE エラー
が発生します。
CTnJESxx parmlib メンバー
次の表は、CTnJESxx parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTnJESxx で指定可能かどうか
ON または OFF
はい
ASID
いいえ
JOBNAME
いいえ
BUFSIZE
いいえ
OPTIONS
いいえ
SUB
はい
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON または OFF
1 つ必要
nnnnK または nnnnM
いいえ
COMP
必須
SUB
はい
PARM
はい
第 11 章 コンポーネント・トレース
11-83
コンポーネント・トレース
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
いいえ
JOBNAME
いいえ
OPTIONS
いいえ
WTR
はい
SYSJES トレースの要求の例
例 1: CTIJESON メンバーによる SYSJES トレースの開始
次の例は、1 つのシステムに関するトレースを開始するために
SYS1.SAMPLIB で提供されている CTIJESON parmlib メンバーを示していま
す。
TRACEOPTS
WTRSTART(IXZCTW) WRAP
SUB(MSGTRC)
ON
WTR(IXZCTW)
SUB(USRXIT)
ON
WTR(IXZCTW)
SUB(FLOW)
ON
WTR(IXZCTW)
SUB(XCFEVT)
ON
WTR(IXZCTW)
11-84
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例 2: CTIJESOF メンバーによる SYSJES トレースの停止
次の例は、1 つのシステムに関するトレースを停止するために
SYS1.SAMPLIB で提供されている CTIJESOF parmlib メンバーを示していま
す。
TRACEOPTS
SUB(MSGTRC)
OFF
SUB(USRXIT)
OFF
SUB(FLOW)
OFF
SUB(XCFEVT)
OFF
次のコマンドでトレースを停止してください。
TRACE CT,OFF,COMP=SYSJES,PARM=CTIJESOF
そのあとで、外部書き出しプログラムを停止するために次のコマンドを指定し
てください (外部書き出しプログラムのソース JCL のメンバー名が IXZCTW
であるものとします)。
TRACE CT,WTRSTOP=IXZCTW
初期設定中に発生した問題に関する SYSJES トレースの要求
この手順は、IBM サポートから依頼された場合にだけ使用してください。この手順
は、JES サブシステムを初期設定するときに発生する JES XCF の問題に関する
SYSJES トレースを要求します。この手順は、デフォルトの parmlib メンバー
CTIJES01、 CTIJES02 または CTIJES04 を使用し、これらの SYSJES サブレベル
のトレースを要求します。parmlib メンバー CTIJES03 は、デフォルトではユーザー
のシステム上で活動状態にあるモジュール・フットプリントのトレースを含みま
す。したがって、ユーザーはこのトレースを変更するためのアクションは必要あり
ません。
4 つすべてのトレースを活動化することにより、システムのパフォーマンスを落と
す場合があります。これは、大量のトレース・データが生成されるためです。した
がって、この手順は IBM から依頼された場合に限って使用するようにし、この完
全トレースを常時オンにすることは避けてください。完全トレースは IBM から依
頼された場合にだけ実行すべきものであるため、同一の parmlib メンバーが、トレ
ースをオフに設定した状態で提供されています。parmlib メンバー CTIJES01、
CTIJES02 および CTIJES04 のデフォルトの内容は、次の通りです。
TRACEOPTS
OFF
parmlib メンバー CTIJES03 のデフォルトの内容は、次の通りです。
TRACEOPTS
ON
IBM では、必ずこのサブレベルのトレースをいつもオンにすることをお勧めしてい
ます。
第 11 章 コンポーネント・トレース
11-85
コンポーネント・トレース
1. トレースをオンにするために CTIJES01、CTIJES02 および CTIJES04 parmlib
メンバーを変更してください: parmlib メンバー CTIJES01、CTIJES02 および
CTIJES04 を変更して サブレベルのトレースをオンにし、サブレベルを外部書き出
しプログラムに接続します。これらの parmlib メンバーは、トレースをオフに設定
し、書き出しプログラムへの接続を行わない状態で提供されています。
parmlib メンバーを修正して JES サブシステムを初期設定すると、 JES XCF に関
する完全なトレースが自動的に開始されます。
例: CTIJESxx メンバーにおけるトレースをオンにする
以下は、IBM サポートの依頼に基づいて、JES サブシステム初期設定時にト
レース・データの収集を行うように修正されたあとの、CTIJESxx parmlib メン
バーの例です。このメンバーはサブレベルのトレースをオンにし、サブレベル
を外部書き出しプログラムに接続します。
TRACEOPTS
WTRSTART(IXZCTW)
ON
WTR(IXZCTW)
2. SYSJES トレースを停止するための CTIJESOF parmlib メンバーを作成してく
ださい: CTIJESOF parmlib メンバーを使用して、初期設定時の完全 SYSJES トレー
スを停止し、外部書き出しプログラムからサブレベルを切断してください。
3. 初期設定トレースの完了後に SYSJES トレースを停止してください: マスター
権限のあるコンソールから次のように、CTIJESOF parmlib メンバーを参照する
TRACE CT コマンドを入力してください。
TRACE CT,OFF,COMP=SYSJES,PARM=CTIJESOF
4. CTIJES01、CTIJES02 および CTIJES04 parmlib メンバーを再修正してデフォ
ルトのトレースに戻してください: parmlib メンバー CTIJES01、CTIJES02 および
CTIJES04 を変更してサブレベルのトレースをオフにします。
例: CTIJESxx メンバーでデフォルト値に戻す
次の例は、トレースをオフに設定して元の内容に戻したあとの、 parmlib メン
バー CTIJES01、CTIJES02 および CTIJES04 を示しています。
TRACEOPTS
OFF
SYSJES トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSJES) サブコマンドを使
用して行います。SYSJES トレースをフォーマット設定するには、次のことを行う
必要があります。
11-86
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
v フォーマット設定したい 4 つのサブレベルのそれぞれについて 1 回ずつ、
SYSJES 用の CTRACE コマンドを入力します。『SYSJES サブレベル情報のフ
ォーマット設定』を参照してください。
v OPTIONS パラメーターで SYSJES オプションを指定します。『SYSJES トレー
スをフォーマット設定するための OPTIONS パラメーター』を参照してくださ
い。
v 異なるサブレベル要求からの出力をマージします。『複数のサブレベルからの
SYSJES 情報のマージ』を参照してください。
SYSJES トレースの場合には、IPCS MERGE サブコマンドを使用してタイム・スタ
ンプ順になっていないトレースを表示します。
SYSJES サブレベル情報のフォーマット設定
フォーマット設定したいそれぞれの SYSJES サブレベルについて、個別に
CTRACE コマンドを入力する必要があります。たとえば、サブレベル MSGTRC お
よび USRXIT に関する SYSJES トレース・データのフォーマット設定を要求する
には、次の 2 つのコマンドを入力します。
CTRACE COMP(SYSJES) SUB((USRXIT)) FULL
CTRACE COMP(SYSJES) SUB((MSGTRC)) FULL
これらの例の場合には、オプションを要求しないでトレースが行われます。
SYSJES トレースをフォーマット設定するための OPTIONS パラメ
ーター
IBM では、SYSJES トレースのためにオプションを入力するように依頼することが
あります。SYSJES トレースのオプションは、CTRACE コマンドの OPTIONS パラ
メーターで指定できます。オプションには、以下のものがあります。
v すべてのサブレベルに有効なオプション
– MSGTOKEN=msgtoken
– REQTOKEN=reqtoken
– MSGBUF=msgbuf
– CTCR=ctcr
v FLOW サブレベルだけに有効なオプション
– MODID=id
– MODFLOW
– MSGFLOW
v MSGTRC サブレベルだけに有効なオプション
– SEND
– RECEIVE
v USRXIT サブレベルだけに有効なオプション
– EXIT1
– EXIT3
– EXIT2
複数のサブレベルからの SYSJES 情報のマージ
SYSJES は 4 つのサブレベル・トレースを同時に実行できるため、完全な SYSJES
トレース・データを発生順に見るためには、データをマージする必要があります。
第 11 章 コンポーネント・トレース
11-87
コンポーネント・トレース
たとえば、4 つのすべてのサブレベルから得られた JESXCF トレース・データをマ
ージするには、次のコマンドを入力します。
MERGE
CTRACE COMP(SYSJES)
CTRACE COMP(SYSJES)
CTRACE COMP(SYSJES)
CTRACE COMP(SYSJES)
MERGEEND
SUB((USRXIT)) FULL
SUB((MSGTRC)) FULL
SUB((XCFEVT)) FULL
SUB((FLOW)) FULL
4 つのサブレベルに関する CTRACE コマンドを発行して出力を自動的にマージす
るように、IPCS CLIST を作成することができます。CLIST の記述に関する情報
は、z/OS MVS IPCS カスタマイズ を参照してください。
SYSJES トレースからの出力
次の例は、FULL パラメーターが指定された 4 つの SYSJES サブレベル・トレー
スから得られたマージ出力を示しています。
11-88
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
_______________________________________________________________________________
********** MERGED TRACES ***********
01. CTRACE comp(sysjes) sub((flow)) full
02. CTRACE comp(sysjes) sub((usrxit)) full
03. CTRACE comp(sysjes) sub((msgtrc)) full
04. CTRACE comp(sysjes) sub((xcfevt)) full
_______________________________________________________________________________
COMPONENT TRACE FULL FORMAT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((FLOW))
_______________________________________________________________________________
COMPONENT TRACE FULL FORMAT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((USRXIT))
_______________________________________________________________________________
COMPONENT TRACE FULL FORMAT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((MSGTRC))
_______________________________________________________________________________
COMPONENT TRACE FULL FORMAT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((XCFEVT))
**** 10/25/93
MNEMONIC ENTRY ID
TIME STAMP
DESCRIPTION
-------- -------- --------------- ----------04. XCFEVT
00000030 16:53:54.876999 XCF event message buffer
HOMEASID 0013
JOBNAME. JESXCF HOMETCB@ 007EA6F8
CPUID... FF170945 30900000
CTCR@... 03062460 MEMBER.. SY1
SYSNAME. SY1
MSGBUF@. 20000014 ALET.... 0101001B REQTOKEN 00000001 20000014
MSGTOKEN 00000001 20000014
+0000 E8C9E7C5 D5400100 00000001 00000001 | YIXEN .......... |
+0010 E2E8E2E9 D1C5E2F3 E2E8E2C5 E5C5D5E3 | SYSZJES3SYSEVENT |
+0020 40404040 40404040 E2E8E2C5 E5C5D5E3 |
SYSEVENT |
+0030 40404040 40404040 E2E8E2E9 D1C5E2F3 |
SYSZJES3 |
+0040 E2E8E2C5 E5C5D5E3 40404040 40404040 | SYSEVENT
|
+0050 E2E8E2C5 E5C5D5E3 40404040 40404040 | SYSEVENT
|
+0060 10001000 80000108 01140000 00000000 | ................ |
+0070 00000000 A849C5A7 AE08EC01 00000000 | ....y.Ex........ |
+0080 00000000 00000000 00000000 00000000 | ................ |
.
.
.
第 11 章 コンポーネント・トレース
11-89
コンポーネント・トレース
**** 10/25/93
MNEMONIC ENTRY ID
TIME STAMP
DESCRIPTION
-------- -------- --------------- ----------02. PREXIT3 00000007 16:53:55.303610 SPELL prior to Exit 3 processing
HOMEASID 0017
JOBNAME. JES3
HOMETCB@ 007FD2B8
CPUID... FF170945 30900000
CTCR@... 03062460 MEMBER.. SY1
SYSNAME. SY1
XPLBUF@. 03368000
+0000 E95BE7D7 D3400101 C9E7E9E7 C9E3F0F3 | Z$XPL ..IXZXIT03 |
+0010 40404040 40404040 40000000 80000000 |
....... |
+0020 00000000 00000000 00000000 00000000 | ................ |
+0030 00000054 00000038 E2E8E2E9 D1C5E2F3 | ........SYSZJES3 |
+0040 E2E8F140 40404040 40404040 40404040 | SY1
|
+0050 00000000
| ....
|
02. POSTXIT3 00000008 16:53:55.306462 SPELL after Exit 3 processing
HOMEASID 0017
JOBNAME. JES3
HOMETCB@ 007FD2B8
CPUID... FF170945 30900000
CTCR@... 03062460 MEMBER.. SY1
SYSNAME. SY1
XPLBUF@. 03368000
+0000 E95BE7D7 D3400101 C9E7E9E7 C9E3F0F3 | Z$XPL ..IXZXIT03 |
+0010 40404040 40404040 40000000 80000000 |
....... |
+0020 00000000 00000000 00000000 00000000 | ................ |
+0030 00000054 00000038 E2E8E2E9 D1C5E2F3 | ........SYSZJES3 |
+0040 E2E8F140 40404040 40404040 40404040 | SY1
|
+0050 00000000
| ....
|
**** 10/25/93
MNEMONIC ENTRY ID
TIME STAMP
DESCRIPTION
-------- -------- --------------- ----------03. INDATA
00000011 16:55:17.318441 input message data
HOMEASID 0017
JOBNAME. JES3
HOMETCB@ 007FD2B8
CPUID... FF170945 30900000
CTCR@... 03062460 MEMBER.. SY1
SYSNAME. SY1
MSGBUF@. 1FFFF814 ALET.... 0102001B REQTOKEN 00000001 1FFFF814
MSGTOKEN 00000001 1FFFF814
+0000 E8C9E7C5 D5400100 00000001 00000001 | YIXEN .......... |
+0010 E2E8E2E9 D1C5E2F3 E2E8F240 40404040 | SYSZJES3SY2
|
+0020 40404040 40404040 E2E8E2D1 C5E24040 |
SYSJES |
+0030 C3D6D5E2 C5D9E540 E2E8E2E9 D1C5E2F3 | CONSERV SYSZJES3 |
+0040 E2E8F140 40404040 40404040 40404040 | SY1
|
+0050 E2E8E2D1 C5E24040 C3D6D5E2 C5D9E540 | SYSJES CONSERV |
+0060 20001000 20000100 01148000 00000000 | ................ |
+0070 00000000 A849C5F6 19827F03 00000000 | ....y.E6.b"..... |
+0080 00000000 007FD2B8 00FC1D00 00000000 | ....."K......... |
+0090 00000214 00000000 00000000 00000001 | ................ |
+00A0 1FFFF814 00000000 00000000 00000000 | ..8............. |
.
.
.
11-90
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
02.
EXIT1ERR 00000003 16:55:17.474658 SPELL error Exit 1 processing
HOMEASID 0017
JOBNAME. JES3
HOMETCB@ 007FD2B8
CPUID... FF170945 30900000
CTCR@... 03062460 MEMBER.. SY1
SYSNAME. SY1
XPLBUF@. 1FFFF414
MSGBUF@. 1FFFF814 ALET.... 0102001B REQTOKEN 00000001 1FFFF814
MSGTOKEN 00000001 1FFFF814
+0000 E95BE7D7 D3400100 C9E7E9E7 C9E3F0F1 | Z$XPL ..IXZXIT01 |
+0010 40404040 40404040 40000000 20000000 |
....... |
+0020 00000000 00000000 00000000 00000000 | ................ |
+0030 000001A0 00000038 E2E8E2E9 D1C5E2F3 | ........SYSZJES3 |
+0040 E2E8F240 40404040 40404040 40404040 | SY2
|
+0050 E2E8E2D1 C5E24040 C3D6D5E2 C5D9E540 | SYSJES CONSERV |
+0060 E2E8E2E9 D1C5E2F3 E2E8F140 40404040 | SYSZJES3SY1
|
+0070 40404040 40404040 E2E8E2D1 C5E24040 |
SYSJES |
+0080 C3D6D5E2 C5D9E540 00000100 1FFFF4B4 | CONSERV ......4. |
+0090 00000000 00000000 0000E300 00000000 | ..........T..... |
+00A0 E3C8C9E2 40C9E240 C1D540C1 E2E8D5C3 | THIS IS AN ASYNC |
+00B0 C8C1C3D2 40D4C5E2 E2C1C7C5 40404040 | HACK MESSAGE
|
+00C0 40404040 40404040 40404040 40404040 |
|
+00D0 40404040 40404040 40404040 40404040 |
|
+00E0 40404040 40404040 40404040 40404040 |
|
+00F0 40404040 40404040 40404040 40404040 |
|
+0100 40404040 40404040 40404040 40404040 |
|
+0110 40404040 40404040 40404040 40404040 |
|
+0120 40404040 40404040 40404040 40404040 |
|
+0130 40404040 40404040 40404040 40404040 |
|
+0140 40404040 40404040 40404040 40404040 |
|
+0150 40404040 40404040 40404040 40404040 |
|
+0160 40404040 40404040 40404040 40404040 |
|
+0170 40404040 40404040 40404040 40404040 |
|
+0180 40404040 40404040 40404040 40404040 |
|
+0190 40404040 40404040 40404040 40404040 |
|
03. SEND
00000010 16:55:17.568558 message queued to be sent
HOMEASID 0013
JOBNAME. JESXCF HOMETCB@ 007EA6F8
CPUID... FF170945 30900000
CTCR@... 03062460 MEMBER.. SY1
SYSNAME. SY1
MSGBUF@. 1FFFF814 ALET.... 0102001B REQTOKEN 00000001 1FFFF814
MSGTOKEN 00000001 1FFFF814
+0000 E8C9E7C5 D5400100 00000001 00000001 | YIXEN .......... |
+0010 E2E8E2E9 D1C5E2F3 E2E8F240 40404040 | SYSZJES3SY2
|
+0020 40404040 40404040 E2E8E2D1 C5E24040 |
SYSJES |
+0030 C3D6D5E2 C5D9E540 E2E8E2E9 D1C5E2F3 | CONSERV SYSZJES3 |
+0040 E2E8F140 40404040 40404040 40404040 | SY1
|
+0050 E2E8E2D1 C5E24040 C3D6D5E2 C5D9E540 | SYSJES CONSERV |
.
.
.
次の例は、TALLY パラメーターが指定された 4 つの SYSJES サブレベル・トレー
スから得られたマージ出力を示しています。トレース出力に含まれているイベント
ID を調べる場合には、TALLY 報告書を使用してください。
第 11 章 コンポーネント・トレース
11-91
コンポーネント・トレース
_______________________________________________________________________________
COMPONENT TRACE TALLY REPORT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((FLOW))
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
COUNT
INTERVAL
MNEMONIC DESCRIBE
-------- -------- ------------ -------- -------------------------------00000020
29
6,902,004 MSGFLOW module flow for this message
00000021
114
1,755,686 MODFLOW module flow
0000002E
3
2,631,973 MSGERR
module error flow
0000002F
7
27,207,632 MODERR
module error flow
Total trace entries:
153
_______________________________________________________________________________
COMPONENT TRACE TALLY REPORT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((MSGTRC))
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
COUNT
INTERVAL
MNEMONIC DESCRIBE
-------- -------- ------------ -------- -------------------------------00000010
13
17,076,718 SEND
message queued to be sent
00000011
17
12,821,783 INDATA
input message data
00000012
0
SENDBUF buffer sent by XCF
00000013
0
SENDQERR Sendq queueing error
00000014
0
SBUFERR Send error from XCF
00000018
13
17,061,037 RECEIVE msg dequeued from receive
00000019
10
30,944,882 OUTDATA output message data
0000001A
26
8,192,076 RECVBUF buffer received from XCF
0000001B
0
RBUFERR Receive error from XCF
0000001C
0
RECVQERR Receiveq queueing error
Total trace entries:
79
_______________________________________________________________________________
COMPONENT TRACE TALLY REPORT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((XCFEVT))
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
COUNT
INTERVAL
MNEMONIC DESCRIBE
-------- -------- ------------ -------- -------------------------------00000030
27
35,794,857 XCFEVT
XCF event message buffer
00000031
0
XCFERR
XCF event message error
Total trace entries:
27
_______________________________________________________________________________
COMPONENT TRACE TALLY REPORT
SYSNAME(SY1)
COMP(SYSJES) SUBNAME((USRXIT))
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
COUNT
INTERVAL
MNEMONIC DESCRIBE
-------- -------- ------------ -------- -------------------------------00000001
1
PREXIT1 SPELL prior to Exit 1 processing
00000002
0
POSTXIT1 SPELL after Exit 1 processing
00000003
1
EXIT1ERR SPELL error Exit 1 processing
00000004
1
PREXIT2 SPELL prior to Exit 2 processing
00000005
0
POSTXIT2 SPELL after Exit 2 processing
00000006
1
EXIT2ERR SPELL error Exit 2 processing
00000007
14
60,329,405 PREXIT3 SPELL prior to Exit 3 processing
00000008
14
60,374,425 POSTXIT3 SPELL after Exit 3 processing
00000009
0
EXIT3ERR SPELL error Exit 3 processing
Total trace entries:
32
11-92
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SYSjes2 コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、JES2 サブシステム用の SYSjes2 コンポーネント・トレースを要求するた
めの情報を要約します。説明を簡単にするために、このコンポーネント・トレース
は SYSjes2 という名前で呼ばれていますが、jes2 の部分は、ユーザーの (1 次ま
たは 2 次) JES2 サブシステムに割り当てられている名前で置き換えてください。
たとえば、多重 JES 環境における 2 次 JES2 の名前として使用されている JESA
に関するトレース情報を入手するには、コンポーネント名として SYSJESA を使用し
てください。
情報
SYSjes2 の場合
parmlib メンバー
適用外
デフォルトのトレース
あり。サブレベル JQE および JOE に関する完全トレ
ース
トレース要求の OPTIONS パラメー なし
ター
バッファー
v
v
v
v
v
デフォルト: 適用外
範囲: 適用外
サイズの設定方法: JES2
IPL 後のサイズ変更: 不可
場所: コンポーネント・アドレス・スペース内
トレース・レコードの場所
アドレス・スペース・バッファー
SVC ダンプの要求
コンポーネント、DUMP または SLIP によって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSjes2)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSjes2 トレースは、初期設定中に自動的に開始します。SYSjes2 には、並行して
連続的に実行される 2 つのサブレベル・トレースが含まれます。
サブレベルは次のとおりです。
v JQE サービス・トレース: JQE は、すべてのジョブ・キュー・サービス呼び出し
を記録します (次を含みます: $QADD、$QPUT、$QREM、$QMOD、$QJIX、
$GETJLOK、$QRBDCHK、$QBUSY、$GETLOKW、$FREJLOK および
$FRELOKW)。
第 11 章 コンポーネント・トレース
11-93
コンポーネント・トレース
v JOE サービス・トレース: JOE は、すべてのジョブ出力エレメント・サービス呼
び出し ($#ADD、$#PUT、$#REM、$#MOD、 $#RBDCHK、$#BUSY、$#GET、お
よび $#CAN を含みます) を記録します。
SYSjes2 トレースの要求
SYSjes2 トレースを要求するためには、アクションは必要ありません。このトレー
スは、JES2 サブシステムが制御権を得ているときには常に活動状態になります。
SYSjes2 サブレベル・トレース情報のフォーマット設定
フォーマット設定したいそれぞれの SYSJES サブレベルについて、個別に
CTRACE コマンドを入力する必要があります。たとえば、サブレベル JQE および
JOE に関する SYSJES トレース・データのフォーマット設定を要求するには、次の
2 つのコマンドを入力します。
CTRACE COMP(SYSjes2) SUB((JQE)) FULL
CTRACE COMP(SYSjes2) SUB((JOE)) FULL
複数のサブレベルからの SYSjes2 情報のマージ
SYSjes2 は 2 つのサブレベル・トレースを同時に実行するため、完全な SYSjes2
トレース・データを発生順に見るためには、データをマージする必要があります。
SYSjes2 トレース・データをマージするためには、次のコマンド・ストリングを入
力してください。
MERGE
CTRACE COMP(SYSjes2) SUB((JQE)) FULL
CTRACE COMP(SYSjes2) SUB((JOE)) FULL
MERGEEND
両方のサブレベルに関する CTRACE コマンドを発行して出力を自動的にマージす
るように、IPCS CLIST を作成することができます。CLIST の記述に関する情報
は、z/OS MVS IPCS カスタマイズ を参照してください。
SYSjes2 トレースからの出力
SYSjes2 トレースからの出力では、最大 500 個のトレース項目が折り返し (すなわ
ちローリング) トレース・フォーマットで表示されます。つまり、トレース・テー
ブルに 500 の項目が入ると、次の項目 (501、502、503...) により連続循環方式で項
目 1、2、3... が上書きされます。
次の例は、FULL パラメーターが指定された両方の SYSjes2 サブレベル・トレース
から得られたマージ出力を示しています。
_______________________________________________________________________________
********** MERGED TRACES ***********
01. CTRACE comp(sysjes2) sub((jqe)) full
02. CTRACE comp(sysjes2) sub((joe)) full
次の例は、SHORT パラメーターが指定された両方の SYSjes2 サブレベル・トレー
スから得られたマージ出力を示しています。
11-94
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
_______________________________________________________________________________
***********************short format screen ********************
COMPONENT TRACE SHORT FORMAT
COMP(SYSjes2) SUBNAME((JQE))
**** 07/11/94
SYSNAME
-------
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-------------
MVS1
JQE
00000200
14:33:35.162400
$QADD
MVS1
JQE
00000204
14:33:35.162404
$QJIX (ALLOC new number)
MVS1
JQE
00000200
14:33:36.174242
$QADD
------------------------------------------------------------------------
次の例は、FULL パラメーターが指定された両方の SYSjes2 サブレベル・トレース
から得られたマージ出力を示しています。このトレースで表示されるフィールドを
マップするには、マッピング・マクロ $ROTT (ローリング・トレース・テーブル)
を使用してください。
_______________________________________________________________________________
********************full format screen ******************************
IPCS OUTPUT STREAM ------------------------------------------ Line 0 Co
****************************** TOP OF DATA ***************************
COMPONENT TRACE FULL FORMAT
COMP(SYSjes2) SUBNAME((JQE))
**** 07/11/94
SYSNAME
-------
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-------------
MVS1
JQE
00000200
14:33:35.162400
$QADD
03B06C20 00000000 00000064 FF200100 | ..%............. |
00000000 0000
| ......
|
MVS1
JQE
00000204 14:33:35.162404 $QJIX (ALLOC new number
03B06C20 00000001 00000064 20200100 | ..%............. |
04000000 0000
| ......
|
MVS1
JQE
00000200 14:33:36.174242 $QADD
------------------------------------------------------------------------
次の例は、TALLY パラメーターが指定された両方の SYSjes2 サブレベル・トレー
スから得られたマージ出力を示しています。
第 11 章 コンポーネント・トレース
11-95
コンポーネント・トレース
_______________________________________________________________________________
**************************tally format screen *************************
COMPONENT TRACE TALLY REPORT
COMP(SYSjes2) SUBNAME((JQE))
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
COUNT
INTERVAL
MNEMONIC DESCRIBE
-------- -------- ------------ -------- --------------------------00000200
12
96,278,898 JQE
$QADD
00000201
0
JQE
$QPUT
00000202
0
JQE
$QREM
00000203
30
36,473,953 JQE
$QMOD
00000204
12
96,278,898 JQE
$QJIX (ALLOC new number)
00000205
0
JQE
$QJIX (SWAP job numbers)
00000206
5
273,117,249 JQE
$GETJLOK
00000207
5
274,068,170 JQE
$FREJLOK
.
.
.
Total trace entries:
89
****************************** END OF DATA ***************************
SYSLLA コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、内容監視のライブラリー索引機能 (LLA) 用の SYSLLA コンポーネント・
トレースを要求するための情報を要約します。
情報
SYSLLA の場合
parmlib メンバー
なし
デフォルトのトレース
あり。LLA の実行中は常にオン。
トレース要求の OPTIONS パラメー なし
ター
11-96
バッファー
v
v
v
v
v
トレース・レコードの場所
アドレス・スペース・バッファー
SVC ダンプの要求
コンポーネントによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSLLA)
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
デフォルト: 適用外
範囲: 適用外
サイズの設定方法: MVS システム
IPL 後のサイズ変更: 不可
場所: コンポーネント・アドレス・スペース内
コンポーネント・トレース
情報
SYSLLA の場合
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSLLA トレースの要求
このトレースは、LLA が制御を行っているときには常に実行されます。トレースを
要求するためのアクションは不要です。
SYSLLA トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSLLA) サブコマンドを使
用して行ってください。このサブコマンドには OPTIONS 値はありません。
SYSLOGR コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
次の表に、システム・ロガー・コンポーネント用の SYSLOGR コンポーネント・ト
レースを要求するための情報を要約します。
表 11-2. SYSLOGR コンポーネント・トレース要求の要約
情報
SYSLOGR の場合
parmlib メンバー
CTnLOGxx
デフォルト・メンバー: CTILOG00
Parmlib のデフォルト・トレース・
オプション
CONNECT、LOGSTRM、DATA
SET、SERIAL、MISC、LOCBUFF、RECOVERY
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー CTnLOGxx および TRACE コマンドの REPLY で指
ター
定
バッファー
Parmlib デフォルト: 16MB
デフォルト: 2MB
範囲: 2MB - 2047MB
サイズの設定: CTnLOGxx メンバーまたは TRACE
CT コマンドの REPLY で指定
v IPL 後のサイズ変更: 可能
v 位置: システム・ロガー・トレース・データ・スペ
ース
v
v
v
v
第 11 章 コンポーネント・トレース
11-97
コンポーネント・トレース
表 11-2. SYSLOGR コンポーネント・トレース要求の要約 (続き)
情報
SYSLOGR の場合
トレース・レコードの場所
アドレス・スペース・バッファー ; システム・ロガ
ー・トレース・データ・スペース、トレース・デー
タ・セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSLOGR)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSLOGR トレースは初期設定の際に開始されます。
システム・ロガー情報のダンプの入手
以下の例を使用してシステム・ロガーに関する適切な診断情報を入手してくださ
い。ダンプとして要求する情報量は非常に大きい場合があります。ロガーのダンプ
を入手する前に、CHNGDUMP 設定 の MAXSPACE を 999 MB に設定することが
必要となる場合があります。
CD SET,SDUMP,MAXSPACE=999M
構造ダンプの場合は、次のコマンドを出して、カップリング・ファシリティーが、
ダンプ・スペースを定義していることを確認してください。
D CF,CFNAME=xxxx
注: 以下にリストした手順を自動化するためのモデルとして使用できる、サンプル
のロガー・ダンプ parmlib メンバーがいくつかあります。サンプル parmlib メ
ンバーは ’SYS1.SAMPLIB(IEADMCLx)’ に入って出荷されます。詳細について
は、IEADMCLx メンバー、または 2-17 ページの表 2-1 を参照してください。
1. すべてのタイプのログ・ストリームに、必ず以下を含めてください。
a. IXGLOGR (ロガー) asid、および DSPNAME パラメーターにより IXGLOGR
asid に関連付けられたデータ・スペース。これらは、JOBNAME= パラメー
ターを使用してダンプします。
b. トレース・データ・スペース SYSLOGR0 は、DSNAME=(’IXGLOGR’.*) を
ダンプ・コマンドに応答して指定した場合、ダンプに含まれます。
注: OS/390® リリース 2 以前のリリースを実行する場合、ロガーにはトレー
スのための SYSLOGR* データ・スペースはありません。この場合、
DSPNAME=(’IXGLOGR’.*) オプションを省略できます。
DUMP COMM=(dump system logger with component trace)
* rr IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND
rr,JOBNAME=(IXGLOGR),CONT
ss,DSPNAME=(’IXGLOGR’.SYSLOGR*),CONT
tt,SDATA=(COUPLE,ALLNUC,LPA,LSQA,PSA,RGN,SQA,SUM,
TRT,CSA,GRSQ,XESDATA),END
2. CF リスト構造体ベースのログ・ストリームを使用するとき、以下を含めてくだ
さい。
a. XCF asid およびトレース・データ・スペース。これらは、JOBNAME= パラ
メーターおよび DSPNAME パラメーターを使用してダンプします。
11-98
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
b. XES STRUCTURE データ。これは、STRLIST= パラメーターを使用して、構
造体名を指定することによって、ダンプします。 structure_name は、影響を
受ける STRUCTURE 名です。
注: CFRM ポリシーの CF 定義に定義されているとおりに、必ず十分な
DUMPSPACE() を割り振ってください。十分なスペースを割り振らない
場合には、STRUCTURE のすべてまたは一部がダンプされません。
c. 「データがない」または「ブロックが見つからない」場合は、IDCAMS を使
用して OFFLOAD データ・セットをダンプすることをお勧めします。
DUMP COMM=(dump system logger with xes and structure data)
* rr IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND
rr,JOBNAME=(IXGLOGR,XCFAS),CONT
ss,DSPNAME=(’XCFAS’.*,’IXGLOGR’.SYSLOGR*),CONT
tt,SDATA=(COUPLE,ALLNUC,LPA,LSQA,PSA,RGN,SQA,SUM,
TRT,CSA,GRSQ,XESDATA),CONT
uu,STRLIST=(STRNAME=structure_name,LOCKENTRIES,ACC=NOLIM,
(LISTNUM=ALL,ADJUNCT=DIRECTIO,ENTRYDATA=UNSERIALIZE)),END
3. シスプレックス内の複数のシステムでシステム・ロガー・ダンプを必要とする場
合には、REMOTE パラメーターを含めてください。
DUMP COMM=(dumps for system logger around the sysplex)
* rr IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND
rr,JOBNAME=(IXGLOGR,XCFAS),CONT
ss,DSPNAME=(’XCFAS’.*,’IXGLOGR’.SYSLOGR*),CONT
tt,SDATA=(COUPLE,ALLNUC,LPA,LSQA,PSA,RGN,SQA,SUM,
TRT,CSA,GRSQ,XESDATA),CONT
uu,STRLIST=(STRNAME=structure_name,LOCKENTRIES,ACC=NOLIM,
(LISTNUM=ALL,ADJUNCT=DIRECTIO,ENTRYDATA=UNSERIALIZE)),CONT
vv,REMOTE=(SYSLIST=*)’XCFAS’,’IXGLOGR’),DSPNAME,SDATA),END
4. 他の診断上の考慮事項
CTILOG00 のバッファー・サイズは 16MB です。 この値を下げないことを強く
お勧めします。 11-97 ページの表 11-2 に記載された CTnLOGxx メンバーを参照
してください。
システム・ロガーが使用するデータの多くは、IPL を行っても残っていることに
注意してください。このことは、このデータが破壊されて、システム・ロガーが
悪影響を受けると、IPL を行っても問題が解決できないことを意味します。IPL
を行っても消えないシステム・ロガー障害の場合、IXGLOGR アドレス・スペー
スを FORCE することができます。 FORCE を行う前に、接続状態のアプリケ
ーションのすべてを終了させてください。それから FORCE コマンド (
FORCE IXGLOGR,ARM
) を出し、SYS1.PROCLIB に提供されているプロシージャー (IXGLOGRS) を使
用してシステム・ロガーを再始動します。 (
S IXGLOGRS
)
もし、
FORCE IXGLOGR,ARM
第 11 章 コンポーネント・トレース
11-99
コンポーネント・トレース
でこの状態が解決され「ない」場合は、 IPL を実行しても、おそらく解決され
ません。システム・ロガーがまだダンプを取得していない場合は、このときにダ
ンプを取得します。
注:
a. CICS ダンプは、IXGLOGR アドレス・スペースをダンプしません。新しい
(壊れていない) LOGSTREAM に接続してください。この結果、CICS などの
一部のアプリケーションの LOSS OF DATA が発生し、それらを強制的に
INITIAL START することになります。しかし、このほかには、アプリケーシ
ョンを再開する方法はない可能性があります。新しい LOGSTREAM (異なる
名前の) に接続することにより、壊れたデータを事後の診断検討用に構造に残
すことができます。
b. この新しい LOGSTREAM に接続する準備として、セットアップ時に各
STRUCTURE に対して未使用の LOGSTREAM を定義する必要が生じます。
CICS を実行している場合、必ず、以下の SLIP を指定して実行してください。
SLIP SET,COMP=1C5,REASON=804,
STRLIST=(STRNAME=strname1,LOCKE,ACC=NOLIM,
(LNUM=ALL,EDATA=SER,ADJ=CAP)),
JL=(XCFAS,IXGLOGR),DN=("XCFAS".*,"IXGLOGR".*),
SD=(COUPLE,ALLNUC,LPA,LSQA,PSA,RGN,SQA,TRT,CSA,GRSQ,
XESDATA,SUM),
SUMLIST=(13R?-7FFF,13R?+7FFF),END
注: SLIP 対象を CICS だけに限定するために、JOBNAME=DFH* を追加するこ
ともできます。RSN804 は「ブロックが見つからない」を意味し、この状態
は CICS では常に正しくない状態ですが、他のアプリケーションでは、正し
い場合と正しくない場合があります。この SLIP 設定により、CICS ですべ
ての RSN804 発生時にシステム・ロガーがダンプされることになります。
5. 頻繁に発生する間違ったブロック
a. MONOPLEX 状態の場合を除き、OFFLOAD データ・セットには VSAM
SHAREOPTIONS(3,3) を指定する必要があります。
b. OW33261 適用後は、システム・ロガーは、パフォーマンス上の理由により
OFFLOAD データ・セットに対して 24K CI サイズの使用をお勧めします。
ステージング・データ・セットは、4K CI サイズのままにしてください。
ACS ルーチンは、それに合わせてコーディングしてください。
c. XES 構造のサイズ。「このサイズは大きければ大きいほど、常に適切である
とは限りません。」アプリケーションごとの推奨サイズに従ってください。
d. OFFLOAD ディレクトリーのエクステントに対する考慮。z/OS MVS シスプ
レックスのセットアップ にある「結合データ・セット用のフォーマット・ユ
ーティリティー」を参照してください。
e. システム・ロガーは HSM サービスを使用して、オフロード・データ・セッ
トのリコール (ARCHRCAL) と削除 (ARCHDEL) を行います。HSM 競合ま
たは ARC0055A メッセージなどの WTOR 応答待ちが、システム・ロガーの
割り振りタスクを必要とするログ・ストリームすべてをハング状態にする可
能性があります。
11-100
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SYSLOGR トレースの要求
SYSLOGR コンポーネント・トレースを要求するオプションは、CTnLOGxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
SYSLOGR コンポーネント・トレースを要求するオプションは、CTnLOGxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
トレースの実行中に SYSLOG トレースのオプションとトレース・データ・スペー
ス・バッファー・サイズを変更できます。しかし、SYSLOGR トレースが外部書き
出しプログラムに接続されていなくて、トレース・データ・スペース・バッファー
のサイズを小さくする場合には、このデータがデバッグに重要であるときには、バ
ッファー・サイズを小さくする前にバッファーの内容 ( 11-98 ページの『システム・
ロガー情報のダンプの入手』を参照) をダンプする必要があります。トレース・デ
ータ・スペースのトレース・データは、バッファー・サイズを小さくするとき、廃
棄されます。
トレースをオフにした (TRACE CT,OFF コマンド、または CTnLOGxx parmlib メ
ンバーを使用して) 場合、および、SYSLOGR トレースが外部書き出しプログラム
に接続されていない場合、データの消失を避けるために、トレースをオフにする前
にトレース・データをダンプする必要があります。
CTnLOGxx parmlib メンバー
次の表は、CTnLOGxx parmlib メンバーで指定できるパラメーターを示していま
す。
パラメーター
CTnLOGxx で指定可能かどうか
ON または OFF
はい
ASID
はい
JOBNAME
いいえ
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
IBM は、システム・ロガー・トレースを初期設定時にアクティブにするようにする
ように指定する、CTILOG00 parmlib メンバーを提供します。 V1.4 現在で
OA07611 が適用済みの CTILOG00 の内容は、以下のとおりです。
TRACEOPTS ON
BUFSIZE(16M)
OPTIONS(’CONNECT,LOGSTRM,DATA SET,SERIAL,MISC,LOCBUFF,RECOVERY’)
これらのパラメーターは、最小限のシステム・ロガー・トレースをオンにして、必
ず特定のトレース・オプションを組み込ませて、16 MB のデフォルトのトレース・
バッファーを設定します。これらのトレース・オプションは、システム・ロガーの
初期設定時に活動化されます。
第 11 章 コンポーネント・トレース
11-101
コンポーネント・トレース
CTnLOGxx parmlib メンバーの例: 次の CTnLOGxx parmlib メンバーの例におけ
るステートメントは、24 MB トレース・バッファーを指定します。システム・ロガ
ー・トレース・レコードはすべて、トレース出力に含まれます。
TRACEOPTS
ON
BUFSIZE(24M)
OPTIONS(’ALL’)
次の CTxLOGxx の例におけるステートメントは、32MB トレース・バッファーを
指定し、 ASID 09 のログ・ストリーム SYSPLEX.OPERLOG に対するログ・スト
リームの機能要求処理のトレースを行います。さらに、外部書き出しプログラム
EXTWTR を開始して、SYSLOGR を外部書き出しプログラムに接続します。
TRACEOPTS
WTRSTART(EXTWTR)
ON
BUFSIZE(32M)
ASID(09)
WTR(EXTWTR)
OPTIONS(’LOGSTRM’,’STRMNAME=(SYSPLEX.OPERLOG)’)
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnM、または OFF
はい
COMP
必須
SUB
いいえ
PARM
はい
OPTIONS
はい。ただし REPLY の場合にのみ可能
SYSLOG トレースが外部書き出しプログラムに接続されていなくて、トレース・デ
ータ・スペース・バッファーのサイズを小さくする場合には、このデータがデバッ
グに重要であるときには、バッファー・サイズを小さくする前にバッファーの内容
( 11-98 ページの『システム・ロガー情報のダンプの入手』を参照) をダンプする必
要があります。トレース・データ・スペース・バッファーのトレース・データは、
バッファー・サイズを小さくするとき、廃棄されます。
トレースをオフにした (TRACE CT,OFF コマンド、または CTnLOGxx parmlib メ
ンバーを使用して) 場合、および、トレースが外部書き出しプログラムに接続され
ていない場合、データの消失を避けるために、トレースをオフにする前にトレー
ス・データをダンプする必要があります。
11-102
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
いいえ
OPTIONS
はい
WTR
はい
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
OPTIONS パラメーター
CTnLOGxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下に英字順で示します。
オプション
デフォルト
サブパラメーター
ALL
いいえ
いいえ
CONNECT
はい
いいえ
DATA SET
はい
いいえ
INVENTRY
いいえ
いいえ
LOCBUFF
はい
いいえ
LOGSTRM
はい
いいえ
MISC
はい
いいえ
RECOVERY
はい
いいえ
SERIAL
はい
いいえ
STRMNAME
いいえ
ログ・ストリーム
STORAGE
いいえ
いいえ
ALL
すべてのシステム・ロガー・イベントをトレースします。
ASID
指定されたアドレス・スペース ID (ASID) に関するイベントだけをトレースし
ます。
COMPERR
内部システム・ロガー・エラーをトレースします。
CONNECT
リスト構造体の接続、切断、再構築、およびイベント出口処理をトレースしま
す。
DATA SET
ログ・ストリーム・データ・セットの割り振りおよび管理をトレースします。
INVENTRY
すべての LOGR CDS アクセスだけでなく、ログ・ストリームおよび構造体の
定義と削除処理をトレースします。このオプションは、IBM サポートから要求
されない場合は、指定しないでください。これは大量のレコードを生成し、バッ
ファーが頻繁にラップする原因になるからです。
LOCBUFF
システム・ロガー・ローカル・バッファー管理をトレースします。
LOGSTRM
ログ・ストリームの機能要求処理をトレースします。
MISC
システム・ロガー内部各種サービスをトレースします。
RECOVERY
システム・ロガー・コンポーネント・リカバリーをトレースし、処理中の異常条
件を検出します。
第 11 章 コンポーネント・トレース
11-103
コンポーネント・トレース
SERIAL
システム・ロガー逐次化サービスをトレースします。
STORAGE
システム・ロガー・ストレージ管理をトレースします。このオプションは、IBM
サポートから要求されない場合は、指定しないでください。これは大量のレコー
ドを生成し、バッファーが頻繁にラップする原因になるからです。
STRMNAME
指定されたログ・ストリームに関するイベントだけをトレースします。
STRMNAME を指定した場合、指定されたログ・ストリームによって
CONNECT、LOGSTRM、 INVENTRY、および DATA SET オプションがフィ
ルター操作されます。STRMNAME パラメーターには、STRMNAME=
(strmname1) を指定する必要があります。複数のログ・ストリームを指定する場
合、STRMNAME には STRMNAME=(strmname1,strmname2) を指定する必要が
あります。最大で 8 つまでのログ・ストリーム名を指定できます。
システムは、指定されたログ・ストリーム名を検査しないことに注意してくださ
い。
SYSLOGR トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSLOGR) サブコマンドを
使用して行います。IBM では、SYSLOGR フォーマット設定のためにオプションを
入力するように依頼することがあります。SYSLOG0R トレースのオプションは、
CTRACE コマンドの OPTIONS パラメーターで指定できます。オプションには、以
下のものがあります。
COMPERR
内部システム・ロガー・コンポーネント・エラーを表示します。
CONNECT
リスト構造体の接続、切断、再構築、およびイベント出口処理を表示します。
DATA SET
ログ・ストリーム・データ・セットの割り振りおよび管理を表示します。
INVENTRY
LOGR ポリシー処理だけでなく、ログ・ストリームおよび構造体の定義と削除
処理を表示します。
LOCBUFF
システム・ロガー・ローカル・バッファー管理を表示します。
LOGSTRM
ログ・ストリームの機能要求処理を表示します。
MISC
システム・ロガー内部各種サービスを表示します。
RECOVERY
システム・ロガー・コンポーネント・リカバリーを表示し、処理中の異常条件を
検出します。
11-104
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
RQE(request_address)
8 バイト 16 進数 RQE アドレスを指定します。指定した RQE 制御ブロックを
表示します。
SERIAL
システム・ロガー逐次化サービスを表示します。
STACK(request_address)
8 バイト 16 進数スタック・アドレスを指定します。指定したアドレスのスタッ
クを表示します。
STORAGE
システム・ロガー・ストレージ管理を表示します。
SYSLOGR トレースからの出力
CTRACE COMP(SYSLOGR) サブコマンドの出力
CTRACE COMP(SYSLOGR) サブコマンドを指定してフォーマット設定されたシス
テム・ロガー・コンポーネント・トレース・レコードの例を次に示します。
COMPONENT TRACE FULL FORMAT
COMP(SYSLOGR)
**** 09/12/1994
CONNECT 03190001 13:03:28.955894 System
C9E7C3E2 C9C7F0F3 40404040 40404040 |
E2D3C3E3 C5E2E3F1 0100
|
RECOVERY 07040001 13:03:58.055519 System
C9E7C7C3 F4D9C6C3 840C1000 00000001 |
03171D80 0000
|
RECOVERY 07040001 13:09:55.907719 System
C9E7C7C3 F4D9C6C3 840C1000 00000001 |
031700A0 0000
|
COMPERR 01070007 13:30:58.322696 System
E2E8E2F0 F0F0F0F1 C9E7C7D3 D6C7D94B |
E2C3D6E3 E3F34BC1 F0F0F0F0 F0F0F140 |
40404040 40404040 40404040 40404040 |
40404040 0000
|
Logger Services
IXCSIG03
SLCTEST1..
Logger Services
IXGC4RFCd.......
......
Logger Services
IXGC4RFCd.......
......
Logger Services
SYS00001IXGLOGR.
SCOTT3.A0000001
..
|
|
|
|
|
|
|
|
|
|
SYSOMVS コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、z/OS UNIX 用の SYSOMVS コンポーネント・トレースを要求するための
情報を要約します。
第 11 章 コンポーネント・トレース
11-105
コンポーネント・トレース
情報
SYSOMVS の場合
parmlib メンバー
CTnBPXxx
デフォルト・メンバー: BPXPRM00 メンバーで指定さ
れた CTIBPX00
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー CTnBPXxx および TRACE コマンドの REPLY で指
ター
定
バッファー
v
v
v
v
デフォルトの値: 4MB
範囲: 16KB - 64MB
サイズの設定方法: CTnBPXxx メンバー
場所: データ・スペース内。 DUMP コマンドに対
する REPLY で DSPNAME=(asid.SYSZBPX2) を指
定する (asid は z/OS UNIX の ASID)。
トレース・レコードの場所
データ・スペース・バッファー、トレース・データ・
セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSOMVS)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSOMVS トレースの要求
SYSOMVS コンポーネント・トレースを要求するオプションは、CTnBPXxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
SYSOMVS トレースのオプションは、トレースの実行中に変更できます。
CTnBPXxx parmlib メンバー
次の表は、CTnBPXxx parmlib メンバーで指定できるパラメーターを示していま
す。
パラメーター
CTnBPXxx で指定可能かどうか
ON または OFF
はい
ASID
はい
JOBNAME
はい - 注参照
BUFSIZE
はい - 注参照
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
注:
11-106
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
v 新しいバッファー・サイズは、使用する CTnBPXxx メンバーの BUFSIZE パ
ラメーターで指定してください。
v JOBNAME= パラメーターは、SYSOMVS Ctrace に使用して、JOBNAME リ
ストで指定された特定ユーザー ID で実行されるジョブに対してのみデータ
のトレースを行うことができます。このフィルター処理は、ジョブのユーザ
ー ID に基づくもので、そのジョブ名には基づきません。
v OMVS カーネルは、ジョブ名 OMVS でトレースされます。
IBM により、CTIBPX00 parmlib メンバーが提供されています。これには、IPL 時
に z/OS UNIX トレースを開始するように指定されています。CTIBPX00 の内容は
次のとおりです。
TRACEOPTS
ON
BUFSIZE(128K)
これらのパラメーターを使用すると、最小限 SYSOMVS トレースがオンになりま
す。これらのパラメーターは、予期しないまたは重要な z/OS UNIX システム・サ
ービス・イベントを要求します。トレース・バッファー・サイズは 128KB です。
このメンバーは、IPL 時に最小限トレースを活動化します。IBM 提供の
BPXPRM00 parmlib メンバーでは、CTRACE パラメーターでデフォルトとして
CTIBPX00 が指定されています。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON または OFF
1 つ必要
nnnnK または nnnnM
いいえ
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
はい
OPTIONS
はい
WTR
はい
SYSOMVS トレースのオプションは、トレースの実行中に変更できます。
第 11 章 コンポーネント・トレース
11-107
コンポーネント・トレース
OPTIONS パラメーター
CTnBPXxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下に英字順で示します。
ALL
すべてのイベントをトレースします。
CBTR(cbid,offset,length)
トレースする制御ブロックのフィールド (複数可) をトレースします。トレース
の内容は、すべての SYSCALL トレース・レコードについて、トレース・レコ
ードに入れられます。
v cbid は、サポートされている任意の USS 制御ブロックの名前を 1 から 4
文字で指定します。
v offset は、制御ブロック内の望ましいフィールドのオフセットを、X'0' から
X'FFFF' の範囲で指定します。
v length は、トレースされる制御ブロック内のデータの長さをバイト数で指定
します。 length は、X'1' から X'8' の範囲の整数の 16 進値です。
CHARS
文字の特殊イベントをトレースします。
DEVPTY
疑似端末イベントのトレース。
DEVRTY
外部通信サーバー (OCS) リモート端末イベントのトレース。
FILE
ファイル・システム・イベントをトレースします。
IPC
共用メモリー、メッセージ・キューおよびセマフォーに関してプロセス間通信活
動をトレースする。
LOCK
ロック・サービス・イベントをトレースします。
PIPE
パイプ・イベントをトレースします。
PROCESS
処理イベントをトレースします。
PTRACE
PTRACE イベントをトレースします。
SIGNAL
信号イベントをトレースします。
STORAGE
ストレージ管理イベントをトレースします。
SYSCALL
呼び出し可能サービス層イベントをトレースします。
11-108
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SYSOMVS トレースの要求の例
例 1: CTnBPXxx メンバー
このメンバーは DEVPTY、FILE、および SIGNAL オプションを要求していま
す。
TRACEOPTS
ON
OPTIONS(’DEVPTY’,’FILE’,’SIGNAL’)
例 2: TRACE コマンド
この例は DEVPTY および FILE トレース・イベントのトレースを要求してい
ます。
TRACE CT,ON,COMP=SYSOMVS
* 18 ITT006A ...
REPLY 18,OPTIONS(DEVPTY,FILE),END
例 3: TRACE コマンド
この例は、制御ブロック PPRP のオフセットがゼロにおける 4 バイトのトレ
ースを要求します。
TRACE CT,ON,COMP=SYSOMVS
* 18 ITT006A ...
REPLY 18,OPTIONS(=(CBTR(PPRP,0,4))),END
SYSOMVS トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSOMVS) サブコマンドを
使用して行います。このサブコマンドの OPTIONS パラメーターでは、フォーマッ
ト設定するトレース・レコードを選択するためのオプションを指定します。ユーザ
ーが指定するフォーマット設定オプションは、要求されたトレース・オプションに
応じて大きく異なります。オプションを使用して表示されるレコードの範囲を狭く
して、エラーを見付けやすくしてください。CTRACE サブコマンドでオプションを
なにも指定しなかった場合、IPCS はすべてのトレース・レコードを表示します。
ALL
すべてのイベントをフォーマット設定します。
CHARS
文字特殊イベントをフォーマット設定します。
DEVPTY
疑似端末イベントのフォーマット設定。
DEVRTY
OCS リモート端末イベントのフォーマット設定。
EXCEPTION
リカバリー・レコードまたはエラー・レコードなどの例外イベントをフォーマッ
ト設定します。
第 11 章 コンポーネント・トレース
11-109
コンポーネント・トレース
FILE
ファイル・システム・イベントをフォーマット設定します。
IPC
共用メモリー、メッセージ・キューおよびセマフォーに関するイベントのフォー
マット設定。
LOCK
ロック・サービス・イベントをフォーマット設定します。
PIPE
パイプ・イベントをフォーマット設定します。
PROCESS
処理イベントをフォーマット設定します。
PTRACE
PTRACE イベントをフォーマット設定します。
SCCOUNTS
トレースで発生するシスコール (syscall) の数をカウントします。トレースで発
生する機能コードの数もカウントします。出力は、テーブル形式で表示されま
す。フォーマット設定は抑止されます。機能コードは、シスプレックス環境での
システム間で送受されるメッセージのタイプを表します。シスプレックス以外の
ダンプでは、機能コード・テーブルにはなにも入っていません。 CTRACE デー
タを収集中にアプリケーションを実行することもでき、その場合このオプション
を使用して、アプリケーションが行うシスコールや機能コードの発生数を測定す
ることもできます。
SEARCH
指定したオフセットから開始して、特定値のトレース項目を検索し、一致したも
のを表示します。
失敗したシスコール出口を識別する特定のエンティティー ID に対して検索を
行うことができる BPXMSCER と呼ばれる CLIST があります。
SIGNAL
信号イベントをフォーマット設定します。
STORAGE
ストレージ管理イベントをフォーマット設定します。
SYSCALL
呼び出し可能サービス層イベントをフォーマット設定します。
SYSID(nnn)
シスプレックス・システム・イベントをフォーマット設定します。
ユーザーがこれを要求すると、このシスプレックス・システム ID をもつトレ
ース・レコードだけがフォーマット設定されて表示されます。 (nnn) は、表示
されるレコードをもつ、シスプレックスにおけるシスプレックス番号またはシス
テムの名前です。 CTRACE DISPLAY PARAMETERS パネルの例およびパネル
上の SYSID オプションについては、 11-111 ページの『CTRACE DISPLAY
PARAMETERS パネルの例』を参照してください。
XCF
XCF イベントをフォーマット設定します。
11-110
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CTRACE DISPLAY PARAMETERS パネルの例
CTRACE DISPLAY PARAMETERS パネルは、次のフォーマットで表示されます。
--------- CTRACE DISPLAY PARAMETERS --------- Enter option
COMMAND ===>
System
Component
Subnames
===>
===>
===>
(System name or blank
SYSOMVS (Component name (required)
GMT/LOCAL
Start/time
Stop time
Limit
Report type
User exit
Override source
Options
===>
===>
===>
===>
===>
===>
===>
===>
G
(G or L, GMT is default)
(mm/dd/yy,hh:mm:ss:dddddd or
mm/dd/yy,hh.mm:ss.dddddd)
0
Exception ===>
SHORT (SHort, SUmmary, Full, Tally)
(Exit program name)
SYSID(1)
To enter/verify required values, type any character
Entry IDs ===> Jobnames ===> ASIDs ===> OPTIONS ===> SUBS===>
CTRACE COMP(SYSOMVS) SHORT OPTIONS((SYSID(1)))
ENTER = update CTRACE definition. END/PF3 = return to previous panel.
S = start CTRACE. R = reset all fields.
SYSID を指定すると、シスプレックス・システム ID をもつトレース・レコードだ
けがフォーマット設定されて表示されます。SYSID を指定しなければ、すべてのシ
ステムからのデータが表示されます。
SYSOMVS トレースをフォーマット設定するサブコマンドの例
例 1: SEARCH オプションを要求する CTRACE サブコマンド
この例では、offset が指定するオフセットから開始して、value が指定する値に
ついて、CTRACE の各項目を検索するための SEARCH オプションを要求しま
す。
CTRACE COMP(SYSOMVS) FULL OPTIONS((SEARCH(x’offset’,x’value’))
例 2: SCCOUNTS オプションを要求する CTRACE サブコマンド
この例では、トレース内で発生するシスコールの数をカウントするために
SCCOUNTS オプションを要求します。
CTRACE COMP(SYSOMVS) FULL OPTIONS((SCCOUNTS))
SYSOMVS トレースからの出力
CTRACE COMP(SYSOMVS) FULL サブコマンドの出力
CTRACE COMP(SYSOMVS) サブコマンドを指定してフォーマット設定された
SYSOMVS コンポーネント・トレース・レコードの例を次に示します。
第 11 章 コンポーネント・トレース
11-111
コンポーネント・トレース
COMPONENT TRACE FULL FORMAT
COMP(SYSOMVS)
**** 05/25/1999
SYSNAME
------SY1
MNEMONIC
-------XCF
ENTRY ID
-------0D890407
TIME STAMP
--------------18:14:14.551107
DESCRIPTION
------------XCF BUFFER I/O TRACE
ASID..0025
TCB...009E04A0
+0000 E2C5D5C4
+0010 B2DBC852
+0020 01FF0006
SY1
XCF
USERID....WELLIE1 [email protected]
EUID......0000000B SYSCALL...00000036
80180101 02000001 000A0002 | SEND............ |
285F5AC7 7BA70500 403E3000 | ..H..¬!G#x.. ... |
00008178 C6000000
| ......a.F...
|
0D6F0401 18:14:14.551325 NXMSO-->XCF MESSAGE OUT
ASID..0025
TCB...009E04A0
+0000 E2E8D5C3
+0010 0013C000
+0020 7BA70500
+0030 0D6F0000
+0040 00000000
SY1
XCF
USERID....WELLIE1 [email protected]
EUID......0000000B SYSCALL...00000036
80A001D3 0A010014 01170BD4 | SYNC...L.......M |
02000001 000A0002 00004C4B | ..{...........<. |
000080E0 00000000 00000000 | #x.....\........ |
00030025 009E04A0 0000000B | .?.............. |
2538E980 01000000
| ......Z.....
|
0D690402 18:14:14.554457 NXMSG-->XCF MESSAGE SRB EXIT
ASID..000E
TCB...00000000
+0000 D9C5E2D7
+0010 00030000
+0020 02000001
+0030 00300098
+0040 00000000
SY1
XCF
USERID....OMVS
[email protected]
EUID......00000000 SYSCALL...00000000
B4600101 009D6C68 00000080 | RESP.-....%..... |
0A010014 01170BD4 0013402C | ...........M.. . |
000A0002 00000118 01FF0006 | ................ |
24C02910 00008000 00000000 | ...q.{.......... |
00000000 00000000
| ............
|
0D6F0401 18:14:14.554513 NXMSO-->XCF MESSAGE OUT
ASID..0025
TCB...009E04A0
+0000 C6D9C5C5
+0010 00000000
+0020 00000000
+0030 0D6F0000
+0040 00000000
USERID....WELLIE1
EUID......0000000B
10000100 00000000
00000000 00000000
00000000 00000000
00000000 00000000
2538E980 00000000
[email protected]
SYSCALL...00000036
00000000 | FREE............
00000000 | ................
00000000 | ................
00000000 | .?..............
| ......Z.....
|
|
|
|
|
図 11-2. CTRACE COMP(SYSOMVS) でフォーマット設定された SYSOMVS コンポーネント・
トレース (1/2)
11-112
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SY2
XCF
0D690402
18:14:14.553698
NXMSG-->XCF MESSAGE SRB EXIT
ASID..000E
TCB...00000000
+0000 D9C5C3E5
+0010 00030000
+0020 01000001
+0030 40060098
+0040 00000000
SY2
XCF
USERID....OMVS
[email protected]
EUID......00000000 SYSCALL...00000000
D4600201 009E04A0 002580E0 | RECVM-.........\ |
0A010014 01170BD4 0013C000 | ...........M..{. |
000A0001 00008178 01FF0006 | ..........a..... |
80000009 00000000 00000000 | ..q............ |
00000000 4F4F4F4F
| ........||||
|
0D6D0403 18:14:14.553715 NXWRK-->XCF WORKER TASK TR.
ASID..0025
TCB...009E04A0
FCODE.0003
+0000 E6D6D9D2
+0010 01170BD4
+0020 01FF0006
+0030 00250003
+0040 00000000
SY2
XCF
USERID....OMVS
EUID......0000000B
SYSNAME...SY1
3000022C 009D6C68
0013C02C 01000001
40060098 000080E0
00000000 00000000
ASID..0025
TCB...009E04A0
FCODE.0003
+0000 E2C5D5C4
+0010 B2DBC852
+0020 01FF0006
SY2
XCF
USERID....OMVS
[email protected]
EUID......0000000B
SYSNAME...SY1
80180101 01000001 000A0001 | SEND............ |
29114142 7F636AD8 401FB000 | ..H....."..Q ... |
00000118 C6000000
| ........F...
|
0D6F0401 18:14:14.554039 NXMSO-->XCF MESSAGE OUT
ASID..0025
TCB...009E04A0
FCODE.0003
+0000 D9C5E2D7
+0010 0013402C
+0020 7F636AD8
+0030 0D6F0000
+0040 253A4088
0D890407
[email protected]
0A010014
000A0001
009E04A0
00000000
18:14:14.553881
USERID....OMVS
EUID......0000000B
SYSNAME...SY1
202002D3 0A010014
01000001 000A0001
00000080 00000000
00030000 009D6C68
00000000 00000000
|
|
|
|
|
WORK......%.....
...M..{.........
.... ..q...\....
................
....
XCF BUFFER I/O TRACE
|
|
|
|
|
[email protected]
01170BD4
00002BBC
00000000
00000000
|
|
|
|
|
RESP...L.......M
.. .............
"..Q............
.?........%.....
.. h........
|
|
|
|
|
図 11-2. CTRACE COMP(SYSOMVS) でフォーマット設定された SYSOMVS コンポーネント・
トレース (2/2)
SY1 トレース・フロー: 11-114 ページの図 11-3 および 11-114 ページの図 11-4
には、 11-112 ページの図 11-2 にあるような SY1 トレース情報があります。
11-114 ページの図 11-3 では、クライアント側での BPXNXMSO 処理によって生成
される CTRACE 項目を説明します。強調表示されている ASID / TCB は、要求を
行っているクライアントについて記述します。
最も重要な情報は、固有要求 ID (アスタリスク (*) を付けて示されている) です。
これを使用して、クライアントとサーバーとの間で送受される要求をトラッキング
します。
2 つの別個のトレース項目があります: 1 つは、メッセージがメッセージ・ブロック
に入ったことを示します。もう 1 つは、そのブロックが書き出されたことを示しま
す。バッファー・アドレス (@ を付けて示されている) を使用して、これら 2 つの
トレース項目を相互参照します。
第 11 章 コンポーネント・トレース
11-113
コンポーネント・トレース
SYSNAME
------SY1
MNEMONIC
-------XCF
ENTRY ID
-------0D890407
TIME STAMP
--------------18:14:14.551107
DESCRIPTION
------------XCF BUFFER I/O TRACE
#ASID..0025
USERID....WELLIE1 [email protected]
#TCB...009E04A0 EUID......0000000B SYSCALL...00000036
+0000 E2C5D5C4 80180101 02000001 000A0002 | SEND............ |
+0010 B2DBC852 285F5AC7 @7BA70500 403E3000 | ..H..¬!G#x.. ... |
+0020 01FF0006 00008178 C6000000
| ......a.F...
|
SY1
XCF
#ASID..0025
#TCB...009E04A0
+0000 E2E8D5C3
+0010 $0013C000
+0020 @7BA70500
+0030 0D6F0000
+0040 00000000
0D6F0401
18:14:14.551325
USERID....WELLIE1
EUID......0000000B
80A001D3 !0A010014
02000001 000A0002
000080E0 00000000
00030025 009E04A0
2538E980 01000000
NXMSO-->XCF MESSAGE OUT
[email protected]
SYSCALL...00000036
*01170BD4 | SYNC...L.......M
00004C4B | ..{...........<.
00000000 | #x.....\........
0000000B | .?..............
| ......Z.....
|
|
|
|
|
# - ASID / TCB of requester
@ - Buffer address containing request
$ - Block #, Index into NXRQ ! - HFS function being requested
* - Unique Request-ID = System number w/ 3byte seq#
図 11-3. SY1 トレース・フロー: パート 1
図 11-4 は、クライアント・システムに入ってくる応答を説明します。最初に XCF
SRB (BPXNXMSG) が入ってくる応答を処理して、クライアント・タスクをアクテ
ィブにします。次に、ターゲット・タスク (以後再度マップされることはない) が立
ち上げられて、この例では、XCF メッセージ処理の一部としてターゲット・タスク
に割り振られていたリソースを明示的に解放します。
SYSNAME
------SY1
MNEMONIC
-------XCF
ENTRY ID
-------0D690402
TIME STAMP
--------------18:14:14.554457
DESCRIPTION
------------NXMSG-->XCF MESSAGE SRB EXIT
ASID..000E
USERID....OMVS
[email protected]
TCB...00000000 EUID......00000000 SYSCALL...00000000
+0000 D9C5E2D7 B4600101 009D6C68 00000080 | RESP.-....%..... |
+0010 00030000 !0A010014 *01170BD4 $0013402C | ...........M.. . |
+0020 02000001 000A0002 00000118 01FF0006 | ................ |
+0030 00300098 24C02910 00008000 00000000 | ...q.{.......... |
+0040 00000000 00000000 00000000
| ............
|
SY1
XCF
#ASID..0025
#TCB...009E04A0
+0000 C6D9C5C5
+0010 00000000
+0020 00000000
+0030 0D6F0000
+0040 00000000
0D6F0401
18:14:14.554513
USERID....WELLIE1
EUID......0000000B
10000100 00000000
00000000 00000000
00000000 00000000
00000000 00000000
2538E980 00000000
# - ASID / TCB of requester
$ - Block #, Index into NXRQ
* - Unique Request-ID
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
[email protected]
SYSCALL...00000036
00000000 | FREE............
00000000 | ................
00000000 | ................
00000000 | .?..............
| ......Z.....
! - HFS function being requested
図 11-4. SY1 トレース・フロー: パート 2
11-114
NXMSO-->XCF MESSAGE OUT
|
|
|
|
|
コンポーネント・トレース
SY2 トレース・フロー: 図 11-5 および 11-116 ページの図 11-6 には、 11-112 ペ
ージの図 11-2 にあるような SY2 トレース情報があります。
図 11-5 は、最初に要求をキューイング (BPXNXMSG) し、次に続いて行う処理の
ための作業を作業タスクに取り出させる (BPXNXWRK) ことによって行うサーバー
側の XCF SRB 処理を説明します。
* を付けて示すように、要求 ID を使用して個々のトレース項目を相互参照しま
す。
SYSNAME フィールドがトレース項目に含まれているとき、ASID / TCB の情報は
クライアント側のリクエスター情報を実際に説明します。 SYSNAME フィールド
は、起点となっているシステムについて記述します。 & を付けて強調表示したフィ
ールドは、サーバー・システムに常駐の作業の TCB アドレスです。
SYSNAME
------SY2
MNEMONIC
-------XCF
ENTRY ID
-------0D690402
TIME STAMP
--------------18:14:14.553698
DESCRIPTION
------------NXMSG-->XCF MESSAGE SRB EXIT
ASID..000E
USERID....OMVS
[email protected]
TCB...00000000 EUID......00000000 SYSCALL...00000000
+0000 D9C5C3E5 D4600201 009E04A0 002580E0 | RECVM-.........\
+0010 00030000 !0A010014 *01170BD4 $0013C000 | ...........M..{.
+0020 01000001 000A0001 00008178 01FF0006 | ..........a.....
+0030 40060098 80000009 00000000 00000000 | ..q............
+0040 00000000 00000000 4F4F4F4F
| ........||||
SY2
XCF
#ASID..0025
#TCB...009E04A0
FCODE.0003
+0000 E6D6D9D2
+0010 *01170BD4
+0020 01FF0006
+0030 00250003
+0040 00000000
0D6D0403
18:14:14.553715
NXWRK-->XCF WORKER TASK TRACE
USERID....OMVS
[email protected]
EUID......0000000B
SYSNAME...SY1
3000022C &009D6C68 !0A010014 | WORK......%.....
$0013C02C 01000001 000A0001 | ...M..{.........
40060098 000080E0 009E04A0 | .... ..q...\....
00000000 00000000 00000000 | ................
| ....
# - ASID / TCB of requester
$ - Block #, Index into NXRQ
* - Unique Request-ID
|
|
|
|
|
|
|
|
|
|
& - Real OMVS resident worker TCB
! - HFS function being requested
% - Indicates ASID/TCB remapped to requester
図 11-5. SY2 トレース・フロー: パート 1
11-116 ページの図 11-6 は、クライアント・システムに入ってくる応答を説明しま
す。最初に XCF SRB (BPXNXMSG) が入ってくる応答を処理して、クライアン
ト・タスクをアクティブにします。次に、ターゲット・タスク (以後再度マップさ
れることはない) が立ち上げられて、この場合、XCF メッセージ処理の一部として
ターゲット・タスクに割り振られていたリソースを明示的に解放します。
第 11 章 コンポーネント・トレース
11-115
コンポーネント・トレース
SYSNAME
------SY2
MNEMONIC
-------XCF
#ASID..0025
#TCB...009E04A0
FCODE.0003
+0000 E2C5D5C4
+0010 B2DBC852
+0020 01FF0006
SY2
ENTRY ID
-------0D890407
DESCRIPTION
------------XCF BUFFER I/O TRACE
USERID....OMVS
[email protected]
EUID......0000000B
%SYSNAME...SY1
80180101 01000001 000A0001 | SEND............ |
29114142 @7F636AD8 401FB000 | ..H....."..Q ... |
00000118 C6000000
| ........F...
|
XCF
0D6F0401
#ASID..0025
#TCB...009E04A0
FCODE.0003
+0000 D9C5E2D7
+0010 $0013402C
+0020 @7F636AD8
+0030 0D6F0000
+0040 253A4088
TIME STAMP
--------------18:14:14.553881
18:14:14.554039
USERID....OMVS
EUID......0000000B
%SYSNAME...SY1
202002D3 !0A010014
01000001 000A0001
00000080 00000000
00030000 009D6C68
00000000 00000000
# - ASID / TCB of requester
$ - Block #, Index into NXRQ
* - Unique Request-ID
NXMSO-->XCF MESSAGE OUT
[email protected]
*01170BD4 | RESP...L.......M |
00002BBC | .. ............. |
00000000 | "..Q............ |
00000000 | .?........%..... |
| .. h........
|
@ - Buffer address containing request
! - HFS function being requested
% - Indicates ASID/TCB remapped to requester
図 11-6. SY2 トレース・フロー: パート 2
制御ブロック・トレース: 次は、OPTIONS(CBTR(PPRP,0,4)) を指定して要求され
た SYSOMVS コンポーネント・トレース・レコードの例で、PPRP 制御ブロックの
オフセット・ゼロにおける 4 バイトのフィールドをトレースします。次に、トレー
ス・データは、CTRACE COMP(SYSOMVS) サブコマンドを使用してフォーマット
設定されています。
SY1 SYSCALL
0F080001
20:06:58.662146
STANDARD SYSCALL ENTRY TRACE
ASID..0020
USERID....IBMUSER [email protected]
TCB...008BF088 EUID......00000000 SYSCALL...00000019
+0000 00000019 00000000 D1C3E2C5 8C0000F4 | ........JCSE...4
+0010 0000000C 00000000 80D1AE06 25D596F4 | .........J...No4
+0020 25D596E4 00000085 00000000 7F5FF0A8 | .NoU...e...."¬0y
+0030 00000006 2501BB50 00D1AFA4 7F5FF0E8 | .......&.J.u"¬0Y
+0040 7F5FF0CC 7F5FF0D0 FF5FF0D4
| "¬0."¬0}.¬0M
+0050 D7D7D9D7 00000004 D7D7D9D7 00000000
PPRP.........PPRP
SY1
SYSCALL
0F080002
ASID..0020
TCB...008BF088
+0000 00000019
+0010 0000000A
+0020 00000002
00000000
20:06:58.662171
|
|
|
|
|
STANDARD SYSCALL EXIT TRACE
USERID....IBMUSER [email protected]
EUID......00000000 SYSCALL...00000019
00000000 D1C3E2C5 8C000000 | ........JCSE.... |
00000000 00000000 00000002 | ................ |
D7D7D9D7 00000004 D7D7D9D7 PPRP..........PPRP
図 11-7. 制御ブロック・トレースの出力
CTRACE COMP(SYSOMVS) SUMMARY サブコマンドの出力
CTRACE COMP(SYSOMVS) SUMMARY サブコマンドを指定してフォーマット設
定された SYSOMVS コンポーネント・トレース・レコードの例を次に示します。
11-116
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
COMPONENT TRACE SHORT FORMAT
COMP(SYSOMVS)
**** 06/17/92
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-----------
SYSCALL
SYSCALL
PROCESS
PROCESS
FILE
CHARS
PROCESS
PROCESS
DEVPTY
DEVPTY
PROCESS
PROCESS
CHARS
FILE
0F080002
0F080001
0B080007
0B08000A
05700103
05A90503
0B080008
0B08000A
0223E005
0223E008
0B080007
0B08000A
05A90603
05700203
22:02:42.314264
22:02:42.821156
22:02:42.821219
22:02:42.821256
22:02:42.821324
22:02:42.821398
22:02:42.821452
22:02:42.821472
22:02:42.821530
22:02:42.821566
22:02:42.822182
22:02:42.822206
22:02:42.822253
22:02:42.822506
STANDARD SYSCALL EXIT TRACE
STANDARD SYSCALL ENTRY TRACE
PROCESS LATCH OBTAIN
PROCESS LATCH-ON THE WAY OUT
TRACE CALL TO VN_RDWR
TRACE CHARSPEC CALL TO DEVICE DR
PROCESS LATCH RELEASE REQUEST
PROCESS LATCH-ON THE WAY OUT
MASTER READ BEGIN
MASTER READ END
PROCESS LATCH OBTAIN
PROCESS LATCH-ON THE WAY OUT
TRACE DEVICE DRIVER READ RETURN
TRACE RETURN FROM VN_RDWR
SCCOUNTS オプションを使用した SYSOMVS トレースからの出力
SCCOUNTS オプションを使用した SYSOMVS トレースからの出力には、図 11-8
および 図 11-9 に示す、2 つのフォーマットがあります。
SYSCALL#
-------F
2F
SYSCALL NAME
-----------BPX1CHO
BPX1STA
COUNT
----5000
150
FREQUENCY/SEC
------------nnn
nnn
図 11-8. SYSCALL の発生回数を表示する SCCOUNT 機能
図 11-8 は、リストの上から高い発生回数順になっています。SYSCALL# は、16 進
数でのシスコールの番号です。 FREQUENCY/SEC は、インターバル内に呼び出さ
れたシスコールの回数です。
FuncCode
-------00001001
00001010
00000012
FuncCode Name
-----------MntCatchup
GetPathName
UnQuiesce
Count
----76
60
38
Functions/Sec
------------0.0593
0.0468
0.0296
図 11-9. 機能コードの発生回数を表示する SCCOUNT 機能
図 11-9 は、リストの上から高い発生回数順になっています。FuncCode は、16 進数
での機能コードの番号です。Functions/Sec は、インターバル内に呼び出された機能
コードの回数です。
第 11 章 コンポーネント・トレース
11-117
コンポーネント・トレース
SYSOPS コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、操作サービス・コンポーネント (OPS) 用の SYSOPS コンポーネント・ト
レースを要求するための情報を要約します。
情報
SYSOPS の場合
parmlib メンバー
CTnOPSxx
デフォルト・メンバー: CONSOLxx メンバーで指定さ
れた CTIOPS00
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー CTnOPSxx または TRACE コマンドの REPLY で指
ター
定
バッファー
v デフォルト: 2MB
v 範囲: 64KB から 16MB まで
v サイズの設定: CTnOPSxx メンバーまたは TRACE
CT コマンドの REPLY で指定
v IPL 後のサイズ変更: トレースの実行中に可能
v 場所: コンソール・アドレス・スペース (専用)
トレース・レコードの場所
アドレス・スペース・バッファー、トレース・デー
タ・セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSOPS)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
注: OPS に関する完全なダンプを獲得するには、NUC、CSA、および SQA も要求
してください。
SYSOPS トレースの要求
SYSOPS コンポーネント・トレースを要求するオプションは、CTnOPSxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
11-118
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CTnOPSxx parmlib メンバー
次の表は、CTnOPSxx parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTnOPSxx で指定可能かどうか
ON または OFF
はい
ASID
はい
JOBNAME
はい
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
IBM により CTIOPS00 parmlib メンバーが提供されています。このメンバーはシス
テムに対してコンポーネント・トレースを定義し、2M のトレース・バッファーを
設定します。CTIOPS00 の内容は次のとおりです。
TRACEOPTS
ON
BUFSIZE(2M)
IBM 提供のサンプル CONSOL00 parmlib メンバーはありません。CONSOLxx
parmlib メンバーを作成し、IEASYSxx parmlib メンバーで CON=xx を指定してく
ださい。CONSOLxx の INIT ステートメントの CTRACE パラメーターでデフォル
トとして CTIOPS00 を指定してください。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnnnM、または OFF
1 つ必要
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き込み用に TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
第 11 章 コンポーネント・トレース
11-119
コンポーネント・トレース
パラメーター
トレース用の REPLY で指定可能かどうか
JOBNAME
はい
OPTIONS
はい
WTR
はい
OPTIONS パラメーター
CTnOPSxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下に英字順で示します。
MESSAGES
このオプションには WTO および MSGDLVRY オプションが含まれます。
MSG=msgid
特定のメッセージの処理をトレースします。OPTIONS : MESSAGES、WTO ま
たは MSGDLVRY のいずれかも指定してください。msgid は、トレースされる
メッセージ ID を示す、長さが 1-10 桁の英数字です。
MSGDLVRY
WQE 処理、MCS コンソール・メッセージ・キューイング、および拡張 MCS
コンソール・メッセージ処理に関するイベントをトレースします。
SYSPLEX
XCF 信号、シスプレックス逐次化サービス、シスプレックス・クリーンアップ
処理、および各種キューの操作に関するイベントをトレースします。
WTO
MPFLSTxx、ユーザー出口、および SSI がメッセージの内容と属性に与える効
果をトレースします。
これらの追加オプションを指定すると、システムが収集するトレース・レコードの
数が増加するため、システム・パフォーマンスが低下する可能性があります。トレ
ース・オプションを変更するたびに、直前のトレースのまま効果を持続させたいオ
プションを再指定しなければなりません。
注: MESSAGES、WTO、または MSGDLVRY オプションを使用する前に、次のこ
とを行う必要があります。
v バッファー・サイズを増やす
v 外部書き出しプログラムを開始および接続する
これは、IPL 時にトレースを開始する場合には特に重要です。これは、メッセージ
ID をトレースしている場合には、特定のメッセージに対するレコードだけを取り出
すことになるため、必要ではないことがあります。
11-120
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SYSOPS トレースの要求の例
例 1: システムの実行中にトレース・オプションを活動化する
次のパラメーターを指定して parmlib メンバー CTIOPS01 を作成します。プ
ロシージャー OPSWTR が SYS1.PROCLIB に入っているものと想定します。
TRACEOPTS
WTRSTART(OPSWTR)
ON
WTR(OPSWTR)
OPTIONS(’MESSAGES’,’MSG=IEE136I’)
ASID(1,2,3)
JOBNAME(PAYROLL)
BUFSIZE(2M)
例 2: REPLY コマンドでトレース・オプションを指定する
この例では例 1 と同じトレースを要求していますが、すべてのオプションを
REPLY で指定しています。
trace ct,wtrstart=opswtr
trace ct,2m,comp=sysops
システムがトレース・オプションの入力をプロンプト指示したときには、id の
部分を応答 ID で置き換えて次のコマンドを入力してください。
reply 27,wtr=opswtr,options=(messages,msg=IEE136I),asid=(1,2,3),
jobname=(payroll),end
例 3: IPL 時に使用される CTnOPSxx メンバー
このメンバーは SYSPLEX オプションを要求し、デフォルト・バッファー・サ
イズを 2 倍にし、トレース対象を ASID 1 と JOBNAME JOB1 に限定しま
す。
TRACEOPTS
ON
OPTIONS(’SYSPLEX’)
BUFSIZE(4M)
ASID(1)
JOBNAME(JOB1)
SYSOPS トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSOPS) サブコマンドを使
用して行います。このサブコマンドの OPTIONS パラメーターでは、フォーマット
設定するトレース・レコードを選択するためのオプションを指定します。ユーザー
が指定するフォーマット設定オプションは、要求されたトレース・オプションに応
じて大きく異なります。オプションを使用して表示されるレコードの範囲を狭くし
て、エラーを見付けやすくしてください。CTRACE サブコマンドでオプションをな
にも指定しなかった場合、IPCS はすべてのトレース・レコードを表示します。
SYSOPS トレースをフォーマット設定するためのオプションは次のとおりです。
第 11 章 コンポーネント・トレース
11-121
コンポーネント・トレース
MESSAGES
このオプションには WTO および MSGDLVRY オプションが含まれます。
MSG=msgid
特定のメッセージの処理をトレースします。OPTIONS : MESSAGES、WTO ま
たは MSGDLVRY のいずれかも指定してください。msgid は、トレースされる
メッセージ ID を示す、長さが 1-10 桁の英数字です。
MSGDLVRY
WQE 処理、MCS コンソール・メッセージ・キューイング、および拡張 MCS
コンソール・メッセージ処理に関するイベントをトレースします。
SYSPLEX
XCF 信号、シスプレックス逐次化サービス、シスプレックス・クリーンアップ
処理、および各種キューの操作に関するイベントをトレースします。
WTO
MPFLSTxx、ユーザー出口、および SSI がメッセージの内容と属性に与える効
果をトレースします。
SYSOPS トレースからの出力
CTRACE COMP(SYSOPS) SHORT サブコマンドの出力
CTRACE COMP(SYSOPS) SHORT サブコマンドを指定してフォーマット設定され
た OPS コンポーネント・トレース・レコードの例を次に示します。
COMPONENT TRACE SHORT FORMAT
COMP(SYSOPS)
**** 05/20/93
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-----------
INITMSG
POSTMPF
POSTEXIT
POSTSSI
INITMSG
POSTMPF
POSTEXIT
POSTSSI
INITMSG
POSTMPF
00000001
00000002
00000003
00000004
00000001
00000002
00000003
00000004
00000001
00000002
14:41:06.918883
14:41:06.919198
14:41:06.919595
14:41:06.920118
14:41:06.930088
14:41:06.930405
14:41:06.930803
14:41:06.931267
14:41:06.931637
14:41:06.931934
Message prior to MPF processing
Message after MPF processing
Post Message Exit
Post Subsystem Interface
Message prior to MPF processing
Message after MPF processing
Post Message Exit
Post Subsystem Interface
Message prior to MPF processing
Message after MPF processing
CTRACE COMP(SYSOPS) FULL サブコマンドの出力
CTRACE COMP(SYSOPS) FULL サブコマンドを指定してフォーマット設定された
OPS コンポーネント・トレース・レコードの例を次に示します。
11-122
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
COMPONENT TRACE FULL FORMAT
COMP(SYSOPS)
**** 05/20/93
MNEMONIC
--------
ENTRY ID
--------
INITMSG 00000001
TR_GROUP WTO
HOMEASID 0001
REQSASID 0001
CPU_ADDR 0001
KEY..... 0001
+0000 LKP......
+000A USE......
+00D1 TS2......
+001E PAD2.....
+0044
+009E TXTL.....
+00A1 ASID.....
+00A8 SYSID....
+00AD MCSF2....
+00B1 ROUT2....
+00B4 UCMID....
+00B8 DC1......
+00BC JSTCB....
+00C2 MCSE1....
+00CC DATE.....
+00D6 RFB3.....
+00D9 ML2......
+00E0 ERC1.....
+00E3 ERC4.....
+00E6 ERC7.....
+00E9 ERC10....
+00EC ERC13....
+00EF ERC16....
+00F8 TOKN.....
.
.
.
TIME STAMP
---------------
DESCRIPTION
-----------
14:41:06.918883 Message prior to MPF processing
Write to Operator Services
HOMEJOBN *MASTER*
REQSJOBN UNKNOWN
00000000
0000
.91
40
ESTED VIA
40
0001
03
10
00
0A
08
008D57C0
42
93140
00
00
00
00
00
00
00
00
00000000
TXTLN....
PAD......
PAD1.....
TXT......
THE TRACE
PAD3.....
AVAIL....
SEQN.....
MSGT1....
CHAR1....
FLG1.....
DC2......
VRSN.....
MCSE2....
RFB1.....
SUPB.....
LENG.....
ERC2.....
ERC5.....
ERC8.....
ERC11....
ERC14....
KEY......
CNID.....
005F
RTCT.....
40
TS.......
40
JOBNM....
ITT038I ALL OF THE
CT COMMAND WERE
00
XA.......
50
TCB......
00049D
MCSF1....
00
ROUT1....
00
FLG3.....
04
RPYID....
00
RSV26....
05
MFLG1....
00
SYSNM....
00
RFB2.....
90
ML1......
0160
DSQN.....
00
ERC3.....
00
ERC6.....
00
ERC9.....
00
ERC12....
00
ERC15....
40404040 40404040
0000000A OJBID....
0000
10.41.06
TRANSACTIONS REQU
01
008D57C0
C0
00
00
0000
0000
00
SYS2
00
00
00000000
00
00
00
00
00
40404040
SYSRRS コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、RRS 用の SYSRRS コンポーネント・トレースを要求するための情報を要
約します。
第 11 章 コンポーネント・トレース
11-123
コンポーネント・トレース
情報
SYSRRS の場合
parmlib メンバー
CTnRRSxx
デフォルト・メンバーはありません
|
|
デフォルトのトレース
あり。最小限。予期しないイベントが対象。汎用 UR
サービス。
トレース要求の OPTIONS パラメー CTnRRSxx および TRACE コマンドの REPLY で指
ター
定
バッファー
v デフォルト: 1MB
v 範囲: 1MB - 2045MB
v サイズの設定: CTnRRSxx メンバーまたは TRACE
CT コマンドの REPLY で指定
v IPL 後のサイズ変更: トレースの停止後の再始動時
に可能
v 位置: データ・スペースおよびコンポーネント・ア
ドレス・スペース。 DUMP コマンドの REPLY
に、DSPNAME=(’RRS’.ATRTRACE) および
SDATA=RGN を指定する。
トレース・レコードの場所
データ・スペース・バッファー、トレース・データ・
セット、RRS アドレス・スペース内のトレース・バッ
ファー
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSRRS)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSRRS トレースの要求
SYSRRS コンポーネント・トレースを要求するオプションは、CTnRRSxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
オプションまたはバッファー・サイズを変更する場合には、トレースを停止し、新
しいオプション、新しいバッファー・サイズ、またはその両方を指定して再始動し
なければなりません。
CTnRRSxx parmlib メンバー
次の表は、CTnRRSxx parmlib メンバーで指定できるパラメーターを示しています。
11-124
パラメーター
CTnRRSxx で指定可能かどうか
ON または OFF
はい
ASID
はい
JOBNAME
はい
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
パラメーター
CTnRRSxx で指定可能かどうか
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
CTnRRSxx parmlib メンバーはオプションです。指定しない場合、SYSRRS コンポ
ーネント・トレースは、RRS コンポーネントを開始するときに開始し、そのコンポ
ーネントを停止するときに終了する、最小限トレースを実行します。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnnnM、または OFF
1 つ必要
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
はい
OPTIONS
はい
WTR
はい
OPTIONS パラメーター
CTnRRSxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターには、キーワード・サブパラメーターが入ります。これらのサブパラ
メーターによって、RRS コンポーネント・トレースが収集する情報を制御できま
す。最初のサブパラメーター EVENTS は、トレースするイベントを指定します。
他のサブパラメーターは、最高 3 つの検査を使用してイベントを選別するためのフ
ィルターとして働きます。コンポーネント・トレースのすべての検査をイベントが
パスしなければ、トレース・レコードは生成されません。検査の順序は、次のとお
りです。
1. イベントが指定されていること。
2. イベントが、OR 検査で、次のいずれかのフィルターと一致すること。
v REPLY コマンドまたは CTnRRSxx TRACEOPTS ステートメントのアドレ
ス・スペース ID (ASID)
第 11 章 コンポーネント・トレース
11-125
コンポーネント・トレース
v REPLY コマンドまたは CTnRRSxx TRACEOPTS ステートメントのジョブ名
(JOBNAME)
v OPTIONS パラメーターのユーザー ID (USERID)
v OPTIONS パラメーターの論理作業単位 ID (LUWID)
3. イベントが OPTIONS パラメーターのリソース・マネージャー名 (RMNAME)
に一致すること。
OPTIONS=([EVENTS(event[,event]...)]
[USERID(userid[,userid]...)]
[RMNAME(rmname[,rmname]...)]
[LUWID((luwid)[,(luwid)]...)])
[EID((eid)[,(eid)]...)
注: TRACE CT コマンドへの REPLY では、オプションの間には 1 つまたは複数
のブランクを入れてください。
EVENTS(event[,event]...)
トレースするイベントを指定します。他のオプションを指定する場合には、
EVENTS パラメーターが必要になります。イベントは、英字順で次のとおりで
す。
ALL
すべてのイベントをトレースします。コンポーネント・トレースは、他のイ
ベントが指定されても、無視します。
CONTEXT
コンテキスト・サービスの呼び出しをトレースします。
EXITS
リソース・マネージャーが提供する RRS 出口ルーチンの実行に関連するイ
ベントをトレースします。
FLOW
RRS エントリー・ポイントに出入りするエントリーをトレースします。
LOGGING
RRS によるデータのロギングに関連するイベントをトレースします。
RESTART
RRS の初期設定と再始動に関連するイベントをトレースします。
RRSAPI
アプリケーション・プログラミング・インターフェースに関連するイベント
をトレースします。このインターフェースは、Application_Commit_UR サー
ビスと Application_Backout_UR サービスの呼び出しから構成されていま
す。
STATECHG
リカバリー単位 (UR) の状態の変更に関係するイベントをトレースします。
URSERVS
UR のサービスに関連する汎用イベントをトレースします (デフォルトによ
るトレース)。
|
|
11-126
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
USERID(userid[,userid]...)
指定したイベント用のフィルターとして 1 つから 16 個までのユーザー ID を
指定します。システムは、そのユーザー ID に関連するイベントだけをトレー
スします。
RMNAME(rmname[,rmname]...)
指定したイベント用のフィルターとして 1 - 16 個までのリソース・マネージャ
ー名を指定します。リソース・マネージャー名に依存するトレース・イベントの
場合、システムはそのリソース・マネージャーに関連するイベントだけをトレー
スします。
LUWID((luwid)[,(luwid)]...)
指定したイベントのフィルターとして 1 - 16 個の作業論理単位 ID (LUWID)
を指定します。システムは、その LUWID に関連するイベントだけをトレース
します。それぞれの luwid は、次のもので構成されます。
netid.luname[,instnum][,seqnum]
コンポーネント・トレースは、先頭および末尾のブランクを無視します。
netid.luname
ネットワーク ID とローカル論理装置名を指定します。 LUWID のこれら
の部分は、必須です。
次のようにワイルドカード文字としてアスタリスク (*) を使用できます。
v netid、luname、またはその両方の最後の文字
v netid または luname のどちらかでの 1 文字だけ、ただし両方で 1 文字
だけではない
instnum
インスタンス番号を 1 - 12 桁の 16 進数整数で指定します。先行ゼロを省
略できます。
seqnum
シーケンス番号を 1 - 4 桁の 16 進数整数で指定します。先行ゼロを省略
できます。
LUWID の例を次に示します。
(A.B,5,1)
(A.B,5)
(A.B,,1)
(A.B)
(A.*,5,1)
(A*.B*)
EID((eid)[,(eid)]...)
指定したイベントのフィルターとして 1 - 16 個のエンタープライズ ID (EID)
を指定します。システムは、その EID に関連するイベントだけをトレースしま
す。それぞれの eid は、次のもので構成されます。
[tid][,gtid]
先頭のゼロを省略できます。コンポーネント・トレースは、先頭および末尾のブ
ランクを無視します。
tid
4 バイトの 16 進数トランザクション ID (TID) を指定します。
第 11 章 コンポーネント・トレース
11-127
コンポーネント・トレース
gtid
8-40 バイトの 16 進数グローバル・トランザクション ID (GTID) を指定し
ます。
RRS ISPF パネルを使用して RRS ログ・ストリームをブラウズすることによっ
て、UR の EID を入手することができます。Retrieve_Work_Identifier サービス
も EID を戻すことができます。
EID の例を次に示します。
(1,C)
(,C)
(1)
SYSRRS トレースの要求の例
例 1: CTnRRSxx メンバー
メンバーは、ユーザー ID JONES によってフィルター操作されたコンテキス
ト・サービス・イベントを要求し、1024KB のバッファーを要求します。
TRACEOPTS
ON
OPTIONS(’EVENTS(CONTEXT) USERID(JONES)’)
BUFSIZE(1024K)
例 2: TRACE コマンド
この例は、例 1 と同じトレースを要求します。
trace ct,off,comp=sysrrs
trace ct,1024K,comp=sysrrs
* 17 ITT006A ...
reply 17,options=(’events(context) userid(jones)’),end
SYSRRS トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSRRS) サブコマンドを使
用して行います。このサブコマンドの OPTIONS パラメーターでは、フォーマット
設定するトレース・レコードを選択するためのオプションを指定します。ユーザー
が指定するフォーマット設定オプションは、要求されたトレース・オプションに応
じて大きく異なります。フォーマット設定オプションを使用して、エラーを見付け
やすくなるように、表示されるレコードの範囲を限定してください。 CTRACE サ
ブコマンドでどのオプションも指定しない場合、IPCS はすべてのトレース・レコー
ドを表示します。
1 つまたは複数の OPTIONS サブパラメーターを指定できます。どの OPTIONS サ
ブパラメーターも指定しない場合、すべてのトレース・レコードがフォーマット設
定されます。トレース・レコードは、フォーマット設定のために指定した OPTIONS
サブパラメーターすべてと一致しなければなりません。
11-128
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
OPTIONS=((option[,option]...))
option is one of the following:
LUWID(luwid)
EID(eid)
RMNAME(rmname)
URID(urid)
USERID(userid)
LUWID(luwid)
トレースを生成したときに指定した作業論理単位 ID (LUWID) の 1 つを指定
します。
EID(eid)
トレースを生成したときに指定したエンタープライズ ID (EID) の 1 つを指定
します。
eid を次のように指定してください。
tid
tid,gtid
または、ID を指定したときに tid を省略した場合には、次のようになりま
す。
*,gtid
RMNAME(rmname)
トレースを生成したときに指定したリソース・マネージャー名の 1 つを指定し
ます。
URID(urid)
UR ID を指定します。URID は、呼び出し可能サービス
(Change_Interest_Type、 Express_UR_Interest、Retain_Interest、
Retrieve_UR_Interest、または Retrieve_UR_Data) のいずれかによってリソース・
マネージャーに戻される 16 バイトの文字ストリングです。 URID は、リソー
ス・マネージャーのログに保管され、RRS パネルを介して入手できます。
USERID(userid)
トレースを生成したときに指定したユーザー ID の 1 つを指定します。
USERID は、ユーザー ID がブランクのトレース・レコードのフィルター操作
を行わないことに注意してください。
IPCS CTRACE OPTIONS パラメーターの例
OPTIONS=((RMNAME(datamgr),USERID(jjones)))
SYSRRS トレースからの出力
印刷可能な文字が入っていないフィールドは、アスタリスク (*) で埋められます。
値は、別の行に 16 進数で示されます。
注: RRS は、CTRACE サブコマンドの SUMMARY と FULL のパラメーターにつ
いて同じレポートを出します。
第 11 章 コンポーネント・トレース
11-129
コンポーネント・トレース
CTRACE COMP(SYSRRS) SHORT サブコマンドの出力
CTRACE COMP(SYSRRS) SHORT サブコマンドを指定してフォーマット設定され
た SYSRRS コンポーネント・トレース・レコードの例を次に示します。
COMPONENT TRACE SHORT FORMAT
COMP(SYSRRS)
**** 01/20/1997
SYSNAME
-------
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-------------
SY1
SY1
SY1
SY1
SY1
SY1
SY1
COMPERR
FLOW
FLOW
FLOW
CONTEXT
URSERVS
FLOW
00000000
0801FFFE
0801FFFF
0201FFFF
02010002
02010001
0201FFFE
07:53:43.615114
07:53:43.615114
07:53:43.619823
07:53:43.619867
07:53:43.620027
07:53:43.620699
07:53:43.620887
Resource Recovery Services
ATRB1PCT EXIT
ATRB1PCT ENTRY
ATRU1EIN ENTRY
CTXMEINT call
ATREINT invoked
ATRU1EIN EXIT
.
.
.
11-130
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CTRACE COMP(SYSRRS) SUMMARY または FULL 出力
COMPONENT TRACE FULL FORMAT
COMP(SYSRRS)
**** 01/20/1997
SYSNAME
-------
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-------------
SY1
COMPERR 00000000 07:53:43.615114 Resource Recovery Services
FFF0003E 7EF6D000 0001FE6E 00000000 | .0..=6}....>.... |
000A0000 00000000 00020000 | ................ |
0101001F 00000000 7F04D000 01000000 | ........".}..... |
00000000 00000000 0000
| .............. |
SY1
FLOW
0801FFFE 07:53:43.615114 ATRB1PCT EXIT
HASID.... 00AA
HJOBNAME. APPL1AS
SASID.... 00A3
SJOBNAME. RMAS1
USERID... *
RMNAME...
URID..... AE18AB4E 7ED2CF90 0000012B 01010000
TID...... 000000000000
GTID..... 00000000
00000000 00000000 00000000
LUWID.... 00000000 00000000 00000000 0000
NETNAME.. ******** LUNAME... ********
INSTNUM.. ******
SEQNUM... **
SY1
FLOW
0801FFFF 07:53:43.619823 ATRB1PCT ENTRY
HASID.... 00AA
HJOBNAME. APPL1AS
SASID.... 00A3
SJOBNAME. RMAS1
USERID... *
RMNAME...
URID..... AE18AB4E 7ED2CF90 0000012B 01010000
TID...... 000000000000
GTID..... 00000000
00000000 00000000 00000000
LUWID.... 00000000 00000000 00000000 0000
NETNAME.. ******** LUNAME... ********
INSTNUM.. ******
SEQNUM... **
SY1
FLOW
0201FFFF 07:53:43.619867 ATRU1EIN ENTRY
HASID.... 00AA
HJOBNAME. APPL1AS
SASID.... 00A3
SJOBNAME. RMAS1
USERID... *
RMNAME...
URID..... AE18AB4E 7ED2CF90 0000012B 01010000
TID...... 000000000000
GTID..... 00000000
00000000 00000000 00000000
LUWID.... 00000000 00000000 00000000 0000
NETNAME.. ******** LUNAME... ********
INSTNUM.. ******
SEQNUM... **
.
.
.
第 11 章 コンポーネント・トレース
11-131
コンポーネント・トレース
CTRACE COMP(SYSRRS) TALLY 出力
COMPONENT TRACE TALLY REPORT
COMP(SYSRRS)
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID
COUNT
INTERVAL
-------- ----------- -----------00000000
7 23,774,056
02010001
46
2,398,672
02010002
46
2,398,670
02018001
6 18,803,430
02018008
3 47,008,505
0201FFFE
46
2,398,673
0201FFFF
46
2,398,670
02030001
0
02038009
0
0203FFFE
0
0203FFFF
0
02050001
0
0205FFFE
0
0205FFFF
0
MNEMONIC
-------COMPERR
URSERVS
CONTEXT
STATECHG
STATECHG
FLOW
FLOW
URSERVS
STATECHG
FLOW
FLOW
URSERVS
FLOW
FLOW
DESCRIBE
-------------------------------Resource Recovery Services
ATREINT invoked
CTXMEINT call
UR State Change
UR being created
ATRU1EIN EXIT
ATRU1EIN ENTRY
ATRDINT invoked
UR being destroyed
ATRU1DIN EXIT
ATRU1DIN ENTRY
ATRPDUE invoked
ATRU1PDU EXIT
ATRU1PDU ENTRY
.
.
.
SYSRSM コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、実記憶管理プログラム (RSM) 用の SYSRSM コンポーネント・トレースを
要求するための情報を要約します。
情報
SYSRSM の場合
parmlib メンバー
CTnRSMxx
デフォルト・メンバーはありません
デフォルトのトレース
いいえ
トレース要求の OPTIONS パラメー CTnRSMxx または TRACE コマンドの REPLY
ター
11-132
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
情報
SYSRSM の場合
バッファー
v デフォルト: 32 ページの 3 つのバッファー
v 範囲: 2 - 7 個のアドレス・スペース・バッファ
ー、バッファー当り 4 - 262,144 ページ
データ・スペース・バッファーの場合には 1 から
2047MB
v サイズの設定: CTnRSMxx メンバーまたは TRACE
CT コマンドの REPLY で指定
v IPL 後のサイズ変更: トレースの開始時に可能
v 場所: 共通サービス・エリア (CSA)、または
CTnRSMxx で指定された場合にはデータ・スペー
ス。メッセージ IAR007I でデータ・スペース名が
示される。
トレース・レコードの場所
アドレス・スペース・バッファー、データ・スペー
ス・バッファー、トレース・データ・セット
SVC ダンプの要求
v DUMP または SLIP コマンドによって行う
v CTnRSMxx parmlib メンバーまたは TRACE CT コ
マンドに対する REPLY で DMPREC オプションを
指定することにより、RSM がリカバリー処理に入
ったときに行なう (デフォルト)
v CTnRSMxx の DMPOFF オプション または
TRACE CT の応答により、SYSRSM トレースがオ
フになったときに行なう
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSRSM)
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSRSM トレースの要求
SYSRSM コンポーネント・トレースを要求するオプションは、CTnRSMxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
CTnRSMxx parmlib メンバー
次の表は、CTnRSMxx parmlib メンバーで指定できるパラメーターを示していま
す。
パラメーター
CTnRSMxx で指定可能かどうか
ON または OFF
はい
ASID
はい
JOBNAME
はい。すべてのバッチ・ジョブをトレースす
るには、ジョブ名のリストで ‘INIT’ を指定
してください。
BUFSIZE
はい
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
第 11 章 コンポーネント・トレース
11-133
コンポーネント・トレース
パラメーター
CTnRSMxx で指定可能かどうか
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
IBM 提供の 2 つのサンプル CTIRSMxx parmlib メンバーが SYS1.PARMLIB に入
っています。デフォルト・メンバーはありません。
v CTIRSM01: DMPOFF、NOCOMASID、および NODMPREC を使用してすべての
RSM 機能およびイベントのトレースを要求する方法を示します。
v CTIRSMSP: トレースを制限するためにアドレス・スペースおよびジョブ名のフ
ィルター操作とトレース要求オプションを要求する方法を示します。
データ・スペース内の RSM トレース・データ: RSM はデータ・スペースへのトレ
ース・データの収集をサポートします。この場合、システムはバッファーからデー
タ・スペースにトレース・データをコピーします。トレース・データ・セットのほ
かに、データ・スペースを使用して多数の RSM トレース・レコードを取り扱うこ
とができます。RSM トレース・レコードではデータ・スペースのページング活動が
表示される可能性があることにご注意ください。
システムでページングの問題が発生していると思われる場合には、アドレス・スペ
ース・バッファー内の RSM トレース・レコードを収集して、ページング中のレコ
ードの消失を防いでください。いっぱいになったデータ・スペース・バッファーを
システムが再使用すると、レコードが失われることがあります。システムは、次の
データ・スペース・バッファーの最初のレコードで、失われたトレース・レコード
の数を示します。
RSM の場合、CTnRSMxx parmlib メンバーの BUFSIZE パラメーターでデータ・ス
ペース・バッファーのサイズを指定します。その他のコンポーネントの場合には、
BUFSIZE でアドレス・スペース・バッファーのサイズを指定します。
例: CTWRSM05 parmlib メンバー
RSM の場合、CTnRSMxx OPTIONS パラメーターの BUFF を使用して、アド
レス・スペース・バッファーの数とそれらのページ・サイズを指定してくださ
い。次の CTWRSM05 のステートメントでは、64 ページのアドレス・スペー
ス・バッファーを 4 つ、および 640KB のデータ・スペース・バッファーを 1
つ指定しています。
TRACEOPTS
ON
BUFSIZE(640K)
OPTIONS(’BUFF(4,64)’)
バッファーを含むデータ・スペースの名前は、メッセージ IAR007I で提供されま
す。この名前は SYSIARnn 形式になっています。オペレーターは、DUMP コマンド
に対する応答でデータ・スペース名を指定する必要があります。
11-134
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、nnnnM、または OFF
1 つ必要。 nnnnK および nnnnM でデー
タ・スペース内のバッファーのサイズを指
定。
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き込み用に TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
はい
JOBNAME
はい。すべてのバッチ・ジョブをトレースす
るには、ジョブ名のリストで ‘INIT’ を指定
してください。
OPTIONS
はい
WTR
はい
自動ダンプ: オペレーターがトレースを停止したとき、または RSM がリカバリー
処理に入ったときに、コンポーネントが SVC ダンプを要求します。トレースがト
レース・データ・セットに書き込まれたとき、またはオペレーターがダンプを要求
したときに自動ダンプが行われないようにするには、TRACE CT コマンドまたは
CTnRSMxx parmlib メンバーの OPTIONS パラメーターで NODMPREC および
NODMPOFF を指定してください。
OPTIONS パラメーター
CTnRSMxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を以下に示します。
フィルターまたはオプションをなにも指定しないで SYSRSM トレースをオンにす
ると、コンポーネント・トレースは、すべてのアドレス・スペースおよびジョブで
発生するそれぞれの RSM 機能およびイベントを記録します。このようなトレース
を行うと非常に大量のデータが収集され、システムのパフォーマンスが低下しま
す。SYSRSM のフィルターとオプションを使用して、コンポーネント・トレースに
よって記録されるデータの量を制限してください。特定のアドレス・スペース、ジ
ョブ、RSM イベント、および RSM 機能をトレースするように指定してください。
RSM トレース・オプションは、次の 3 つのグループに分けられます。
v 特殊トレース・オプション
第 11 章 コンポーネント・トレース
11-135
コンポーネント・トレース
v RSM 機能トレース・オプション
v RSM イベント・トレース・オプション
特殊トレース・オプション: これらのオプションでは、固定 RSM トレース・バッ
ファーのサイズを設定し、共通域活動を記録するようにトレースに指示し、トレー
ス・データをダンプすべき時期をシステムに指示します。これらのオプションは以
下のとおりです。
BUFF=(x,y)
SYSRSM トレース・バッファーの数とサイズを指定します。バッファーは、固
定拡張共通サービス・エリア (ECSA) ストレージにあります。
x
バッファーの数 (2 から 7 まで)。デフォルトは 3 です。
y
バッファー当りのページ数 (4 から 262,144 まで)。デフォルトは 32
です。
たとえば BUFF=(5,10) を指定すると、コンポーネント・トレースは 5 つの固定
トレース・バッファーを使用します。各バッファーには 10 ページが含まれま
す。使用される固定ストレージの合計量は 200 キロバイトになります。
注: トレース・バッファー用の固定ストレージの量を選択する場合には、利用可
能な中央記憶装置の量を考慮してください。
COMASID
共通域ページ内の活動をトレースします。これはデフォルトです。
NOCOMASID
共通域ページ内の活動のトレースを行わないようにします。
DMPREC
RSM がリカバリー処理に入ったときに要求された SVC ダンプにトレース・デ
ータを含めます。ダンプの進行中は SYSRSM トレースが延期されます。このダ
ンプには、問題の発生前に記録された最新のトレース・データが含まれます。デ
フォルトであるこのダンプ・オプションを使用すると、次のようになります。
v RSM がリカバリー処理に入ってもトレース・テーブルがダンプされません。
v リカバリー処理中は別のプロセッサーでトレースが続行されます。
NODMPREC
RSM がリカバリー処理に入ったときにトレース・データがダンプされないよう
にします。
DMPOFF
TRACE CT,OFF,COMP=SYSRSM コマンドにより、あるいは CTnRSMxx
parmlib メンバーの OFF パラメーターによって RSM に関するトレースがオフ
にされたときに、トレース・データをダンプします。
NODMPOFF
トレースを停止するために TRACE オペレーター・コマンドが入力されたとき
にダンプが書き出されないようにします。これはデフォルトです。
機能トレース・オプション: 機能トレース・オプションは、トレース対象の RSM
機能およびサービスを識別します。これらのオプションは以下のとおりです。
ASPCREAT
アドレス・スペース作成機能に関するイベントをトレースします。
11-136
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
COPYSRVG
RSM コピー・サービス・グループをトレースします。このオプションは、
COPYSERV と COPYSRVH を指定した場合と同じです。個別に指定できるグ
ループ・オプションは次のとおりです。
COPYSERV
コピー・サービスをトレースします。
COPYSRVH
高位仮想コピー・サービスをトレースします。
DFSTEAL
二重フレーム・スチール機能に関するイベントをトレースします。
DIV
仮想域内データ・サービス・グループの中のすべてのイベントをトレースしま
す。DIV オプションは、DIVACCUN、DIVMAP、DIVMAPLV、DIVRES、
DIVRESLV、DIVRTR、 DIVSAVE、および DIVUNMAP をすべて指定した場合
と同じ効果をもちます。個別に指定できるグループ・オプションは次のとおりで
す。
DIVACCUN
DIV ACCESS および DIV UNACCESS サービスをトレースします。
DIVMAP
仮想域内データ MAP サービスをトレースします。
DIVMAPLV
仮想域内データ MAP サービスをトレースします (直前の ACCESS で
LOCVIEW=MAP が指定されている場合)。
DIVRES
仮想域内データ RESET サービスをトレースします。
DIVRESLV
仮想域内データ RESET サービスをトレースします (直前の ACCESS で
LOCVIEW=MAP が指定されている場合)。
DIVRTR
仮想域内データ・サービス・ルーターをトレースします。
DIVSAVE
仮想域内データ SAVE サービスをトレースします。
DIVUNMAP
仮想域内データ UNMAP サービスをトレースします。
DSPCONV
データ・スペース変換インターフェース機能内のイベントをトレースします。
DSPLIMIT
データ・スペース制限インターフェース機能内のイベントをトレースします。
DATASPAC
データ・スペースおよびハイパースペース・グループ内のすべてのイベントをト
レースします。DATASPAC オプションは、DSPSERV および HSPSERV を両
方指定した場合と同じ効果をもちます。個別に指定できるグループ・オプション
は次のとおりです。
第 11 章 コンポーネント・トレース
11-137
コンポーネント・トレース
DSPSERV
データ・スペース・サービス・グループの中のすべてのイベントをトレース
します。このオプションは、DSPCREAT、DSPDELET、DSPEXTEN、
DSPIOOF、DSPIOON、DSPREL、および DSPSRTR をすべて指定した場合
と同じ効果をもちます。個別に指定できるグループ・オプションは次のとお
りです。
DSPCREAT
DSPSERV CREATE サービス内のイベントをトレースします。
DSPDELET
DSPSERV DELETE サービス内のイベントをトレースします。
DSPDRFOF
DSPSERV 定義 DREF オフにおけるイベントをトレースします。
DSPDRFON
DSPSERV 定義 DREF オンにおけるイベントをトレースします。
DSPEXTEN
DSPSERV EXTEND サービス内のイベントをトレースします。
DSPLOAD
DSPSERV LOAD サービス内のイベントをトレースします。
DSPIOOF
DSPSERV IOOFF サービス内のイベントをトレースします。
DSPIOON
DSPSERV IOON サービス内のイベントをトレースします。
DSPOUT
DSPSERV OUT サービス内のイベントをトレースします。
DSPREL
DSPSERV RELEASE サービス内のイベントをトレースします。
DSPSRTR
DSPSERV ルーター・サービス内のイベントをトレースします。
DSPSRTRD
DSPSERV 使用不能 RTR サービス内のイベントをトレースします。
HSPSERV
ハイパースペース・サービス・グループ内のすべてのイベントをトレースし
ます。このオプションは、HSPCACHE と HSPSCROL を指定した場合と同
じ効果をもちます。個別に指定できるグループ・オプションは次のとおりで
す。
HSPCACHE
HSPSERV キャッシュ・サービス内のイベントをトレースします。
HSPSCROL
HSPSERV スクロール・サービス内のイベントをトレースします。
DUMPSERV
ダンプ機能をトレースします。
11-138
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
FAULTS
不在サービス・グループ内のすべてのイベントをトレースします。このオプショ
ンは、FLTASP、FLTDSP、FLTEPROT をすべて指定した場合と同じ効果があり
ます。個別に指定できるグループ・オプションは次のとおりです。
FLTASP
アドレス・スペース不在グループ内のすべてのイベントをトレースします。
このオプションは、FLTADPAG、FLTAEPAG、および FLTAESEG をすべ
て指定した場合と同じ効果をもちます。個別に指定できるグループ・オプシ
ョンは次のとおりです。
FLTADPAG
使用不能なアドレス・スペース・ページの不在をトレースします。
FLTAEPAG
使用可能なアドレス・スペース・ページの不在をトレースします。
FLTAESEG
使用可能なアドレス・スペース・セグメントの不在をトレースします。
FLTAHPAG
2 ギガバイト境界より上のアドレスにおける、アドレス・スペースのペ
ージ不在をトレースします。
FLTAHSEG
2 ギガバイト境界より上のアドレスにおける、アドレス・スペースのセ
グメント不在をトレースします。
FLTAREGN
アドレス・スペースの領域不在をトレースします。
FLTATYPE
アドレス・スペースのタイプ不在をトレースします。
FLTDSP
データ・スペース不在グループの中のすべてのイベントをトレースします。
このオプションは、FLTDEN と FLTDDIS を指定した場合と同じ効果をも
ちます。個別に指定できるグループ・オプションは次のとおりです。
FLTDEN
使用可能なデータ・スペースの不在をトレースします。
FLTDDIS
使用不能なデータ・スペースの不在をトレースします。
FLTEPROT
保護不在をします。
FREEFRAM
フレーム解放機能をトレースします。
GEN
汎用機能グループ内のすべてのイベントをトレースします。このオプションは、
GENDEFER、GENIOCMP、および GENTERM をすべて指定した場合と同じ効
果をもちます。個別に指定できるグループ・オプションは次のとおりです。
GENDEFER
一般的な据え置きをトレースします。
第 11 章 コンポーネント・トレース
11-139
コンポーネント・トレース
GENIOCMP
一般的な入出力完了をトレースします。
GENTERM
一般的な異常終了をトレースします。
IARVSERV
すべての IARVSERV 要求をトレースします。個別に指定できる、仮想サービス
のグループ・オプションは、次のとおりです。
VSCHGACC
IARVSERV CHANGEACCESS 要求をトレースします。
VSROUTR
IARVSERV サービス・ルーターをトレースします。
VSSHARE
IARVSERV SHARE 要求をトレースします。
VSSHSEG
IARVSERV SHARESEG 要求をトレースします。
VSUNSHAR
IARVSERV UNSHARE 要求をトレースします。
IARV64
すべての IARV64 要求をトレースします。個別に指定できる、高位仮想サービ
スのグループ・オプションは、次のとおりです。
V6CHACC
IARV64 CHANGEACCESS 要求をトレースします。
V6CHGURD
IARV64 CHANGEGUARD 要求をトレースします。
V6DETACH
IARV64 DETACH 要求をトレースします。
V6DISCAR
IARV64 DISCARDDATA 要求をトレースします。
V6GETSHR
IARV64 GETSHARED 要求をトレースします。
V6GETSTR
IARV64 GETSTOR 要求をトレースします。
V6LIST
IARV64 LIST 要求をトレースします。
V6PAGFIX
IARV64 PAGEFIX 要求をトレースします。
V6PAGIN
IARV64 PAGEIN 要求をトレースします。
V6PAGOUT
IARV64 PAGEOUT 要求をトレースします。
11-140
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
V6PAGUNF
IARV64 PAGEUNFIX 要求をトレースします。
V6ROUTR
IARV64 サービス・ルーターをトレースします。
V6SHMOMB
IARV64 SHAREMEMOBJ 要求をトレースします。
MACHCHK
マシン・チェック機能をトレースします。
MIGRAT
マイグレーション機能をトレースします。
PER
PER 割り込みの結果 RSM に入ったときにトレースを行います。
PGSER
ページング・サービス・グループ内のすべてのイベントをトレースします。この
オプションは、PGANY、PGFIX、PGFREE、PGLOAD、PGOUT、PGREL、およ
び PRSRTR をすべて指定した場合と同じ効果をもちます。個別に指定できるグ
ループ・オプションは次のとおりです。
PGANY
ページ任意サービス内のイベントをトレースします。
PGFIX
ページ固定サービス内のイベントをトレースします。
PGFREE
ページ解放サービス内のイベントをトレースします。
PGLOAD
ページ・ロード・サービス内のイベントをトレースします。
PGOUT
ページアウト・サービス内のイベントをトレースします。
PGREL
ページ解除サービス内のイベントをトレースします。
PGSRTR
ページング・サービス・ルーター内のイベントをトレースします。
QFSTEAL
クワッド・フレーム・スチール機能に関するイベントをトレースします。
RECONFIG
再構成機能をトレースします。
RPBPMGMT
RSM セル・プール管理機能をトレースします。
SUBSPACE
サブスペース・グループ内のすべてのイベントをトレースします。このオプショ
ンは、SSPCONV および IARSUBSP を両方指定した場合と同じ効果をもちま
す。個別に指定できるグループ・オプションは次のとおりです。
第 11 章 コンポーネント・トレース
11-141
コンポーネント・トレース
SSPCONV
サブスペース変換サービスをトレースします。
IARSUBSP
サブスペース・サービス・グループをトレースします。このオプションは、
SSPIDENT、SSPCREAT、SSPASSIG、SSPUNAS、SSPDELET、SSPUNID、
および SSPSRTR をすべて指定した場合と同じ意味をもちます。個別に指定
できるグループ・オプションは次のとおりです。
SSPIDENT
IARSUBSP IDENTIFY サービスをトレースします。
SSPCREAT
IARSUBSP CREATE サービスをトレースします。
SSPASSIG
IARSUBSP ASSIGN サービスをトレースします。
SSPUNAS
IARSUBSP UNASSIGN サービスをトレースします。
SSPDELET
IARSUBSP DELETE サービスをトレースします。
SSPUNID
IARSUBSP UNIDENTIFY サービスをトレースします。
SSPSRTR
IARSUBSP ルーターをトレースします。
STORMOD
ストレージ状態修正グループの中のすべてのイベントをトレースします。このグ
ループは、CLONEPAG および CLONESEG を両方指定した場合と同じ効果を
もちます。個別に指定できるグループ・オプションは次のとおりです。
CLONEPAG
サブスペースにコピーされたページ・テーブル項目をトレースします。
CLONESEG
サブスペースにコピーされたセグメント・テーブル項目をトレースします。
SWAP
スワップ・サービス・グループの中のすべてのイベントをトレースします。この
オプションは、SWAPIN および SWAPOUT を両方指定した場合と同じ効果を
もちます。個別に指定できるグループ・オプションは次のとおりです。
REALSWAP
実記憶域内スワップ処理中のイベントをトレースします。
SWAPIN
スワップイン・サービス内のイベントをトレースします。
SWAPOUT
スワップアウト・サービス内のイベントをトレースします。
TRACE*
トレース機能をトレースします。この機能は常にトレースされます。
11-142
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
UIC
未参照間隔カウント機能をトレースします。
VIO
仮想入出力機能をトレースします。
VR
V=R 割り振り機能をトレースします。
VSM
VSM サービス・グループ内のすべてのイベントをトレースします。このオプシ
ョンは、VSMFRMN および VSMGTMN を両方指定した場合と同じ効果をもち
ます。個別に指定できるグループ・オプションは次のとおりです。
VSMFRMN
FREEMAIN サービス内のイベントをトレースします。
VSMGTMN
GETMAIN サービス内のイベントをトレースします。
WAITSER
RSM 待機機能をトレースします。
XCHUP
上方交換機能をトレースします。
XMPOST
仮想記憶間通知機能をトレースします。
イベント・トレース・オプション: イベント・トレース・オプションは、RSM がト
レース・データを収集するイベントを識別します。これらのオプションは以下のと
おりです。
ESTOR
拡張ストレージ管理グループの中のすべてのイベントをトレースします。このオ
プションは、ESDEQ、ESENQ、ESFREE、および ESGET をすべて指定した場
合と同じ意味をもちます。個別に指定できるグループ・オプションは次のとおり
です。
ESGET
拡張記憶の取得をトレースします。
ESENQ
拡張記憶のエンキュー待機をトレースします。
ESDEQ
拡張記憶のデキューをトレースします。
ESFREE
拡張記憶の解放をトレースします。
FUNCREQ
機能要求イベントをトレースします。
PAGEREQ
ページ要求グループ内のすべてのイベントをトレースします。このオプション
は、PAGEA2R、PAGEDEF、PAGEE2R、PAGEP2R、PAGEREL、PAGER2A、
第 11 章 コンポーネント・トレース
11-143
コンポーネント・トレース
PAGER2E、PAGER2EA、PAGER2P、PAGER2R、および PAGETAPS をすべて
指定した場合と同じ効果をもちます。個別に指定できるグループ・オプションは
次のとおりです。
PAGEA2R
補助記憶装置から中央記憶装置へのページ移動の要求をトレースします。
PAGEDEF
中央記憶装置へのページ移動の要求のうち、フレーム不足のために据え置か
れたものをトレースします。
PAGEE2R
拡張記憶装置から中央記憶装置へのページ移動の要求をトレースします。
PAGEP2R
永続記憶装置から中央記憶装置へのページ移動の要求をトレースします。
PAGEREL
入出力進行中または据え置きイベントに関する要求をトレースします。
PAGER2A
中央記憶装置から補助記憶装置へのページ移動の要求をトレースします。
PAGER2E
中央記憶装置から拡張記憶装置へのページ移動の要求をトレースします。
PAGER2EA
中央記憶装置から拡張記憶装置への非同期ページ移動開始の要求をトレース
します。
PAGER2P
中央記憶装置から永続記憶装置へのページ移動の要求をトレースします。
PAGER2R
中央記憶装置から中央記憶装置へのページ移動の要求をトレースします。
PAGETAPS
中央記憶装置から拡張記憶装置への非同期ページ移動完了の要求をトレース
します。
PGEVENTS
ページ固定/解放グループ内のすべてのイベントをトレースします。このオプシ
ョンは、FIX および FREE を両方指定した場合と同じ効果をもちます。個別に
指定できるグループ・オプションは次のとおりです。
FIX
固定中のページをトレースします。
FREE
解放中のページをトレースします。
REGIONGR
領域テーブル・グループの中のすべてのイベントをトレースします。このオプシ
ョンは、CREG1ST、CREG2ND、および CREG3RD をすべて指定した場合と同
じ効果があります。個別に指定できるグループ・オプションは次のとおりです。
CREG1ST
領域の 1 番目のテーブル作成をトレースします。
11-144
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CREG2ND
領域の 2 番目のテーブル作成をトレースします。
CREG3RD
領域の 3 番目のテーブル作成をトレースします。
RSTOR
フレーム管理グループ内のすべてのイベントをトレースします。このオプション
は、RSDEQ、RSENQ、RSFREE、RSGET、および HVFRGRP をすべて指定した
場合と同じ意味を持ちます。個別に指定できるグループ・オプションは次のとお
りです。
HVFRGRP
高位仮想フレームのフレーム管理用イベントをトレースします。このオプシ
ョンは、HVFRENQ、HVFRDEQ、HVPGTENQ、および HVPGTDEQ をす
べて指定した場合と同じ意味を持ちます。個別に指定できるグループ・オプ
ションは次のとおりです。
HVFRDEQ
フレームを、高位仮想フレーム・キューからデキューする時点でトレー
スします。
HVFRENQ
フレームを、高位仮想フレーム・キューにエンキューする時点でトレー
スします。
HVPGTDEQ
フレームを、高位仮想ページ・テーブル・フレーム・キューからデキュ
ーする時点でトレースします。
HVPGTENQ
フレームを、高位仮想ページ・テーブル・フレーム・キューにエンキュ
ーする時点でトレースします。
RSDEQ
デキュー・フレーム・グループ内のすべてのイベントをトレースします。こ
のオプションは、RSDDEFER、RSDFIX、RSDPAG、RSDSBUF、RSDSQA、
および RSDVRW をすべて指定した場合と同じ効果をもちます。個別に指
定できるグループ・オプションは次のとおりです。
RSDDEFER
据え置き FREEMAIN フレーム・キューまたは孤立フレーム・キューか
らフレームがデキューされたときにトレースを行います。
RSDFIX
フレームを、固定フレーム・キューまたはローカル・クワッド・フレー
ム・キューからデキューする時点でトレースします。
RSDGDFER
汎用据え置きフレーム・キューからフレームがデキューされたときにト
レースします。
RSDPAG
ページング可能フレーム・キューからフレームがデキューされたときに
トレースを行います。
第 11 章 コンポーネント・トレース
11-145
コンポーネント・トレース
RSDSBUF
中央記憶装置バッファー・フレーム・キューからフレームがデキューさ
れたときにトレースを行います。
RSDSQA
SQA フレーム・キューからフレームがデキューされたときにトレース
を行います。
RSDVRW
V=R 待機フレーム・キューからフレームがデキューされたときにトレ
ースを行います。
RSENQ
フレーム待機グループ内のすべてのイベントをトレースします。このオプシ
ョンは、RSEDEFER、RSEFIX、RSEPAG、RSESBUF、RSESQA、および
RSEVRW をすべて指定した場合と同じ効果をもちます。個別に指定できる
グループ・オプションは次のとおりです。
RSEDEFER
据え置きまたは孤立フレーム・キューにフレームがエンキューされたと
きにトレースを行います。
RSEFIX
フレームを、固定フレーム・キューまたはローカル・クワッド・フレー
ム・キューにエンキューする時点でトレースを行います。
RSEPAG
ページング可能フレーム・キューにフレームがエンキューされたときに
トレースを行います。
RSESBUF
中央記憶装置バッファー・フレーム・キューにフレームがエンキューさ
れたときにトレースを行います。
RSEGDFER
汎用据え置きフレーム・キューにフレームがエンキューされたときにト
レースします。
RSESQA
SQA フレーム・キューにフレームがエンキューされたときにトレース
を行います。
RSEVRW
V=R 待ちフレーム・キューにフレームがエンキューされたときにトレ
ースを行います。
RSFREE
フリー・フレーム・グループ内のすべてのイベントをトレースします。この
オプションは、RSFDBL および RSFSNG を両方指定した場合と同じ意味を
もちます。個別に指定できるグループ・オプションは次のとおりです。
QFFREE
クワッド・グループが解放されたときにトレースします。
QHFREE
クワッド保持フレームが解放されたときにトレースします。
11-146
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
QSFREE
単一クワッド・フレームが解放されたときにトレースします。
RSFDBL
二重フレームが解放されたときにトレースを行います。
RSFSNG
単一フレームが解放されたときにトレースを行います。
RSGET
フレーム取得グループ内のすべてのイベントをトレースします。このオプシ
ョンは、RSGDBL および RSGSNG を両方指定した場合と同じ意味をもち
ます。個別に指定できるグループ・オプションは次のとおりです。
QFGET
クワッド・グループが取得されたときにトレースします。
QHGET
クワッド保持フレームが取得されたときにトレースします。
QSGET
単一クワッド・フレームが取得されたときにトレースを行います。
RSGDBL
二重フレームが取得されたときにトレースを行います。
RSGSNG
単一フレームが取得されたときにトレースを行います。
SHRDATA
IARVSERV サービス・グループ内のすべてのイベントをトレースします。この
オプションは、GRPCREAT、GRPDEL、GRPPART、VIEWADD、 VIEWCHG、
VIEWDEL または VIEWMOVE をすべて指定した場合と同じ効果があります。
個別に指定できるグループ・オプションは次のとおりです。
GRPCREAT
新規共用グループの作成をトレースします。
GRPDEL
既存共用グループの削除をトレースします。
GRPPART
既存共用グループの区分化をトレースします。
VIEWADD
共用グループへのビューの追加をトレースします。
VIEWCHG
ビューの記憶属性の変更をトレース。
VIEWDEL
既存共用グループからのビューの削除をトレースします。
VIEWMOVE
ある共用グループから別の共用グループへの既存ビューの移動をトレースし
ます。
SHRINT
高位仮想共用インタレスト・イベントをトレースします。このオプションは、
第 11 章 コンポーネント・トレース
11-147
コンポーネント・トレース
SHRADD および SHRDEL を両方指定した場合と同じです。個別に指定できる
グループ・オプションは次のとおりです。
SHRADD
共用インタレストの追加をトレースします。
SHRDEL
共用インタレストの除去をトレースします。
TRACEB
トレース・バッファー・イベントをトレースします。このイベントは常にトレー
スされます。
WORKUNIT
ネット・イベント・トレース・グループ内のすべてのイベントをトレースしま
す。このオプションは、SUSPEND および RESUME を両方指定した場合と同じ
効果をもちます。個別に指定できるグループ・オプションは次のとおりです。
ENABLE
作業単位を使用可能にする要求をトレースします。
SUSPEND
作業単位を延期する要求をトレースします。
RESUME
作業単位を再開する要求をトレースします。
XEPLINK
外部入り口点リンケージ・グループ内のすべてのイベントをトレースします。こ
のオプションは、XEPENTRY および XEPEXIT を両方指定した場合と同じ効果
をもちます。個別に指定できるグループ・オプションは次のとおりです。
XEPENTRY
入り口点に入るときにトレースを行います。
XEPEXIT
入り口点から出るときにトレースを行います。
SYSRSM トレースの要求の例
例 1: CTnRSMxx メンバー
このメンバーは、アドレス・スペース X'11' および X'41' とジョブ PGM1 に
ついてのみ、FAULTS サービス・グループ、PGANY サービス、および VIO
機能のトレースを要求します。
TRACEOPTS
ON
ASID(11,41)
JOBNAME(PGM1)
OPTIONS(’FAULTS’,’PGANY’,’VIO’)
11-148
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
例 2: TRACE コマンド
この例では、parmlib メンバー CTWRSM17 からオプションを獲得するように
指定しています。
trace ct,on,comp=sysrsm,parm=ctwrsm17
例 3: TRACE コマンド
この例では例 2 と同じトレースを要求していますが、すべてのオプションを
REPLY で指定しています。
trace ct,on,comp=sysrsm
* 78 ITT006A ...
reply 78,options=(faults,pgany,vio),asid=(11,41),jobname=(pgm1),end
SYSRSM トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSRSM) サブコマンドを使
用して行います。このサブコマンドには OPTIONS 値はありません。
SYSRSM トレースからの出力
CTRACE COMP(SYSRSM) FULL サブコマンドの出力
CTRACE COMP(SYSRSM) FULL サブコマンドを指定してフォーマット設定された
RSM コンポーネント・トレース・レコードの例を次に示します。
XEPENTRY 00000001 18:18:06.441411 External Entry Point Entry
FUNC1... PGFIX
Page Fix
JOBN1... ASNB
ASID1... 000D
PLOCKS.. 80000001 CPU..... 0000
JOBN2... ASNB
ASID2... 000D
RLOCKS.. 80000000
KEY..... 0036
ADDR.... 015FF008 ALET.... 00000000
7D00
KEY..... 002C
ADDR.... 005FEF80 ALET.... 00000000
00000000 005EF000 005EFFFF 00F00200 00FF8DD8 00F8BD00 00F8BC98
005EFFC3 005EF02C 00F8BD50 005EF02C 00F8BE00 00F8BC00 005FEF78
00FF91DA 81082798
FIX
00000003 18:18:06.441921 Page
FUNC1... PGFIX
Page Fix
JOBN1... ASNB
ASID1... 000D
JOBN2... ASNB
ASID2... 000D
KEY..... 0036
ADDR.... 015FF008
7D003500
KEY..... 005D
ADDR.... 005EF000
KEY..... 0001
ADDR.... 011F8220
0151182C 012D2E60 81C00000 03000001
Being Fixed
PLOCKS.. 88004001 CPU..... 0000
RLOCKS.. 88004000
ALET.... 00000000
ALET.... 00000000
ALET.... 00000000
0000000D 005EF000 00000000 00000000
第 11 章 コンポーネント・トレース
11-149
コンポーネント・トレース
XEPENTRY 00000001 18:18:06.461716 External Entry Point Entry
FUNC1... PGFREE
Page Free
JOBN1... ASNB
ASID1... 000D
PLOCKS.. 80000001 CPU..... 0000
JOBN2... ASNB
ASID2... 000D
RLOCKS.. 80000000
KEY..... 0036
ADDR.... 015FF008 ALET.... 00000000
8100
KEY..... 002C
ADDR.... 005FEF80 ALET.... 00000000
005F5EC0 00F8BC08 00000000 00F00200 00FF8DD8 00FF6896 00F8DB00
00000008 00F8BF2C 00FF7B60 00000C60 00F8BE00 00F8Bc00 005FEF78
00FF96A4 810801B8
FREE
00000004 18:18:06.461766 Page Being Freed
FUNC1... PGFREE
Page Free
JOBN1... ASNB
ASID1... 000D
PLOCKS.. 88004001 CPU..... 0000
JOBN2... ASNB
ASID2... 000D
RLOCKS.. 88004000
KEY..... 0036
ADDR.... 015FF008 ALET.... 00000000
8100
KEY..... 005D
ADDR.... 005F5000 ALET.... 00000000
KEY..... 0001
ADDR.... 01210660 ALET.... 00000000
011F9CA0 01242560 81C00000 03000000 0000000D 005F5000 00000000 00000000
FREE
00000004 18:18:06.461805 Page Being Freed
FUNC1... PGFREE
Page Free
JOBN1... ASNB
ASID1... 000D
PLOCKS.. 88004001 CPU..... 0000
JOBN2... ASNB
ASID2... 000D
RLOCKS.. 88004000
KEY..... 0036
ADDR.... 015FF008 ALET.... 00000000
8100
KEY..... 005D
ADDR.... 005EF000 ALET.... 00000000
KEY..... 0001
ADDR.... 011F8220 ALET.... 00000000
0151182C 012D2E60 81C00000 03000000 0000000D 005EF000 00000000 00000000
報告書で必要になる可能性のあるフィールドは、以下のとおりです。
FUNC1
トレース・イベントが記録されたときに制御権を得ていた機能。
JOBN1
RSM サービスを要求している作業単位を含むアドレス・スペースを識別するジ
ョブ名。
JOBN2
TRACE オペレーター・コマンドで指定したジョブ名リスト内の名前と一致する
ジョブ名。
ASID1
RSM サービスを要求している作業単位を含むアドレス・スペースを識別する
ASID。
ASID2
TRACE オペレーター・コマンドで指定した ASID リスト内の ID と一致する
ASID。
CPU
トレースが実行されているプロセッサーの中央処理装置 ID。
11-150
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
SYSSPI コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、サービス・プロセッサー・インターフェース (SPI) 用の SYSSPI コンポー
ネント・トレースを要求するための情報を要約します。
情報
SYSSPI の場合
parmlib メンバー
なし
デフォルトのトレース
いいえ
トレース要求の OPTIONS パラメー なし
ター
バッファー
v
v
v
v
v
デフォルト: 64KB
範囲: 適用外
サイズの設定方法: MVS システム
IPL 後のサイズ変更: 不可
場所: コンポーネント・エリア内
トレース・レコードの場所
アドレス・スペース・バッファー
SVC ダンプの要求
コンポーネントによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSSPI)
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSSPI トレースの要求
SYSSPI トレースは、IBM サポートから依頼があったときに要求してください。次
の手順に従ってください。
1. 次のコマンドを使用してトレースを開始します。
TRACE CT,ON,COMP=SYSSPI
2. IBM が指定した間隔をおいて、次のコマンドを使用してトレースを停止しま
す。
TRACE CT,OFF,COMP=SYSSPI
バッファーがいっぱいになると、コンポーネントが SVC ダンプを要求します。こ
のダンプにはバッファーの内容が含まれています。オプションで、オペレーターが
DUMP コマンドを入力することもできます。
第 11 章 コンポーネント・トレース
11-151
コンポーネント・トレース
SYSSPI トレースのフォーマット設定
1. SPZAP を使用してモジュールを変更します。変更内容は IBM が提供します。
2. トレースのフォーマット設定は IPCS CTRACE COMP(SYSSPI) サブコマンドを
使用して行います。このサブコマンドには OPTIONS 値はありません。
SYSTTRC トランザクション・トレース
トランザクション・トレースは、コンポーネント・トレース制御の処理には関係し
ません。トランザクション・トレースは、独立したトレース機能です。トランザク
ション・トレースに TRACE CT コマンドを使用しないでください。トランザクシ
ョン・トレース用にコンポーネント・トレースの parmlib メンバーの追加を試みな
いでください。トランザクション・トレースについては、 12-1 ページの『第 12 章
トランザクション・トレース』を参照してください。
SYSVLF コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、仮想索引機能 (VLF) 用の SYSVLF コンポーネント・トレースを要求する
ための情報を要約します。
情報
SYSVLF の場合
parmlib メンバー
なし
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー なし
ター
11-152
バッファー
v
v
v
v
v
トレース・レコードの場所
アドレス・スペース・バッファー、データ・スペー
ス・バッファー
SVC ダンプの要求
DUMP または SLIP コマンドにより、あるいは
SYSVLF の完全トレースがオフになったとき
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
デフォルト: 適用外
範囲: 適用外
サイズの設定方法: MVS システム
IPL 後のサイズ変更: 不可
場所: データ・スペース内。VLF データ・スペース
を識別するために DISPLAY J,VLF と入力。
DUMP コマンドに対する REPLY で
DSPNAME=(’VLF’.Dclsname, ’VLF’.Cclsname) を指
定する (clsname は VLF クラス名)。
コンポーネント・トレース
情報
SYSVLF の場合
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSVLF)
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSVLF トレースの要求
VLF が制御権を得ているときには、最小限トレースが実行されます。最小限トレー
スを要求するためのアクションは不要です。
最小限トレースよりも多くの情報を記録するには、TRACE オペレーター・コマンド
で完全トレースを要求します。完全トレースを実行するとシステム・パフォーマン
スが低下することがありますので、ご注意ください。次の表は、TRACE CT コマン
ドで指定できるパラメーターを示しています。コマンドに対応してシステムがオペ
レーターに応答の入力を求めるプロンプト指示することはありません。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON または OFF
1 つ必要
nnnnK または nnnnM
いいえ
COMP
必須
SUB
いいえ
PARM
いいえ
完全トレースをオフにすると、システムはトレース・レコードを含むダンプを書き
出し、最小限トレースを再開します。
SYSVLF 完全トレースの要求および停止の例
例 1: SYSVLF 完全トレースの要求
このコマンドは、完全トレースを要求します。
TRACE CT,ON,COMP=SYSVLF
例 2: SYSVLF 完全トレースの停止
このコマンドは完全トレースをオフにします。システムは、このコマンドに対
応してダンプを書き出し、最小限 SYSVLF トレースを再開します。
TRACE CT,OFF,COMP=SYSVLF
第 11 章 コンポーネント・トレース
11-153
コンポーネント・トレース
例 3: シスプレックスにおける SYSVLF トレースのためのコマンド
次のコマンドは、シスプレックス内のシステムで SYSVLF トレースのトレー
スをオンにします。SYSVLF には parmlib メンバーがないため、CTIITT00 メ
ンバーを使用して、プロンプト指示が出されないようにします。
route *all,trace ct,on,comp=sysvlf,parm=ctiitt00
SYSVLF トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSVLF) サブコマンドを使
用して行います。このサブコマンドには OPTIONS 値はありません。
SYSVLF トレースからの出力
CTRACE COMP(SYSVLF) FULL サブコマンドの出力
CTRACE COMP(SYSVLF) FULL サブコマンドを指定してフォーマット設定された
VLF コンポーネント・トレース・レコードの例を次に示します。このレコードで
は、トレース・バッファーから得られた定様式例外レコードが表示されています。
VLF COMPONENT TRACE FULL FORMAT
**** 01/27/90
COFRCVRY 00000000 16:03:02.181262 VLF RECOVERY ENTRY
HASID... 000E
SASID... 000E
CPUID... FF170284 30900000
MODNAME. COFMPURG ABEND... 840C4000 REASON.. 00000011
EPTABLE. PURG ESTA .... .... .... .... .... .... .... ....
COFRCVRY 00000001 16:03:02.181324 VLF RECOVERY EXIT
HASID... 000E
SASID... 000E
CPUID... FF170284 30900000
MODNAME. COFMPURG ABEND... 840C4000 REASON.. 00000011
RETCODE. 00000000 RSNCODE. 00000000 FTPRTS.. 80300000 DATA.... 00000000
.
.
.
報告書のフィールドについて以下で説明します。例には表示されないその他のフィ
ールドも報告書にある可能性があります。これらのフィールドについては、11-155
ページに説明されています。
COFRCVRY
トレース・レコードの名前または ID。
00000000
16 進数による ID。
16:03:02.181262
このレコードがトレース・テーブルに入った時刻を示すタイム・スタンプ。
HASID... 000E
ホーム・アドレス・スペース ID。
SASID... 000E
2 次アドレス・スペース ID。
CPUID... FF170284 30900000
このレコードをトレース・テーブルに入れたプロセッサーの ID。
11-154
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CALLER
DEFINE、CREATE、NOTIFY、PURGE などの VLF サービス要求を発行したル
ーチンのアドレス。
MODNAME.COFMPURG
実行されていたモジュールの名前。
ABEND... 840C4000
VLF がリカバリー機能に入る原因となった異常終了は 0C4 であることを示
す。
REASON..00000011
異常終了に関連した理由コード。
EPTABLE.PURG ESTA
IBM による診断で使用される情報
RETCODE.00000000
終了しようとしているモジュールによって発行された戻りコード。
RSNCODE.00000000
終了しようとしているモジュールによって発行された理由コード。
FTPRTS..80300000
IBM による診断で使用される情報
DATA....00000000
IBM による診断で使用される情報
その他のフィールド: CTRACE 出力の例にはありませんが、レポートに出てくる可
能性があるフィールドは、次のとおりです。
CINDX
オブジェクトの作成または検索が行われた大分類名の連結索引。
CLASS... NPDS3
VLF クラスの名前。
DDNAME
連結データ・セット・リストの DD 名。
FUNC=xxxx
NOTIFY が発生した機能を示します。
FUNCCODE
NOTIFY 機能コードを解釈できない場合の、この機能コードの 16 進数値。
MAJOR
大分類名。
MINADDR
小分類名を含むフィールドのアドレス。
MINALET
小分類名を見付けるために使用されるアドレスに関連したアクセス・リスト入り
口トークン (ALET)。
MINOR
小分類名。
第 11 章 コンポーネント・トレース
11-155
コンポーネント・トレース
OBJSIZE
COFRETRI マクロによって戻されるオブジェクトの、バイト単位の合計サイ
ズ。
PARMS
COFNOTIF マクロ・パラメーター・リストの 16 進数ダンプ。
TLSTADDR
COFRETRI マクロのターゲット・リストのアドレス。
TLSTALET
COFRETRI マクロのターゲット・リストのアクセス・リスト入り口トークン
(ALET)。
TLSTSIZE
ターゲット・リストのバイト単位の長さ。
UTOKEN
COFIDENT マクロによって戻され、COFREMOV、COFCREAT、および
COFRETRI マクロの入力として必要となるユーザー・トークン。
VOLSER
ボリューム通し番号。
SYSWLM コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、ワークロード管理機能 (WLM) 用の SYSWLM コンポーネント・トレース
を要求するための情報を要約します。
情報
SYSWLM の場合
parmlib メンバー
なし
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー なし
ター
11-156
バッファー
v
v
v
v
v
トレース・レコードの場所
アドレス・スペース・バッファー、トレース・デー
タ・セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
デフォルト: 64KB
範囲: 64KB - 16M
サイズの設定方法: MVS システム
IPL 後のサイズ変更: トレースの開始時に可能
場所: 拡張共通サービス・エリア (ECSA)
コンポーネント・トレース
情報
SYSWLM の場合
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSWLM)
トレース・フォーマット設定の
OPTIONS パラメーター
なし
SYSWLM トレースの要求
TRACE CT コマンドにより SYSWLM コンポーネント・トレースを要求します。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON、nnnnK、OFF
1 つ必要。nnnnK でバッファーのサイズを指
定。
COMP
必須
SUB
いいえ
PARM
いいえ
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
いいえ
JOBNAME
いいえ
OPTIONS
いいえ
WTR
はい
SYSWLM トレースの要求の例
次の例では、SYSWLM コンポーネント・トレースを要求しています。
trace ct,on,comp=syswlm
* 17 ITT006A ...
reply 17,end
SYSWLM トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSWLM) サブコマンドを
使用して行います。このサブコマンドには OPTIONS 値はありません。
第 11 章 コンポーネント・トレース
11-157
コンポーネント・トレース
SYSWLM トレースからの出力
CTRACE COMP(SYSWLM) SHORT サブコマンドの出力
CTRACE COMP(SYSWLM) SHORT サブコマンドを指定してフォーマット設定され
た SYSWLM コンポーネント・トレース・レコードの例を次に示します。
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-----------
WLMEPEXT
WLMEPENT
WLMEPEXT
WLMEPENX
WLMEPENT
WLMEPENT
SMSYNMEM
WLMEPEXT
WLMEPENT
SMSYNMEM
00005004
00005003
00005004
00005005
00005003
00005003
00000921
00005004
00005003
00000921
14:07:42.807618
14:07:46.335563
14:07:46.336376
14:07:46.336540
14:07:46.336557
14:07:46.337909
14:07:46.512018
14:07:46.512360
14:07:46.512374
14:07:46.594486
Entry Point Exited
Entry Point Entered
Entry Point Exited
Entry Point Entered Exception
Entry Point Entered
Entry Point Entered
SM Synch XCF Member
Entry Point Exited
Entry Point Entered
SM Synch XCF Member
CTRACE COMP(SYSWLM) FULL サブコマンドの出力
CTRACE COMP(SYSWLM) FULL サブコマンドを指定してフォーマット設定された
SYSWLM コンポーネント・トレース・レコードの例を次に示します。
SYSNAME MNEMONIC
------- -------SY1
WLMEPENT
FUNCID... 0409
HOMEASID. 000B
REQASID.. 0000
KEY...... 5018
04098000
KEY...... 501E
00000084
KEY...... 501F
00000040
KEY...... 5020
00000000
ENTRY ID
-------00005003
TIME STAMP
DESCRIPTION
--------------- ------------14:52:23.449339 Entry Point Entered
CPU...... 0001
HJOBNAME. WLM
RJOBNAME. UNKNOWN
RUCA_EPIDS IWMDMPRP
PARM1
PARM2
PARM3
報告書のフィールドについて以下で説明します。
FUNCID
トレース・レコードを書き込んだモジュールのモジュール・テーブル項目。
CPU
モジュールが実行されていた CPU。
HOMEASID
PSAAOLD から得られた ASID。
REQASID
トレース呼び出しで明示的にコード化された ASID。
HJOBNAME
ホーム・アドレス・スペースの JOBNAME。
11-158
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
RJOBNAME
トレース呼び出しで明示的にコード化された JOBNAME。
KEY
これ以降のデータのタイプを識別します。このデータは HEX および EBCDIC
の両方でフォーマット設定されます。
SYSXCF コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、システム間カップリング・ファシリティー (XCF) 用の SYSXCF コンポー
ネント・トレースを要求するための情報を要約します。
情報
SYSXCF の場合
parmlib メンバー
CTnXCFxx
デフォルト・メンバー: COUPLE00 メンバーで指定さ
れた CTIXCF00
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー CTnXCFxx または TRACE コマンドの REPLY で指
ター
定する
バッファー
v デフォルトの値: 72KB
v 範囲: 16KB - 16MB (システムにより、最も近い
72 バイトの倍数にサイズが切り上げられます。)
v サイズの設定方法: CTnXCFxx メンバー
v IPL 後のサイズ変更: 不可
v ロケーション: XCFAS の拡張ローカル・システ
ム・キュー・エリア (ELSQA)。
トレース・レコードの場所
アドレス・スペース・バッファー、トレース・デー
タ・セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSXCF)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSXCF トレースの要求
SYSXCF コンポーネント・トレースを要求するオプションは、CTnXCFxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
第 11 章 コンポーネント・トレース
11-159
コンポーネント・トレース
システムの実行中に追加トレース・オプションを指定する場合、初期設定時に指定
されたトレース・バッファー・サイズをシステムの実行中に変更することはできな
いため、トレース・レコードは 1 つまたは複数のトレース・データ・セットに入れ
るようにしてください。トレース・レコードの消失を防ぐため、NOWRAP を指定
してください。
注: NOWRAP を指定すると、1 つまたは複数のデータ・セットに書き込まれたトレ
ース・レコードが上書きされるのを回避できます。1 つまたは複数のデータ・
セットがいっぱいになると、レコードはそれ以上書き込まれません。システム
は、その場合にもアドレス・スペース・バッファーへのトレース・レコードの
書き込みを続けます。システムはアドレス・スペース・バッファーを折り返す
ため、トレース・レコードが失われる可能性があります。診断に必要なすべて
のレコードを保持できるように、データ・セットには十分なスペースを割り振
るようにしてください。
CTnXCFxx parmlib メンバー
次の表は、CTnXCFxx parmlib メンバーで指定できるパラメーターを示していま
す。
パラメーター
CTnXCFxx で指定可能かどうか
ON または OFF
はい
ASID
いいえ
JOBNAME
いいえ
BUFSIZE
はい。IPL 時または XCF の再初期設定時に
可能
OPTIONS
はい
SUB
いいえ
PRESET
いいえ
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
注: バッファー・サイズは、IPL 時または XCF の再初期設定時にだけ変更できま
す。新しいバッファー・サイズを、使用中の CTnXCFxx メンバーの BUFSIZE
パラメーターで指定してください。
IBM により、CTIXCF00 parmlib メンバーが提供されています。これには、XCF ト
レースを初期設定時に開始するよう指定されています。CTIXCF00 の内容は次のと
おりです。
TRACEOPTS
ON
BUFSIZE(72K)
これらのパラメーターを指定すると最小限 XCF トレースがオンになり、 72KB の
トレース・バッファーが設定されます。このメンバーは、初期設定時に最小限トレ
ースを活動化します。IBM 提供の COUPLE00 parmlib メンバーでは、CTRACE パ
ラメーターでデフォルトとして CTIXCF00 が指定されています。
11-160
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON または OFF
1 つ必要
nnnnK または nnnnM
いいえ
COMP
必須
SUB
いいえ
PARM
はい
パラメーター
書き込み用に TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
いいえ
JOBNAME
いいえ
OPTIONS
はい
WTR
はい
OPTIONS パラメーター
CTnXCFxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下に英字順で示します。
ARM
自動再始動管理サービスに関するイベントをトレースします。
CFRM
カップリング・ファシリティー・リソース管理サービスに関するイベントをトレ
ースします。
GROUP
XCF サービスとの結合または XCF サービスからの関連解除を行う XCF グル
ープなどの、グループ・サービスに関するイベントをトレースします。
GRPNAME=(groupname[,groupname]...)
トレース対象を、指定された XCF グループに関するイベントだけに限定しま
す。GRPNAME を指定すると、指定された 1 つまたは複数の XCF グループに
よって GROUP、 SERIAL、SIGNAL、および STATUS オプションがフィルタ
ー操作されます。STORAGE オプションは GRPNAME ではフィルター操作され
ません。 XCF グループは 8 つまで指定できます。
SERIAL
逐次化サービスに関するイベントをトレースします。
第 11 章 コンポーネント・トレース
11-161
コンポーネント・トレース
SFM
シスプレックス障害管理サービスに関するイベントをトレースします。
SIGNAL
信号サービス処理に関するイベントをトレースします。
STATUS
XCF モニター・サービスおよびシスプレックス区分化サービスに関するイベン
トをトレースします。
STORAGE
ストレージ管理サービスに関するイベントをトレースします。
SYSXCF トレースの要求の例
例 1: CTnXCFxx メンバー
このメンバーは STORAGE および SIGNAL オプションを要求しています。ま
た、このメンバーは、トレース・データの脱落を最小限に抑えるため、
NOWRAP オプションを指定して外部書き出しプログラム WTRDASD1 を開始
し、トレースを外部書き出しプログラムに接続します。
TRACEOPTS
WTRSTART(WTDASD1) NOWRAP
ON
WTR(WTDASD1)
OPTIONS(’STORAGE’,’SIGNAL’)
例 2: TRACE コマンド
この例は、例 1 と同じトレースを要求します。
trace ct,wrtstart=wtdasd1
trace ct,on,comp=sysxcf
* 62 ITT006A ...
r 62,wtr=wtdasd1,options=(storage,signal),end
SYSXCF トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSXCF) サブコマンドを使
用して行います。このサブコマンドの OPTIONS パラメーターでは、フォーマット
設定するトレース・レコードを選択するためのオプションを指定します。ユーザー
が指定するフォーマット設定オプションは、要求されたトレース・オプションに応
じて大きく異なります。オプションを使用して表示されるレコードの範囲を狭くし
て、エラーを見付けやすくしてください。CTRACE サブコマンドでオプションをな
にも指定しなかった場合、IPCS はすべてのトレース・レコードを表示します。
これらのオプションは以下のとおりです。
ARM
自動再始動管理サービスに関するトレース・レコードをフォーマット設定しま
す。
11-162
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
CFRM
カップリング・ファシリティー・リソース管理サービスのトレース・レコードを
フォーマット設定します。
GROUP
XCF サービスとの結合または関連解除を行うグループなどの、XCF グループ・
サービスに関するトレース・レコードをフォーマット設定します。
SERIAL
逐次化サービスのトレース・レコードをフォーマット設定します。
SFM
シスプレックス障害管理サービスのトレース・レコードをフォーマット設定しま
す。
SIGNAL
信号サービス処理のトレース・レコードをフォーマット設定します。
STATUS
XCF モニター・サービスおよびシスプレックス区分化サービスのトレース・レ
コードをフォーマット設定します。
STORAGE
ストレージ管理サービスのトレース・レコードをフォーマット設定します。
SYSXCF トレースからの出力
CTRACE COMP(SYSXCF) FULL サブコマンドの出力
CTRACE COMP(SYSXCF) FULL サブコマンドを指定してフォーマット設定された
SYSXCF コンポーネント・トレース・レコードの例を次に示します。
SYSXCF COMPONENT TRACE FULL FORMAT
**** 01/15/90
STORAGE 0F030001 21:01:30.893078 CROSS SYSTEM COUPLING FACILITY
00000000 00000004 00000000 | ................ |
00000000 00000000 | ................ |
00000000 00000000 | ................ |
00000000 0000
| ......
|
SIGNAL
08560000 21:01:30.941115 CROSS SYSTEM COUPLING FACILITY
01000000 08018000 826445C0 C9D5C9E3 | ........b..{INIT |
40404040 00000000 00000000 |
............ |
00000000 7F68A810 00000000 | ....".y......... |
00000000 0000
| ......
|
.
.
.
第 11 章 コンポーネント・トレース
11-163
コンポーネント・トレース
SYSXES コンポーネント・トレース
このコンポーネント・トレースを使用する前に
このトピックでは、読者が以下の部分をお読みになっていることを想定してい
ます。
v 11-3 ページの『コンポーネント・トレースの計画』
v 11-12 ページの『コンポーネント・トレースの獲得』
v 11-28 ページの『コンポーネント・トレース・データの表示』
以下に、システム間拡張サービス (XES) 用の SYSXES コンポーネント・トレース
を要求するための情報を要約します。
情報
SYSXES の場合
parmlib メンバー
CTnXESxx
デフォルト・メンバー: COUPLE00 メンバーで指定さ
れた CTIXES00
デフォルトのトレース
あり。最小限。予期しないイベントが対象。
トレース要求の OPTIONS パラメー CTnXESxx または TRACE コマンドの REPLY で指
ター
定
バッファー
v デフォルト: 168KB
v 範囲: 16KB - 16MB
v サイズの設定: CTnXESxx メンバー、または
TRACE CT コマンドによる。
v IPL 後のサイズ変更: 可能
v 場所: データ・スペース内。DUMP コマンドに対す
る REPLY で SDATA=XESDATA および
DSPNAME=(asid.IXLCTCAD) を指定する (asid は
アドレス・スペース XCFAS の ASID)。
トレース・レコードの場所
データ・スペース・バッファー、トレース・データ・
セット
SVC ダンプの要求
DUMP または SLIP コマンドによって行う
IPCS によるトレース・フォーマッ
ト設定
CTRACE COMP(SYSXES)
トレース・フォーマット設定の
OPTIONS パラメーター
はい
SYSXES はサブレベル・トレースをサポートします。トレース・オプションはトレ
ース・レベルの階層を介して継承されます。サブレベルを指定しないでトレース・
オプションを設定した場合、そのオプションは階層の最高レベル (すなわちヘッド)
に適用されます。サブレベルは、そのサブレベルに関して明示的にオプションが指
定されている場合を除き、それよりも 1 つ上のレベルからトレース・オプションを
継承します。あるサブレベルに関するトレース・オプションを設定すると、そのオ
プションは、階層内のそのサブレベルよりも下位のレベルに属するすべてのサブレ
ベルにも継承されます。
11-164
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
図 11-10 は、SYSXES トレースの階層構造を示しています。
┌─────────────────┐
│SYSXES ヘッド
│
┌─────────┤
オプション
├─────────┐
│
└─────────────────┘
│
┌────────────────┐
┌──────────────────────┐
│
│
│
│
│
GLOBAL
│
┌──────┤
STRUCTURE
│
│ サブレベル
│
│
│
サブレベル
│
│
│
│
│
│
└────────────────┘
│
└────────────┬─────────┘
|
│
│
|
|
┌─────────┐
┌──────────────────────┐
|
│
│
│
│
|
│ ADDRESS │
│
ADDRESS SPACE
│
|
│ SPACE │
│
サブレベル
├──────────┐
|
│
│
│
│
│
|
└────┬────┘
└───────────┬──────────┘
│
|
│
│
│
|
|
┌───────────┐
┌────────────────────┐
┌───────────┐
|
│
│
│
│
│
│
|
│ コネクター│
│
接続 │
│ コネクター│
|
│
│
│
サブレベル
│
│
│
|
│
│
│
│
│
│
|
└───────────┘
└────────────────────┘
└───────────┘
|
|
|
|
|
|
非コネクション
接続
トレース
トレース
図 11-10. SYSXES SUB トレースの構造
次の 2 つのクラスのサブレベル・トレースがヘッド・トレース・オプションを継承
します。
v グローバル・サブレベル・トレースは固有のトレース・バッファーをもち、特定
の接続と関連していないトレースを制御します。SUB=(GLOBAL) を指定して
GLOBAL トレースを要求してください。
v 接続サブレベルは特定の接続に関するトレースを制御します。各接続は固有のト
レース・バッファーをもちます。接続サブレベルは次の項目にもとづいて階層的
にフィルター操作されます。
1. システムが接続されているカップリング・ファシリティー構造の構造名
(STRNAME)
2. 接続を行ったアドレス・スペースのアドレス・スペース ID (ASID)
3. トレース要求の対象となる特定コネクターの接続名 (CONNAME)
したがって、特定の構造名に関して指定されたオプションは、その構造体に接続
されたアドレス・スペースによってしか継承されません。特定のアドレス・スペ
ースに関して指定されたオプションは、そのアドレス・スペースを介して接続さ
れる接続によってしか継承されません。
必要な特殊性に応じて、SUB=(strname)、SUB=(strname.asid)、または
SUB=(strname.asid.conname) を指定してください。asid を指定しないで
conname を指定してはなりません。また、strname を指定しないで asid を指
第 11 章 コンポーネント・トレース
11-165
コンポーネント・トレース
定してはなりません。SUB オプションに構造体名またはコネクター名を指定する
とき、その名前に特殊文字が含まれている場合には、引用符で囲む必要がありま
す。引用符で囲む場合、大文字と小文字は同じではありません。したがって、大
文字小文字についての情報は重要であり、システムが使用する名前と完全に一致
する必要があります。引用符で囲むと、大文字小文字の区別をすることが必要に
なります。
SYSXES トレースの要求
SYSXES コンポーネント・トレースを要求するオプションは、CTnXESxx parmlib
メンバーまたは TRACE CT コマンドに対する応答で指定してください。
CTnXESxx parmlib メンバー
次の表は、CTnXESxx parmlib メンバーで指定できるパラメーターを示しています。
パラメーター
CTnXESxx で指定可能かどうか
ON または OFF
はい
ASID
いいえ
JOBNAME
いいえ
BUFSIZE
はい
OPTIONS
はい
SUB
サブレベル・トレースの場合にだけ可能
PRESET
サブレベル・トレースの場合にだけ可能
LIKEHEAD
いいえ
WTR
はい
WTRSTART または WTRSTOP
はい
注: バッファー・サイズは、IPL 時に使用される parmlib メンバーで指定しなけれ
ばなりません。このバッファー・サイズは、TRACE コマンドまたはシステムの
実行中に活動化された parmlib メンバーにより修正することができます。
バッファー・サイズの設定: トレース・バッファーのサイズを選択する際には、以
下のことを考慮してください。
v 外部書き出しプログラムを使用している場合は、トレース・バッファーを小さく
することができます。これは、バッファー折り返しが問題にならなくなるためで
す。
v 問題の再現を行う場合は、バッファー・サイズをまず大きくしてください。
v SYSXES には、指定されたサイズのトレース・バッファーが コネクター当り 1
つ、さらにグローバル・トレース用に 1 つあります。システムで多数のコネクタ
ーを使用する場合には、使用されるストレージの量が重要な意味をもつことがあ
ります。また、トレース・バッファーは単一の共通域データ・スペース (CADS)
から割り振られます。 CADS 全体を使いきった場合には、バッファー・スペース
が利用不能となり、後続の接続はトレースされません。
v SYSXES トレース・バッファーは使用不能参照 (DREF) データ・スペース・スト
レージに入っているため、ストレージの制約によってバッファー・サイズが制限
されることがあります。
11-166
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
バッファー・サイズの変更: トレースの実行中にトレース・バッファーのサイズ変
更する場合は、TRACE CT コマンドを発行するか、違う CTnXESxx parmlib メン
バーを活動化してください。これらの方法を使用して階層中の SUB レベルを変更
し、違う SUB トレースが異なるサイズのバッファーを使用できるようにすること
ができます。SYSXES GLOBAL サブ・バッファー・サイズは、システムによって
16MB に設定されます。 このデフォルト値はオーバーライドできません。
TRACE および REPLY コマンド
次の表は、TRACE CT コマンドおよび REPLY で指定できるパラメーターを示して
います。
パラメーター
トレース用の TRACE CT で
指定可能かどうか
ON または OFF
1 つ必要
nnnnK または nnnnM
はい
COMP
必須
SUB
はい
PARM
はい
パラメーター
書き出しプログラム用の TRACE CT で
指定可能かどうか
WTRSTART または WTRSTOP
書き出しプログラムが使用されている場合、
1 つ必要
パラメーター
トレース用の REPLY で指定可能かどうか
ASID
いいえ
JOBNAME
いいえ
OPTIONS
はい
WTR
はい
OPTIONS パラメーター
CTnXESxx parmlib メンバーおよび TRACE コマンドの応答で指定する OPTIONS
パラメーターの値を、以下に英字順で示します。
ALL
すべてのオプションに関してリストされたイベントをトレースします。
CONFIG
パスの追加または除去などの、カップリング・ファシリティーへの接続性の状態
の変化をトレースします。
CONNECT
XES リソースに対する接続または切断を行うシステムおよびサブシステム・コ
ンポーネントおよび出口処理に関するイベントをトレースします。
HWLAYER
カップリング・ファシリティーとの通信を取り扱う XES サービスに関するイベ
ントをトレースします。
第 11 章 コンポーネント・トレース
11-167
コンポーネント・トレース
LOCKMGR
リソースのグローバル管理およびグローバル管理関連出口に関するイベントをト
レースします。
RECOVERY
XES リソース・アクセス障害を取り扱うモジュール内の、リソース割り振りと
メインライン・コマンド処理の両方に関するイベントをトレースします。このオ
プションを指定すると、デフォルトを指定した場合よりも詳細な情報が提供され
ます。
REQUEST
XES メインライン・サービスを介してデータにアクセスするための要求に関す
るイベントをトレースします。
SIGNAL
XES 内部信号に関連するイベントをトレースします。
STORAGE
XES 制御ブロックの管理に関連するイベントをトレースします。
SYSXES トレースの要求の例
例 1: CTnXESxx メンバー
このメンバーは HWLAYER、LOCKMGR、CONNECT、および REQUEST ト
レース・イベントに関するトレース、および 100KB のバッファー・サイズを
要求します。
TRACEOPTS
ON
OPTIONS(’HWLAYER’,’LOCKMGR’,’CONNECT’,’REQUEST’)
BUFSIZE(100K)
例 2: TRACE コマンド
この例では、構造体 STR3 に関する ASID 5 における接続 CON3 について、
CONNECT、CONFIG、および STORAGE トレース・イベントのトレースを要
求します。
trace ct,on,comp=sysxes,sub=(str3.asid(5).con3)
* 17 ITT006A ...
reply 17,options=(connect,config,storage),end
SYSXES トレースのフォーマット設定
トレースのフォーマット設定は IPCS CTRACE COMP(SYSXES) サブコマンドを使
用して行います。このサブコマンドの OPTIONS パラメーターでは、フォーマット
設定するトレース・レコードを選択するためのオプションを指定します。ユーザー
が指定するフォーマット設定オプションは、要求されたトレース・オプションに応
じて大きく異なります。オプションを使用して表示されるレコードの範囲を狭くし
て、エラーを見付けやすくしてください。CTRACE サブコマンドでオプションをな
にも指定しなかった場合、IPCS はすべてのトレース・レコードを表示します。
11-168
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース
ALL
すべてのトレース・レコードをフォーマット設定します。
CONFIG
カップリング・ファシリティーへの接続性の状態の変化をフォーマット設定しま
す。
CONNECT
XES リソースに対する接続または切断を行うシステムおよびサブシステム・コ
ンポーネントおよび出口処理に関するイベントをフォーマット設定します。
HWLAYER
カップリング・ファシリティーとの通信を取り扱う XES サービスに関するイベ
ントをフォーマット設定します。
LOCKMGR
リソースのグローバル管理およびグローバル管理関連出口に関するイベントをフ
ォーマット設定します。
RECOVERY
XES リソース・アクセス障害を取り扱うモジュール内のイベントをフォーマッ
ト設定します。
REQUEST
XES メインライン・サービスを介してデータをアクセスするための要求に関す
るイベントをフォーマット設定します。
SIGNAL
XES 内部信号に関連するイベントをフォーマット設定します。
STORAGE
XES 制御ブロックの管理に関連するイベントをフォーマット設定します。
CTRACE サブコマンドでは、SUB((subname.subname.subname)) パラメーターによっ
てサブレベル・トレースが指定されます。subname は以下のとおりです。
v 特定の接続に関連していないイベントの場合には GLOBAL。
v 特定のコネクターに関連したイベントの場合には strname.asid.conname。接続
に関連するサブレベルの場合の subname には、最大 3 つまでの部分が含まれま
す。
– 構造体を表す strname
– アドレス・スペース ID (ASID) を表す asid
– asid が指定されている場合には、接続名を表す conname
QUERY オプションはどのサブレベル指定も有効です。たとえば、次のように指定
できます。
SUB(STR3)
SUB(STR3.ASID(5))
COMP パラメーターを指定した場合には、GLOBAL および完全修飾された接続サ
ブレベル指定子だけが有効です。たとえば、次のように指定できます。
SUB(GLOBAL)
SUB(STR3.ASID(5).CON3)
第 11 章 コンポーネント・トレース
11-169
コンポーネント・トレース
SYSXES トレースからの出力
CTRACE COMP(SYSXES) SHORT サブコマンドの出力
下記のサブコマンドを指定してフォーマット設定された SYSXES コンポーネント・
トレース・レコードの例を次に示します。
CTRACE COMP(SYSXES) SUB((GLOBAL)) SHORT OPTIONS((CONNECT,HWLAYER))
COMPONENT TRACE SHORT FORMAT
COMP(SYSXES) SUBNAME((GLOBAL))
**** 10/20/93
11-170
MNEMONIC
--------
ENTRY ID
--------
TIME STAMP
---------------
DESCRIPTION
-----------
HWLAYER
HWLAYER
HWLAYER
CONNECT
HWLAYER
HWLAYER
HWLAYER
HWLAYER
CONNECT
CONNECT
HWLAYER
090C0002
07140001
07140002
08190001
090C0001
09030001
09080001
09080003
08110001
08110004
09080004
20:47:22.096016
20:47:22.096296
20:47:22.096429
20:47:30.171676
20:47:30.171718
20:47:30.171758
20:47:30.171779
20:47:30.171804
20:47:30.172316
20:47:30.172476
20:47:30.180754
EXIT FROM IXLMLTAM
ENTRY TO IXLERTRR
EXIT FROM IXLERTRR
CONNECTOR DIE ROUTINE
ENTRY TO IXLMLTAM
ENTRY TO IXLMLXRB
ENTRY TO IXLM2SR START IMMED RE
ISSUING A SMSG COMMAND
MAINLINE TIMER EXIT ENTERED
MAINLINE TIMER EXITED
COMPLETION OF A SMSG COMMAND
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 12 章 トランザクション・トレース
トランザクション・トレースでは、複数システム・アプリケーション環境で実行す
るアプリケーション・タイプまたはトランザクション・タイプの作業単位 の実行パ
スについてキー・イベントを統合トレースできます。単一のシステムにおいて、ま
たは (もっと重要であるが) シスプレックス環境でのシステム間で実行する作業単位
(これは、複数システム・トランザクション・サーバー、サブシステム・インターフ
ェース、およびリソース・マネージャーによって処理される) のパスをトレースす
ることによって、トランザクション・トレースはシステム・プログラマーがこのよ
うな環境で問題をデバッグできるようにします。
トランザクション・トレースの非常に重要なタスクは、トランザクションにサービ
スを提供するために結合された、シスプレックスにおけるコンポーネント間の作業
のフローを示すデータを集約することです。トランザクション・トレースは、コン
ポーネントの入り口、出口、例外などのイベントおよび COMMIT や ROLLBACK
などの主なイベントをトレースします。トランザクション・トレースは、コンポー
ネント・トレース機能として使用しないでください。
以下のトピックで、トランザクション・トレースについて詳しく説明します。
v 『トランザクション・トレースの作動方法』
v
12-2 ページの『トランザクション・トレースのコマンド』
v
12-5 ページの『トランザクション・トレース出力を表示するための IPCS の使
用』
トランザクション・トレースの作動方法
トランザクション・トレース (TTrace) は、マスター・スケジューラーの初期設定が
完了した後で、システム・トレース・アドレス・スペースに子タスクとして付加さ
れます。初期設定が完了して、トレースする作業単位の属性を指定するフィルター
を使用した最初のトランザクション・トレースのコマンドが入力されると、トラン
ザクション・トレースはアクティブにされます。外部書き出しプログラムの使用な
どの追加の情報も、トランザクション・トレース処理に使用することができます。
トランザクション・トレースをアクティブにすると、WLM Classify は、現在の作業
単位をトレースする必要があるかどうかを判別するために、フィルター出口を呼び
出します。作業単位の属性をコマンドのフィルター属性と比較して、トレースを行
うかどうかを判別します。トレースが必要な場合には、ゼロ以外のトークンを作成
して Classify の呼び出し元に戻します。その作業単位に対してトレースが実行され
ない場合は、トランザクション・トレース・トークンをゼロに設定します。呼び出
し元 (たとえば、CICS または IMS) は、サービス・クラス・トークンの伝搬と同じ
方法で、トークンを伝搬します。
次に、トランザクション・トレース・マクロは、
v トレースを行うことができるかどうかを判別する (ITZQUERY)
v トランザクション・トレース・レコードの書き込みを開始する (ITZEVENT)
© Copyright IBM Corp. 1988, 2008
12-1
トランザクション・トレース
トランザクション・トレースは、トレース・アドレス・スペース内のトランザクシ
ョン・トレース・データ・スペースにトレース・データを書き込みます。外部書き
出しプログラムが定義されると、レコードは外部書き出しプログラムにも書き出さ
れます。対話式問題管理システム (IPCS) を使用して、トランザクション・トレー
ス・レコードを表示します。
トランザクション・トレースのコマンド
トランザクション・トレースで、以下のコマンドを使用します。
v TRACE TT
v DISPLAY TRACE,TT
トランザクション・トレースで TRACE または DISPLAY TRACE コマンドを使用
する方法については、「z/OS MVS システム・コマンド」を参照してください。
TRACE TT コマンド
トランザクション・トレースは、TT キーワードを指定した MVS TRACE コマンド
を使用して、以下を行います。
v トランザクション・トレースを開始する。
v トレース・フィルター・セットを追加する。
v アクティブなトレース・フィルター・セットを除去する。
v トランザクション・トレースを停止する。
v CTRACE 外部書き出しプログラムを開始する。
v CTRACE 外部書き出しプログラムを停止する。
v トランザクション・トレースのバッファー・サイズを変更する。
v レベル標識を指定する。
v 潜在するトランザクションをトレースする必要があるかどうかを指定する。
トランザクション・トレースの開始
トランザクション・トレースは、フィルター情報を指定して TRACE TT コマンド
を発行すると、開始します。ユーザー ID TESTERP1 およびトランザクション名
TRAN1 を使用して設定したトランザクション・トレース・フィルターを定義する例
を次に示します。
trace tt,user=testerp1,tran=tran1
ITZ002I ’BUFSIZ’ IS SET TO 0001M
ITZ001I TRANSACTION TRACE IS NOW ACTIVE WITH FILTER SET 01
複数のフィルター・キーワードを指定するとき、上記の例にあるように、「論理
AND」を使用して、トランザクションをトレースする必要があるかどうかを判別し
ます。
トレース・フィルター・セットの追加
最高 5 つのトランザクション・トレース・フィルター・セットを同時にアクティブ
にすることができます。これらは、フィルター情報を指定して TRACE TT コマン
ドを発行すると、アクティブにされます。次の例のコマンドは、ユーザー ID
DONNA* を指定して追加のトランザクション・トレース・フィルター・セットを定
12-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
トランザクション・トレース
義します。最後の文字の位置にアスタリスク (*) を使用するのは、ワイルドカード
が定義されていることを示します。トランザクション・トレース・トークンを作成
するかどうかを判別するとき、DONNA という接頭部をもつユーザー ID があれ
ば、一致することになります。
trace tt,user=donna*
ITZ001I TRANSACTION TRACE IS NOW ACTIVE WITH FILTER SET 02
複数のフィルター・セットを指定する場合、「論理 OR」をフィルター・セットの
間で使用して、トランザクションをトレースする必要があるかどうかを判別しま
す。
アクティブなトレース・フィルター・セットの除去
トランザクション・トレース・フィルター・セットは、OFF=x キーワードを使用す
ると、除去されます。例:
trace tt,off=2
ITZ016I TRANSACTION TRACE FILTER SET TURNED OFF
上の例は、トランザクション・トレース・フィルター・セット 02 がオフにされた
ことを示します。
トランザクション・トレースの停止
トランザクション・トレースを停止するには、OFF=ALL キーワードを使用しま
す。例:
trace tt,off=all
ITZ007I TRANSACTION TRACE IS NO LONGER ACTIVE.
A DUMP COMMAND MAY BE ISSUED TO DUMP THE TRANSACTION TRACE
DATA SPACE.
トランザクション・トレース・データ・スペースをダンプするには、DUMP コマン
ドを使用します。例:
DUMP COMM=(TTrace for TRAN=ATM1)
R x,DSPNAME=’TRACE’.SYSTTRC
CTRACE 外部書き出しプログラムの開始
トランザクション・トレースは、トランザクション・トレース・レコードの処理の
ための外部書き出しプログラムの使用をサポートします。外部書き出しプログラム
は、トランザクション・トレースをアクティブにする最初のコマンドに指定する
か、またはトランザクション・トレースがアクティブである間に単独で指定できま
す。例:
trace tt,wtr=abcdefg
コンポーネント・トレースのメッセージが、このコマンドに応答して発行されま
す。
CTRACE 外部書き出しプログラムの停止
トランザクション・トレースの外部書き出しプログラムの処理は、WTR=OFF キー
ワードを使用して停止できます。例:
trace tt,wtr=off
第 12 章 トランザクション・トレース
12-3
トランザクション・トレース
コンポーネント・トレースのメッセージが、このコマンドに応答して発行されま
す。
データ・スペース・サイズの変更
トランザクション・トレース TTRACE TT コマンドを使用すると、トランザクショ
ン・トレースのデータ・スペースのサイズを変更できます。データ・スペースは、
16K から 999K まで、または 1M から 32M までです。例:
trace tt,bufsiz=2m
ITZ002I ’BUFSIZ’ IS SET TO 0002M
レベル標識の指定
トランザクション・トレース TTRACE TT コマンドを使用すると、フィルター・セ
ットごとにレベル標識を定義できます。
v 1 は、コンポーネントの入り口、出口、例外、および主なイベントに関連してい
ます。
v 2 は、コンポーネントの外部によって制御される詳細に関連しています。
デフォルトは 2 です。例:
trace tt,bufsiz=2m,user=testerp1,tran=tran1,lvl=01
ITZ002I ’BUFSIZ’ IS SET TO 0002M
ITZ001I TRANSACTION TRACE IS NOW ACTIVE WITH FILTER SET 01
潜在するトランザクションのトレース
トランザクション・トレース TTRACE TT コマンドを使用して、潜在するトランザ
クションをトレースするかどうかを指定します。デフォルトは、潜在処理をトレー
スすることです。何を指定するかを決定する際には以下を考慮してください。
v トランザクションは現在システム内でアクティブであること。
v トランザクションはトレースのマークが付けられていること。
v トレースに適格であるとトランザクションにマーク付けするために使用されたフ
ィルター・セットはアクティブでなくなっていること。
次に例を示します。
trace tt,latent=no
ITZ002I ’LATENT’ IS SET TO NO
DISPLAY TRACE,TT
DISPLAY TRACE コマンドの TT キーワードを使用して、トランザクション・トレ
ースの状況を判別します。トランザクション・トレースの状況を照会するために、
コンポーネント・トレースの表示コマンドを使用しないでください。 TRACE TT
コマンドに指定した表示情報に加えて、DISPLAY TRACE,TT の応答は、トランザ
クション・トレースのシスプレックス処理に関係しているシステムのリストも表示
します。
DISPLAY TRACE,TT コマンドの応答の例を次に示します。
IEE843I 14.47.19 TRACE DISPLAY
SYSTEM STATUS INFORMATION
ST=(ON,0064K,00064K) AS=ON BR=OFF EX=ON
MT=(ON,024K)
--------------------------------------------------------------
12-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
トランザクション・トレース
TRANSACTION TRACE STATUS: ON
BUFSIZ= 0002M
WRITER= *NONE*
LATENT= YES
01: TRAN= TRAN1
USER= TESTERP1
LVL = 001
02: USER=DONNA*
LVL = 002
SYSTEMS PARTICIPATING IN TT: SYS1
SYS2
SYS3
トランザクション・トレース出力を表示するための IPCS の使用
IPCS サブコマンド CTRACE COMP(SYSTTRC) を使用して、トランザクション・
トレースのレコードを表示します。シスプレックス TTrace ストリームを取得する
ためには、IPCS MERGE サブコマンドを使用して、複数の入力データ・セットから
の TTrace レコードをフォーマット設定してください。 TTrace レコードに埋め込ま
れた汎用トレース機能 (GTF) レコードがある場合、そのレコードは上記のコマンド
に追加キーワードを指定しなくても、処理されます。
IPCS CTRACE COMP(SYSTTRC) の例
短い IPCS CTRACE COMP(SYSTTRC) SHORT コマンドの応答の例を次に示しま
す。
ctrace comp(systtrc) short
COMPONENT TRACE SHORT FORMAT
COMP(SYSTTRC)
**** 09/23/1999
SYSNAME
MNEMONIC ENTRY ID
-------------- --------
TIME STAMP
---------------
DESCRIPTION
----------
SY1
TTCMD
00000002
14:17:20.833847
TRACE TT Command
SY1
TTCMD
00000002
14:18:11.611755
TRACE TT Command
SY1
EVENT
00000003
14:31:55.813125
TRACE EVENT
SY1
EVENT
00000003
14:31:55.899216
TRACE EVENT
SY1
EVENTU
00000005
14:31:56.378480
TRACE EVENT with User
Data
SY1
EVENTG
00000004
14:31:56.818367
TRACE EVENT with GTF
Data
IPCS CTRACE COMP(SYSTTRC) LONG コマンドの応答の例を次に示します。
ctrace comp(systtrc) full
COMPONENT TRACE FULL FORMAT
COMP(SYSTTRC)
**** 09/23/1999
SYSNAME
MNEMONIC ENTRY ID TIME STAMP
DESCRIPTION
-------------- -------- --------------- ---------SY1
TTCMD
00000002 14:17:20.833847 TRACE TT Command
CMDID.....0501
COMMAND...TRACE TT,BUFSIZ=2M,USER=TESTERP1,TRAN=TRAN1,
LVL=01
SY1
TTCMD
00000002 14:18:11.611755
CMDID.....0402
COMMAND...TRACE TT,USER=DONNA*
TRACE TT Command
SY1
TRACE EVENT
EVENT
00000003
14:31:55.813125
COMPONENT..COMP
EVENTDESC..TTVAPIEA008
FUNCTION...TEST_ITZEVENT_WITH_FUNCTIONNAME.
ASID..0022
CMDID.....0501
TCB...007ED9C8
第 12 章 トランザクション・トレース
12-5
トランザクション・トレース
TRACETOKEN..SY1
SY1
EVENT
B2E447A3
00000003
F32E4048
05010100
14:31:55.899216
00000000
TRACE EVENT
COMPONENT..COMP
EVENTDESC..TTVAPIEA009
CMDID.....0000
FUNCTION................................... TCB...007ED7A8
ASID..0022
TRACETOKEN..
40404040 40404040 40404040 40404040
LATENT workunit traced.
SY1
EVENTU
00000005
14:31:56.378480
TRACE EVENT with User
Data
COMPONENT..COMP
EVENTDESC..TTVAPIEA003
CMDID.....0501
FUNCTION................................... TCB...007ED148
ASID..0022
TRACETOKEN..SY1
B2E447A3 F5D056C1 0105FF00 00000000
+0000 E3C8C9E2 40C9E240 E3E340C4 C1E3C140 │ THIS IS TT DATA
+0010 C6D6D940 C140E3D9 C1D5E2C1 C3E3C9D6 │ FOR A TRANSACTIO
+0020 D540E3D9 C1C3C540 D9C5C3D6 D9C44BE3 │ N TRACE RECORD.T
+0030 C8C9E240 C9E240E3 E340C4C1 E3C140C6 │ HIS IS TT DATA F
+0040 D6D940C1 40E3D9C1 D5E2C1C3 E3C9D6D5 │ OR A TRANSACTION
+0050 40E3D9C1 C3C540D9 C5C3D6D9 C44B
│ TRACE RECORD.
SY1
EVENTG
00000004
14:31:56.818367
TRACE EVENT with GTF
Data
COMPONENT..COMP
EVENTDESC..TTVAPIEA004
CMDID.....0402
FUNCTION................................... TCB...007ED368
ASID..0022
TRACETOKEN..SY1
B2E447A3 F566F584 03030300 00000000
HEXFORMAT AID FF FID 00 EID E000
+0000 E3C8C9E2 40C9E240 C7E3C640 C4C1E3C1 │ THIS IS GTF DATA
+0010 40C6D6D9 40C140E3 D9C1D5E2 C1C3E3C9 │ FOR A TRANSACTI
+0020 D6D540E3 D9C1C3C5 40D9C5C3 D6D9C44B │ ON TRACE RECORD.
+0030 E3C8C9E2 40C9E240 C7E3C640 C4C1E3C1 │ THIS IS GTF DATA
+0040 40C6D6D9 40C140E3 D9C1D5E2 C1C3E3C9 │ FOR A TRANSACTI
+0050 D6D540E3 D9C1C3C5 40D9C5C3 D6D9C44B │ ON TRACE RECORD.
12-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
│
│
│
│
│
│
│
│
│
│
│
│
第 13 章 GETMAIN、 FREEMAIN、 STORAGE (GFS) トレー
ス
GFS トレースは、GETMAIN、FREEMAIN、または STORAGE マクロの使用に関す
る情報を収集する診断ツールです。GFS トレースを使用して、仮想記憶域の割り振
りを分析したり、大量に仮想記憶域を使用しているユーザーを識別したりできま
す。
GFS トレース・データ出力を獲得するには、汎用トレース機能 (GTF) を使用する
必要があります。
以下のトピックで、GFS トレースについて説明します。
v 『GFS トレースの開始および停止』
v
13-3 ページの『GFS トレース・データの受取』
v
13-4 ページの『定様式の GFS トレース出力』
v
13-5 ページの『不定様式 GFS トレース出力』
GFS トレースの開始および停止
以下の手順は、GFS トレースの要求方法を説明しています。
1. DIAGxx parmlib メンバーで VSM TRACE GETFREE パラメーターを ON に設
定して、 GFS トレース制御データを定義してください。
例: GFS トレースを開始するための DIAGxx parmlib メンバー
次の DIAGxx parmlib メンバーは GFS トレースを開始し、アドレス・ス
ペース 3、5、6、7、8、および 9 に入っている 24 バイト長の仮想記憶域
の獲得および解放を要求するようにトレース出力を限定します。
VSM TRACE GETFREE (ON)
ASID (3, 5-9)
LENGTH (24)
DATA (ALL)
注: IPCS GTFTRACE 出力をフォーマット設定したい場合は、DIAGxx parmlib
メンバーの DATA キーワード指定に TYPE および FLAGS データ項目を
含めてください。
これとは別に、GFS トレースの停止を定義した DIAGxx parmlib メンバーも必
要になります。5 (13-2 ページ)を参照してください。
2. DIAGxx parmlib メンバー内の定義を使用して GFS トレースを活動化するため
に、 SET DIAG=xx コマンドを入力するようにオペレーターに依頼してくださ
い。
3. GTF トレースを開始してください (マスター・コンソールから START
membername コマンドを入力するようにオペレーターに指示してください)。
membername はソース JCL を含むメンバー (カタログ式プロシージャーまたは
© Copyright IBM Corp. 1988, 2008
13-1
GETMAIN、FREEMAIN、STORAGE トレース
ジョブ) の名前です。GTF ユーザー・トレース・レコードをトレースするために
ユーザー・イベント ID X'F65' を指定するようにオペレーターに指示してくださ
い。
例: GFS データに関する GTF トレースの開始
次の例では、GTF トレース出力に GFS データを得るために、オペレータ
ーがカタログ式プロシージャー GTFPROC を指定して GTF トレースを開
始します。カタログ式プロシージャー GTFPROC の内容は次のとおりで
す。
//GTF
PROC MEMBER=GTFPROC
//* Starts GTF
//IEFPROC EXEC PGM=AHLGTF,REGION=32M,
// PARM=’MODE=EXT,DEBUG=NO,TIME=YES,BLOK=40K,SD=0K,SA=40K’
//IEFRDER DD DSN=D31POOL.PJREDGTF.TRACE,
//
DISP=SHR,UNIT=3380,VOL=SER=CTDSD1
そのあとでオペレーターは、メッセージ AHL100A に応答して USRP オプショ
ンを入力します。オペレーターは、オプション USRP のキーワードを入力する
ようにメッセージ AHL101A によってプロンプト指示されたときに、GTF トレ
ース出力に GFS ユーザー・トレース・レコードを出力するために USR=(F65)
で応答します。
START GTFPROC
00 AHL100A SPECIFY TRACE OPTIONS
REPLY 00,TRACE=USRP
01 AHL101A SPECIFY TRACE EVENT KEYWORDS--USR=
REPLY 01,USR=(F65)
02 AHL102A CONTINUE TRACE DEFINITION OR REPLY END
REPLY 02 END
AHL103I TRACE OPTIONS SELECTED--USR=(F65)
03 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
REPLY 03,U
4. GTF トレースを停止するために、マスター・コンソールから STOP procname
コマンドを入力するようにオペレーターに指示してください。
5. GFS トレースを停止するために、VSM TRACE GETFREE(OFF) を指定した
DIAGxx parmlib メンバーを作成し、オペレーターに SET DIAG=xx コマンドの
入力を指示してください。
例: GFS トレースを停止するための DIAGxx parmlib メンバー
次の DIAGxx parmlib メンバーは GFS トレースを停止させます。
VSM TRACE GETFREE (OFF)
13-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
GETMAIN、FREEMAIN、STORAGE トレース
参照
v DIAGxx parmlib メンバーの構文については、「z/OS MVS 初期設定およびチュー
ニング 解説書」を参照してください。
v SET および START コマンドの構文については、「z/OS MVS システム・コマン
ド」を参照してください。
v GTF EID の指定方法については、 10-1 ページの『第 10 章 汎用トレース機能
(GTF)』を参照してください。
GFS トレース・データの受取
GTF は、GFS トレース・データをイベント ID が X'F65' のユーザー・トレース・
レコードに収めます。この GFS トレース・データを獲得するには、次のいずれか
の方法を使用してください。
v GTF がトレース・データをデータ・セットに書き込む場合には、IPCS
GTFTRACE サブコマンドを使用してトレース・データのフォーマット設定と印刷
を行います。
v GTF が GTF アドレス・スペースだけにトレース・データを書き込む場合には、
ダンプを使用してデータを調べてください。SDATA=TRT ダンプ・オプションを
使用してダンプ内の GTF トレース・データを要求してください。
v 不定様式ダンプ内のトレースをフォーマット設定して調べるには、IPCS
GTFTRACE サブコマンドを発行してください。
参照
GTFTRACE サブコマンドについては、「z/OS MVS IPCS コマンド」を参照してく
ださい。
第 13 章 GETMAIN、 FREEMAIN、 STORAGE (GFS) トレース
13-3
GETMAIN、FREEMAIN、STORAGE トレース
定様式の GFS トレース出力
例: 定様式 GFS トレース出力
READY
IPCS NOPARM
IPCS
DROPD DA(’D10JHM1.VSMNEW.GTF’)
BLS18206I All records for 1 dump dropped
IPCS
SETD NOCONFIRM
IPCS
GTFTRACE DA(’D10JHM1.VSMNEW.GTF’) USR(F65)
IKJ56650I TIME-03:42:20 PM. CPU-00:00:01 SERVICE-52291 SESSION-00:00:20 JANUARY 22,1998
BLS18122I Initialization in progress for DSNAME(’D10JHM1.VSMNEW.GTF’)
IKJ56650I TIME-03:42:21 PM. CPU-00:00:01 SERVICE-54062 SESSION-00:00:20 JANUARY 22,1998
**** GTFTRACE DISPLAY OPTIONS IN EFFECT ****
USR=SEL
**** GTF DATA COLLECTION OPTIONS IN EFFECT: ****
USRP option
**** GTF TRACING ENVIRONMENT ****
Release: SP6.0.6
FMID: HBB6606
System name: CMN
CPU Model: 9672 Version: FF Serial no. 270067
USRDA F65 ASCB 00FA0800
JOBN GTFJM2
Getmain SVC(120) Cond=Yes
Loc=(Below,Below) Bndry=Dblwd
Return address=849CA064 Asid=001A Jobname=GTFJM2
Subpool=229 Key=0 Asid=001A Jobname=GTFJM2
TCB=008DCA70 Retcode=0
Storage address=008D6768 Length=10392 X’2898’
GPR Values
0-3 00002898 00000000 7FFFC918 0B601E88
4-7 01FE3240 008FF830 849CA000 00FA0800
8-11 00000000 00000DE8 049CBFFE 849CA000
12-15 049CAFFF 0B601A9C 00FE9500 0000E510
GMT-01/06/1998 21:15:43.111628
LOC-01/06/1998 21:15:43.111628
.
.
.
USRDA F65 ASCB 00FA0800
JOBN GTFJM2
Freemain SVC(120) Cond=No
Return address=8B2D608A Asid=001A Jobname=GTFJM2
Subpool=230 Key=0 Asid=001A Jobname=GTFJM2
TCB=008DCA70
Storage address=7F73DFF8 Length=8 X’8’
GPR Values
0-3 00000000 7F73DFF8 008D82D8 008D7BC0
4-7 008D8958 008D6B08 008D85C8 0B335000
8-11 00000002 00000000 7F73DFF8 008D862C
12-15 8B2D6044 008D8C98 849D242A 0000E603
GMT-01/06/1998 21:15:43.111984
IPCS
SETD
IPCS
END
READY
END
13-4
Retcode=0
LOC-01/06/1998 21:15:43.111984
CONFIRM
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
GETMAIN、FREEMAIN、STORAGE トレース
GETMAIN / FREEMAIN / STORAGE トレースは、少し異なるフォーマットをもつ
2 番目のタイプのレコードを作り出します。このレコード・タイプの例を次に示し
ます。
USRDA F65 ASCB 00F4C280
JOBN IYCSCTS6
Releasing Subpool=230 Key=1 Asid=003E TCB=008B11E0
Storage address=7F653E00 Length=512 X’200’
このタイプのレコードは、戻りアドレスをトレースしないため、独特です。このレ
コードは、個々のストレージ域がサブプール FREEMAIN 要求の中で FREEMAIN
されるときはいつでも、書き込まれます。これらのレコードが多く続いている場合
があります。一連のレコードの最後のレコードには、サブプール FREEMAIN 要求
を示すレコードが続きます。このレコードには、サブプール FREEMAIN の発行者
の戻りアドレスが含まれています。
不定様式 GFS トレース出力
このトピックでは、GTF が出力を書き込むトレース・データ・セットで表示される
不定様式 GFS トレース出力を示しています。この情報を使用して、ユーザー独自
のフォーマット設定ルーチンまたは分析ルーチンを作成できます。
Unformatted GFS Trace Output
Part 1 - This part is in every GFS trace entry.
Offset Length Description
--------------------------------------------------------------------0
1
Flags
X’80’ - Common storage
X’40’ - Caller’s registers are traced
X’20’ - This is a subpool release range entry
X’10’ - Copy of VSWKOWNINFO
--------------------------------------------------------------------1
1
Actual subpool after translation
--------------------------------------------------------------------2
2
ASID which owns the storage
--------------------------------------------------------------------4
4
Address of storage area
--------------------------------------------------------------------8
4
Actual length of storage area
--------------------------------------------------------------------C
4
Address of TCB
--------------------------------------------------------------------10
1
Copy of VSWKSKEY
--------------------------------------------------------------------11
1
Copy of VSWKRC
--------------------------------------------------------------------12
1
Modification level number X’01’ - HBB6606
X’02’ - HBB7703
X’03’ - HBB7730
--------------------------------------------------------------------13
1
Reserved
--------------------------------------------------------------------14
2
Offset of Part 2
--------------------------------------------------------------------16
2
Offset of Part 3
---------------------------------------------------------------------
図 13-1. GFS トレース出力のレイアウト (1/2)
第 13 章 GETMAIN、 FREEMAIN、 STORAGE (GFS) トレース
13-5
GETMAIN、FREEMAIN、STORAGE トレース
Part 2 - This part is in every GRS trace entry except for subpool
release range entries.
Offset Length Description
--------------------------------------------------------------------0
4
Caller’s return address
--------------------------------------------------------------------4
4
Minimum length for a variable request
--------------------------------------------------------------------8
4
Maximum length for a variable request
--------------------------------------------------------------------C
8
Name of job which owns the storage
--------------------------------------------------------------------14
8
Name of job which contained the program which
requested the storage
--------------------------------------------------------------------1C
2
ASID which contained the program which
requested the storage
--------------------------------------------------------------------1E
1
Copy of VSWKESPL
--------------------------------------------------------------------1F
1
Copy of VSWKSVC
--------------------------------------------------------------------20
1
Copy of VSWKRFLG
--------------------------------------------------------------------21
1
Copy of VSWKPFLG
--------------------------------------------------------------------22
1
Copy of VSWKFLGS
--------------------------------------------------------------------23
1
Copy of VSWKRFLG2
--------------------------------------------------------------------24
4
Copy of VswkRetAddrHigh
--------------------------------------------------------------------28
4
Copy of VswkAR15Value
--------------------------------------------------------------------2C
4
Copy of VswkAR1Value
--------------------------------------------------------------------Part 3 - This part is in the GFS trace record if the caller’s
registers are traced.
Offset Length Description
--------------------------------------------------------------------0
X’40’ Caller’s registers 0-15
---------------------------------------------------------------------
図 13-1. GFS トレース出力のレイアウト (2/2)
注: IGVVSMWK マクロには、VSWK で始まるフィールド名が含まれています。
詳しい情報は、「z/OS MVS Data Areas, Vol 2 (DCCB-ITZYRETC)」を参照して
ください。
13-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 14 章 Logrec エラー・レコードの記録
エラーが発生すると、システムはそのエラーに関する情報を Logrec データ・セッ
トまたは Logrec ログ・ストリームに記録します。この情報により、すべてのハー
ドウェア障害、特定のソフトウェア・エラー、および特定のシステム状態のヒスト
リーが提供されます。 環境記録・編集・印刷プログラム (EREP) を使用して、以下
のことを行ってください。
v システム・レコードに関する報告書を印刷する
v システムのヒストリーを判別する
v 特定のエラーについて調べる
ソフトウェアおよびハードウェア情報の収集
ダンプが作成された時に、Logrec データ・セットまたは Logrec ログ・ストリーム
内のレコードを補足情報として使用してください。これらのレコード内の情報に
は、障害に関する症状データが提供し、問題判別のための適切な手掛かりを得るこ
とができます。
図 14-1 は、SYS1.LOGREC という名前の Logrec データ・セットに関するエラー処
理を示しています (この名前は Logrec データ・セットのデフォルト名です)。
図 14-1. Logrec エラー記録の概要
主要トピック
システムの設定により、エラーを Logrec データ・セットに記録することも、
Logrec ログ・ストリームに記録することもできます。このトピックでは、エラー・
レコードの収集方法を決定する前に各メディアに関して知っておく必要のある事項
について説明します。
© Copyright IBM Corp. 1988, 2008
14-1
Logrec エラー・レコードの記録
Logrec データ・セットまたは Logrec ログ・ストリームを使用するには、各デー
タ・セットまたはログ・ストリームを初期設定する方法、それらにシステム・イベ
ントを記録する方法、利用可能なときにデータを収集する方法、および EREP を介
して出力を解釈する方法について知っておく必要があります。このトピックでは、
以下の各タスクについて説明します。
v 『適切な Logrec 記録メディアの選択』
v
14-3 ページの『Logrec データ・セットの初期設定および再初期設定』
v
14-5 ページの『Logrec ログ・ストリームの定義』
v
14-8 ページの『エラー記録の内容』
v
14-11 ページの『Logrec データ・セットからの情報の入手』
v
14-15 ページの『Logrec ログ・ストリームからのレコードの入手』
v
14-22 ページの『Logrec 記録制御バッファーからの情報の入手』
v
14-24 ページの『ソフトウェア・レコードの解釈』
適切な Logrec 記録メディアの選択
ユーザーは、システムが Logrec エラー・レコードをどこに記録するのかを選択す
ることができます。システムがシスプレックス内にない場合、インストール・シス
テムはエラー・レコードを記録するために、個々のシステムに関連付けられた
Logrec データ・セットを使用することができます。インストール・システムでは、
Logrec データ・セットを使用するシステムを IPL する前に、Logrec データ・セッ
トを初期設定することにより、このタイプの記録方法を使用し続けるように選択で
きます。
ただし、シスプレックスの場合には、各システムが固有の Logrec データ・セット
を必要とするため、エラーが発生したときにはそれぞれの Logrec データ・セット
を調べる必要があります。
最大 32 個までの Logrec データ・セットを管理しなくても済むように、インスト
ール・システムでは 1 つのカップリング・ファシリティーの Logrec ログ・ストリ
ームを定義することもできます。カップリング・ファシリティーの Logrec ログ・
ストリームを使用すると、以下のことを行う必要がなくなります。
v IFCDIP00 を実行して複数の Logrec データ・セットを初期設定する。
v 全データ・セット条件または緊急データ・セット条件を処理する。
v Logrec データ・セットの日常的なオフロードをスケジューリングする。
v 複数のヒストリー・データ・セットを連結する。
v Logrec レコードを保存する。
参照
v 使用しているシステム用に Logrec データ・セットを初期設定したい場合には、
14-3 ページの『Logrec データ・セットの初期設定および再初期設定』を参照して
ください。
v 使用しているシステム用に Logrec ログ・ストリームを定義したい場合には、
14-5 ページの『Logrec ログ・ストリームの定義』を参照してください。
14-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
Logrec データ・セットの初期設定および再初期設定
Logrec データ・セットは、それを使用するシステムを IPL する前に初期設定する
必要があります。
訂正不能エラーが発生したときには、Logrec データ・セットを再初期設定してくだ
さい。 Logrec データ・セットがいっぱいになったり、いっぱいに近くなったりし
た場合には、 Logrec データ・セットをクリアしてください。
Logrec データ・セットを初期設定または再初期設定するには、保守援助機能
IFCDIP00 を使用してください。いっぱいになった Logrec データ・セットをクリア
するには、EREP を使用してください。IFCDIP00 は、Logrec データ・セット用の
ヘッダー・レコードおよびタイム・スタンプ・レコードを作成します。
注意 Logrec データ・セットは移動不能なデータ・セットです。 IPL 後にデフラ
グ・プログラムなどのプログラムを使用してこのデータ・セットを移動しようとす
ると、システムによるデータ・セットの読み取りと書き込みの両方が困難になりま
す。
Logrec データ・セットの初期設定
Logrec データ・セットが存在していない場合には、最初にそのデータ・セットを割
り振り、そのあとで初期設定を行う必要があります。(Logrec データ・セットの割り
振りまたは再割り振りを行った場合、新しく割り振られたデータ・セットは、ユー
ザーがそのデータ・セットを初期設定して、そのデータ・セットが使用されるシス
テムを IPL するまで使用されません。)
次の例は、既存の Logrec データ・セットをスクラッチおよびアンカタログし、新
しい Logrec データ・セットの割り振り、カタログ、および初期設定を行うジョブ
を示しています。(現在 Logrec データ・セットが存在していない場合には、ジョブ
の 2 番目のステップから開始してください。)
第 14 章 Logrec エラー・レコードの記録
14-3
Logrec エラー・レコードの記録
例: スペース割り振りの変更
次の JCL ステートメントを使用して、以下のことを行ってください。
v Logrec データ・セットを名前変更してください。たとえば、 SYS1.LOGREC を
SYS1.LOGREC.OLD に名前変更します。
v IFCDIP00 を使用して、新しいスペース仕様の新規 Logrec データ・セットの割り振りおよび初期設
定を行います。
//KATHYLR JOB (9999),’CREATE NEW LOGREC DS’,CLASS=A,MSGCLASS=X,
//
MSGLEVEL=(1,1),NOTIFY=KATHY
//*-----------------------------------------------------------------//* RENAME THE CURRENT LOGREC DATASET
//* UNCATLG SYS1.LOGREC SO THE NEW LOGREC CAN BE ALLOCATED ON
//* ANOTHER VOLUME, IF DESIRED
//*-----------------------------------------------------------------//RENAME
EXEC PGM=IEHPROGM
//M43RES
DD VOL=SER=M43RES,UNIT=3390,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSIN
DD *
RENAME DSNAME=SYS1.LOGREC,VOL=3390=M43RES,
NEWNAME=SYS1.LOGREC.OLD
UNCATLG DSNAME=SYS1.LOGREC
/*
//*-----------------------------------------------------------------//* CREATE THE NEW LOGREC DATASET AND INITIALIZE IT
//*-----------------------------------------------------------------//IFCDIP00 EXEC
PGM=IFCDIP00,COND=(0,LT)
//SERERDS DD DSN=SYS1.LOGREC,DISP=(,CATLG),
//
VOL=SER=M43RES,UNIT=SYSDA,SPACE=(CYL,3,,CONTIG)
/*
//
X
注: 上記の JCL を実行して、Logrec データ・セットがスクラッチされてから再割
り振りされるまでの間にエラーが発生した場合には、この Logrec データ・セッ
トを使用してシステムを IPL することはできません。
この問題を解決するには、次のいずれかの方法を使用してください。
v DFDSS スタンドアロン復元プログラムを使用して古い Logrec データ・セットを
復元してください。
v 別のシステムで、そのデータ・セットの再割り振りジョブを実行してください。
参照
v DFDSS 独立型復元プログラムについては、「z/OS DFSMS Storage Administration
Reference」を参照してください。
Logrec データ・セットの再初期設定
Logrec データ・セットがいっぱいになったとき、または訂正不能エラーが発生した
ときには、 Logrec データ・セットを再初期設定する必要があります。
このデータ・セットがいっぱいになった場合には、EREP を使用してデータをヒス
トリー・データ・セットに記録して、Logrec データ・セットを再初期設定してくだ
さい。
14-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
エラーが発生した場合には、JCL ステートメントを指定して IFCDIP00 を呼び出
し、既存の Logrec データ・セットを再初期設定してください。 IFCDIP00 は、デ
ータ・セット全体が使用可能であることを示すように Logrec データ・セットのヘ
ッダー・レコードをリセットし、タイム・スタンプ・レコードをクリアして 16 進
数のゼロにします。
EREP の使用法については、「EREP User’s Guide」を参照してください。
IFCDIP00 保守援助機能を使用して Logrec データ・セットを再初期設定する例を次
に示します。
例: Logrec データ・セットの再初期設定
以下の JCL ステートメントを使用します。
//INSERLOG JOB
//STEP1
EXEC PGM=IFCDIP00
//SERERDS
DD
DSNAME=SYS1.LOGREC,UNIT=3380,
//
VOL=SER=111111,DISP=(OLD,KEEP)
JOB ステートメントによってジョブが開始されます。ジョブ名 INSERLOG に
は意味はありません。
EXEC ステートメントは、プログラム名 (PGM=IFCDIP00) を指定します。
SERERDS DD ステートメントは、再初期設定される Logrec データ・セット
(この例では SYS1.LOGREC) を指定します。このデータ・セットは永続的に装
着されたボリューム (この例では VOL=SER=111111) になければなりません。
DDNAME は SERERDS でなければなりません。
Logrec ログ・ストリームの定義
Logrec ログ・ストリームを定義する前に、IFCDIP00 によって初期設定された
Logrec データ・セットを使用して IPL を行うことをお勧めします。データ・セッ
トを使用して IPL を行わない場合には、SETLOGRC コマンドを使用して Logrec
記録メディアを LOGSTREAM から DATASET に変更することはできません。
Logrec ログ・ストリームを使用するためには、まず、インストール・システムでシ
ステム・ロガー機能を使用できるように準備する必要があります。シスプレックス
の複数システムからデータをマージするため、LOGREC にカップリング・ファシリ
ティーのログ・ストリームの使用をお勧めします。
単一のシステム・シスプレックスの logrec レコードを取得するためには、全体とし
て単一システムになっているため、DASD-only ログ・ストリームを使用することも
できます。これは、シスプレックスごとに 1 つの logrec ログ・ストリームしかも
つことができないため、複数システムのシスプレックスではお勧めしないことに注
意してください。このことは、使用する logrec ログ・ストリームを DASD-only に
する場合、1 つのシステムしかログ・ストリームにアクセスできないことを意味し
ます。 DASD-only ログ・ストリームについては、「z/OS MVS シスプレックスのセ
ットアップ 」の「システム・ロガー」の章を参照してください。
第 14 章 Logrec エラー・レコードの記録
14-5
Logrec エラー・レコードの記録
参照
詳しくは、「z/OS MVS シスプレックスのセットアップ」を参照してください。
以下のステップは、Logrec データ・セットの代わりにカップリング・ファシリティ
ーの Logrec ログ・ストリームを使用する方法を示しています。
1. システム・ロガー・ログ・ストリーム定義ユーティリティー IXCMIAPU を使用
して、 SYSPLEX.LOGREC.ALLRECS という名前のログ・ストリームを定義しま
す。
例: IXCMIAPU を使用するサンプル JCL
管理データ・ユーティリティー IXCMIAPU を使用してシスプレックスに
対してカップリング・ファシリティー Logrec ログ・ストリームを定義する
例として、SYS1.SAMPLIB に IFBLSJCL が含まれています。
//IFBLSJCL JOB
//* Member Name: IFBLSJCL
//* Descriptive Name:
//*
Sample JCL to provide an example of using the System Logger
//*
utility to define the Logrec log stream to a sysplex.
//* Function:
//*
This JCL sample provides an example of running the System
//*
Logger utility (IXCMIAPU) to define the Logrec log stream
//*
in the logger inventory.
//*
//*
Note that the MAXBUFSIZE parameter must have at least 4068
//*
specified, or Logrec will not be able to write to the Log
//*
stream.
//*
//*
The Logrec log stream name must be specified as
//*
SYSPLEX.LOGREC.ALLRECS.
//*
//* Suggested Modifications:
//*
Provide the specifications that are relevant for your
//*
installation on the SYSIN DATA TYPE(LOGR) definition.
//*
For example, the following parameters define the log stream
//*
data set attributes:
//*
//*
LS_DATACLAS(data class)
- Name of data class
//*
LS_MGMTCLAS(management class) - Name of management class
//*
LS_STORCLAS(storage class)
- Name of storage class
//*
//* Distribution Library: ASAMPLIB
//*
//DEFINE
EXEC PGM=IXCMIAPU
//SYSPRINT DD SYSOUT=A
//SYSIN
DD *
DATA TYPE (LOGR)
DEFINE STRUCTURE NAME(LOGRECSTRUCTURE)
LOGSNUM(1)
AVGBUFSIZE(4068)
MAXBUFSIZE(4068)
DEFINE LOGSTREAM NAME(SYSPLEX.LOGREC.ALLRECS)
STRUCTNAME(LOGRECSTRUCTURE)
/*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
注: Logrec はレコードを 1 つのページ・ブロックに書き込むため、
MAXBUFSIZE は少なくとも 4068 でなければなりません。あるデータ・セ
14-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
ットがいっぱいになったときに別のデータ・セットが割り振られるように、
SMS 記憶グループ、ストレージ、データ、および管理クラスを指定してく
ださい。 Logrec ログ・ストリームにマイグレーションする前にシスプレッ
クス内のシステムのすべての Logrec データ・セットに割り振られているの
と同じ大きさのスペースを割り振ってください。
すべての Logrec レコードを管理するには、ログ・データ・セットの HSM への
自動マイグレーションを指定するのが最も効果的な方法です。自動マイグレーシ
ョンを行うと、保存用ヒストリー・データ・セットの作成と保守が不要になりま
す。ただし、1 つだけ例外があります。ログ・ストリーム・データ・セット・デ
ィレクトリーがいっぱいになっている場合には、 LOGR サブシステムの
SUBSYS-options2 を使用してログ・ストリームからヒストリー・データ・セット
にデータをコピーし、コピー済みデータをログ・ストリームから削除することが
できます。
2. IEASYSxx parmlib メンバー内で LOGREC=LOGSTREAM を指定するか、あるい
は LOGREC=dsname を指定して IPL を行ったあとで SETLOGRC コマンドを使
用して Logrec 記録メディアを Logrec ログ・ストリームに変更します。一般
に、Logrec ログ・ストリームに変更する前に Logrec データ・セットに書き込ま
れたレコードは、別個の EREP ジョブで読み取る必要があります。しかし、
MERGE オプションを使用すると、単一の EREP ジョブで、ログ・ストリーム
からの Logrec 出力を Logrec データ・セットに結合することができます。
LOGREC=LOGSTREAM を指定してシステムを IPL した場合には、SETLOGRC
コマンドを使用して Logrec 記録メディアを Logrec データ・セットに変更する
ことはできません。
3. 次のように EREP ジョブ・ストリームを変更してください。
v Logrec データ・セットに関連した SERLOG DD DSN=SYS1.LOGREC ステー
トメントを、対応する SUBSYS パラメーターを指定した ACCIN DD
DSN=SYSPLEX.LOGREC.ALLRECS ステートメントに変更して、EREP を
Logrec ログ・ストリームと関連付けしてください。SUBSYS パラメーターに
ついては、 14-15 ページの『Logrec ログ・ストリームからのレコードの入
手』 で説明されています。
v 入力をヒストリー・データ・セットとして識別してください。後続のすべての
ステップでヒストリー・データ・セットを入力として使用する必要があるた
め、現在推奨されているとおり、ヒストリー・データ・セットへの出力はその
ままにしておいてください。
注: 後続の各ステップでは、直前のステップよりも多くのレコードを処理しま
す。その結果、連続する報告書の数とデータに不一致が生じることになる
ため、複数のステップの入力として Logrec ログ・ストリームを使用する
ことはお勧めできません。
v 通常はヒストリー・データ・セットを処理する後続の EREP 報告書は、シス
テムごとに 1 つずつのヒストリー・データ・セットを連結する必要がなくな
ります。
参照
v システム・ロガー機能を使用するためのシステムのインストール準備について
は、「z/OS MVS シスプレックスのセットアップ」を参照してください。
第 14 章 Logrec エラー・レコードの記録
14-7
Logrec エラー・レコードの記録
v ヒストリー・データ・セットを得るための EREP ジョブの実行については、
「EREP User’s Guide」を参照してください。
v SETLOGRC コマンドに関する情報については、「z/OS MVS システム・コマン
ド」を参照してください。
v IEASYSxx parmlib メンバーに関する詳細については、「z/OS MVS 初期設定およ
びチューニング 解説書」を参照してください。
エラー記録の内容
システムは、ハードウェアまたはソフトウェアの障害およびシステム条件が発生す
るたびにレコードを作成し、これらのレコードを Logrec データ・セットまたは
Logrec ログ・ストリームに格納します。これらのレコードには、障害およびシステ
ム条件を記述する以下の 2 つのタイプのデータが含まれます。
v エラー統計。チャネル、マシン・モデル、および入出力装置で障害が起こった回
数が含まれています。
v 環境データ。それぞれの障害またはシステム条件に関連する時刻および状況が含
まれています。
注: プログラマーは、SYMRBLD マクロを使用して症状レコードを作成して、
SYMREC マクロを使用することによりこれらのレコードを Logrec データ・セ
ットまたは Logrec ログ・ストリームに書き込むこともできます。
参照
マクロについての情報は、「z/OS MVS プログラミング: アセンブラー・サービス解
説書 第 2 巻 (IARR2V-XCTLX)」を参照してください。
各レコードは、未定義長レコードとして 16 進数フォーマットで記録されます。各
レコードには、以下の情報が含まれています。
v 障害発生時の関連システムの情報
v 障害発生時の装置のハードウェア状況
v 装置/制御装置のリカバリー試行の結果
v ソフトウェア・システムのリカバリー試行の結果
v 統計データ
全体的に見た場合、これらのレコードはシステムのヒストリーを作成します。この
ヒストリーは、システム初期設定の初期に開始し、システムが停止したときに終了
します。これらのレコード全体には、以下の情報が含まれます。
v 完全な異常終了ヒストリー: システムは、ダンプが要求されたか抑制されたかに
かかわらず、異常終了ごとに Logrec レコードを書き込みます。 Logrec データ・
セットまたは Logrec ログ・ストリームには、異常終了の完全な記録が含まれて
います。
v システム初期設定エラー: システムは、他の診断サービスが完全に機能する前
に、システム初期設定中のエラーを書き込みます。
v 脱落レコード・カウント: システムは、脱落したエラー・レコードを要約するた
めに Logrec レコードを書き込みます。ハードウェア検出エラーとソフトウェア
検出エラーが時間的に接近して発生することがあります。エラーの発生間隔が近
14-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
すぎる場合には、システムは各エラーについて個別のレコードを書き込むことが
できません。その代わりにシステムはエラーの件数をカウントし、要約レコード
を書き込みます。
下記のセクションでは Logrec データ・セットの内容について説明します。
v 『Logrec データ・セットのヘッダー・レコード』
v 『Logrec データ・セットのタイム・スタンプ・レコード』
下記のセクションでは、Logrec データ・セットまたは Logrec ログ・ストリームの
内容について説明します。
v 14-10 ページの『Logrec エラー・レコードのタイプ』
参照
ヘッダー・レコード、タイム・スタンプ・レコード、および Logrec エラー・レコ
ードのフォーマットについては、「z/OS MVS 診断: 解説書」を参照してください。
Logrec データ・セットのヘッダー・レコード
IFCDIP00 は Logrec データ・セット内にヘッダー・レコードを作成します。Logrec
データ・セットのヘッダー・レコードの内容は以下のとおりです。
v 新しいレコード項目を Logrec データ・セットに書き込む箇所を判別するために
システム記録ルーチンが使用できる情報。
v Logrec データ・セットから既存のレコード項目を検出するために EREP が使用
できる情報。この情報は、EREP 報告を実行して特定のエラーを検出するときに
役立ちます。
v Logrec データ・セットが全体の 90% まで使用されたときに注意メッセージを発
行するためにシステム記録ルーチンが使用できる情報。
注: Logrec ログ・ストリームの場合ヘッダー・レコードは生成されません。
Logrec データ・セットのタイム・スタンプ・レコード
IFCDIP00 は、Logrec データ・セット内のヘッダー・レコードの後の最初のレコー
ド・スペースにタイム・スタンプ・レコードを作成します。タイム・スタンプ・レ
コードには、IPL レコードに関する現在日付および時刻の情報が含まれています。
この情報を使用することにより、IPL レコードに記録されている、オペレーティン
グ・システムの終了から再初期設定までの大体の時間間隔を測定できます。
システムは事前設定された時間間隔ごとに現在日付と時刻を入手し、それまでの日
付と時刻に上書きする形でこの情報をタイム・スタンプ・レコードに書き込みま
す。
それ以降のシステムの初期設定中には、システムはタイム・スタンプ・レコードか
ら日付および時刻を入手し、それを IPL レコードに追加します。
IFCDIP00 を使用して Logrec データ・セットを再初期設定した場合は、タイム・ス
タンプ・レコード内の情報は、システムが現行の日付および時刻を書き込むまで 16
進数のゼロで上書きされます。
第 14 章 Logrec エラー・レコードの記録
14-9
Logrec エラー・レコードの記録
注: Logrec ログ・ストリームの場合、タイム・スタンプ・レコードは生成されませ
ん。
Logrec エラー・レコードのタイプ
Logrec データ・セットまたは Logrec ログ・ストリームが初期設定されると、シス
テムはイベントの記録を開始します。システムは、装置依存または発生イベント依
存の情報を含む、以下のタイプのエラー・レコードを記録します。
v 非同期通知レコード (ANR):
– シスプレックス・タイマー発生イベントに関連した情報に関する外部タイマー
参照 (ETR) レコード。
– 保守の必要性についての情報を示す直接アクセス記憶装置 (DASD) のサービス
通知メッセージ (SIM) レコード
– 特定のリンク発生イベントに関する情報を示すリンク保守情報 (LMI) レコー
ド。
v 以下の情報を示すチャネル報告ワード (CRW) レコード
– チャネル・パス・エラー
– サブチャネル・エラー
– 構成アラート・エラー
– モニター機能エラー
v 以下の情報を示す動的装置再構成 (DDR) レコード
– 直接アクセス装置と磁気テープ装置の間でのオペレーター・スワップおよびシ
ステム・スワップ
– ユニット・レコード装置でのオペレーター・スワップ
v システムに RDE オプションが含まれている場合の、終業時条件およびシステム
終了条件に関連した情報を示す終業時 (EOD) レコード
v IOS リカバリー・アクションに関連した情報を示す入出力監視プログラム (IOS)
レコード
– リカバリー・アクションに関する動的パス指定サービス妥当性検査 (DPSV) レ
コード
v システムに RDE オプションが含まれている場合の、システム初期設定に関連し
た情報を示す初期プログラム・ロード (IPL) レコード
v 以下の情報を示すマシン・チェック・ハンドラー (MCH) レコード
– 中央処理装置の障害
– ストレージの障害
– 記憶キーの障害
– タイマーの障害
v 以下の情報を示す雑データ (MDR) レコード
– バッファー式ログ装置でのバッファー・オーバーフローと装置障害
– バッファー式ログが入っている DASD での取り外し
– バッファー式ログの入っている DASD と除去可能ディスク・パックの間での
DFDSS プログラムによる取り外し
– IBM 通信コントローラーに接続されたテレプロセシング装置で発生した装置障
害
– バッファー式ログのある DASD で EREP によって行われた統計記録
14-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
v 以下の情報を示す未着割り込みハンドラー (MIH) レコード
– 未着入出力割り込み
– 指定時間間隔
– 必要なリカバリー・アクション
– 実行されるリカバリー・アクション
v 以下の情報を示す外部 (OBR) レコード
– テレプロセシング・アクセス方式でサポートされる装置上のカウンター・オー
バーフロー統計および装置障害
– 終業時 (EOD) 要求
– ページ入出力エラー
– 永続チャネルおよび入出力装置障害
– 統計カウンター・オーバーフロー
– 一時的または断続的な入出力装置障害
– IBM 磁気テープ・ドライブでの取り外し
– 独自の診断バッファーを備えた装置
– バッファー式ログのある DASD で EREP によって行われた統計記録
v チャネル・エラーに関するサブチャネル・ログアウト・ハンドラー (SLH) レコー
ド
v 以下の情報を含むソフトウェア・レコード
– マシン・チェック (ハード・マシン故障に関するソフトウェア・リカバリー試
行などの、マシン故障で検出されたハードウェア・エラー)
– プログラム・チェック (ハードウェアで検出されたソフトウェア・エラー)
– 再始動エラー (オペレーターが検出したエラー)
– 脱落レコード・エラー (Logrec データ・セットに書き込まれるバッファーに格
納できなかったレコードのカウント)
– ソフトウェアで検出された以下のようなエラー
- 異常終了 (アベンド とも呼ばれます)。ソフトウェア・レコードまたは誤り
監視プログラム呼び出し (SVC) 命令で報告されます。これらは SDWA タ
イプのソフトウェア・レコードと呼ばれます。
- 異常終了ではないエラー。これらは症状レコードで報告されます。
- アプリケーション・プログラムまたはシステム・コンポーネントによって生
成されたエラー。これらは症状レコードで報告されます。
これまでに述べたように、システムは、システム障害の診断に役立つエラー・レコ
ードの包括的なリストを記録します。
Logrec データ・セットからの情報の入手
Logrec データ・セットに記録された情報は、EREP を使用して入手できます。
EREP はエラー・レコードをフォーマット設定します。
EREP を使用すると、以下の機能を実行できます。
v Logrec データ・セットから累計データ・セットを作成する。
v Logrec データ・セットをクリアする。
v 入力累計データ・セットを出力累計データ・セットにコピーする。
第 14 章 Logrec エラー・レコードの記録
14-11
Logrec エラー・レコードの記録
v 累計データ・セットおよび Logrec データ・セットから得られたデータをマージ
する。
v 選択されたハードウェアおよびソフトウェア・エラー・レコードの詳細記述を印
刷する。
v 装置障害に関する統計を要約し、印刷する。
EREP は Logrec データ・セットから入手した情報を報告書に記入します。EREP に
作成させる報告書のタイプは JCL を使用して決定してください。
EREP の使用
EREP は、Logrec ソフトウェア・エラー・レコードから入手した情報を 5 つの報告
書で提示します。
異常終了に関する詳細編集報告書
システムは、異常終了 Logrec エラー・レコードに関するほとんどの情報をシス
テム診断作業域 (SDWA) から入手します。この報告書の内容は以下のとおりで
す。
v レコード・ヘッダー: 報告書タイプ (SOFTWARE RECORD)、システム、ジョ
ブ名、エラー ID (ERRORID)、日付、および時刻
v 検索引数の要約
v 保守容易性の情報
v エラー時刻の情報
v 要求ブロックから得られた状況情報
v リカバリー環境
v リカバリー・ルーチン・アクション
v 可変記録域 (VRA) を含む SDWA の 16 進ダンプ
例: 詳細編集報告書の印刷
次の例は、すべてのソフトウェアおよび操作レコードの詳細編集および要
約を生成する方法を示しています。
//STEP7
EXEC
//ACCIN
DD
//DIRECTWK DD
//
//EREPPT
DD
//TOURIST
DD
//SYSIN
DD
//
PRINT=PS
TYPE=SIE
HIST
ACC=N
ENDPARM
PGM=IFCEREP1,PARM=’CARD’
DSN=EHISTORY,DISP=(OLD,PASS)
UNIT=SYSDA,
SPACE=(CYL,5,,CONTIG)
SYSOUT=A,DCB=BLKSIZE=133
SYSOUT=A,DCB=BLKSIZE=133
DSN=EREP.PARMS(STEP7),
DISP=(OLD,PASS)
症状レコードに関する詳細編集報告書
システムは、異常終了ではない Logrec エラー・レコードに関するほとんどの情
14-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
報を、 SYMREC マクロで識別された症状レコードから入手します。プログラ
マーは、SYMRBLD マクロを使用して症状レコードを作成できます。この報告
書の内容は以下のとおりです。
v レコード・ヘッダー: 報告書タイプ (SYMPTOM RECORD)、システム、日
付、および時刻
v 検索引数の要約
v システム環境
v コンポーネント情報
v 1 次および 2 次症状ストリング
v フリー・フォーマットのコンポーネント情報
v 症状レコードの 16 進ダンプ
システム要約報告書
この報告書は、インストール・システムの各主要部分、あるいはサブシステム
(すなわち、プロセッサー、チャネル、サブチャネル、ストレージ、オペレーテ
ィング・システム制御プログラム、および入出力サブシステム) に関するエラー
を要約します。この報告書の内容は以下のとおりです。
v レコード・ヘッダー: 報告書タイプ (SYSTEM SUMMARY)、システム、日
付、時刻
v 以下のタイプのエラーに関する合計エラー数とプロセッサーごとのエラー数
– IPL
– マシン・チェック
– プログラム・エラー
– 終業時
v 報告書に示されるプロセッサーの識別
イベント・ヒストリー報告書
この報告書は、エラー・ヒストリー (エラーの頻度、順序、およびパターン) を
示します。この報告書の内容は以下のとおりです。
v レコード・ヘッダー: 報告書タイプ (EVENT HISTORY)
v 異常終了および非異常終了の Logrec エラー・レコードを発生順に要約したも
の
v システムおよび各プロセッサーごとの Logrec エラー・レコードの合計数とタ
イプ
第 14 章 Logrec エラー・レコードの記録
14-13
Logrec エラー・レコードの記録
例: イベント・ヒストリー報告書の印刷
次の JCL は 2 つのステップからなるジョブを定義しています。最初のス
テップでは、すべての Logrec データ・セット・レコードのイベント・ヒ
ストリー報告書を印刷します。2 番目のステップでは、それぞれのソフト
ウェア、IPL、および EOD レコードを個別にフォーマット設定します。イ
ベント・ヒストリー報告書は、最初のステップの EXEC ステートメント
で EVENT=Y パラメーターを指定することによって印刷されます。この報
告書は、記録されたとおりのシーケンスでレコードを印刷し、その結果ハ
ードウェア・エラー・レコードとソフトウェア・エラー・レコードの間の
相互関係が分かるため、問題解決のために非常に役立ちます。
//EREP JOB MSGLEVEL=1
//EREPA EXEC PGM=IFCEREP1,PARM=’EVENT=Y,ACC=N’,
//
REGION=128K
//SERLOG DD DSN=SYS1.LOGREC,DISP=SHR
//TOURIST DD SYSOUT=A
//EREPPT DD SYSOUT=A,DCB=BLKSIZE=133
//EREPB EXEC PGM=IFCEREP1,PARM=’TYPE=SIE,PRINT=PS,ACC=’,
//
REGION=128K
//SERLOG DD DSN=SYS1.LOGREC,DISP=SHR
//TOURIST DD SYSOUT=A
//EREPPT DD SYSOUT=A,DCB=BLKSIZE=133
/*
詳細要約報告書
この報告書は Logrec エラー・レコード内のデータに関する情報を要約します。
この報告書の内容は以下のとおりです。
v レコード・ヘッダー: 要約される報告書のタイプ
v 要約情報およびカウント
例: 詳細要約報告書の印刷
次の例は、すべての入出力エラーの詳細要約の生成方法を示しています。
//STEP6
EXEC PGM=IFCEREP1,PARM=’CARD’
//ACCIN
DD DSN=EHISTORY,DISP=(OLD,PASS)
//DIRECTWK DD UNIT=SYSDA,
//
SPACE=(CYL,5,,CONTIG)
//EREPPT
DD SYSOUT=A,DCB=BLKSIZE=133
//TOURIST DD SYSOUT=A,DCB=BLKSIZE=133
//SYSIN
DD DSN=EREP.PARMS(STEP6),
//
DISP=(OLD,PASS)
//
DD DSN=EREP.CONTROLS,
//
DISP=(OLD,PASS)
PRINT=SU
TYPE=DOTH
DEV=(N34XX,N3704,N3705,N3720,N3725,N3745)
HIST
ACC=N
ENDPARM
14-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
Logrec ログ・ストリームからのレコードの入手
次のどちらかの方法で logrec ログ・ストリームのレコードにアクセスできます。
v IXGCONN サービスと IXGBRWSE サービスを使用するプログラムを作成する
(『システム・ロガー・サービスを使用して Logrec ログ・ストリームからレコー
ドの入手』を参照してください)。
v EREP を使用する (『EREP を使用して Logrec ログ・ストリームからレコードの
入手』を参照してください)。
システム・ロガー・サービスを使用して Logrec ログ・ストリームからレ
コードの入手
IXGCONN および IXGBRWSE システム・ロガー・サービスを使用してログ・デー
タを戻すプログラムを作成することによって、Logrec ログ・ストリームからレコー
ドを入手できます。 IXGBRWSE サービスが Logrec ログ・ストリームから戻すデ
ータは、IFBLOGLB データ・エリアによってマップされます。(システム・ロガー・
サービスの使用法については、「z/OS MVS プログラミング：アセンブラー・サー
ビス ガイド 」を参照してください。)
IXGBRWSE サービスからの Logrec ログ・ストリーム出力には、個々のログ・スト
リーム・レコードが入っていることに注意してください。ただし、ログ・ストリー
ム・レコードには実際は、1 つのグループのレコードが入っています。 Logrec ロ
グ・ストリームは、IFBLOGLB マッピング・マクロによってマップされます。
IFBLOGLB マッピング・マクロについては、「z/OS MVS Data Areas, Vol 2
(DCCB-ITZYRETC)」を参照してください。
EREP を使用して Logrec ログ・ストリームからレコードの入手
EREP を使用して、各システムに関する Logrec ログ・ストリーム内のレコードにア
クセスできます。ログ・ストリーム・サブシステムを使用すると、既存のプログラ
ムは、Logrec データ・セットからアクセスする場合と同じ方法でログ・ストリーム
からエラー・レコードにアクセスできます。ログ・ストリーム・サブシステムの使
用と開始に関する情報については、「z/OS MVS プログラミング：アセンブラー・
サービス ガイド 」を参照してください。
LOGR サブシステム用の JCL
ログ・ストリーム・データにアクセスするには、SUBSYS パラメーターを使用し
て、ログ・ストリーム・サブシステム (LOGR) を呼び出してください。
//ddname
DD DSNAME=log.stream.name,
//
SUBSYS=(LOGR[,exit_routine_name][,’SUBSYS-options1’][,’SUBSYS-options2’])
ここで、
SUBSYS-options1:
[FROM={({[yyyy/ddd][,hh:mm[:ss]]}) |OLDEST}]
[TO={({[yyyy/ddd][,hh:mm[:ss]]}) |YOUNGEST}]
[,DURATION=(nnnn,HOURS)]
[,VIEW={ACTIVE|ALL|INACTIVE}]
[,GMT|LOCAL]
SUBSYS-options2:
defined by the log stream owner
図 14-2. ログ・ストリーム SUBSYS データ・セットの仕様
第 14 章 Logrec エラー・レコードの記録
14-15
Logrec エラー・レコードの記録
注: SUBSYS キーワード内で括弧、コンマ、等号、またはブランク文字を使用する
場合、キーワードの前後に引用符が必要です。
その他の DD キーワードを指定した場合、妥当性検査は行われますが、 LOGR サ
ブシステム処理では無視されます。
DSNAME=log.stream.name
読み取られるログ・ストリームの名前を指定します。指定できる名前は、デー
タ・セット名フォーマットの 1 文字から 26 文字までの名前です。
SUBSYS=(LOGR[,exit_routine_name][,’SUBSYS-options1’][,’SUBSYS-options2’])
この DD の処理が LOGR サブシステムによって取り扱われることを指定しま
す。
exit_routine_name は 2 番目の定位置パラメーターであり、LOGR サブシステム
から制御権を受け取る出口ルーチンの名前を指定します。
v ログ・ストリームのサブシステムの出口ルーチンを使用するには、IXGEXIT
を指定またはデフォルト設定してください。
v Logrec ログ・ストリームから得られたレコードにアクセスするには、
IFBSEXIT を指定してください。 Logrec 固有のパラメーターについては、
SUSBSYS-options2 を参照してください。
v SMF ログ・ストリームから得られたレコードにアクセスするには、
IFASEXIT を指定してください。 SMF 固有のパラメーターについては、
SUSBSYS-options2 を参照してください。
|
|
|
SUBSYS-options1
すべての出口ルーチンに関して意味のあるオプションを指定します。これらの共
通オプションの例外については、特定のログ・ストリーム出口の資料を参照して
ください。キーワードは次のとおりです。
FROM=starting_time
VIEW キーワードが指定するログ・ストリームのビューに基づいて最初に処
理するログ・ストリーム・ブロックの開始時刻を示します。最初のブロック
は、指定された時刻またはそれよりも後のタイム・スタンプが付いているブ
ロックになります。
OLDEST
ログ・ストリーム内の最も古いブロックを最初に読み取ることを示しま
す。 OLDEST はデフォルトです。
yyyy/ddd
開始日付を指定します。この日付を省略すると、現在日付が採用されま
す。
yyyy は 4 桁の年で、ddd は 001 から 366 まで (366 はうるう年の場
合にのみ有効です) の 3 桁の日数です。たとえば、2000 年 2 月 20 日
は 2000/051 とコーディングし、1996 年 12 月 31 日は 1996/366 とコ
ーディングします。
hh:mm[:ss]
開始時刻を指定します。この時刻を省略すると、深夜 0 時を過ぎて最
初に書き込まれたブロックが使用されます。
14-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
hh は 00 から 23 までの 2 桁の時間数、mm は 00 から 59 までの 2
桁の分、そして ss は 00 から 59 までの 2 桁の秒です。ログ・ストリ
ーム所有者が必要としない場合には、秒フィールドとそれに関連する :
区切り文字は省略することができます。
FROM キーワードと DURATION キーワードは、同時に指定することがで
きません。
TO=ending_time
VIEW キーワードが指定するログ・ストリームのビューに基づいて、最後に
処理するログ・ストリーム・ブロックの終了時刻を示します。最後のブロッ
クは、指定された時刻またはそれよりも前のタイム・スタンプのついたブロ
ックになります。
YOUNGEST
最後に読み取るブロックが、DD に関する割り振りが行われた時点にお
けるログ・ストリーム内の最新のブロックであることを示します。
YOUNGEST はデフォルトです。
yyyy/ddd
終了日付を指定します。この日付を省略すると、現在日付が採用されま
す。
yyyy は 4 桁の年で、ddd は 001 から 366 まで (366 はうるう年の場
合にのみ有効です) の 3 桁の日数です。たとえば、2001 年 3 月 7 日
は 2001/066 とコーディングし、2000 年 11 月 12 日は 2000/317 とコ
ーディングします。
hh:mm[:ss]
終了時刻を指定します。この時刻を省略すると、深夜 0 時以前に書き
込まれた最初のブロックが使用されます。終了日付が現行日付と同じで
ある場合には、DD に関する割り振りが行われた時点のログ・ストリー
ム内の最新のブロックが使用されます。
hh は 00 から 23 までの 2 桁の時間数、mm は 00 から 59 までの 2
桁の分、そして ss は 00 から 59 までの 2 桁の秒です。ログ・ストリ
ーム所有者が必要としない場合には、秒フィールドとそれに関連する :
区切り文字は省略することができます。
TO キーワードと DURATION キーワードは、同時に指定することができま
せん。
注: FROM キーワードに指定された値が TO キーワードに指定された値よ
りも大きい場合には、システムは JCL エラーでジョブ・ステップを終
了します。
DURATION=(nnnn,HOURS)
処理するブロックを指定します。各 n は、 0 ∼ 9 の数値です。
(nnnn,HOURS) を指定すると、VIEW キーワードが指定するログ・ストリー
ムのビューに基づいて処理する最新のブロックまでの最後の nnnn 時間のブ
ロックが要求されます。最後の nnnn 時間 は、DD に関する割り振り時点
の現行時刻から計算されます。
第 14 章 Logrec エラー・レコードの記録
14-17
Logrec エラー・レコードの記録
最初のブロックは、計算された開始時刻またはそれよりも大きなタイム・ス
タンプが付いているブロックになります。最後に読み取られるブロックは、
DD に関する割り振りが行われた時点におけるログ・ストリーム内の最新ブ
ロックになります。
DURATION キーワードと TO および FROM キーワードは、同時に指定す
ることができません。
VIEW=ACTIVE|ALL|INACTIVE
ログ・ストリームからレコードを取得するために使用されるログ・データの
ビューまたはログ・データの一部を指定します。
システム・ロガーは、ログ・ストリーム内に、アクティブ部分と非アクティ
ブ部分の 2 種類のログ・ストリーム・データを保持します。ログ・ストリ
ームのアクティブ部分は、ログ・ストリーム所有者が IXGDELET 要求によ
って論理的に削除していないログ・データです。ログ・ストリームの非アク
ティブ部分は、ログ・ストリーム所有者が論理的に削除しているが、ログ・
ストリームに指定した保存期間 (RETPD) の有効期限がまだ切れていないた
め、物理的には削除されていないログ・データです。
VIEW オプションは、他のパラメーターを適用した上で、ログ・ストリーム
からログ・データを取得するために使用されるログ・ストリームの部分 (ま
たは複数の部分) を指定します。
他のパラメーターも適用されるため、FROM、TO、または DURATION の
各パラメーターと VIEW パラメーターとの組み合わせは、ログ・ストリー
ム・サブシステム出口がログ・データまたは目的のログ・データの一部分だ
けを戻すことを意味することがあります。たとえば、FROM=starting_time と
VIEW=INACTIVE の両方を指定して、starting_time がログ・ストリームの非
アクティブ部分にあるログ・データよりも最新である (より若い) 場合に
は、そのアクセス基準を満たすログ・データはありません。同様に、
TO=ending_time と VIEW=ACTIVE の両方を指定して、ending_time がロ
グ・ストリームのアクティブ部分にあるログ・データよりも前のものである
(より古い) 場合には、そのアクセス基準を満たすログ・データはありませ
ん。
ACTIVE
ログ・ストリームのビューには、他のログ・ストリーム・アクセス・パ
ラメーターを適用した上で、アクティブなログ・データだけが含まれま
す。 ACTIVE はデフォルトです。
ALL
ログ・ストリームのビューには、他のログ・ストリーム・アクセス・パ
ラメーターを適用した上で、アクティブおよび非アクティブ両方のロ
グ・データが含まれます。
INACTIVE
ログ・ストリームのビューには、他のログ・ストリーム・アクセス・パ
ラメーターを適用した上で、非アクティブなログ・データだけが含まれ
ます。
14-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
GMT|LOCAL
時刻がローカル時刻 (ログが書き込まれた時点の時間帯オフセットに基づい
て求められます) であるのか GMT 時刻であるのかを指定します。GMT は
デフォルトです。
ログ・ストリーム・サブシステム・データ・セットについて指定できる上記の汎用
パラメーターの他に、システム・ロガーでは SUBSYS-options2 に追加パラメーター
を指定できます。Logrec ログ・ストリームには以下の値をコーディングできます。
SUBSYS-options2
固有の出口ルーチン・オプションを指定します。これらのパラメーターについて
は、特定のログ・ストリーム所有者が提供する情報を参照してください。
LASTRUN
Logrec ログ・ストリームからのレコードの読み取りを、LASTRUN を使用
したアプリケーションを前回に使用したときに読み取った最後のレコードか
ら開始するように指示します。レコードの終点は、Logrec ログ・ストリー
ムの最新のブロックになります。
LASTRUN は、SUBSYS-options1 の FROM、TO、および DURATION キー
ワード、および SUBSYS-options2 の DELETE キーワードとは同時に指定す
ることができません。
DELETE
ログ・ストリーム・レコードを Logrec ログ・ストリームから削除するよう
に指示します。ログ・ストリームは削除されず、引き続き利用可能です。
Logrec ログ・ストリームがこのジョブ・ステップでオープンされたもので
ある場合には、プログラムで最後読み取られた完全ブロックの直前までのす
べてのレコードが Logrec ログ・ストリームから削除されます。
Logrec ログ・ストリームがこのジョブ・ステップでオープンされたもので
ない場合には、 TO キーワードで示された時刻よりも前のすべてのレコー
ドが Logrec ログ・ストリームから削除されません。
DELETE は、SUBSYS-options1 の FROM と DURATION キーワード、およ
び SUBSYS-options2 の LASTRUN と SYSTEM キーワードとは同時に指定
することができません。
DEVICESTATS
このジョブが実行されているシステムで維持されている装置統計を、レコー
ドの読み取り前に Logrec ログ・ストリームに記録するように指示します。
SYSTEM=system name
Logrec ログ・ストリームを読み取るアプリケーションに、指定された
system name から得られたレコードだけを戻すように指示します。
system name の値は、IEASYSxx parmlib メンバーの SYSNAME パラメー
ターで指定された名前と一致していなければなりません。
SYSTEM は、SUBSYS-options2 の DELETE キーワードとは同時に指定でき
ません。
第 14 章 Logrec エラー・レコードの記録
14-19
Logrec エラー・レコードの記録
時刻に関する考慮事項
LOGR 用に SUBSYS DD ステートメントを使用している場合には、時刻フィルタ
ー操作を行う際に注意が必要です。SUBSYS は停止時刻として 24:00 を受け入れま
せんが、EREP パラメーターは停止時刻として 24:00 を受け入れます。
JCL および EREP 制御ステートメントを書く必要がある場合には、 SUBSYS DD
ステートメントと EREP パラメーターの両方でフィルター操作を要求しなければな
らない可能性があります。
v SUBSYS パラメーターはレコードのブロックを使用し、これらのブロックのフィ
ルター操作は、ブロックに含まれる各論理レコードに独自のタイム・スタンプが
割り当てられたあとで割り当てられたタイム・スタンプを使用して行われます。
例: SUBSYS パラメーターの使用
1997 年 6 月 1 日の 05:00 からその日の終わりまでの間に作成された
Logrec ログ・ストリームを選択するには、次のようにコーディングしてく
ださい。
//ACCIN
//
//
//
DD DSN=SYSPLEX.LOGREC.ALLRECS,DISP=SHR,
DCB=(RECFM=VB,BLKSIZE=4000),
SUBSYS=(LOGR,IFBSEXIT,
’FROM=(1997/152,05:00),TO=(1997/153,23:59),GMT’)
v EREP パラメーターは Logrec 論理レコードを使用します。EREP で TIME パラ
メーターを使用すると、選択されたそれぞれの日について、特定の時間および分
の範囲を指定することになります。
例: EREP パラメーターの使用
1997 年 6 月 1 日の 05:00 からその日の終わりまでの間に作成された
Logrec レコードを選択するには、次のようにコーディングしてください。
DATE=(97152-97152),TIME=(0500-2400)
次のようにコーディングするとエラーになりますので、ご注意ください。
DATE=(97152-97153),TIME=(0500-0000)
14-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
例: ヒストリー・データ・セットの作成
Logrec ログ・ストリームに記録されたログ・データからヒストリー・データ・
セットを作成するには、次のような JCL を使用します。
この例では、DEVICESTATS は装置統計とレコードをログ・ストリームに記録
することを要求しています。″LASTRUN″ EREP ジョブの直前の実行依頼で処
理された最後のブロックからログ・ストリーム内の最も新しいブロックまでの
レコードが読み取られます。 ″LASTRUN″ オプションが指定されたジョブを
初めて実行すると、ログ・ストリーム内の最も古いブロックからレコードが読
み取られます。
//EREPDALY
//ACCIN
//
//
//ACCDEV
//
//
//
//SERLOG
//DIRECTWK
//TOURIST
//EREPPT
//SYSABEND
//SYSIN
/*
EXEC PGM=IFCEREP1,PARM=(’HIST,ACC=Y,SYSUM’)
DD DSN=SYSPLEX.LOGREC.ALLRECS,
SUBSYS=(LOGR,IFBSEXIT,,’DEVICESTATS,LASTRUN’),
DCB=(RECFM=VB,BLKSIZE=4000)
DD DSN=EREP.HISTORY,
DISP=(NEW,CATLG),
DCB=(RECFM=VB,BLKSIZE=4000),
UNIT=SYSDA,SPACE=(CYL,(25,5))
DD DUMMY
DD UNIT=SYSDA,SPACE=(CYL,15,,CONTIG)
DD SYSOUT=A,DCB=BLKSIZE=133
DD SYSOUT=A,DCB=BLKSIZE=133
DD SYSOUT=A
DD DUMMY
第 14 章 Logrec エラー・レコードの記録
14-21
Logrec エラー・レコードの記録
例: イベント・ヒストリーの作成
Logrec ログ・ストリームに記録されたレコードからイベント・ヒストリー報告
書を作成するには、次のような JCL を使用します。FROM または TO キーワ
ードを指定しないことによって、デフォルトは FROM=OLDEST と
TO=YOUNGEST になり、処理にはログ・ストリームの先頭から終わりまでの
レコードが含まれることを示します。印刷データ・セット EREPPT を指定す
ることにより、レポートをオンラインでブラウズして重要な活動の概要を調べ
ることができます。
//EREPNOW EXEC PGM=IFCEREP1,REGION=4M,
//
PARM=’CARD’
//ACCIN
DD DSN=SYSPLEX.LOGREC.ALLRECS,
//
DISP=SHR,
//
SUBSYS=(LOGR,IFBSEXIT,,)
//DIRECTWK
DD UNIT=SYSDA,SPACE=(CYL,5,,CONTIG)
//EREPPT
DD DSN=EREP.EVENT,DISP=(NEW,CATLG),
//
DCB=BLKSIZE=133,
//
UNIT=SYSDA,SPACE=(CYL,(25,5))
//TOURIST
DD SYSOUT=A,DCB=BLKSIZE=133
//SYSABEND
DD SYSOUT=A
//SYSIN
DD *
EVENT
HIST
ACC=N
TYPE=ACDEHIMOSX
ENDPARM
/*
日時および時刻を指定してレコードを読み取るときには、EREP パラメーターと
SUBSYS パラメーターの両方を指定できます。EREP は、SUBSYS パラメーターに
より渡されたレコードの中からレコードを選択します。
Logrec 記録制御バッファーからの情報の入手
システムがダンプを書き込むときには、そのダンプにはストレージ内の Logrec バ
ッファーに入っているレコードが含まれます。これらのバッファー・レコードは
Logrec データ・セットに書き込まれたもの、または Logrec データ・セットに書き
込むためにキューイングされたものです。
システムの問題を調べるためにダンプの診断を開始するときには、IPCS を使用して
Logrec 記録制御バッファー内のシステム・レコードを表示できます。
Logrec 記録制御バッファーは、MVS 内の問題を分析する際に使用すべき、最も重
要なエリアの 1 つです。このバッファーは、Logrec データ・セットに書き込むた
めにキューイングされたハードウェアおよびソフトウェア・エラー・レコードのた
めの、一時的な記憶場所として機能します。このバッファーが重要なのは、エラ
ー・ヒストリーを含んでいるためです。また、バッファー内のレコードのうちで
Logrec データ・セットに到達していない ものは、ほぼ間違いなく、ユーザーが解
決しようとしている問題に関連しています。
14-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
Logrec バッファーのフォーマット設定
Logrec バッファーをフォーマット設定するには、IPCS サブコマンド VERBEXIT
LOGDATA を使用してください。 まだバッファーに入っている項目は、EREP 詳細
編集報告書で印刷される項目と同じ方法でフォーマット設定されます。
Logrec および WTO 記録制御バッファーの検出
SQA には 2 つの記録制御バッファー (RCB) があります。システムは、Logrec メ
ッセージ用に 1 つのバッファーを使用し、WTO メッセージ用にもう 1 つのバッフ
ァーを使用します。CVT+X'16C' (CVTRBCB) は記録バッファー制御ブロック
(RBCB) を指します。 RBCB には、2 つの記録制御ブロック (RCB またはバッフ
ァーとも呼ばれます) に関する以下の情報が含まれます。
Logrec RCB の場合:
v RBCB+X'10' (RBCBLRCB) は Logrec バッファーを指します。
v RBCB+X'14' (RBCBLLEN) には Logrec バッファーの長さが含まれます。
WTO RCB の場合:
v RBCB+X'18' (RBCBWRCB) は WTO バッファーを指します。
v RBCB+X'1C' (RBCBWLEN) には WTO バッファーの長さが含まれます。
Logrec および WTO 記録制御バッファーは、取り出し保護された SQA に入ってい
ます。これらのバッファー内の項目にはタイム・スタンプ (8 バイトの TOD クロ
ック値) が含まれているため、ダンプを調べたり、Logrec イベントおよび WTO メ
ッセージの発生順リストを作成したりできます。
Logrec 記録制御バッファーの読み方
Logrec 記録制御バッファーは、システム・トレース・テーブルに類似した “折り返
しテーブル” です。項目のサイズはさまざまです。最新の項目は、特に Logrec デー
タ・セットにまだ書き込まれていない場合には、最も重要です。エラーが検出され
たシステムのエリア、およびそれに関連したリカバリー・ルーチンのアクションが
分かると、 Logrec データ・セットおよび Logrec 記録制御バッファーから得られた
情報をもとに、調べようとしている環境に関して全般的な理解を得ることができま
す。
注: Logrec バッファー内の SDWA は圧縮された SDWA であり、その中の記録可
能拡張子は、SDWAVRA の使用済み部分の直後から始まります。 SDWAURAL
には SDWAVRA の長さが入っています。
バッファーの最も古い項目は、RCBFREE+RCBFLNG によって得られる未使用域ま
たはフリー域の終わりを探し出すことによって見付けられます。(この合計値がバッ
ファーの終わりを超えている場合には、合計値から RCBTLNG を引いてくださ
い。) 各項目の終わりから項目長を使用することにより、バッファーを逆方向に読
み取ることもできます。最新の項目は、バッファーのフリー・エリアまたは未使用
エリアの直前に示されます。
参照
RCB のフォーマットについては、「z/OS MVS Data Areas, Vol 3 (IVT-RCWK)」を
参照してください。
第 14 章 Logrec エラー・レコードの記録
14-23
Logrec エラー・レコードの記録
ソフトウェア・レコードの解釈
ソフトウェア・レコードには、Logrec データ・セットに記録されるものと、Logrec
ログ・ストリームに記録されるものの 2 つのタイプがあります。
v ソフトウェア・レコード
システムはこれらのレコードを生成し、システム診断作業域 (SDWA) から得られ
た、異常終了またはプログラム・チェックが原因で検出された問題を記述する情
報を提供します。詳細については、『ソフトウェア・レコードに関する詳細編集
報告書』を参照してください。
v 症状レコード
ユーザーのアプリケーション・プログラムまたはシステムは、SYMREC マクロを
発行して症状レコードの作成を要求できます。一般に、症状レコードは異常終了
を伴わない問題を記述しますが、いくつかの例外があります。詳細については、
14-31 ページの『症状レコードに関する詳細編集報告書』を参照してください。
報告書情報の使用
ソフトウェア・レコードまたは症状レコードの詳細編集報告書から得られた検索引
き数は、既知の問題の検索に使用してください。ユーザー自身が検索を行わない場
合は、IBM サポートにご連絡ください。検索の結果、次のような対応が考えられま
す。
v 問題を訂正するための PTF。
エラーを訂正する PTF を適用してください。
v 問題を記述する APAR、および多くの場合には関連の APAR。場合によっては、
一時修正 (ZAP または更新) または特定の手順によって問題が回避できることが
あります。
利用可能な場合には一時修正を適用してください。一時修正が利用可能でない場
合には回避手順に従ってください。
v 問題の発生原因と考えられる事項の記述。多くの場合、エラー・レコードの原因
となる、製品の典型的な誤用が記述されています。このタイプの問題はユーザ
ー・エラーと呼ばれます。
MVS 以外の製品の誤用によってエラーが発生した場合には、その製品について記
述されている手順を使用して、問題の最善のデバッグ方法を判別してください。
上記の 3 つ以外の場合 (検索基準と一致するレコードがサービス・リンク・データ
ベースに含まれていない場合など) には、IBM サポートに連絡して問題を通知して
ください。
ソフトウェア・レコードに関する詳細編集報告書
ソフトウェア・レコードの詳細編集報告書は、異常終了に関して、システム診断作
業域 (SDWA) を含む完全な内容を示します。この報告書は、EREP により、また
VERBEXIT LOGDATA サブコマンドを介して IPCS のもとで作成されます。
14-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
ソフトウェア・レコードの詳細編集報告書を使用して異常終了の原因を判別し、シ
ステムまたはアプリケーションが実行したリカバリー・アクションまたは実行しな
かったリカバリー・アクションを判別してください。この報告書を使用することに
より、SVC ダンプを分析した場合と同じように、エラーの発生場所を突きとめるこ
とができます。エラーを突きとめることができると、その問題を修正するための検
索引き数を作成できるようになります。
参照
v SDWA タイプのレコードに関する詳細編集レポートの作成については、「EREP
User’s Guide」を参照してください。
v VERBEXIT LOGDATA サブコマンドに関する情報については、「z/OS MVS IPCS
コマンド」を参照してください。
報告書出力
次の出力例は、SDWARC4 および 64 ビット情報を持つ 1 つのレコードから得られ
たものです。また、このレコードは、VRA (可変記録域) にフォーマット済みの情報
を持っています。
第 14 章 Logrec エラー・レコードの記録
14-25
Logrec エラー・レコードの記録
TYPE:
SOFTWARE RECORD
(SVC 13)
FORMATTED BY: IEAVTFDE
JOBNAME: PIDA1028
ERRORID: SEQ=00757
REPORT:
HBB7703
MODEL:
SERIAL:
SOFTWARE EDIT REPORT
DAY.YEAR
REPORT DATE: 343.04
ERROR DATE: 336.04
2084
HH:MM:SS.TH
11778D
TIME: 17:43:44.72
SYSTEM NAME: J50
CPU=0056 ASID=0097
TIME=17:43:44.7
SEARCH ARGUMENT ABSTRACT
PIDS/5752SCLDR RIDS/IEWLDR00#L RIDS/IEWLUNF0 AB/S0378 PRCS/00000014
RIDS/IEWLRECV#R
SYMPTOM
------PIDS/5752SCLDR
RIDS/IEWLDR00#L
RIDS/IEWLUNF0
AB/S0378
PRCS/00000014
RIDS/IEWLRECV#R
DESCRIPTION
----------PROGRAM ID: 5752SCLDR
LOAD MODULE NAME: IEWLDR00
CSECT NAME: IEWLUNF0
SYSTEM ABEND CODE: 0378
ABEND REASON CODE: 00000014
RECOVERY ROUTINE CSECT NAME: IEWLRECV
OTHER SERVICEABILITY INFORMATION
SUBFUNCTION:
LSLOADER
SERVICEABILITY INFORMATION NOT PROVIDED BY THE RECOVERY ROUTINE
RECOVERY ROUTINE LABEL
DATE ASSEMBLED
MODULE LEVEL
TIME OF ERROR INFORMATION
PSW: 07041000 80000000 00000000 012F902E
INSTRUCTION LENGTH: 02
INTERRUPT CODE: 000D
FAILING INSTRUCTION TEXT: 00181610 0A0D18CE 18FB180C
BREAKING EVENT ADDRESS: 00000000_00000000
AR/GR 0-1
00000000/00000000_84000000 00000000/00000000_84378000
AR/GR 2-3
00000000/00000000_00000020 00000000/00000000_0000FC03
AR/GR 4-5
00000000/00000001_008FD098 00000000/00000000_00FD5750
AR/GR 6-7
01FF000C/00000000_00000003 01FF000C/00000001_00F52C00
AR/GR 8-9
00000000/00000001_7F33F4A8 00000000/00000001_00001748
AR/GR 10-11 00000000/00000001_2C417000 01FF000C/00000001_7F36EC88
AR/GR 12-13 00000000/00000000_8651F240 00000000/00000001_7F33F0E8
AR/GR 14-15 00000000/00000000_8651FF54 00000000/00000000_00000014
HOME ASID: 0097
PKM: 00C0
PRIMARY ASID: 0097
AX: 0000
SECONDARY ASID: 0097
EAX: 0000
RTM WAS ENTERED BECAUSE AN SVC WAS ISSUED IN AN IMPROPER MODE.
THE ERROR OCCURRED WHILE: A TYPE 1 SVC WAS IN CONTROL
A LOCKED OR DISABLED ROUTINE WAS IN CONTROL
LOCKS HELD: LOCAL/CML
NO SUPER BITS WERE SET.
RECOVERY ENVIRONMENT
RECOVERY ROUTINE TYPE: FUNCTIONAL RECOVERY ROUTINE (FRR)
PSW AT ENTRY TO FRR: 070C0000 86502368
FRR PARAMETER AREA ON ENTRY TO FRR:
+00 7F33F4A8 00000000 00000000 00000000 00000000 00000000
14-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
RECOVERY ROUTINE ACTION
THE RECOVERY ROUTINE RETRIED TO ADDRESS 0651FFA2.
THE REQUESTED SVC DUMP WAS SUCCESSFULLY STARTED.
NO LOCKS WERE REQUESTED TO BE FREED.
THE SDWA WAS REQUESTED TO BE FREED BEFORE RETRY.
THE REGISTER VALUES TO BE USED FOR RETRY:
REGISTERS 0-7
GR: 008FDD00 00000000 7FFFC100 00000000 008FD098
AR: 00000000 00000000 00000000 00000000 00000000
REGISTERS 8-15
GR: 7F33F4A8 06520100 00FD5750 00000001 8651F240
AR: 00000000 00000000 00000000 01FF000C 00000000
7FFFC150 7FFFBF48 00F52C00
00000000 01FF000C 01FF000C
7F33F0E8 7F33F638 00000000
00000000 00000000 00000000
HEXADECIMAL DUMP
HEADER
+000
40831820
+010
0011778D
00000000
20848000
JOBNAME
+000
D7C9C4C1
F1F0F2F8
SDWA BASE
+000
00000C00
+010
00000000
+020
00000020
+030
00000003
+040
2C417000
+180
+190
00000000
00FFA0B0
04378000
00000000
0000FC03
00F52C00
7F36EC88
.
.
.
00000000
0004336F
17434472
| C.........?....|
|.....D..
|
|PIDA1028
|
00000000
84000000
008FD098
7F33F4A8
8651F240
00000000
84378000
00FD5750
00001748
7F33F0E8
|................|
|........D...D...|
|..........}Q...&|
|.....5..".4Y....|
|...."..HF.2 ".0Y|
00000000
0009BD27
|................|
|....
|
VARIABLE RECORDING AREA (SDWAVRA)
+000
+002
KEY: 37
C4C4D5C1
LENGTH: 06
D4C5
+008
+00A
KEY: 39
6060C8C6
LENGTH: 08
E2606060
.
.
.
+0AA
0003
|DDNAME
|
|--HFS---
|
|..
+0AC
KEY: 53
LENGTH: 00
+0AE
KEY: FF
LENGTH: 00
第 14 章 Logrec エラー・レコードの記録
|
14-27
Logrec エラー・レコードの記録
SDWA FIRST RECORDABLE EXTENSION
+000
E2C3D3C4
D9D3E2D3
+010
40404040
40404040
+020
00000000
00000000
+030
00000000
00000000
.
.
.
+1B0
00000000
00000000
+1C0
D1F5F040
40404040
(SDWARC1)
D6C1C4C5
40404040
00000000
F5F7F5F2
D9404040
00000000
00000014
01000001
|SCLDRLSLOADER
|
|
....|
|................|
|........5752....|
00000000
00000000
|................|
|J50
|
SDWA SECOND RECORDABLE EXTENSION (SDWARC2)
+000
00000000
00000000
00000000
00000000
|................|
SDWA THIRD RECORDABLE EXTENSION (SDWARC3)
+000
00000000
00000000
00000000
+010
00000000
00000000
00000000
00000000
00000000
|................|
|................|
84378000
0000FC03
00FD5750
00F52C00
|....D.......D...|
|................|
|......}Q.......&|
|.............5..|
80000000
|................|
|........
|
SDWA FOURTH RECORDABLE EXTENSION (SDWARC4)
+000
00000000
84000000
00000000
+010
00000000
00000020
00000000
+020
00000001
008FD098
00000000
+030
00000000
00000003
00000001
.
.
.
+150
00000000
00000000
07041000
+160
00000000
012F902E
ERRORID
+000
02F50056
00970009
BD27
|.5...P....
|
TYPE: SOFTWARE RECORD
この詳細編集報告書が SDWA タイプのレコードに関するものであることを示し
ます。
REPORT DATE
EREP 報告書の作成日付を示します。
ERROR DATE
エラーの発生日付を示します。
TIME
エラーの発生時刻 (ローカル時刻) を示します。
JOBNAME
ジョブ名が NONE-FRR である場合には、記録されたエラーは、機能リカバリ
ー・ルーチン (FRR) が取り扱うシステムまたはサブシステム・コード内で発生
したものです。
SYSTEM NAME
SDWA タイプのレコードが作成されたシステムの名前を示します。
ERRORID
Logrec、コンソール・ログ (SYSLOG)、およびシステム・ダンプから得られた診
断情報を調整できるようにします。ERRORID は、以下の情報を連結したもので
す。
SEQ
14-28
各エラーに割り当てられた固有の番号。このシーケンス番号はエラーの
シーケンスを示していますが、レコードは順番どおりにリストされてい
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
ない可能性があります。どのエラーが最初に発生したのかを知るには、
すべての項目をスキャンしてシーケンス番号を調べることが重要です。
リカバリー機能委任の結果として複数のリカバリー・ルーチンが制御権
を獲得し、同じエラーの記録を要求した場合には、複数の項目で同じシ
ーケンス番号が使用されていることがあります。ただし、このような場
合にも、エラーのタイム・スタンプは異なっています。
CPU
失敗したプロセスがエラー発生時に実行されていた中央処理装置の内部
識別番号。この CPU に関するシステム・トレース・テーブルから得ら
れた情報を使用して、エラーに関する追加情報を入手してください。
ASID
エラーの発生時における現行 (すなわちホーム) アドレス・スペースの
アドレス・スペース ID (ASID)。
TIME
エラーの発生時刻を示します。
PIDS/... RIDS/... AB/... PRCS/...
この症状ストリングを使用して、IBM データベースに関する構造化検索を行っ
てください。
PROGRAM ID
このプログラム ID (PID) は、エラーが発生した製品およびコンポーネントを示
します。IBM 製品の場合は、「z/OS MVS 診断: 解説書」内の、製品およびコ
ンポーネントを列挙している表を参照してください。IBM 以外の製品の場合に
は、購入元から提供された該当資料を参照してください。
LOAD MODULE NAME
エラーの発生時に制御権を得ていたロード・モジュールを示します。
CSECT NAME
エラーを取り扱うために制御権が与えられていたリカバリー・ルーチンによって
提供されます。詳細については PSW を参照してください。
SYSTEM ABEND CODE
システム、アプリケーション、またはコンポーネントによって発行されたシステ
ムまたはユーザー完了コードを示します。システム異常終了コードに関する情報
については、 z/OS MVS システム・コード を参照してください。ユーザー異常
終了コードについては、製品に関する該当資料を参照してください。
ABEND REASON CODE
システムまたはユーザー異常終了コードに関連する理由コードが存在する場合に
は、その理由コードを示します。
RECOVERY ROUTINE CSECT NAME
エラー条件を取り扱うために制御権を与えられていたリカバリー・ルーチンを示
します。
PSW
エラー発生時のプログラム状況ワード (PSW) を示します。
ソフトウェア・レコードが SVC 13 である場合、PSW の後半部のアドレスは、
エラーを検出したモジュールのアドレスを示しています。このモジュールの呼び
出し側を探す必要があります。呼び出し側のアドレスは、レジスター 14 に入っ
ています。レジスター 14 がモジュール IEAVEEXP を指している場合には、ソ
第 14 章 Logrec エラー・レコードの記録
14-29
Logrec エラー・レコードの記録
フトウェア・レコードの STATUS セクションを使用して呼び出し側を判別して
ください。STATUS セクションの割り込みコードは、最後に発行された SVC
を示しています。
ソフトウェア・レコードがプログラム割り込みである場合には、PSW の後半部
のアドレスは通常、障害が起こったモジュールを指しています。
FAILING INSTRUCTION TEXT
エラー発生時の 12 バイトの命令ストリームが入っています。この中には、異常
終了の原因となった実命令が含まれます。6 バイトから後の部分で、命令長を引
くと、障害が起こった命令が判別できます。上記の例では、障害が起こった命令
は X'0A0D' です。
THE ERROR OCCURRED WHILE . . .
エラー発生時のシステム環境に関する情報を提供します。この情報は、制御権を
得ていたルーチンのタイプ、ロックが維持されていたかどうか、およびエラー発
生時に監視プログラム FRR が設定されていたかどうかを示しています。
STATUS
エラーに関する制御権を得ていた ESTAE リカバリー・ルーチンに関連した要
求ブロック (RB) から得られた PSW とそれに続くレジスター。ここで示され
た情報を使用すると、エラーの発生時に実行されていたプログラムが判別できま
す。STATUS セクションに含まれているこの情報は、FRR がリカバリーを取り
扱う場合には表示されません。
RECOVERY ROUTINE ACTION
リカバリー・ルーチンによって実行されたか、あるいは実行が要求されたリカバ
リー・アクションを記述します。上記の例では、SVC ダンプが要求されていま
せん。ただし、リカバリー・ルーチンが SVC ダンプを要求することもありま
す。このセクションに SVC DUMP SUCCESSFULLY STARTED と表示されて
いる場合には、SVC ダンプ、および Logrec エラー・レコードに表示されたメ
ッセージ IEA911E にエラー ID (ERROR ID) が示されています。
HEXADECIMAL DUMP
SDWA 制御ブロックの不定様式 16 進ダンプを提供します。 SDWA 内の標識
(これはレコードを生成したリカバリー・ルーチンによって設定されます) に応
じて、 SDWA は 16 進数、EBCDIC テキスト、またはキー、長さ、およびデ
ータのフォーマットで表示されます。
VARIABLE RECORDING AREA (SDWAVRA)
コンポーネント特定の情報を提供します。PROGRAM ID フィールドの情報を使
用してコンポーネントを判別してください。IBM 製品の、システム・コンポー
ネントに関連した診断情報については、「z/OS MVS 診断: 解説書」を参照して
ください。
オプションで、SDWAVRA はキー、長さ、データ・フォーマットでマップでき
ます。リカバリー・ルーチンは SDWAVRA を使用してメッセージを構成し、
データを提供します。このデータには、多くの場合有益なデバッグ情報が含まれ
ています。MVS リカバリー・ルーチンの中には、ソフトウェア発生イベントに
関する標準化された診断情報を提供するために、キー、長さ、データ・フォーマ
ットを使用するものがあります。このフォーマット設定された情報を使用する
と、重複したエラーを選別できます。
14-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
Logrec エラー・レコードの記録
キー・フィールドの定数は、戻りコードまたは理由コード (あるいはその両
方)、パラメーター・リスト、レジスター、および制御ブロック情報などのデー
タを記述するように定義されています。たとえば、X'10' というキーはリカバリ
ー・ルーチンのパラメーター・エリアを表します。(SDWA の固定部分にある)
SDWAVRAM ビットは、SDWAVRA が、IHAVRA マッピング・マクロで記述
されたキー、長さ、データ・フォーマットでマップされていることを示していま
す。
参照
キーの説明を含む、SDWA のフォーマットについては、「z/OS MVS Data
Areas, Vol 4 (RD-SRRA) 」を参照してください。
SDWA RECORDABLE EXTENSIONS
SDWA 標準エリアおよび SDWAVRA 以外に、SDWA 記録可能拡張部分にも次
のような有益なデバッグ情報が含まれています。
v SDWARC1 (記録拡張部分 1) には、コンポーネント・サービス・データ (コ
ンポーネント ID、コンポーネント名、障害の原因となったタスクを表す
TCB のアドレス、制御レジスター、元の完了コードと理由コード、リンケー
ジ・スタック・ポインター、および変換例外アクセス・レジスター番号など)
が含まれています。
v SDWARC2 (記録拡張部分 2) には、追加の入出力マシン・チェック・データ
(マシン・チェック割り込みコードなど) が含まれています。
v SDWARC3 (記録拡張部分 3) には、ロック情報 (解放されるロック、ロック
ワードのアドレスなど) が含まれています。
注: Logrec バッファー内の SDWA は圧縮された SDWA であり、その中の記
録可能拡張部分は、SDWAVRA の使用済み部分の直後から始まります。
SDWAURAL には SDWAVRA の長さが入っています。
症状レコードに関する詳細編集報告書
SYMREC マクロは、システム環境情報を使用して症状レコードを更新し、その後、
この症状レコードを Logrec データ・セットまたは Logrec ログ・ストリームに記録
します。システムまたはアプリケーションは、SYMREC マクロを使用して症状レコ
ードを作成します。 ADSR マッピング・マクロは、症状レコードをマップします。
この症状レコードには、アプリケーションによって決められた診断情報が含まれて
います。
アプリケーションまたはシステム・コンポーネントは、処理中にエラーを検出する
と、診断情報を症状レコードに格納し、SYMREC マクロを発行してレコードをログ
します。診断情報は、プログラミング障害の記述、および障害が発生した環境の記
述からなります。
参照
v SYMREC マクロについての情報は、「z/OS MVS プログラミング: アセンブラ
ー・サービス解説書 第 2 巻 (IARR2V-XCTLX)」を参照してください。
v ADSR データ・エリアについての情報は、「z/OS MVS Data Areas, Vol 1
(ABEP-DALT)」を参照してください。
第 14 章 Logrec エラー・レコードの記録
14-31
Logrec エラー・レコードの記録
報告書出力: 次の 2 つの部分からなる例は、システムによって作成された 1 つの
レコードから得られた出力を示しています。例の後には、診断のために特に重要な
フィールドのリストを示します。強調表示されたフィールドについてだけ説明しま
す。
TYPE:
SYMPTOM RECORD
SCP:
VS 2 REL 3
REPORT:
MODEL:
SERIAL:
SOFTWARE EDIT REPORT
DAY.YEAR
REPORT DATE: 176.92
ERROR DATE: 175.92
9021
HH:MM:SS.TH
031347
TIME: 10:41:14.37
SEARCH ARGUMENT ABSTRACT:
PIDS/5752SC1CM AB/S080A PRCS/00000010 RIDS/IEAVTRSR
RIDS/IGC0101C#L FLDS/SR#ORIGIN VALU/CIEAVTRSR PCSS/FAILING
SYSTEM ENVIRONMENT:
CPU MODEL: 9021
CPU SERIAL: 031347
SYSTEM:
CPUR
DATE: 175
92
TIME: 10:41:14.37
BCP:
MVS
RELEASE LEVEL OF SERVICE ROUTINE:
SYSTEM DATA AT ARCHITECTURE LEVEL:
COMPONENT DATA AT ARCHITECTURE LEVEL:
SYSTEM DATA:
00000000 00000000
JBB4422
10
10
|........|
COMPONENT INFORMATION:
COMPONENT ID:
COMPONENT RELEASE LEVEL:
DESCRIPTION OF FUNCTION:
5752SC1CM
D10
RTM2 RECURSION ERROR RECORDING
PRIMARY SYMPTOM STRING:
PIDS/5752SC1CM AB/S080A PRCS/00000010 RIDS/IEAVTRSR
RIDS/IGC0101C#L FLDS/SR#ORIGIN VALU/CIEAVTRSR PCSS/FAILING
PCSS/CSECT PCSS/UNKNOWN FLDS/RTM2SCTC FLDS/FROM#PRWA
VALU/H00040000
SYMPTOM
--------------PIDS/5752SC1CM
AB/S080A
PRCS/00000010
RIDS/IEAVTRSR
RIDS/IGC0101C#L
FLDS/SR#ORIGIN
VALU/CIEAVTRSR
PCSS/FAILING
PCSS/CSECT
PCSS/UNKNOWN
FLDS/RTM2SCTC
FLDS/FROM#PRWA
VALU/H00040000
14-32
SYMPTOM DATA
------------5752SC1CM
080A
00000010
IEAVTRSR
IGC0101C#L
SR#ORIGIN
IEAVTRSR
FAILING
CSECT
UNKNOWN
RTM2SCTC
FROM#PRWA
00040000
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
EXPLANATION
----------COMPONENT IDENTIFIER
ABEND CODE - SYSTEM
RETURN CODE
ROUTINE IDENTIFIER
ROUTINE IDENTIFIER
DATA FIELD NAME
ERROR RELATED CHARACTER VALUE
SOFTWARE STATEMENT
SOFTWARE STATEMENT
SOFTWARE STATEMENT
DATA FIELD NAME
DATA FIELD NAME
ERROR RELATED HEXADECIMAL VALUE
Logrec エラー・レコードの記録
SECONDARY SYMPTOM STRING:
FLDS/RTM2SCTR VALU/H00040000 FLDS/RTM2SCTX VALU/H00040000
SYMPTOM
--------------FLDS/RTM2SCTR
VALU/H00040000
FLDS/RTM2SCTX
VALU/H00040000
SYMPTOM DATA
------------RTM2SCTR
00040000
RTM2SCTX
00040000
EXPLANATION
----------DATA FIELD NAME
ERROR RELATED HEXADECIMAL VALUE
DATA FIELD NAME
ERROR RELATED HEXADECIMAL VALUE
FREE FORMAT COMPONENT INFORMATION:
KEY = FF00
+000
+010
LENGTH = 00048 (0030)
C5D9D9D6
E840D9E3
D940C4C5
D4F240D9
.
.
.
E3C5C3E3
C5C3E4D9
C5C440C2
E2C9E5C5
|ERROR DETECTED B|
|Y RTM2 RECURSIVE|
00000000
90210000
0092175F
10411437
|<C.......K. ....|
|W.......
|
F2F1F0F3
A5ED4104
E4D94040
.
.
.
F1F3F4F7
40404040
4040F5F7
00000000
40404040
F5F2D1C2
|SR9021031347....|
|VSS.V...
|
| CPUR
5752JB|
HEX DUMP OF RECORD:
HEADER
+000
+010
4C831800
A6031347
SYMPTOM RECORD
+000
+010
+020
E2D9F9F0
A5E2A254
4040C3D7
TYPE: SYMPTOM RECORD
この詳細編集報告書が症状レコードに関するものであることを示します。
SEARCH ARGUMENT ABSTRACT
検索引き数の作成に使用できる情報を提供します。このフィールドで十分な情報
が提供されている場合には、IBM サービス・リンク問題報告データベースを検
索して、エラーを訂正するための PTF があるかどうかを判別できます。
症状レコード内の検索引き数要約の後の情報は、ユーザー・プログラムまたはシ
ステム・コンポーネントによって SYMREC マクロで指定されたオプションに
応じて異なります。上記の報告書出力では、システムによって再帰的エラーが記
録されています。症状レコード内の情報は様々です。この情報を解釈するには、
レコードを作成した製品またはコンポーネントに関して IBM サポートにご連絡
ください。
症状レコードの場所のカスタマイズ: 非許可プログラムから得られる Logrec 症状
レコードの場所を制御することができます。Logrec レコードを書き込む直前に
ASREXIT インストール・システム出口を使用して、以下を制御します。
v プログラムで症状レコードを書き込めるようにするかどうか。
v 症状レコードの場所: Logrec データ・セット、ジョブ・ログ、その両方、あるい
はいずれにも置かない。
第 14 章 Logrec エラー・レコードの記録
14-33
Logrec エラー・レコードの記録
参照
ASREXIT についての情報は、「z/OS MVS 導入システム出口」を参照してくださ
い。
14-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 15 章 AMBLIST
AMBLIST は次の問題データを提供します。
v オブジェクト・モジュールのフォーマット設定されたリスト
v ロード・モジュールまたはプログラム・オブジェクト内の制御セクション
(CSECT) のマップ。
v CSECT 内のコードの修正リスト。
v リンク・パック域 (LPA) 内のすべてのモジュールのマップ。
v DAT-on 中核の内容のマップ。このマップはもはや IPL バージョンを表さなくな
り、メッセージ AMB129I が発行されます。
これらのフォーマット設定されたリストを使用して、ユーザーのシステムに現在存
在するモジュールと関連した問題の診断に役立ちます。AMBLIST は問題プログラ
ム状態で実行するバッチ・ジョブです。
主要トピック
以下のトピックで、AMBLIST について説明します。
v 15-2 ページの『AMBLIST 出力の入手』
v 15-17 ページの『AMBLIST 出力の読み方』
長い名前のサポート
AMBLIST は、長さが 32767 バイトまでの外部名 (ラベルおよび参照) を処理しま
す。 16 バイトを超える長さの名前は、リストのフォーマット設定された部分では
省略して表示され、長い名前の省略形名参照表がリストの最後に印刷されます。長
い名前をサポートする AMBLIST 機能は、 LISTLOAD、LISTIDR および LISTOBJ
(XSD と GOFF のみ) です。
注:
1. AMBLIST がフォーマット設定し印刷するすべてのロード・モジュールは、リン
ケージ・エディターまたはプログラム管理バインダーが作成するものと同じフォ
ーマットでなければなりません。
2. AMBLIST がフォーマット設定し印刷する、すべてのプログラム・オブジェクト
はプログラム管理バインダーが作成するものと同じフォーマットでなければなり
ません。
3. 編集不可属性を持ったプログラム・オブジェクト形式 2 またはそれ以上は、
AMBLIST でリストできません。
ロード・モジュールとプログラム・オブジェクトのフォーマット設定された出力の
比較は、 15-56 ページの『LISTLOAD OUTPUT=XREF 出力 (ロード・モジュールと
プログラム・オブジェクト・バージョン 1 との比較)』を参照してください。
© Copyright IBM Corp. 1988, 2008
15-1
AMBLIST
AMBLIST 出力の入手
AMBLIST 出力を入手する場合は、JCL をコーディングする必要があります。ジョ
ブへの入力として制御ステートメントを提供してください。これらの制御ステート
メントが AMBLIST が作成する情報のタイプを決定します。
このセクションでは、次の項目を説明します。
v 『JCL ステートメントの指定』
v 『AMBLIST 処理の制御』
v 15-7 ページの『AMBLIST を実行する例』
v 15-16 ページの『z/OS UNIX ファイル・サポートの例』
JCL ステートメントの指定
通常、LISTLPA 以外のすべての機能について AMBLIST を実行する場合、必要な
最小の区画または領域は 64 キロバイトです。LISTLPA は 100 キロバイトが必要
です。ただし、大きなロード・モジュールについては、最小領域サイズを 200 キロ
バイトにすることをお勧めします。プログラム・オブジェクトについては、12 メガ
バイトの最小領域サイズをお勧めします。
AMBLIST では、次の JCL ステートメントが必要です。
JOB
ジョブの開始。
EXEC PGM=AMBLIST
AMBLIST 処理の呼び出し。
SYSPRINT DD
メッセージ・データ・セットの定義。
Anyname DD
入力データ・セットの定義。このステートメントは、z/OS UNIX ファイルを定
義する場合があります。定義する場合は、ファイル名を含む完全パス名を指定す
る必要があります。 z/OS UNIX ファイル内のオブジェクト・モジュールには、
PATHOPTS=(ORDONLY) の指定が必要です。このステートメントで連結デー
タ・セットを定義することはできません。
SYSIN DD
AMBLIST 制御ステートメントを含むデータ・セットを定義します (入力ストリ
ーム内で)。
AMBLIST 処理の制御
入力ストリーム内で 1 つまたは 複数の制御ステートメントを提供して、AMBLIST
処理を制御することができます。次の規則に従って、入手したいデータに適用され
る制御ステートメントをコーディングしてください。
v オプションの記号名を定義したくない場合は、カラム 1 をブランクにしてくださ
い。記号名は、プログラムにおけるラベル名と似ています。記号名の最大長は 8
文字です。記号名は 1 つまたは 複数のブランクで終了する必要があります。
v 1 つの制御ステートメント全体が単一行内に収まらない場合は、最初の行をコン
マで終了するかまたはカラム 72 に非ブランク文字を置き、次の行に続けてくだ
さい。すべての継続ステートメントは、カラム 2 から 16 で始めてください。パ
15-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
ラメーターは 2 つの行に分割しないでください。唯一の例外は MEMBER パラ
メーターで、任意のコンマで分割することができます。
LISTLOAD 制御ステートメント
LISTLOAD 制御ステートメントを使用して、ロード・モジュールまたはプログラ
ム・オブジェクトのリストを入手することができます。リストされたデータを使用
して、なぜ特定のリンク・エディット・エラーが起こったのかを検証することがで
きます。
LISTLOAD
|
[OUTPUT={MODLIST|XREF|BOTH|MAP}]
[,TITLE=(’title’,position)]
[,DDN=ddname]
[,MEMBER={member|(member1,membern...)}]
[,RELOC=hhhhhhhh]
[,ADATA={YES|NO}]
|
OUTPUT={MODLIST|XREF|BOTH|MAP}
OUTPUT=MODLIST はロード・モジュールまたはプログラム・オブジェクトの
テキストと制御情報のフォーマット設定されたリストを要求します。
OUTPUT=XREF は、ロード・モジュールとプログラム・オブジェクトのモジュ
ール・マップと相互参照リストを要求します。
OUTPUT=BOTH は、ロード・モジュールまたはプログラム・オブジェクトのフ
ォーマット設定されたリストと、そのマップと相互参照を要求します。
|
|
OUTPUT=MAP は、ロード・モジュールとプログラム・オブジェクトの数値マ
ップを要求します。
このパラメーターを省略すると、OUTPUT=BOTH が想定されます。
TITLE=(’title’,position)
出力の各ページのヘッディング行の下に印刷される、 1 から 40 文字の長さの
表題を指定します。(ヘッディング行はページ番号と印刷するリストのタイプを
識別し、ユーザーが制御できるものではありません。) POSITION サブパラメー
ターは、表題を字下げするかどうかを指定します。TITLE=(’title’,1) を指定する
か、または POSITION サブパラメーターを指定しないと、表題は左そろえ、す
なわち最初のカラムから印刷されます。表題をマージンから字下げしたい場合
は、 POSITION パラメーターを使用して表題の前にブランクをあける文字数を
指定します。80 以上の位置を指定すると、マージンからの字下げはデフォルト
で 1 になります。
DDN=ddname
入力オブジェクト・モジュールを含んでいるデータ・セットを定義する DD ス
テートメントを識別します。DDN= パラメーターを省略すると、AMBLIST は
デフォルトの DD 名として SYSLIB を想定します。
MEMBER={member|(member1,membern...)}
メンバー名または別名で、入力ロード・モジュールまたはプログラム・オブジェ
第 15 章 AMBLIST
15-3
AMBLIST
クトを識別します。複数のロード・モジュールまたはプログラム・オブジェクト
を指定するには、それらの名前をコンマで区切って括弧に入れます。MEMBER=
パラメーターを省略すると、AMBLIST はデータ・セット内のすべてのモジュー
ルを印刷します。
注:
1. MEMBER=IEANUCxx を指定すると (ここで xx は、現行 IPL 間で使用す
るメンバーの接尾部)、 AMBLIST は DAT-ON 中核をリストします。
2. AMBLIST は、63 バイトの長さまでのメンバー名を処理できます。63 バイ
トより長い別名については、基本メンバー名を代わりに入力してください。
3. この操作に関連する DD 名が z/OS UNIX ディレクトリーに割り振られてい
る場合は、リストされているディレクトリーにファイル (複数可) を持つ対
応 MEMBER= が存在しなければなりません。
RELOC=hhhhhhhh
最大の 8 文字の再配置アドレスまたは基底アドレスを、16 進表示で指定しま
す。再配置アドレスを、各相対マップと相互参照アドレスに加算すると、それは
出力リスト上の各項目についての絶対中央記憶装置アドレスを示します。
RELOC パラメーターを指定すると、再配置は行われません。
ADATA={YES|NO}
LISTLOAD OUTPUT=MODLIST または OUTPUT=BOTH の場合に
ADATA=YES を指定すると、指定した出力パラメーターによる出力リストの他
に、プログラム・オブジェクト内のすべての ADATA クラス (存在する場合)
のフォーマット設定されたリストを、1 行 32 バイトで、16 進数は左側に、
EBCDIC は右側の従来のダンプ・フォーマットで表示する要求になります。
LISTLOAD OUTPUT=MODLIST または OUTPUT=BOTH の場合 OUTPUT=NO
を指定することにより、指定した出力パラメーターによりフォーマット設定され
た通常の一覧を要求し、ADATA は延期されます。
このパラメーターを省略すると、ADATA=NO が想定されます。
LISTOBJ 制御ステートメント
LISTOBJ 制御ステートメントを使用して、選択したオブジェクト・モジュールの一
覧を獲得します。LISTOBJ は、XOBJ または GOFF 形式のオブジェクト・モジュ
ールと同様に、従来のオブジェクト・モジュールをサポートします。
LISTOBJ
[TITLE=(’title’,position)]
[,DDN=ddname]
[,MEMBER={member|(member1,membern...)}]
TITLE=(’title’,position)
出力の各ページのヘッディング行の下に印刷される、 1 から 40 文字の長さの
表題を指定します。(ヘッディング行はページ番号と印刷するリストのタイプを
識別し、ユーザーが制御できるものではありません。) POSITION パラメーター
は、表題を字下げするかどうかを指定します。TITLE=(’title’,1) を指定するか、
または POSITION サブパラメーターを指定しないと、表題は左揃え、すなわち
最初のカラムから印刷されます。表題をマージンから字下げしたい場合は、
15-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
POSITION パラメーターを使用して表題の前にブランクをあける文字数を指定
します。80 以上の位置を指定すると、マージンからの字下げはデフォルトで 1
になります。
DDN=ddname
入力モジュールを含んでいるデータ・セットを定義する DD ステートメントを
識別します。DDN パラメーターを省略すると、AMBLIST はデフォルトの DD
名として SYSLIB を想定します。
MEMBER={member|(member1[,membern]...)}
入力オブジェクト・モジュールをメンバー名または別名で識別します。複数のオ
ブジェクト・モジュールを指定する場合は、名前の一覧を括弧で囲み、名前をコ
ンマで区切ります。
注:
1. 入力オブジェクト・モジュールが区分データ・セット (PDS または PDSE)
のメンバーとして存在する場合は、MEMBER パラメーターを含めなければ
なりません。MEMBER パラメーターを指定しないと、AMBLIST は入力デ
ータ・セットが順次に編成され、単一の連続したオブジェクト・モジュール
を含んでいると想定します。
2. AMBLIST は、63 バイトの長さまでのメンバー名を処理できます。63 バイ
トより長い別名については、基本メンバー名を代わりに入力してください。
|
|
|
3. この操作に関連する DD 名が z/OS UNIX ディレクトリーに割り振られてい
る場合は、リストされているディレクトリーにファイル (複数可) を持つ対
応 MEMBER= が存在しなければなりません。 この特定の場合には、
MEMBER= ステートメント内のファイル名の長さには 8 文字の制限があり
ます。
LISTIDR 制御ステートメント
LISTIDR 制御ステートメントを使用して、選択した CSECT 識別レコード (IDR)
のリストを入手します。 AMBLIST は、z/OS UNIX ファイル内のプログラム・オ
ブジェクトに対する LISTIDR 制御ステートメントもサポートします。
LISTIDR
[OUTPUT={IDENT|ALL}]
[,TITLE=(’title’,position)]
[,DDN=ddname]
[,MEMBER={member|(member1,membern...)}]
[,MODLIB]
OUTPUT={IDENT|ALL}
AMBLIST がすべての CSECT 識別レコードを印刷すべきか、SPZAP データと
ユーザー・データを含むもののみを印刷するかを指定する必要があります。
OUTPUT=ALL を指定すると、モジュールと関連するすべての IDR が印刷され
ます。OUTPUT=IDENT を指定すると、AMBLIST は SPZAP データとユーザー
が提供したデータを含む IDR のみを印刷します。このパラメーターを省略する
と、AMBLIST はデフォルトの OUTPUT=ALL を想定します。 MODLIB パラ
メーターを指定する場合は、OUTPUT を指定しないでください。
第 15 章 AMBLIST
15-5
AMBLIST
TITLE=(’title’,position)
出力の各ページのヘッディング行の下に印刷される、 1 から 40 文字の長さの
表題を指定します。(ヘッディング行はページ番号と印刷するリストのタイプを
識別し、ユーザーが制御できるものではありません。) POSITION パラメーター
は表題を字下げするかどうかを指定します。TITLE=(’title’,1) を指定するか、
POSITION パラメーターを省略すると、表題は左そろえ、すなわち最初のカラ
ムから開始します。表題をマージンから字下げしたい場合は、 POSITION パラ
メーターを使用して表題の前にブランクをあける文字数を指定します。80 以上
の位置を指定すると、マージンからの字下げはデフォルトで 1 になります。
DDN=ddname
入力モジュールを含んでいるデータ・セットを定義する DD ステートメントを
識別します。DDN パラメーターを省略すると、AMBLIST は SYSLIB をデフォ
ルトの DD 名として想定します。
注: この操作に関連する DD 名が z/OS UNIX ディレクトリーに割り振られて
いる場合は、リストされているディレクトリーにファイル (複数可) を持つ
対応 MEMBER= が存在しなければなりません。
MEMBER={member|(member1,membern...)}
メンバー名または別名で、入力ロード・モジュールまたはプログラム・オブジェ
クトを識別します。複数のロード・モジュールまたはプログラム・オブジェクト
を指定するには、それらの名前をコンマで区切って括弧に入れます。MEMBER
パラメーターを省略すると、AMBLIST はデータ・セット内のすべてのモジュー
ルを印刷します。 MODLIB パラメーターを指定する場合は、MEMBER を指定
しないでください。
注: AMBLIST は、63 バイトの長さまでのメンバー名を処理できます。63 バイ
トより長い別名については、基本メンバー名を代わりに入力してください。
MODLIB
モジュールの要約を AMBLIST が印刷しないようにします。AMBLIST は
SPZAP データまたはユーザー提供のデータを含む IDR を印刷します。モジュ
ール間ではページ替えが起きません。MODLIB を指定すると、 OUTPUT また
は MEMBER パラメーターは無効なパラメーターになります。
LISTLPA 制御ステートメント
LISTLPA 制御ステートメントを使用して、固定リンク・パック域 (LPA) 内の選択
したモジュールのリストを入手します。
LISTLPA [FLPA][,MLPA][,PLPA]
LISTLPA
固定リンク・パック域内、修正リンク・パック域、およびページング可能リン
ク・パック域 (PLPA) のモジュールをリストします。このリストは、各リン
ク・パック域 (LPA) の拡張セクションにあるモジュールを含むマップです。
LISTLPA 制御ステートメントにパラメーターを指定しない場合は、 AMBLIST
は 3 つの LPA すべてからモジュールをマップします。
LISTLPA 制御ステートメントは、動的 LPA をサポートしません。動的 LPA
が LPA の更新に使用されても、その変更は AMBLIST LISTLPA 出力に反映さ
れません。 LISTLPA 制御ステートメントは、新しいオペレーティング・システ
15-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
ム機能をサポートするように拡張されません。代わりに、IPCS の LPAMAP サ
ブコマンドを使用することをお勧めします。このコマンドについては、「z/OS
MVS IPCS コマンド」を参照してください。
FLPA
固定リンク・パック域内のモジュールのマッピングを要求します。
MLPA
修正リンク・パック域内のモジュールのマッピングを要求します。
PLPA
ページング可能リンク・パック域内のモジュールのマッピングを要求しま
す。
AMBLIST を実行する例
ジョブの JCL への入力として制御ステートメントを使用し、AMBLIST を呼び出し
て、出力を提供させることができます。AMBLIST の次の例では、出力を作成する
ために必要な制御ステートメントと、各機能についてのサンプル JCL が含まれま
す。
オブジェクト・モジュールの内容のリスト
AMBLIST を使用して、3 つのタイプのオブジェクト・モジュールをフォーマット
します。
1. OBJ (従来のオブジェクト・モジュール)
2. XOBJ (OBJ に基づく拡張オブジェクト・モジュール)
3. GOFF (汎用化オブジェクト・ファイル・フォーマット)
オブジェクト・モジュールから以下の情報をリストできます。
v ヘッド・レコード (HDR) - このレコードには、文字セットと求められる稼働環境
に関する情報が含まれます。
v 外部シンボル・ディクショナリー項目 (ESD または XSD)
v 再配置ディクショナリー項目 (RLD)
v プログラムのテキスト - 言語翻訳プログラムによる出力としての命令とデータ
(TXT)
v 変換プログラム識別レコード (IDRL) - コンパイラー ID とコンパイル日付が入
る
v ADATA レコード (GOFF のみ)
v LEN レコード (GOFF のみ)
v および終了レコード
オブジェクト・モジュールをリストするためには、LISTOBJ 制御ステートメントで
AMBLIST を呼び出します。
出力例は、 15-23 ページの『LISTOBJ 出力』を参照してください。
第 15 章 AMBLIST
15-7
AMBLIST
例: オブジェクト・モジュールのリスト
この例では、AMBLIST を使用して、入力ストリーム内のオブジェクト・モジ
ュールをフォーマット設定しリストします。
//LSTOBJDK
JOB
MSGLEVEL=(1,1)
//
EXEC
PGM=AMBLIST,REGION=64K
//SYSPRINT
DD
SYSOUT=A
//OBJMOD
DD
*
object module
/*
//SYSIN
DD
*
LISTOBJ
DDN=OBJMOD,
TITLE=(’OBJECT MODULE LISTING FOR MYJOB’,25)
/*
OBJMOD DD ステートメント
すぐあとに続く入力データ・セットを定義します。この場合は、入力デー
タ・セットはオブジェクト・モジュールです。
SYSIN DD ステートメント
AMBLIST 制御ステートメントを含む、すぐあとに続くデータ・セットを
定義します。
LISTOBJ 制御ステートメント
OBJMOD DD ステートメントで定義するデータ・セットを AMBLIST に
フォーマット設定させます。また出力の各ページの表題を左方マージンか
ら 25 文字字下げするように指定します。
15-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
例: 複数のオブジェクト・モジュールのリスト
この例では AMBLIST を使用して、 OBJMOD という名前のデータ・セット
に含まれるすべてのオブジェクト・モジュールと、OBJMODS と呼ばれる別の
データ・セットから 3 つの特定のオブジェクト・モジュールをリストしま
す。
注: AMBLIST を使用してプログラム・オブジェクトをリストする場合は、
REGION=12M またはそれ以上を指定することをお勧めします。
//OBJLIST
JOB
MSGLEVEL=(1,1)
//LISTSTEP
EXEC
PGM=AMBLIST,REGION=64K
//SYSPRINT
DD
SYSOUT=A
//OBJLIB
DD
DSN=OBJMODS,DISP=SHR
//OBJSDS
DD
DSN=OBJMOD,DISP=SHR
//SYSIN
DD
*
LISTOBJ
DDN=OBJSDS,
TITLE=(’OBJECT MODULE LISTING OF OBJSDS’,20)
LISTOBJ
DDN=OBJLIB,MEMBER=(OBJ1,OBJ2,OBJ3),
TITLE=(’OBJECT MODULE LISTING OF OBJ1 OBJ2 OBJ3’,20)
/*
OBJLIB と OBJSDS DD ステートメント
オブジェクト・モジュールを含む入力データ・セットを定義します。
SYSIN DD ステートメント
入力ストリーム内で AMBLIST 制御ステートメントを含むデータ・セット
を定義します。
LISTOBJ 制御ステートメント #1
OBJSDS DD ステートメントで定義するデータ・セットを単一メンバーと
して扱い、AMBLIST にフォーマット設定させます。また出力の各ページ
の表題を左方マージンから 20 文字字下げするように指定します。
LISTOBJ 制御ステートメント #2
OBJLIB DD ステートメントで定義する区分データ・セット (PDS または
PDSE) の 3 つのメンバーを、AMBLIST にフォーマット設定させます。
また出力の各ページの表題を左方マージンから 20 文字字下げするように
指定します。
ロード・モジュールまたはプログラム・オブジェクト内の CSECT をマッ
プする
ロード・モジュールまたはプログラム・オブジェクト内の CSECT の編成、オーバ
ーレイ構造 (存在する場合)、各 CSECT についての相互参照をリストすることがで
きます。
CSECT をマップする場合は、 AMBLIST を LISTLOAD 制御ステートメントを使
用して呼び出してください。
第 15 章 AMBLIST
15-9
AMBLIST
出力例は、 15-32 ページの『LISTLOAD OUTPUT=MODLIST 出力』、 15-54 ペー
ジの『英字相互参照』、および 15-56 ページの『LISTLOAD OUTPUT=XREF 出力
(ロード・モジュールとプログラム・オブジェクト・バージョン 1 との比較)』を参
照してください。
15-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
例: 複数のロード・モジュールあるいはプログラム・オブジェクトのリスト
この例では、複数のロード・モジュールあるいはプログラム・オブジェクトのフォーマット設定されたリストを
作成するために AMBLIST が使用されます。
注: AMBLIST を使用してプログラム・オブジェクトをフォーマットする場合は、REGION=2M またはそれ以上
を指定することをお勧めします。
//LOADLIST
JOB
MSGLEVEL=(1,1)
//LISTSTEP
EXEC
PGM=AMBLIST,REGION=64K
//SYSPRINT
DD
SYSOUT=A
//SYSLIB
DD
DSNAME=SYS1.LINKLIB,DISP=SHR
//LOADLIB
DD
DSNAME=LOADMOD,DISP=SHR
//SYSIN
DD
*
LISTLOAD OUTPUT=MODLIST,DDN=LOADLIB,
MEMBER=TESTMOD,
TITLE=(’LOAD MODULE LISTING OF TESTMOD’,20)
LISTLOAD OUTPUT=XREF,DDN=LOADLIB,
MEMBER=(MOD1,MOD2,MOD3),
TITLE=(’XREF LISTINGS OF MOD1 MOD2 AND MOD3’,20)
LISTLOAD TITLE=(’XREF&LD MOD LSTNG-ALL MOD IN LINKLIB’,20)
/*
SYSLIB DD ステートメント
フォーマット設定すべきロード・モジュールまたはプログラム・オブジェクトを含む入力データ・セット、
SYS1.LINKLIB を定義します。
LOADLIB DD ステートメント
2 番目の入力データ・セットを定義します。
SYSIN DD ステートメント
AMBLIST 制御ステートメントを含むデータ・セットを定義します (入力ストリーム内で)。
LISTLOAD 制御ステートメント #1
外部記号辞書を含む制御レコードとテキスト・レコードと、 LOADLIB DD ステートメントで定義されたデ
ータ・セット内のロード・モジュールまたはプログラム・オブジェクト TESTMOD の再配置辞書レコード
を AMBLIST がフォーマット設定するようにします。また出力の各ページの表題を左方マージンから 20 文
字字下げするように指定します。
LISTLOAD 制御ステートメント #2
LOADLIB DD ステートメントで定義されたデータ・セット内のロード・モジュールまたはプログラム・オ
ブジェクトの MOD1、MOD2、および MOD3 のモジュール・マップと相互参照リストを AMBLIST に作成
させます。また出力の各ページの表題を左方マージンから 20 文字字下げするように指定します。
LISTLOAD 制御ステートメント #3
ロード・モジュールまたはプログラム・オブジェクトからのフォーマット設定されたリストとそのマップと
相互参照リストなどを AMBLIST が作成するようにします。DDN= パラメーターが含まれていないので、入
力データ・セットは SYSLIB DD ステートメントで定義されたものであると想定します。MEMBER パラメ
ーターが指定されていないので、データ・セット内のすべてのロード・モジュールが処理されます。この制
御ステートメントは、また出力の各ページの表題を左方マージンから 20 文字字下げするように指定しま
す。
第 15 章 AMBLIST
15-11
AMBLIST
例: 複数のロード・モジュールあるいはプログラム・オブジェクトのリスト
この例では、AMBLIST を使用して、この 3 つのモジュールを検証する方法を示します。1 つの大きなロード・
モジュールまたはプログラム・オブジェクトを作成するために、2 つのロード・モジュールまたはプログラム・
オブジェクトを使用して 1 つのオブジェクト・モジュールをリンク・エディットしようとしましたが、それが成
功しなかったと想定してください。
>
//LSTLDOBJ
JOB
MSGLEVEL=(1,1)
//
EXEC
PGM=AMBLIST,REGION=64K
//SYSPRINT
DD
SYSOUT=A
//OBJMOD
DD
DSN=MYMOD,DISP=SHR
//LOADMOD1
DD
DSN=YOURMOD,DISP=SHR
//LOADMOD2
DD
DSN=HISMOD,DISP=SHR
//SYSIN
DD
*
LISTOBJ
DDN=OBJMOD,
TITLE=(’OBJECT LISTING FOR MYMOD’,20)
LISTLOAD
DDN=LOADMOD1,OUTPUT=BOTH,
TITLE=(’LISTING FOR YOURMOD’,25)
LISTIDR
DDN=LOADMOD1,OUTPUT=ALL,
TITLE=(’IDRS FOR YOURMOD’,25)
LISTLOAD
DDN=LOADMOD2,OUTPUT=BOTH,
TITLE=(’LISTING FOR HSMOD’,25)
LISTIDR
DDN=LOADMOD2,OUTPUT=ALL,
TITLE=(’IDRS FOR HISMOD’,25)
OBJMOD DD ステートメント
入力ロード・モジュールまたはプログラム・オブジェクト・データ・セットを定義します。
LOADMOD1 と LOADMOD2 DD ステートメント
入力ロード・モジュールまたはプログラム・オブジェクト・データ・セットを定義します。
SYSIN DD ステートメント
AMBLIST 制御ステートメントを含むデータ・セットを定義します。
LISTOBJ 制御ステートメント
OBJMOD DD ステートメントで定義するデータ・セットを AMBLIST にフォーマット設定させます。また
出力の各ページの表題を左方マージンから 20 文字字下げするように指定します。
LISTLOAD 制御ステートメント #1
LOADMOD1 DD ステートメントで定義するデータ・セットと関連するすべてのレコードを AMBLIST にフ
ォーマット設定させます。また出力の各ページの表題を左方マージンから 25 文字字下げするように指定し
ます。
LISTIDR 制御ステートメント #1
LOADMOD1 DD ステートメントで定義するデータ・セットと関連するすべての CSECT 識別レコードを
AMBLIST にリストさせます。また出力の各ページの表題を左方マージンから 25 文字字下げするように指
定します。
LISTLOAD 制御ステートメント #2
LOADMOD2 DD ステートメントで定義するデータ・セットと関連するすべてのレコードを AMBLIST にフ
ォーマット設定させます。また出力の各ページの表題を左方マージンから 25 文字字下げするように指定し
ます。
LISTIDR 制御ステートメント #2
LOADMOD2 DD ステートメントで定義するデータ・セットと関連するすべての CSECT 識別レコードを
AMBLIST にリストさせます。また、出力の各ページの表題を左方マージンから 25 文字字下げするように
指定します。
15-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
CSECT 内の実行可能コードの修正のトレース
ロード・モジュールまたはプログラム・オブジェクトの CSECT 識別レコード
(IDR) 内の情報をリストすることができます。IDR は次の情報を提供します。
v 言語翻訳プログラムのバージョンと修正レベルと、各 CSECT が変換された日付
を示します。(変換データは、IDR 生成をサポートする変換プログラムが作成する
CSECT のみが使用できます。)
v リンケージ・エディターまたはロード・モジュールまたはプログラム・オブジェ
クトを作成したバインダーのバージョンと修正レベルを提供し、ロード・モジュ
ールまたはプログラム・オブジェクトが作成された日付を示します。
v 日付ごとに、SPZAP を使用して行われたロード・モジュールまたはプログラム・
オブジェクトへの修正を示します。
IDR にはオプションのユーザー提供データも含まれることがあります。
修正をトレースする場合は、 LISTIDR 制御ステートメントを使用して AMBLIST
を呼び出してください。
出力例は、 15-62 ページの『LISTIDR 出力』を参照してください。
第 15 章 AMBLIST
15-13
AMBLIST
例: 複数のロード・モジュールについての IDR 情報のリスト
この例では、AMBLIST を使用して、複数のロード・モジュールまたはプログラム・オブジェクト内の CSECT
識別レコードをリストします。
//IDRLIST
//LISTSTEP
//SYSPRINT
//SYSLIB
//LOADLIB
//SYSIN
LISTIDR
LISTIDR
LISTIDR
LISTIDR
JOB
MSGLEVEL=(1,1)
EXEC
PGM=AMBLIST,REGION=64K
DD
SYSOUT=A
DD
DSN=SYS1.LINKLIB,DISP=SHR
DD
DSN=LOADMODS,DISP=SHR
DD
*
TITLE=(’IDR LISTINGS OF ALL MODS IN LINKLIB’,20)
OUTPUT=IDENT,DDN=LOADLIB,MEMBER=TESTMOD
TITLE=(’LISTING OF MODIFICATIONS TO TESTMOD’,20)
OUTPUT=ALL,DDN=LOADLIB,MEMBER=(MOD1,MOD2,MOD3),
TITLE=(’IDR LISTINGS OF MOD1 MOD2 MOD3’,20)
DDN=LOADLIB,MODLIB
/*
SYSLIB DD ステートメント
処理すべきロード・モジュールまたはプログラム・オブジェクトを含む入力データ・セット SYS1.LINKLIB
を定義します。
LOADLIB DD ステートメント
2 番目の入力データ・セットを定義します。
SYSIN DD ステートメント
AMBLIST 制御ステートメントを含むデータ・セットを定義します (入力ストリーム内で)。
LISTIDR 制御ステートメント #1
SYS1.LINKLIB (DDN パラメーターが含まれていないので、これがデフォルトのデータ・セットです) のす
べてのモジュールについてのすべての CSECT 識別レコードを AMBLIST にリストさせます。また出力の各
ページの表題を左方マージンから 20 文字字下げするように指定します。
LISTIDR 制御ステートメント #2
TESTMOD という名のロード・モジュールまたはプログラム・オブジェクトについての SPZAP またはユー
ザー提供のデータを含む CSECT 識別レコードを AMBLIST にリストさせます。 TESTMOD は LOADLIB
DD ステートメントで定義されたデータ・セットのメンバーです。この制御ステートメントは、また出力の
各ページの表題を左方マージンから 20 文字字下げするように指定します。
LISTIDR 制御ステートメント #3
MOD1、MOD2、および MOD3 のロード・モジュールまたはプログラム・オブジェクトについてのすべての
CSECT 識別レコードを AMBLIST にリストさせます。これらは LOADLIB DD ステートメントで定義され
たデータ・セットのメンバーです。この制御ステートメントは、また出力の各ページの表題を左方マージン
から 20 文字字下げするように指定します。
LISTIDR 制御ステートメント #4
LOADLIB データ・セットについての SPZAP またはユーザー提供データを含む CSECT 識別レコードを
AMBLIST にリストさせます。モジュールの要約印刷出力は抑制されます。
リンク・パック域内のモジュールと DAT-on 中核の内容をリストする
固定リンク・パック域、修正リンク・パック域、およびページング可能リンク・パ
ック域内のすべてのモジュールをリストすることができます。
15-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
リンク・パック域のモジュールをマップする場合は、 LISTLPA 制御ステートメン
トを指定して AMBLIST を呼び出します。
出力例は、 15-65 ページの『LISTLPA 出力』を参照してください。
中核のマップと相互参照リストを作成することもできます。
DAT-on 中核の内容をマップする場合は、 LISTLOAD MEMBER=IEANUCxx 制御
ステートメントを使用して AMBLIST を呼び出します。
例: システム中核とリンク・パック域のリスト
この例では、LISTLOAD と LISTLPA 制御ステートメントを使用してシステム
中核をリストし、固定リンク・パック域、修正リンク・パック域、およびペー
ジング可能リンク・パック域をマップする方法を示します。この例では、中核
を含むデータ・セットの名前は SYS1.NUCLEUS で、その中核は IEANUC01
という名前のメンバーを占有する点に注意してください。マップはもはや中核
の IPL バージョンを示すものではなく、メッセージ AMB129I が発行されま
す。NUCMAP をフォーマット設定するために IPCS を使用します。 IPCS の
使用方法についての情報は、 z/OS MVS IPCS ユーザーズ・ガイド および
z/OS MVS IPCS コマンド を参照してください。
//LISTNUC
JOB
//STEP
EXEC
//SYSPRINT
DD
//SYSLIB
DD
//
VOL=SER=nnnnn
//SYSIN
DD
LISTLOAD
TITLE=(’LISTING
LISTLPA
/*
MSGLEVEL=(1,1)
PGM=AMBLIST,REGION=100K
SYSOUT=A
DSN=SYS1.NUCLEUS,DISP=SHR,UNIT=3330,
*
DDN=SYSLIB,MEMBER=IEANUC01,
FOR NUCLEUS IEANUC01’,25)
SYSLIB DD ステートメント
この場合は、中核を含む入力データ・セットを定義します。
SYSIN DD ステートメント
AMBLIST 制御ステートメントを含む、すぐあとに続くデータ・セットを
定義します。
LISTLOAD 制御ステートメント
SYSLIB DD ステートメントで定義するデータ・セット内のロード・モジ
ュール IEANUC01 の、外部記号辞書レコードと再配置辞書レコードを含
む、制御レコードとテキスト・レコードを AMBLIST にフォーマット設定
させます。また出力の各ページの表題を左方マージンから 25 文字字下げ
するように指定します。
LISTLPA 制御ステートメント
固定リンク・パック域 (FLPA)、修正リンク・パック域 (MLPA)、およびペ
ージング可能リンク・パック域 (PLPA) を AMBLIST にマップさせます。
第 15 章 AMBLIST
15-15
AMBLIST
z/OS UNIX ファイル・サポートの例
AMBLIST は、プログラム・オブジェクトのフォーマット設定されたリスト、およ
び z/OS UNIX ファイル内のオブジェクト・モジュールをサポートします。
z/OS UNIX プログラム・オブジェクトの例
z/OS UNIX ファイル内のプログラム・オブジェクトのフォーマット設定され
たリストを入手するには、DD ステートメントで完全パス名を指定し、制御ス
テートメントをコーディングします。参考として、以下の JCL 例を使用して
ください。
//LIST EXEC PGM=AMBLIST
//HFS1 DD PATH=’/u/USER1/outmod’
//
PATHDISP=(KEEP,KEEP)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
LISTLOAD DDN=HFS1,OUTPUT=MODLIST
z/OS UNIX オブジェクト・モジュールの例
z/OS UNIX ファイル内のオブジェクト・モジュールのフォーマット設定され
たリストを入手するには、DD ステートメントで完全パス名を指定し、制御ス
テートメントをコーディングします。参考として、以下の JCL 例を使用して
ください。
/LIST EXEC PGM=AMBLIST
//HFS1 DD PATH=’/u/USER1/myobject.o’,PATHDISP=(KEEP,KEEP),
//
PATHOPTS=(ORDONLY)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
LISTOBJ DDN=HFS1
z/OS UNIX 制御ステートメントの例
AMBLIST は、z/OS UNIX ファイル内のプログラム・オブジェクトの
LISTIDR 制御ステートメントをサポートします。参考として、以下の JCL 例
を使用してください。
//LIST EXEC PGM=AMBLIST
//HFS1 DD PATH=’/u/USER1/outmod’
//
PATHDISP=(KEEP,KEEP)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
LISTIDR DDN=HFS1
出力の相違点:
z/OS UNIX ファイルでは別名情報は提供されず、代わりに LISTLOAD が以下を出
力します。
MEMBER NAME: **HFS**
LIBRARY:
**HFS**
15-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
MAIN ENTRY POINT: 00000000
AMODE OF MAIN ENTRY POINT: 31
AMBLIST
注: この操作に関連する DD 名が z/OS UNIX ディレクトリーに割り振られている
場合は、リストされているディレクトリーにファイル (複数可) を持つ対応
MEMBER= が存在しなければなりません。
AMBLIST 出力の読み方
AMBLIST はユーザーが指定する各制御ステートメントごとに別々のリストを作成
します。
v 各リストの最初のページには、入力されたとおりの制御ステートメントが必ず表
示されます。
v LISTIDR とともに LISTOBJ、LISTLPA、または MODLIB を要求した場合以外
は、リストの 2 番目のページはモジュールの要約です。 LISTIDR も指定した場
合はモジュールの要約は作成されず、リストの 2 番目のページはフォーマット設
定された出力の始まりです。
モジュール要約には、メンバー名 (および別名)、入り口点とそのアドレッシン
グ・モード、別名入り口点とそのアドレッシング・モード、リンケージ・エディ
ターまたはプログラム管理バインダーによりモジュールに割り当てられた属性、
システム状況索引情報 (SSI)、APF コード、フォーマット設定されているモジュ
ールに関する常駐モードがリストされます。プログラム・オブジェクトでは、
PMAR と PMARL は診断情報に関しては 16 進数、16 進、16 進法で表示され
ます。 図 15-1 および 15-18 ページの図 15-2 は、リンケージ・エディターおよ
びバインダーにより処理されたモジュール要約の例を示しています。
v リストの 3 番目のページ (または、LISTIDR とともに LISTOBJ、LISTLPA、ま
たは MODLIB を指定した場合は 2 番目のページ) は、フォーマット設定された
出力の開始です。
モジュールの要約
LISTLOAD DDN=DD1,MEMBER=TESTPR
A
***** M O D U L E S U M M A R Y *****
MEMBER NAME: TESTPR
MAIN ENTRY POINT:
00000000
LIBRARY:
DD1
AMODE OF MAIN ENTRY POINT: ANY
NO ALIASES **
-----------------------------------------------------------------------------------------------------------------------B
LINKAGE EDITOR ATTRIBUTES OF MODULE *
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
8 NOT-DC
9 ZERO-ORG
10 EP-ZERO
11 RLD
12 EDIT
13 NO-SYMS
14 F-LEVEL
15 NOT-REFR
-----------------------------------------------------------------------------------------------------------------------C
****
MODULE SSI: NONE
APFCODE:
RMODE:
D
00000000
24
*****LOAD MODULE PROCESSED BY VS LINKAGE EDITOR
図 15-1. リンケージ・エディターが処理するロード・モジュールのモジュールの要約例
第 15 章 AMBLIST
15-17
AMBLIST
LISTLOAD DDN=DD1,MEMBER=B#Z49$EA
A
***** M O D U L E S U M M A R Y *****
MEMBER NAME: B#Z49$EA
MAIN ENTRY POINT:
00000000
LIBRARY:
MYLIB
AMODE OF MAIN ENTRY POINT: 31
** ALIASES **
ENTRY POINT
AMODE
A1
00000000
31
A2
00000000
31
** A3
00000000
31
A4
00000000
31
THIS#IS#A-BF6190 00000000
31 ALT PRIMARY
-----------------------------------------------------------------------------------------------------------------------B
**** ATTRIBUTES OF MODULE ***
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
8 DC
9 ZERO-ORG
10 RESERVED
11 RLD
12 EDIT
13 NO-SYMS
14 RESERVED
15 NOT-REFR
16 RESERVED
17 <16M
18 NOT-PL
19 NO-SSI
20 NOT-APF
21 PGM OBJ
22 RESERVED
23 RESERVED
24 ALTP
25 RESERVED
26 RESERVED
27 RMODE24
28 RESERVED
29 RESERVED
30 RESERVED
31 RESERVED
32 MIGRATE
33 NO-PRIME
34 NO-PACK
35 RESERVED
36 RESERVED
37 RESERVED
38 RESERVED
39 RESERVED
-----------------------------------------------------------------------------------------------------------------------C
MODULE SSI:
APFCODE:
RMODE:
PO FORMAT:
OS COMPAT LEVEL:
XPLINK:
D
NONE
00000000
ANY
3
z/OSV1R3
YES
*****PROGRAM OBJECT PROCESSED BY BINDER
E
***THE FOLLOWING ARE THE UNFORMATTED PDSE
PMAR 001E0308 02C00412 00000000 02900000
PMARL 00629040 00000000 00050000 02780000
01400000 00240000 011C0000 00050000
00002001 072F0144 340FD7D4 F6E3C5E2
0178
DIRECTORY
00B80000
10000000
01B40001
E3403000
ENTRY SECTIONS (PMAR AND PMARL)
00B80000 00000000 0000
0B540000 40F40000 00740000
00000000 10000000 00000000
00010000 00180000 20000000
図 15-2. バインダーが処理するプログラム・オブジェクトのモジュールの要約例
次に 15-17 ページの図 15-1 と 図 15-2 について説明します。
A
項目名
メンバーについて、ライブラリー (DD 名) とメンバー名が 1 次入り口点オ
フセットと AMODE とともに表示されます。MEMBER NAME フィールド
は基本名を含んでいます。
各別名と代替入り口点について、AMBLIST は別名、入り口点オフセット、
および AMODE を表示します。別名がない場合は、 AMBLIST は NO
ALIASES と印刷します。入力名が別名の場合は、その名前は 2 つのアスタ
リスクを前に付けて別名セクションに印刷されます。
定数 ALT PRIMARY は、バインダーが別名に変換した長い基本名であった
別名の AMODE の右側に付け加えられます。
B
モジュールの属性
モジュールの属性はビットで表現されます。各ビットは ON または OFF
のいずれかに設定されます。リスト内では、AMBLIST がビットの設定値を
解釈し、 STATUS カラムの説明値を示します。たとえば、 15-17 ページの
図 15-1 と 図 15-2 内では、ビット 0 は NOT-RENT と解釈されます。すな
わち、モジュールは再入可能ではありません。すべての STATUS 値の説明
については、 15-19 ページの表 15-1 を参照してください。
15-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
C
その他の属性
モジュールのその他の属性は、次のテーブルに表示されます。これには、シ
ステム状況索引 (SSI) フィールド、APF (許可プログラム機能) コード、モ
ジュール全体の RMODE (常駐モード)、PO フォーマット (ローダー・デー
タ・レベル)、OS Compat レベル (バインダー・データ・フォーマット)、お
よび XPLINK が入っています。属性ビット 19 が OFF 状態の場合は、
NONE が SSI の場所に表示されます。 SSI は通常、バインダーまたは
SPZAP プログラムの SETSSI 制御ステートメントによって設定されます。
注: z/OS V1R3 未満の OS Compat レベルの場合、Compat レベルは印刷さ
れません。
PO フォーマットおよび XPLINK を適用できるのは、プログラム・オブジ
ェクトの場合のみです。 PO フォーマットはプログラム・オブジェクトの
バージョンです。 XPLINK は、ルーチンによる XPLINK リンケージ規則
の使用の有無を示します。 Compat レベルは、リリースのバインダーがこの
オブジェクトを再バインドできる最下位の OS リリースを指定します。モ
ジュールを実行できるレベルは PO フォーマットによって決まることに注
意してください。
D
リンクしているプログラム
モジュールの要約の最後の行は、このモジュールを作成した、リンクしてい
るプログラム (VS リンケージ・エディターまたはバインダー) を示しま
す。たとえば、
*****PROGRAM OBJECT PROCESSED BY BINDER
これはプログラム・オブジェクトに該当します。
****LOAD MODULE PROCESSED EITHER BY VS LINKAGE EDITOR OR BINDER
ロード・モジュールは、リンケージ・エディターで作成され、バインダーで
処理されるか、またはバインダーで作成され、リンケージ・エディターで処
理されます。
E
PMAR と PMARL
プログラム・オブジェクトでは、PMAR と PMARL が診断目的で 16 進数
で表示されます。以下のように処理されます。
*** THE FOLLOWING ARE THE UNFORMATTED PDSE DIRECTORY ENTRY SECTIONS
(PMAR AND PMARL)
表 15-1. プログラム・オブジェクトとロード・モジュール属性： 最初の欄はビット位置を示します。欄 2 と 3 は、
オフの場合に表示される定数とその意味を示します。欄 4 と 5 はオンの場合に表示される定数とその意味を示しま
す。
ビット位置
OFF 値
意味
ON 値
意味
00
NOT-RENT
モジュールは再入不
可。
RENT
モジュールは再入可
能。
01
NOT-REUS
モジュールは再使用
不可。
REUS
モジュールは再使用可
能。
02
NOT-OVLY
モジュールはオーバ
ーレイ・フォーマッ
トではない。
OVLY
モジュールはオーバー
レイ・フォーマット。
第 15 章 AMBLIST
15-19
AMBLIST
表 15-1. プログラム・オブジェクトとロード・モジュール属性 (続き)： 最初の欄はビット位置を示します。欄 2 と
3 は、オフの場合に表示される定数とその意味を示します。欄 4 と 5 はオンの場合に表示される定数とその意味を
示します。
ビット位置
OFF 値
意味
ON 値
意味
03
NOT-TEST
テスト・オプション
がバインディング中
に指定されなかっ
た。
TEST
テスト・オプションが
バインディング中に指
定された。
04
NOT-OL
すべての CSV マクロ ONLY-LOAD
からプログラムを呼
び出すことができ
る。
LOAD マクロのみで
プログラムをロードす
ることができる。
05
BLOCK
モジュールは単一の
連続するテキスト・
ブロックで構成され
る。このビットはプ
ログラム・オブジェ
クトについては常に
オフです。
SCTR
モジュールを分散ロー
ドすることができる
(MVS 中核のみ)。
06
NON-EXEC
モジュールは実行不
可のマークが付いて
いる。
EXEC
モジュールは実行可能
のマークが付いてい
る。
07
MULTI-RCD
モジュールは複数の
テキスト・レコード
を含んでいる。この
ビットはプログラ
ム・オブジェクトに
ついては常にオフで
す。
1-TXT
モジュールには RLD
項目がなく 1 つのテ
キスト・ブロックのみ
が含まれる。
08
DC
モジュールはリンケ
ージ・エディターの
どのレベルからでも
処理できる。
NOT-DC
モジュールは F レベ
ル以上のリンケージ・
エディターで処理でき
る。このビットはプロ
グラム・オブジェクト
については常にオンで
す。
09
NOT-ZERO
ゼロより大きい最初
のテキスト・ブロッ
クの起点。
ZERO-ORG
最初のテキスト・ブロ
ックの起点かゼロ。こ
のビットはプログラ
ム・オブジェクトにつ
いては常にオンです。
10
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
11
RLD
モジュールは RLD
項目を含んでいる。
NO-RLD
モジュールは RLD 項
目を含んでいない。
12
EDIT
モジュールはバイン
ダーが再処理でき
る。
NOT-EDIT
モジュールはバインダ
ーが再処理できない。
15-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
表 15-1. プログラム・オブジェクトとロード・モジュール属性 (続き)： 最初の欄はビット位置を示します。欄 2 と
3 は、オフの場合に表示される定数とその意味を示します。欄 4 と 5 はオンの場合に表示される定数とその意味を
示します。
ビット位置
OFF 値
意味
ON 値
意味
13
NO-SYMS
モジュールには SYM SYMS
レコードを含んでい
ない。
モジュールには SYM
レコードを含んでい
る。
14
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
15
NOT-REFR
モジュールは再生可
能ではない。
REFR
モジュールは再生可
能。
16
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
注: 次のビットがプログラム・オブジェクトについてのみ表示されます。
17
<16M
モジュール・テキス
ト・サイズは 16 メ
ガバイトより小さ
い。
>16M
モジュール・テキス
ト・サイズは 16 メガ
バイトと等しいか、よ
り大きい。
18
NOT-PL
ページ位置合わせは
ロードされたテキス
トに不要。
P-ALIGN
ページ位置合わせがロ
ードされたテキストに
必要。
19
NO-SSI
システム状況索引が
存在しない。
SSI
システム状況索引が存
在する。
20
NOT-APF
モジュールは APF 許 APF
可ではない。
モジュールは APF 許
可。
21
NOT-PO
これはロード・モジ
ュールである。
PGM OBJ
これはプログラム・オ
ブジェクトである。プ
ログラム・オブジェク
トについては常にオ
ン。
22
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
23
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
24
ALTP
代替基本名
NOT-ALTP
代替基本名ではない
25
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
26
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
27
RMODE24
モジュールは必ず 16
メガバイト以下にロ
ードする。
RMODEANY
モジュールは 2 ギガ
バイト以下のどこでも
ロードできる。
28
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
29
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
第 15 章 AMBLIST
15-21
AMBLIST
表 15-1. プログラム・オブジェクトとロード・モジュール属性 (続き)： 最初の欄はビット位置を示します。欄 2 と
3 は、オフの場合に表示される定数とその意味を示します。欄 4 と 5 はオンの場合に表示される定数とその意味を
示します。
ビット位置
OFF 値
意味
ON 値
意味
30
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
31
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
32
NON-MIGR
MIGRATE
プログラム・オブジ
ェクトは直接 PDS ロ
ード・モジュール・
フォーマットには変
換されません。
プログラム・オブジェ
クトは、直接 PDS ロ
ード・モジュール・フ
ォーマットに変換され
ます。
33
PRIME
FETCHOPT PRIME
オプション
FETCHOPT NOPRIME
オプション
34
PACK
FETCHOPT PACK オ NO-PACK
プション
FETCHOPT NOPACK
オプション
35
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
36
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
37
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
38
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
39
RESERVED
IBM が使用するため
に予約済み。
RESERVED
IBM が使用するため
に予約済み。
15-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
NO-PRIME
AMBLIST
LISTOBJ 出力
図 15-3. オブジェクト・モジュール付きの LISTOBJ 出力例
OBJ と XOBJ レコードのレコード・フォーマットは同じですが、例外は、XOBJ モ
ジュールには ESD レコードではなく XSD レコードが含まれていることです。
XSD レコードを除いて、AMBLIST はオブジェクト・モジュール中のレコードを 1
回に 1 レコードずつフォーマット設定します。 XSD レコードは 32767 文字まで
の名前をサポートします。これらの名前は、複数レコードにまたがっても構いませ
んが、このような複数レコードは AMBLIST 出力の中では単一の XSD レコードと
してリストされます。この名前が 16 桁よりも長い場合、16 桁の省略名が XSD と
一緒に印刷されます。省略名を実際の名前にマッピングする省略形名参照表が、リ
ストの最後に印刷されます。
参照
OBJ のフォーマットおよび XOBJ レコード・フォーマットについては、「z/OS
MVS プログラム管理: 拡張機能」の ESD データ項目の説明を参照してください。
OBJECT MODULE LISTING
MEMBER= CALLEDA
PAGE 0001
LIST OF CALLEDA
XSD RECORD:
00000001
ESDID
TYPE
NAME
ADDR
R/R/A ID/LTH
0001 SD(00) CAN_BE_ABBRV_16B 000000
06
0000BC
TXT:
00000002
ADDR=000000 ESDID= 0001 TEXT: 90ECD00C 0DC050D0 C07241E0 C06E50E0 D00818DE 1B115010 C0660700 4510C048 80000070 00000003
02250000 C3C1D3D3 C5C4C140 C1C2D6E4
TXT:
00000004
ADDR=000038 ESDID= 0001 TEXT: E340E3D6 40D9C5E3 E4D9D540 E3D640C3 C1D3D3C5 D9
TXT:
00000005
ADDR=00004E ESDID= 0001 TEXT: 0A234100 00014110 C0660A01 1BFF58D0 D00458E0 D00C980C D0140B0E 00000000 0000E7E7
RLD RECORD:
R PTR P PTR FLAGS ADDR R PTR P PTR FLAGS ADDR R PTR P PTR FLAGS ADDR
00000006
0001
0001
0D
000020 0001
0001
0C
000024
END RECORD:
1566896201 020191248
00000007
図 15-4. XSD レコード付きの LISTOBJ 出力例
第 15 章 AMBLIST
15-23
AMBLIST
***** G E N E R A L I Z E D O B J E C T F I L E F O R M A T *****
PAGE
1
OBJECT MODULE LISTING
RECORD TYPE: HDR
SEQUENCE:
--- CHARACTER SET -ID
NAME
>
1
LANGUAGE
PRODUCT
HDR
VERSION
00000
MODULE
PROPERTIES
00000
RECORD TYPE: ESD
SEQUENCE:
2
ESD OWNER/
ITEM
ITEM
NAME
ESDID TYPE PARENT OFFSET
LENGTH SP/S
---------------- ATTRIBUTES ----------------BA AMD RMD REUS AL TXT ORD STR BINDER
>000001 SD
N/A
N/A
NAME(CSECT)
N/A N/A N/A
>000002 ED
000001
NAME(B_TEXT)
0
1C 01-N/A C
N/A N/S
N/A 03 B-U N/A N/A L,A,C
>000004 ED
000001
NAME(B_IDRL)
0
0 01-N/A C
N/A N/S
N/A 00 F-U N/A N/A C
>000003 LD
000002
NAME(CSECT)
0
N/A
N/A
N/A
01-N/S N/A ANY N/A
N/S N/A N/A N/A N/A N/A
N/A N/A N-U N/A
S
N/A
SIGNATURE
N/A
N/A
N/A
00000000
RECORD TYPE: TEXT
SEQUENCE:
6
-- RESIDENT -TRUE
TEXT
ENCODED
ESDID OFFSET
LENGTH ENCODING LENGTH
------------------------------ T E X T ------------------------------
>000002 00000000 00000000
0000
0000000C
58C07010 58C07014 41C07018
>000002 00000010 00000000
0000
0000000C
00000001 00000004 0000001F
RECORD TYPE: RLD
SEQUENCE:
8
R-PTR P-PTR OFFSET TYPE LEN ATTRIB R-PTR P-PTR OFFSET TYPE LEN ATTRIB
>000002 000002 000010 00+ 004
000002 000002 000014 00+ 004
RECORD TYPE: IDRL
SEQUENCE:
9
ESDID
|---- IDR DATA ----|
>000004
|---- IDR DATA ----|
|---- IDR DATA ----|
|569623400.010295104|
RECORD TYPE: END
SEQUENCE:
RECORD
--ENTRY POINT-COUNT
ESDID
OFFSET
>000000
|---- IDR DATA ----|
R-PTR P-PTR OFFSET TYPE LEN ATTRIB
000002 000002 000018 00+ 004
N/S
10
N/S
図 15-5. GOFF レコード付きの LISTOBJ 出力例
GOFF に関する LISTOBJ 出力
GOFF オブジェクト・リストは、機能と内容において従来のオブジェクト・モジュ
ールについての LISTOBJ フォーマットと類似しています。出力は 1 回に 1 論理
レコードずつフォーマット設定されます。論理レコードは、最初の物理レコード
(レコード・タイプを含む) とすべての継続レコードの連結を表します。レコード内
の名前が 16 桁よりも長い場合、16 桁の省略名が印刷されます。省略名でない名前
は、省略形名参照表を省略名で見て検索できます。この表はリストの最後に印刷さ
れます。論理レコードは、1 カラム目のディンバット (“>”) により高輝度表示され
ます。
レコード・グループには同じタイプのレコードが 1 つまたは複数含まれており、2
から 3 行のレコード・ヘッダーが頭に付いています。各レコード・ヘッダーの最初
の行には、レコード・タイプおよびグループの最初のレコードのシーケンス番号が
含まれます。ページの切れ目に続いて、レコード・ヘッダーは繰り返されます。こ
れは、レコード・タイプが変わっていなくても行われます。
15-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
現行の GOFF フォーマットは 6 レコード・タイプしか定義しませんが、TXT レコ
ード・タイプは 3 つの異なるテキスト・タイプに分割されます。
v TEXT プログラムの指示およびデータを含む。
v IDRL コンパイラーまたはアセンブラーからの IDR 情報を含む。
v ADATA オブジェクト・モジュールに関連する追加のデータを含む。
全部で 8 種類の異なる表示フォーマットがあります。
レポート記述
この記述のキー付けされたセクションは、 15-26 ページの図 15-6 でページ・ヘッダ
ーを強調表示している同等のキー、および 8 つのレコード・フォーマットと同じで
す。 GOFF フォーマットの一部のフラグおよび長さは、構造的な性質でありモジュ
ールのデータ内容を表すものではありません。スペースを小さくするために、これ
らのエレメントはリストから省略されています。同じ理由から、サポートされてい
ないデータ・エレメントも表示されません。省略されたエレメントのリストは各レ
コード・タイプに分けられ、省略の理由はフィールド名に続いて括弧内にコード化
されています。コード値は、S (構造データまたは構文データ) と U (サポートされ
ていないエレメント) です。すべてのレコード・タイプに関する PTV はフォーマッ
ト設定されません。
第 15 章 AMBLIST
15-25
AMBLIST
***** G E N E R A L I Z E D O B J E C T F I L E F O R M A T *****
MY PROGRAM IN GOFF FORMAT
1
OBJECT MODULE LISTING
RECORD TYPE: HDR
SEQUENCE:
--- CHARACTER SET -ID
NAME
>
PAGE
1 2
LANGUAGE
PRODUCT
00000
0RECORD TYPE: ESD
SEQUENCE:
2 3
ESD OWNER/
ITEM
ITEM
NAME
ESDID TYPE PARENT OFFSET LEN/ADA SP/S
N/A
N/A
N/A
--------------------------- ATTRIBUTES --------------------------BA AMD RMD REUS AL TXT ORD STR BINDER_FLAGS LNK SIGNATURE
000001 SD
000000
NAME( )
000002 ED
000001
0
NAME(C_EXTNATTR)
28 01-N/A C
N/A 31
000003 ED
000001
NAME(C_CODE)
0
B8 01-N/A C
N/A 31
000004 LD
000003
NAME( )
0
000005 ED
000001
NAME(C_WSA)
0
000006 PR
000005
N/A
000018 03-L
SORT KEY: 00000000 (HEX)
NAME( )
000006 01-L
N/A N/S N/A RENT N/A N/A N/A N/A N/A
N/A MIN N/A
N/A 03 B-D N/A N/A L,A
N/A
N/A
N/A 03 B-I N/A N/A L,R,A
N/A
N/A
N/A N/A N-I N/A
X
S
N
00000000
N/A
N/A N/A N/A
N/A 03 N/A N/A
S
N
S
N/A
000007 LD
000003
50
000006 01-L N/A MIN N/A
EXTENDED ATTRIBUTES: ESDID = 000002, OFFSET=
NAME(main)
N/A N/A N-I N/A
0
S
N
X
00000000
000008 ER
000001
N/A
NAME(CEESG003)
N/A
01-L
N
N/S N/A
N/A N/A N-D N/A
S
N/S
S
00000000
000009 ER
000001
N/A
NAME(CBCSG003)
N/A
01-L
N
N/S N/A
N/A N/A N-D N/A
S
N/S
S
00000000
000010 SD
000000
N/A
NAME(CEESTART)
N/A
N/A
N/A N/S N/A RENT N/A N/A N/A N/A N/A
000011 ED
000010
NAME(C_CODE)
000012 LD
000011
0
NAME(CEESTART)
000013 ER
000010
N/A
NAME(CEEMAIN)
N/A
000014 ER
000010
N/A
NAME(CEEFMAIN)
000015 ER
000010
0
0
N/A
N/A 31
N/A
N/A
0
0 03-N/A M
N/A
N/A 03 B-D N/A N/A L,A,D
N/A
N/A
N/A 03 B-I N/A N/A L,R,A
N/A
N/A
N/A MIN N/A
N/A N/A N-I N/A
S
N/S
S
00000000
01-L
N
N/S N/A
N/A N/A N-D N/A
W
N/S
S
00000000
N/A
01-L
N
N/S N/A
N/A N/A N-D N/A
W
N/S
S
00000000
N/A
01-L
N
N/S N/A
N/A N/A N-D N/A
S
N/S
S
00000000
7C 01-N/A C
000000 01-L
N/A 31
***** G E N E R A L I Z E D O B J E C T F I L E F O R M A T *****
PAGE
NAME(CEEBETBL)
000016 ER
000010
N/A
NAME(CEEBLLST)
N/A
01-L
N
N/S N/A
N/A N/A N-D N/A
S
N/S
S
00000000
000017 ER
000010
N/A
NAME(CEEROOTD)
N/A
01-L
N
N/S N/A
N/A N/A N-I N/A
S
N/S
S
00000000
000018 ER
000001
N/A
NAME(CEESTART)
000001
0
NAME(C_@@PPA2)
N/A
01-L
N
N/S N/A
N/A N/A N-I N/A
S
N/S
S
00000000
N/A 31
N/A 03 B-D N/A N/A L,A
000019 ED
0 03-N/A M
図 15-6. GOFF に関する LISTOBJ フォーマット (1/3)
15-26
1
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
N/A
N/A
2
AMBLIST
000020 PR
000019
N/A
000008 03-L
SORT KEY: 00000000 (HEX)
NAME( )
N/A N/A N/A
N/A 00 N/A N/A
S
N
S
N/A
000021 ER
000001
N/A
N/A
01-X N N/S N/A
EXTENDED ATTRIBUTES: ESDID = 000002, OFFSET=
NAME(__ls__7os-amFPCc)
N/A N/A N-I N/A
14
S
G,N
X
00000000
000022 ED
000001
NAME(C_WSA)
N/A 03 B-D N/A N/A L,A,D
N/A
N/A
000023 PR
000022
N/A
000000 03-X
SORT KEY: 00000000 (HEX)
NAME(cout)
N/A N/A N/A
N/A 03 N/A N/A
S
N/A
000024 SD
000000
N/A
NAME(CEEMAIN)
N/A N/S N/A
N/S N/A N/A N/A N/A N/A
N/A
N/A
000025 ED
000024
NAME(C_DATA)
N/A 03 B-D N/A N/A L,A
N/A
N/A
000026 LD
000025
0
NAME(CEEMAIN)
N/A MIN N/A
N/A N/A N-D N/A
S
N/S
S
00000000
000027 ER
000001
N/A
NAME(EDCINPL)
N/A
01-L
N
N/S N/A
N/A N/A N-I N/A
S
N/S
S
00000000
000028 ER
000001
N/A
NAME(main)
N/A
01-L
N
N/S N/A
N/A N/A N-I N/A
S
N
X
00000000
000029 ED
000001
0
NAME(C_COPTIONS)
1B0 01-N/A C
N/A 31
N/A 03 B-D N/A N/A A
N/A
N/A
000030 ED
000001
NAME(B_IDRL)
22 01-N/A C
N/A 31
N/A 03 F-U N/A N/A
N/A
N/A
0
0
0
0
0 03-N/A M
N/A
0
N/A
10 01-N/A C
000000 01-L
0
N/A 31
N/A 31
S
N
RECORD TYPE: TEXT
SEQUENCE:
32
4
-- RESIDENT -TRUE
TEXT
ENCODED
ESDID OFFSET
LENGTH ENCODING LENGTH
------------------------------ T E X T ------------------------------
1
000002 00000000 00000000
0000
00000028
00000014 00010001 00010010 00040000 01000000 00000014 00010001 00010010
00040000 01000000
000003 00000000 00000000
0000
000000A0
41F0F050 07FF0700 00000000 F2F0F0F0 F0F1F3F1 F0F8F4F6 F1F6F0F2 F0F9F0F0
***** G E N E R A L I Z E D O B J E C T F I L E F O R M A T *****
000003 000000A0 00000000
0000
00000018
02CE07F8
00C300C5
48045810
480C4140
03012204
00000080
00C500F1
600C1826
405007F7
FFFFFF60
000006 00000000 00000000
0000
00000018
C8859393 9640E696 99938400 00000000 00000000 00000000
000011 00000000 00000000
0000
0000007C
47000000
E3C1D9E3
FFFE004C
00000012
000020 00000000 00000000
0000
00000008
00000000 000000A0
000025 00000000 00000000
0000
00000010
02000001 00000000 00000000 00000000
47000002
000058F0
00000000
00000000
00000201
FFFFFFE0
98566010
FFFFFFB8
00000000
90ECD00C
306A050F
00000000
00000000
00000502
00000050
0D764700
01000000
FFFFFF6C
053047F0
00000000
00000000
00000000
00000038
905C47B4
00044130
00C300C5
FFFFFFB0
30180014
00000000
00000000
00000000
01000000
A74AFFB0
000047F0
00C500F3
01000000
CE030209
00000000
00000000
00000000
PAGE
3
00049481
0D8047F0
802447F0
FFFFFFF6
89950000
80205860
8004987C
00000000
0000002C C3C5C5E2
00000000 00000000
00000000 00000000
00000000
図 15-6. GOFF に関する LISTOBJ フォーマット (2/3)
第 15 章 AMBLIST
15-27
AMBLIST
000029 00000000 00000000
0000
000001B0
C1C7C7D9
C3C84DF2
D3C9E340
D5E85D40
E76B40C6
D5D6C9C7
D3E5D34D
40D3D6D5
40D9C5C4
C44DE95D
E2D6D4C7
E2E3D9C9
D9F95D40
C3D6D4D7
RECORD TYPE: IDRL
SEQUENCE:
40
5
ESDID
|---------- IDR DATA ---------|
000030
C3D6D7E8
5D40C1D9
D5D6C3E2
C5E7C5C3
D6D3C46B
D5C5D9D9
C5E7E3C5
C7D5C1D4
C9D940D5
40D5D6E2
E240E2D7
C3E36DC9
D5D6E3C5
C9D3C5C4
4DD5D6D6
C7D7C1D9
C5C3E340
D6D7E240
40D5D6C1
D5D640D5
D5C4C5C4
C540D5D6
D6D9D6C3
C5D9E5C9
C9D3D34D
D5C4E4C3
E2E34DC8
6DD6D56D
E5C5D9D3
E2C540D5
C3E5C6E3
D5D6C5E7
C6D75D40
D6C9D5C9
5D40D5D6
D6D7E3C9
D6D5E2E3
C3C540D5
F1F2F85D
E3C9D6D5
D6D6D25D
D4E5E2FF
C1D75D40
D6C3D6D4
40C4D3D3
D7D6D9E3
C7D6C6C6
E3C1E4E3
D3C9C2C1
D4C9E9C5
40D5D6D9
D6E2D6D4
40E2E3C1
40E3C1D9
40E3E4D5
C1D5E2C9
D7D9C5E2
4DD5D6C3
C1D3D340
40D5D6C7
D640D5D6
D5E2C940
40D7D3C9
D6E2E3D9
40E2D6D4
D9E340E2
C7C5E34D
C54DF35D
C1D3C9C1
E240D5D6
C1D3D3C2
C6D3D6C1
D6D5E4D4
C9D7C140
D5D6D3D6
E2E34DC8
C9D5C740
C5C9D5C9
E3D9C9C3
D3C56B40
40E7D7D3
E240C1D9
C3D6D5E5
C1C3D2C1
E34DC8C5
C2C5D940
D3C1D5C7
C3C1D3C5
D6E2E35D
D9D6E4D5
E340D5D6
E340D5D6
D6E2E5F2
C9D5D240
|---------- IDR DATA ---------|
|5647A01...02092000031084616000
RECORD TYPE: RLD
SEQUENCE:
41
R-PTR P-PTR OFFSET TYPE LEN ATTRIB
6
R-PTR P-PTR OFFSET TYPE LEN ATTRIB
R-PTR P-PTR OFFSET TYPE LEN ATTRIB
000012 000011 000018
00+ 004
000012 000011 000060
00+ 004
000015 000011 000074
00+ 004
000013 000011 00002C
00+ 004
000014 000011 000068
00+ 004
000016 000011 00006C
00+ 004
000017 000011 000078
00+ 004
000018 000003 0000A4
00+ 004
000004 000003 0000A4
00- 004
000004 000020 000004
00+ 004
000021 000006 000014
00+ 004
000021 000006 000010
70+ 004
000023 000006 00000C
00+ 004
000028 000025 000004
00+ 004
000027 000025 000008
00+ 004
000028 000025 00000C
70+ 004
RECORD TYPE: END
SEQUENCE:
RECORD
--ENTRY POINT-COUNT
ESDID
OFFSET
1
42
7
***** G E N E R A L I Z E D O B J E C T F I L E F O R M A T *****
000042
PAGE
4
000011 00000000
----------------------------------------------------------------------------------------------------------------------1
** LONG NAME TABLE LISTING OF MEMBER HELLOW
**
PAGE
1
ABBREVIATION
LONG NAME
__ls__7os-amFPCc := __ls__7ostreamFPCc
** END OF LONG NAME TABLE LISTING OF MEMBER HELLOW
**
図 15-6. GOFF に関する LISTOBJ フォーマット (3/3)
上記の図の表示されているエレメントを以下に説明します。フィールド・ヘッディ
ングに続く中括弧でくくられた数字は、データ・エレメントが検索される GOFF レ
コード中の場所 (バイト、ビット) です。
1 ページ・ヘッダー
– ページ・ヘッダーは、各ページの最初に印刷されます。
– 2 番目の行にはオプションのユーザー・タイトルがリストされます。
2 HDR レコード
各 GOFF モジュールの最初のレコードです。印刷される唯一のデータ・エレメ
ントは、文字セット ID およびモジュールを生成した言語製品 (コンパイラーま
たはアセンブラー) です。
フォーマット設定されたデータ・エレメント。
– CCSID
– 文字セット名
15-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
– 言語製品 ID
フォーマット設定されないデータ・エレメント。
– ターゲット・ハードウェア環境 (U)
– ターゲット・オペレーティング・システム環境 (U)
3 ESD レコード
ESD は、モジュールで定義されるまたは参照される外部名を記述します。各レ
コード当たり 3 つまでの名前を提供していた従来のオブジェクト・モジュール
とは異なり、GOFF フォーマットにはレコード当たり 1 つしか名前が含まれま
せん。
フォーマット設定されたデータ・エレメント。
– 行 1
- ESDID。定義されるまたは参照される名前の ID。
- ESD タイプ。記号タイプ (SD、ED、LD、PR、ER)。
- OWNER/PARENT。ESD 階層で参照されるまたは所有するレコードの
ESDID。
- ITEM OFFSET。より上位レベルのエンティティーの最初からこの名前が付
けられたエンティティーの最始点までのオフセットをバイトで表現。
- ITEM LENGTH/ADA。ED- または PR- タイプの ESD レコードでは、定
義されているエンティティーの長さ (バイト単位)。この長さフィールドが
-1 の場合、実際の長さは LEN- タイプの GOFF レコード内にあります。
LD レコードの場合、関連データの ESDID です。
- NAME SP/S。ネーム・スペース (00 から 99) とバインディング有効範囲
(S (ローカルまたはセクション)、M (モジュール)、L (ライブラリー)、また
は X (インポート/エクスポート))。
- BA。バインディング・アルゴリズム (C=連結、M=マージ)
- AMD。AMODE (N/S、24、31、64、ANY、MIN)
- RMD。RMODE (N/S、24、31、64)
- REUS。再使用またはタスキング行動。(N/S、NONE、REUS、RENT、
REFR)
- AL。位置合わせ。10 進数 n として印刷されます。位置合わせ境界は 2**n
です。範囲: 0-31
- TXT。テキスト・タイプ。フォーマット x-y で表示されます。
v x は、テキスト・レコードのスタイル (B (バイト指向 = 0)、F (固定 =
1)、または V (変数 = 2))。
v y は、実行可能 (U (非指定= 0)、D (データ=1)、I (命令=2)、または 桁
3-7)。
- STR。バインディング重み。(S (重度=0)、W (弱度=1))。
- BINDER。バインダー属性は、ゼロまたは以下の文字を含むストリングで
す。この属性が適用可能な ESD タイプは、括弧内にリストされます。
v L。初期ロードまたは据え置きロード (ED)
v M。移動可能 (ED)
v R。読み取り専用 (ED)
第 15 章 AMBLIST
15-29
AMBLIST
v A。アドレス可能。テキストにはアドレス・コンスタントが含まれます。
(ED)
v C。共通 (ED)
v I。記号が記述子を定義または参照。(LD, ER, PR)
v G。不明な名前 (LD, PR, ER)
v N。名前変更できない。(LD, PR, ER)
v D。据え置きロード (ED)
v V。取り外し可能 (ED)
- LNK。リンケージ・タイプ (S (標準、非 XPLINK)、X (XPLINK))
- SIGNATURE。任意の 8 バイトのストリングで、16 進数で印刷されます。
– 保管入力キー。(優先度) オプション・フィールド。PR のみ。
– 拡張属性オプション・フィールド。この ESD 用の追加属性を含むテキスト位
置を定義。
– 記号名。最初の行は NAME で始まり、すぐ後に 16 バイトまでの名前が続き
ます。ただし、16 バイト以上の長さの名前に関しては、省略形がここに表示
され、省略形名参照表がリストの最後にリストされます。右小括弧が最後のバ
イトのすぐ次に続きます。単一のブランク文字でなる名前は、″NAME( )″ の
ように表示されます。
フォーマット設定されないデータ・エレメント。
– 拡張属性 ESDID (U)
– 拡張属性データ・オフセット (U)
– 別名または代替記号 ID (U)
– 名前長 (S)
4 TEXT レコード
TEXT レコードは、TXT レコード・タイプのサブセットです。これらには、命
令およびプログラムからのデータが含まれています。TEXT は、16 進フォーマ
ットで表示されます。
フォーマット設定されたデータ・エレメント。
– 行 1
- ESDID。テキストが属するエレメント または部分 を識別します。
- OFFSET。テキストが始まるエレメントまたは部分のオフセットです。
- TRUE LENGTH。エンコード規則 (ある場合は) が適用されて拡張されたテ
キストの長さ。
- TEXT ENCODING。テキストのエンコード、またはデコードの方式。現行
値は、0 と 1 です。
- ENCODED LENGTH。レコード中に現れるテキストの拡張前の長さ。
- TEXT。レコードで表現される通りに表示されるテキスト。テキストの長さ
は ENCODED LENGTH フィールドに表示されます。テキストは、1 行 32
バイトで 16 進フォーマットで表示されます。
– 行 2-n
32 バイト目以降のテキストは継続行に表示されます。最後のテキスト・バイ
ト以降のすべてのバイトは、ブランク文字に設定されます。
フォーマット設定されないデータ・エレメント。
15-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
– データ長 (S)
5 IDRL レコード
IDRL は、GOFF を生成する言語翻訳プログラムに関する識別情報を提供しま
す。構造化レコード・データとして識別される TXT レコード・タイプのサブセ
ットです。フォーマット 1 で、IDRL レコードは、行ごとに 4 つ、19 バイト
のセグメントで表示されます。フォーマット 3 では、IDRL レコードは、行ご
とに 2 つ、30 バイトのセグメントで表示され、4 桁の年の値とタイム・スタン
プをサポートします。
6 RLD レコード
再配置辞書は、バインディングおよびロードの最中に変更されなければならない
アドレス定数および他のデータ・エリアのディレクトリーです。複数のこのよう
なデータ・エリアやアドレス定数は、単一の RLD レコードに記述されます。再
配置ディレクトリー項目は、RLD レコードの {8.0} で始まり、長さは項目にお
ける様々なポインターがあるかないかとオフセットにより変わります。
ディレクトリー項目は 1 行 3 つにフォーマット制御されます。各項目には 5
つまでフィールドが含まれます。各ディレクトリー項目の最初のバイトのフラグ
は、どのフィールドが項目中で表示されるかを示します。結果として、1-8 まで
のフラグ・バイト以外、オフセットは GOFF ファイルに現れるようにディレク
トリー項目内で固定されません。
フォーマット設定されたデータ・エレメント。
– R-PTR。ターゲット・エレメントの ESDID、アドレス定数を再配置するのに
使用される値。
– P-PTR。アドレス定数または修正されるデータ・エリアを含むエレメントの
ESDID。
– OFFSET。アドレス定数またはデータ・エリアが配置されている点の P-PTR
により記述されるエレメント内のオフセット。
– TYPE。アドレス定数のタイプを記述して操作が行われることを暗黙指定しま
す。バイト 1 と 2 は 16 進数で印刷されます。
– LEN。アドレス定数またはデータ・エリアの長さ。範囲: 2-255
– ATTRIB。1 つだけ属性を定義できます。アドレッシング・モードのセンシテ
ィブ・ビットが設定されている場合は、ターゲット・フィールドの高位ビット
がターゲット AMODE の影響を受けることを示す ″H″ が印刷されます。
フォーマット設定されないデータ・エレメント。
– 合計データ長 (S)
– フラグ・バイト 0 (0.7 以外) と 5 (S)
– 拡張属性 ESDID およびオフセット (U)
7 END レコード
END レコードはモジュールにおける最後のレコードです。モジュールにおける
レコードのカウントとオプションで入り口点 (名前またはクラスとオフセットで
指定) が含まれます。
フォーマット設定されたデータ・エレメント。
第 15 章 AMBLIST
15-31
AMBLIST
– 行 1
- RECORD COUNT。HDR および END レコードを含む、モジュールにおけ
る論理 レコードのカウント。
- ENTRY POINT ESDID。入り口点を含むエレメントの ID。
- ENTRY POINT OFFSET。ESDID により識別されるエレメント内の入り口
点のオフセット。
– 行 2 には記号名 (指定されている場合は) が含まれます。表示フォーマット
は、 ESD レコード・タイプと同じです。
LISTLOAD OUTPUT=MODLIST 出力
LISTLOAD MEMBER=ADATA3,OUTPUT=MODLIST,ADATA=YES
***** M O D U L E S U M M A R Y *****
MEMBER NAME: ADATA3
MAIN ENTRY POINT:
00000368
LIBRARY:
SYSLIB
AMODE OF MAIN ENTRY POINT: ANY
NO ALIASES **
-----------------------------------------------------------------------------------------------------------------------****
ATTRIBUTES OF MODULE
****
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS
**
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
8 NOT-DC
9 ZERO-ORG
10 RESERVED
11 RLD
12 EDIT
13 NO-SYMS
14 RESERVED
15 NOT-REFR
16 RESERVED
17 <16M
18 NOT-PL
19 NO-SSI
20 NOT-APF
21 PGM OBJ
22 RESERVED
23 RESERVED
24 NOT-ALTP
25 RESERVED
26 RESERVED
27 RMODE24
28 RESERVED
29 RESERVED
30 RESERVED
31 RESERVED
32 NON-MIGR
33 NO-PRIME
34 NO-PACK
35 RESERVED
36 RESERVED
37 RESERVED
38 RESERVED
39 RESERVED
-----------------------------------------------------------------------------------------------------------------------MODULE SSI:
NONE
APFCODE:
00000000
RMODE:
24
PO FORMAT:
3
XPLINK:
NO
*****PROGRAM OBJECT PROCESSED BY BINDER
***THE FOLLOWING ARE THE UNFORMATTED PDSE DIRECTORY ENTRY SECTIONS (PMAR AND PMARL)
PMAR 001E0308 02C00403 00000000 0F9C0000 03680000 03680000 00000000 0000
PMARL 00628000 00000000 00180000 1A0C0000 10000000 CE140000 AA080000 01C00000
01400000 00240000 011C0000 00180000 03000002 00000000 05300000 0A100000
20002005 011F0153 503FC1C4 C1E3C1F3 40403000 00010000 005C0000 30000000
0410
LISTING OF PROGRAM OBJECT ADATA3
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (1/7)
15-32
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
THIS PROGRAM OBJECT WAS ORIGINALLY PRODUCED BY 5695PMB01 AT LEVEL 01.03 ON 01/11/2005 AT 15:35:03
-----------------------------------------------------------------------------------------------------------------------MODULE SECTION: $SUMMARY
USABILITY: UNSPECIFIED
OVERLAY SEGMENT:
0
OVERLAY REGION:
0
===== ESDs =====
C_WSA(ED)
CLASS:
C_WSA
LENGTH:
5C (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
MERGE
RMODE:
ANY
TEXT
DATA
DEFER
FILL:
0 (HEX)
C_@@DLLI(ED)
CLASS:
C_@@DLLI
LENGTH:
8 (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
MERGE
RMODE:
ANY
TEXT
DATA
LOAD
FILL:
0 (HEX)
C_@@PPA2(ED)
CLASS:
C_@@PPA2
LENGTH:
8 (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
MERGE
RMODE:
ANY
TEXT
DATA
LOAD
READ-ONLY
0 (HEX)
B_PRV(ED)
CLASS:
B_PRV
LENGTH:
4 (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
NAME SPACE:
2
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
MERGE
RMODE:
24
TEXT
NOLOAD
FILL:
UNSPEC
$PRIV000010(PD)
CLASS:
C_@@DLLI
LENGTH:
8 (HEX)
CLASS OFFSET:
0 (HEX)
NAME SPACE:
3
ALIGNMENT:
BYTE
PRIORITY:
0 (HEX)
SCOPE:
LIBRARY
ATTRIBUTES:
GENERATED,STRONG
$PRIV000011(PD)
CLASS:
C_@@PPA2
LENGTH:
8 (HEX)
CLASS OFFSET:
0 (HEX)
NAME SPACE:
3
ALIGNMENT:
BYTE
PRIORITY:
0 (HEX)
SCOPE:
LIBRARY
ATTRIBUTES:
GENERATED,STRONG
$PRIV000012(PD)
CLASS:
C_WSA
LENGTH:
10 (HEX)
CLASS OFFSET:
0 (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
PRIORITY:
0 (HEX)
SCOPE:
SECTION
ATTRIBUTES:
GENERATED,STRONG
__ls__7os-amFPCc(PD)
CLASS:
C_WSA
LENGTH:
20 (HEX)
CLASS OFFSET:
10 (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
PRIORITY:
0 (HEX)
SCOPE:
MODULE
ATTRIBUTES:
GENERATED,STRONG,INDIRECT
endl__FR7-stream(PD)
CLASS:
C_WSA
LENGTH:
20 (HEX)
CLASS OFFSET:
30 (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
PRIORITY:
0 (HEX)
SCOPE:
MODULE
ATTRIBUTES:
GENERATED,STRONG,INDIRECT
HELLOW1#S(PD)
CLASS:
C_WSA
LENGTH:
C (HEX)
CLASS OFFSET:
50 (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
PRIORITY:
0 (HEX)
SCOPE:
LIBRARY
ATTRIBUTES:
GENERATED,STRONG
Q1(PD)
CLASS:
B_PRV
LENGTH:
4 (HEX)
CLASS OFFSET:
0 (HEX)
NAME SPACE:
2
ALIGNMENT:
FULL WORD
PRIORITY:
0 (HEX)
SCOPE:
MODULE
ATTRIBUTES:
WEAK
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (2/7)
第 15 章 AMBLIST
15-33
AMBLIST
===== RLDs =====
CLASS:
C_WSA
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
XPL XATTR NAME
XATTR OFF
00000008 00000018
BR UNRES 0004 NO
1
(+)__ls__7os-amFPCc __ls__7os-amFPCc
NO
0000000C 0000001C N-BR RES 0004 NO
3
(+)__ls__7os-amFPCc __ls__7os-amFPCc
NO
00000010 00000020
BR RES 0004 NO
1
(+)CEETGTFN
__ls__7os-amFPCc
NO
00000018 00000028
BR RES 0004 NO
1
(+)CEESTART
__ls__7os-amFPCc
NO
0000001C 0000002C SEGM RES 0004 NO
0
(+)C_WSA
__ls__7os-amFPCc
NO
00000008 00000038
BR UNRES 0004 NO
1
(+)endl__FR7-stream endl__FR7-stream
NO
0000000C 0000003C N-BR RES 0004 NO
3
(+)endl__FR7-stream endl__FR7-stream
NO
00000010 00000040
BR RES 0004 NO
1
(+)CEETGTFN
endl__FR7-stream
NO
00000018 00000048
BR RES 0004 NO
1
(+)CEESTART
endl__FR7-stream
NO
0000001C 0000004C SEGM RES 0004 NO
0
(+)C_WSA
endl__FR7-stream
NO
===== TEXT =====
CLASS:
C_WSA
00000000 C36DE6E2 C1404040 40404040 40404040 180F58FF 001007FF 00000000 00000010
*C.WSA...........................*
00000020 000009F8 00000000 00000368 00000000 180F58FF 001007FF 00000000 00000030
*...8............................*
00000040 000009F8 00000000 00000368 00000000 00000000 00000000 00000000
...8............................*
===== TEXT =====
CLASS:
C_@@DLLI
00000000 00000000 00000250
................................*
===== TEXT =====
CLASS:
C_@@PPA2
00000000 00000000 00000350
................................*
-----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: A
USABILITY: UNSPECIFIED
OVERLAY SEGMENT:
===== IDRL =====
TRANSLATOR VER MOD
DATE
569623400
01
05
01/11/2005
===== ESDs =====
B_PRV(ED)
CLASS:
B_PRV
LENGTH:
NAME SPACE:
2
ALIGNMENT:
TEXT
NOLOAD
B_TEXT(ED)
CLASS:
B_TEXT
LENGTH:
NAME SPACE:
1
ALIGNMENT:
TEXT
LOAD
C_ADATA0000(ED)
CLASS:
C_ADATA0000
LENGTH:
NAME SPACE:
1
ALIGNMENT:
DESCRIPTIVE DATA DATA
NOLOAD
C_ADATA0001(ED)
CLASS:
C_ADATA0001
LENGTH:
NAME SPACE:
1
ALIGNMENT:
DESCRIPTIVE DATA DATA
NOLOAD
ENTA(ER)
TEXT TYPE:
TARGET SECTION: A
NAME SPACE:
1
SCOPE:
RESOLVED
AUTOCALL
ATTRIBUTES:
STRONG
Q1(PR)
CLASS:
B_PRV
LENGTH:
NAME SPACE:
2
ALIGNMENT:
ATTRIBUTES:
WEAK
ENTA(LD)
CLASS:
B_TEXT
TEXT TYPE:
NAME SPACE:
1
SCOPE:
ATTRIBUTES:
STRONG
0
OVERLAY REGION:
0
0 (HEX)
DOUBLE WORD
CLASS OFFSET:
BIND METHOD:
FILL:
0 (HEX)
MERGE
UNSPEC
FORMAT:
RMODE:
F(0001)
24
18 (HEX)
DOUBLE WORD
CLASS OFFSET:
BIND METHOD:
FILL:
0 (HEX)
CATENATE
UNSPEC
FORMAT:
RMODE:
F(0001)
24
AA (HEX)
DOUBLE WORD
CLASS OFFSET:
BIND METHOD:
READ-ONLY
0 (HEX)
CATENATE
UNSPEC
FORMAT:
RMODE:
F(0001)
24
16 (HEX)
DOUBLE WORD
CLASS OFFSET:
BIND METHOD:
READ-ONLY
0 (HEX)
CATENATE
UNSPEC
FORMAT:
RMODE:
F(0001)
24
CLASS OFFSET:
TARGET CLASS:
ELEMENT OFFSET:
14 (HEX)
B_TEXT
14 (HEX)
0 (HEX)
0 (HEX)
SCOPE:
MODULE
14 (HEX)
14 (HEX)
AMODE:
UNS
UNSPEC
LIBRARY
4 (HEX)
FULL WORD
UNSPEC
MODULE
CLASS OFFSET:
PRIORITY:
CLASS OFFSET:
ELEMENT OFFSET:
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (3/7)
15-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
===== RLDs =====
CLASS:
B_TEXT
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
XPL XATTR NAME
XATTR OFF
00000006 00000006 BR RES 0004 NO
1
(+)ENTA
NO
0000000C 0000000C C-OF RES 0004 NO
2
(+)Q1
NO
===== TEXT =====
CLASS:
B_TEXT
00000000 07FEC1C1 C1C10000 00140000 00000000 00000028 C5D5E3C1
..AAAA..............ENTA........*
==== ADATA ====
CLASS:
C_ADATA0000
00000000 10000003 00010000 0000009E F2F0F0F5 F0F1F1F1 F1F5F3F5 F5F6F9F6 60F2F3F4
*............2005011115355696.234*
00000020 F14BF54B F0404040 0005E4D8 F9F0F3F5 F840A961 D6E240F0 F14BF0F6 4BF0F040
*1.5.0.....UQ90358.z.OS.01.06.00.*
00000040 40404040 40404040 4040C1C4 C1E3C1F3 4040C1E2 E2C5D4C2 D3C54040 40404040
*..........ADATA3..ASSEMBLE......*
00000060 40400000 00010000 006A0000 00000000 00010000 008A0000 00200000 00000000
*................................*
00000080 00000000 00000000 0000D3C5 D6D5C14B C1C4C1E3 C1F34BD1 D6C2F2F8 F6F0F44B
*..........LEONA.ADATA3.JOB28604.*
000000A0 C4F0F0F0 F0F1F0F1 4B6F
D0000101........................*
==== ADATA ====
CLASS:
C_ADATA0001
00000000 10000103 00000000 0000000A BC67CE74 632D716B 0025
................................*
==== ADATA ====
CLASS:
C_ADATA0002
00000000 10000203 00000000 00000008 00000000 00000000 10000203 00000000 00000008
*................................*
00000020 00010000 0000004C
................................*
-----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: CEESTART
USABILITY: REENTRANT
OVERLAY SEGMENT:
0
OVERLAY REGION:
0
===== ESDs =====
C_CODE(ED)
CLASS:
C_CODE
LENGTH:
7C (HEX)
CLASS OFFSET:
368 (HEX)
FORMAT: F(0001)
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
CATENATE
RMODE:
ANY
TEXT
INSTR
LOAD
READ-ONLY
0 (HEX)
CEESTART(LD)
CLASS:
C_CODE
TEXT TYPE:
INSTR
CLASS OFFSET:
368 (HEX)
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
0 (HEX)
AMODE:
ANY
ATTRIBUTES:
STRONG
CEEMAIN(ER)
TEXT TYPE:
DATA
CLASS OFFSET:
8 (HEX)
TARGET SECTION: CEEMAIN
TARGET CLASS:
C_DATA
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
0 (HEX)
RESOLVED
AUTOCALL
ATTRIBUTES:
WEAK
CEEFMAIN(ER)
TEXT TYPE:
DATA
CLASS OFFSET:
0 (HEX)
TARGET SECTION:
TARGET CLASS:
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
0 (HEX)
UNRESOLVED
AUTOCALL
ATTRIBUTES:
WEAK
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (4/7)
第 15 章 AMBLIST
15-35
AMBLIST
===== RLDs =====
CLASS:
C_CODE
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
XPL XATTR NAME
XATTR OFF
00000018 00000380 N-BR RES 0004 NO
1
(+)CEESTART
NO
0000002C 00000394
BR RES 0004 NO
1
(+)CEEMAIN
NO
00000060 000003C8 N-BR RES 0004 NO
1
(+)CEESTART
NO
00000068 000003D0
BR UNRES 0004 NO
1
(+)CEEFMAIN
NO
===== TEXT =====
CLASS:
C_CODE
00000368 47000000 47000002 90ECD00C 053047F0 30180014 CE030310 00000394 C3C5C5E2
*...............0...........mCEES*
00000388 E3C1D9E3 000058F0 306A050F 00000008 00000000 00000000 00000000 00000000
*TART...0........................*
000003A8 FFFF004C 00000000 00000000 00000000 00000000 00000000 00000000 00000000
*................................*
000003C8 0000037A 00000000 00000000 00000000 00000000 00000220 00000030
................................*
-----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: HELLOW1#C
USABILITY: REENTRANT
OVERLAY SEGMENT:
0
OVERLAY REGION:
0
===== IDRL =====
TRANSLATOR VER MOD
DATE
5647A01
02
10
08/16/2000
===== ESDs =====
C_CODE(ED)
CLASS:
C_CODE
LENGTH:
368 (HEX)
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
TEXT
INSTR
LOAD
HELLOW1#C(LD)
CLASS:
C_CODE
TEXT TYPE:
INSTR
NAME SPACE:
1
SCOPE:
LIBRARY
ATTRIBUTES:
STRONG
C_WSA(ED)
CLASS:
C_WSA
LENGTH:
0 (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
TEXT
DATA
DEFER
HELLOW1#S(PR)
CLASS:
C_WSA
LENGTH:
C (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
ATTRIBUTES:
STRONG
C_@@DLLI(ED)
CLASS:
C_@@DLLI
LENGTH:
0 (HEX)
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
TEXT
DATA
LOAD
$PRIV000010(PR)
CLASS:
C_@@DLLI
LENGTH:
8 (HEX)
NAME SPACE:
3
ALIGNMENT:
BYTE
ATTRIBUTES:
STRONG,MAPPED
main(LD)
CLASS:
C_CODE
TEXT TYPE:
INSTR
NAME SPACE:
1
SCOPE:
LIBRARY
ATTRIBUTES:
STRONG,MAPPED
CEESG003(ER)
TEXT TYPE:
TARGET SECTION: CEESG003
NAME SPACE:
1
SCOPE:
LIBRARY
RESOLVED
AUTOCALL
ATTRIBUTES:
STRONG
C_DATA(ED)
CLASS:
C_DATA
LENGTH:
4 (HEX)
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
TEXT
DATA
LOAD
HELLOW1#T(LD)
CLASS:
C_DATA
TEXT TYPE:
DATA
NAME SPACE:
1
SCOPE:
LIBRARY
ATTRIBUTES:
STRONG
CLASS OFFSET:
BIND METHOD:
READ-ONLY
0 (HEX)
CATENATE
0 (HEX)
CLASS OFFSET:
ELEMENT OFFSET:
0 (HEX)
0 (HEX)
CLASS OFFSET:
BIND METHOD:
FILL:
0 (HEX)
MERGE
0 (HEX)
CLASS OFFSET:
PRIORITY:
50 (HEX)
0 (HEX)
CLASS OFFSET:
BIND METHOD:
FILL:
0 (HEX)
MERGE
0 (HEX)
CLASS OFFSET:
PRIORITY:
CLASS OFFSET:
ELEMENT OFFSET:
CLASS OFFSET:
ELEMENT OFFSET:
F(0001)
ANY
AMODE:
ANY
FORMAT:
RMODE:
F(0001)
ANY
SCOPE:
LIBRARY
FORMAT:
RMODE:
F(0001)
ANY
0 (HEX)
0 (HEX)
SCOPE:
LIBRARY
58 (HEX)
58 (HEX)
AMODE:
ANY
DATA
CLASS OFFSET:
TARGET CLASS:
B_TEXT
ELEMENT OFFSET:
0 (HEX)
CLASS OFFSET:
BIND METHOD:
FILL:
FORMAT:
RMODE:
0 (HEX)
CATENATE
0 (HEX)
0 (HEX)
0 (HEX)
2D8 (HEX)
FORMAT:
RMODE:
F(0001)
ANY
AMODE:
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (5/7)
15-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ANY
AMBLIST
C_WSA(ED)
CLASS:
C_WSA
LENGTH:
0 (HEX)
CLASS OFFSET:
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
TEXT
DATA
DEFER
FILL:
endl__FR7-stream(PR)
CLASS:
C_WSA
LENGTH:
0 (HEX)
CLASS OFFSET:
NAME SPACE:
3
ALIGNMENT:
BYTE
PRIORITY:
ATTRIBUTES:
STRONG,MAPPED,INDIRECT,MANGLED
endl__FR7-stream(ER)
TEXT TYPE:
INSTR
CLASS OFFSET:
TARGET SECTION:
TARGET CLASS:
NAME SPACE:
1
SCOPE:
EXP/IMP
ELEMENT OFFSET:
UNRESOLVED
AUTOCALL
ATTRIBUTES:
STRONG,MAPPED,MANGLED
__ls__7os-amFPCc(PR)
CLASS:
C_WSA
LENGTH:
0 (HEX)
CLASS OFFSET:
NAME SPACE:
3
ALIGNMENT:
BYTE
PRIORITY:
ATTRIBUTES:
STRONG,MAPPED,INDIRECT,MANGLED
__ls__7os-amFPCc(ER)
TEXT TYPE:
INSTR
CLASS OFFSET:
TARGET SECTION:
TARGET CLASS:
NAME SPACE:
1
SCOPE:
EXP/IMP
ELEMENT OFFSET:
UNRESOLVED
AUTOCALL
ATTRIBUTES:
STRONG,MAPPED,MANGLED
cout(PR)
CLASS:
C_WSA
LENGTH:
0 (HEX)
CLASS OFFSET:
NAME SPACE:
3
ALIGNMENT:
FULL WORD
PRIORITY:
ATTRIBUTES:
STRONG,MAPPED
CEESTART(ER)
TEXT TYPE:
INSTR
CLASS OFFSET:
TARGET SECTION: CEESTART
TARGET CLASS:
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
RESOLVED
AUTOCALL
ATTRIBUTES:
STRONG
C_@@PPA2(ED)
CLASS:
C_@@PPA2
LENGTH:
0 (HEX)
CLASS OFFSET:
NAME SPACE:
3
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
TEXT
DATA
LOAD
READ-ONLY
$PRIV000011(PR)
CLASS:
C_@@PPA2
LENGTH:
8 (HEX)
CLASS OFFSET:
NAME SPACE:
3
ALIGNMENT:
BYTE
PRIORITY:
ATTRIBUTES:
STRONG,MAPPED
main(ER)
TEXT TYPE:
INSTR
CLASS OFFSET:
TARGET SECTION: HELLOW1#C
TARGET CLASS:
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
RESOLVED
AUTOCALL
ATTRIBUTES:
STRONG,MAPPED
C_COPTIONS(ED)
CLASS:
C_COPTIONS
LENGTH:
1F2 (HEX)
CLASS OFFSET:
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
TEXT
DATA
NOLOAD
READ-ONLY
===== RLDs =====
CLASS:
C_@@PPA2
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
00000004 00000004 N-BR RES 0004 NO
1
(+)HELLOW1#C
$PRIV000011
===== RLDs =====
CLASS:
C_@@DLLI
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
00000004 00000004 N-BR RES 0004 NO
1
(+)HELLOW1#C
$PRIV000010
===== RLDs =====
CLASS:
C_CODE
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
00000108 00000108 C-OF RES 0004 NO
3
(+)HELLOW1#S
0000010C 0000010C N-BR RES 0004 NO
1
(+)HELLOW1#C
00000110 00000110 N-BR RES 0004 NO
1
(+)HELLOW1#C
0000032C 0000032C C-OF RES 0004 NO
3
(+)HELLOW1#S
00000330 00000330 C-OF RES 0004 NO
3
(+)endl__FR7-stream
00000334 00000334 C-OF RES 0004 NO
3
(+)__ls__7os-amFPCc
00000338 00000338 C-OF UNRES 0004 NO
3
(+)cout
00000354 00000354 N-BR RES 0004 NO
1
(+)HELLOW1#C
00000354 00000354 N-BR RES 0004 NO
1
(+)CEESTART
0 (HEX)
MERGE
0 (HEX)
30 (HEX)
0 (HEX)
FORMAT:
RMODE:
F(0001)
ANY
SCOPE:
MODULE
SCOPE:
MODULE
SCOPE:
EXP/IMP
FORMAT:
RMODE:
F(0001)
ANY
SCOPE:
LIBRARY
FORMAT:
RMODE:
F(0001)
ANY
0 (HEX)
0 (HEX)
10 (HEX)
0 (HEX)
0 (HEX)
0 (HEX)
0 (HEX)
0 (HEX)
368 (HEX)
C_CODE
0 (HEX)
0 (HEX)
MERGE
0 (HEX)
0 (HEX)
0 (HEX)
58 (HEX)
C_CODE
58 (HEX)
0 (HEX)
CATENATE
0 (HEX)
XPL XATTR NAME
NO
XATTR OFF
XPL XATTR NAME
NO
XATTR OFF
XPL XATTR NAME
NO
NO
NO
NO
NO
NO
NO
NO
NO
XATTR OFF
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (6/7)
第 15 章 AMBLIST
15-37
AMBLIST
===== TEXT =====
CLASS:
C_CODE
00000000 F2F0F0F0 F0F8F1F6 F1F0F0F5 F4F3F0F2 F0C1F0F0 00000000 1CCEA106 000002F8
*20000816100543020A00...........8*
00000020 00000000 00000000 FF800000 00000001 90000001 00400012 00000000 50000058
*................................*
00000040 00000040 38270000 00000000 00000000 00049481 89950000 47F0F028 01C3C5C5
*..................main...00..CEE*
00000060 000000A0 FFFFFFC0 47F0F001 58F0C31C 184E05EF 00000000 05404140 401E07F4
*.........00..0C................4*
00000080 90E6D00C 58E0D04C 4100E0A0 5500C314 4140F040 4720F014 5000E04C 9210E000
*.W............C...0...0.....k...*
000000A0 50D0E004 18DE5800 C1F45000 D0985810 D0985820 40704152 10005860 40745810
*........A4...q...q..............*
000000C0 50005820 500458F0 20085800 200C1826 4DE0F010 47000008 58205008 5800D098
*.......0..........0............q*
000000E0 58F04078 4DE0F010 47000008 5800D098 5000C1F4 180D58D0 D0041BFF 58E0D00C
*.0....0........q..A4............*
00000100 9826D01C 051E0707 00000050 00000340 00000180 00000000 1CCE2109 000001D0
*q...............................*
00000120 00000000 00000000 FE000000 00000001 E0000000 02400012 00000000 5000003F
*................................*
00000140 00000068 18260000 00000000 00000000 002A96A2 A3998581 947A7A96 97859981
*..................ostream..opera*
00000160 A396994C 4C4D96A2 A3998581 94504D5C 5D4D96A2 A3998581 94505D5D 00000000
*tor...ostream.....ostream.......*
===== TEXT =====
CLASS:
C_COPTIONS
00000000 C1C7C7D9 C3D6D7E8 4DD5D6D6 E5C5D9D3 C1D75D40 C1D5E2C9 C1D3C9C1 E240C1D9
*AGGRCOPY.NOOVERLAP..ANSIALIAS.AR*
00000020 C3C84DF0 5D40C1D9 C7D7C1D9 E2C540D5 D6C3D6D4 D7C1C3E3 40D5D6C3 D6D4D7D9
*CH.0..ARGPARSE.NOCOMPACT.NOCOMPR*
00000040 C5E2E240 D5D6C3D6 D5E5D3C9 E340C3E2 C5C3E34D C3D6C4C5 6B40C8C5 D3D3D6E6
*ESS.NOCONVLIT.CSECT.CODE..HELLOW*
-----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: IEWBLIT
USABILITY: UNSPECIFIED
OVERLAY SEGMENT:
0
OVERLAY REGION:
0
===== ESDs =====
B_LIT(ED)
CLASS:
B_LIT
LENGTH:
120 (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
CATENATE
RMODE:
ANY
TEXT
DATA
LOAD
FILL:
UNSPEC
IEWBLIT(LD)
CLASS:
B_LIT
TEXT TYPE:
DATA
CLASS OFFSET:
0 (HEX)
NAME SPACE:
1
SCOPE:
MODULE
ELEMENT OFFSET:
0 (HEX)
AMODE:
ANY
ATTRIBUTES:
GENERATED,STRONG
===== RLDs =====
CLASS:
B_LIT
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
XPL XATTR NAME
XATTR OFF
00000028 00000028 LTKN RES 0008 NO
0
(+)
NO
00000050 00000050 CPR RES 0004 NO
0
C_CODE
NO
00000054 00000054 SEGM RES 0004 NO
0
(+)C_CODE
NO
00000070 00000070 CPR RES 0004 NO
0
C_@@DLLI
NO
00000074 00000074 SEGM RES 0004 NO
0
(+)C_@@DLLI
NO
00000090 00000090 CPR RES 0004 NO
0
C_DATA
NO
00000094 00000094 SEGM RES 0004 NO
0
(+)C_DATA
NO
000000B0 000000B0 CPR RES 0004 NO
0
C_@@PPA2
NO
000000B4 000000B4 SEGM RES 0004 NO
0
(+)C_@@PPA2
NO
000000D0 000000D0 CPR RES 0004 NO
0
B_TEXT
NO
000000D4 000000D4 SEGM RES 0004 NO
0
(+)B_TEXT
NO
000000F0 000000F0 CPR RES 0004 NO
0
C_WSA
NO
00000110 00000110 CPR RES 0004 NO
0
B_LIT
NO
00000114 00000114 SEGM RES 0004 NO
0
(+)B_LIT
NO
===== TEXT =====
CLASS:
B_LIT
00000000 C9C5E6C2 D3C9E340 00000120 01000000 00000040 00000020 00000007 00000001
*IEWBLIT.........................*
00000020 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
*................................*
00000040 C36DC3D6 C4C54040 40404040 40404040 000003E4 00000000 03038000 00000000
*C.CODE.............U............*
00000060 C36D7C7C C4D3D3C9 40404040 40404040 00000008 00000000 03030000 00000000
*C...DLLI........................*
00000080 C36DC4C1 E3C14040 40404040 40404040 00000014 00000000 03030000 00000000
*C.DATA..........................*
000000A0 C36D7C7C D7D7C1F2 40404040 40404040 00000008 00000000 03038000 00000000
*C...PPA2........................*
000000C0 C26DE3C5 E7E34040 40404040 40404040 00000A0C 00000000 01030000 00000000
*B.TEXT..........................*
000000E0 C36DE6E2 C1404040 40404040 40404040 0000005C 00000000 03032080 00000000
*C.WSA...........................*
00000100 C26DD3C9 E3404040 40404040 40404040 00000120 00000000 03030000 00000000
*B.LIT...........................*
-----------------------------------------------------------------------------------------------------------------------==== MERGE CLASS PART INITIALIZERS ====
CLASS
PART
OFFSET REPEAT --------------------- I N I T I A L T E X T ----------------------C_@@DLLI
$PRIV000010
000000 00001 00000000 00000250
C_@@PPA2
$PRIV000011
000000 00001 00000000 00000350
-----------------------------------------------------------------------------------------------------------------------** LONG NAME TABLE LISTING OF PROGRAM OBJECT ADATA3
**
PAGE
36
ABBREVIATION
LONG NAME
__ls__7os-amFPCc := __ls__7ostreamFPCc
endl__FR7-stream := endl__FR7ostream
** END OF LONG NAME TABLE LISTING OF PROGRAM OBJECT ADATA3
**
END OF PROGRAM OBJECT LISTING
**
図 15-7. プログラム・オブジェクトに対する LISTLOAD OUTPUT=MODLIST, ADATA=YES の出力例 (7/7)
15-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
LISTING OF LOAD MODULE PL1LOAD
RECORD# 1
RECORD# 2
RECORD# 3
TYPE 20 - CESD
ESDID 1
CESD#
SYMBOL
TYPE
ADDRESS
1
PLITC0Z
00(SD)
000000
2
PLITC0ZA 00(SD)
000488
3
IHEQINV
06(PR)
000000
4
IHESADA
02(ER)
000000
5
INESADB
02(ER)
000000
6
IHEQERR
06(PR)
000004
7
IHEQTIC
06(PR)
000008
8
IHEMAIN
00(SD)
000718
9
IHENTRY
00(SD)
000720
l0
IHESAPC
02(ER)
000000
11
IHEQLWF
06(PR)
00000C
12
IHEQSLA
06(PR)
000010
13
IHEQLW0
06(PR)
000014
14
PLITC0ZB 06(PR)
000018
15
PLITC0ZC 06(PR)
00001C
TYPE 20 - CESD
ESDID 16
CESD#
SYMBOL
TYPE
ADDRESS
16
IHELDQA
02(ER)
000000
17
IHELDQB
02(ER)
000000
18
IHEIQBT
02(ER)
000000
19
IHEIQBC
02(ER)
000000
20
IHESAFA
02(ER)
000000
21
IHESAFB
02(ER)
000000
22
AA
02(ER)
000000
23
C
00(SD)
000730
24
B
00(SD)
000738
25
A
00(SD)
000740
26
IHESPRT
00(SD)
000748
27
IHEQSPR
06(PR)
000020
28
IHEDNC
02(ER)
000000
29
IHEVPF
02(ER)
000000
30
IHEDMA
02(ER)
000000
TYPE 20 - CESD
ESDID 31
CESD#
SYMBOL
TYPE
ADDRESS
31
IHEVPB
02(ER)
000000
32
IHEVSC
02(ER)
000000
33
IHEUPA
02(ER)
000000
34
IHEVQC
02(ER)
000000
SEGNUM
1
1
3
3
3
1
1
ESD SIZE 240
ID/LENGTH(DEC)
1206
608
4
4
4
4
4
3
3
3
3
3
SEGNUM
1
1
1
1
3
SEGNUM
PAGE 0001
(HEX)
486
260
4
4
4
12
C
4
4
4
4
4
4
4
4
4
4
ESD SIZE 240
ID/LENGTH(DEC)
4
4
4
56
4
(HEX)
4
4
4
38
4
ESD SIZE 64
ID/LENGTH(DEC)
(HEX)
-------------------------------------------
図 15-8. オーバーレイ構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST の出力例 (1/4)
第 15 章 AMBLIST
15-39
AMBLIST
RECORD# 4
TYPE 01 - CONTROL
CESD#
LENGTH
1
0488
2
0260
8
0008
9
0010
23
0008
24
0008
25
0008
26
0038
LISTING OF LOAD MODULE PL1LOAD
CONTROL SIZE 32
CCW 060000000
RECORD# 5
000000
000020
000040
000060
000080
0000A0
0000C0
0000E0
000100
000120
000140
000160
000180
0001A0
0001C0
0001E0
000200
000220
000240
000260
000280
000200
0002C0
0002E0
000300
000320
000340
000360
000380
0003A0
0003C0
0003E0
000400
000420
000440
000460
000480
0004A0
0004C0
0004E0
47F0F914
58F0B0Z0
F811D090
D0AEB134
D09241A0
B05405EF
8002FA20
7000F821
D0634150
5880B070
F9118000
05EF4110
D0A85080
B04005EF
A13E9280
D094D090
4110B0A0
58F0B058
05EF9213
000000D0
9201D084
9209D063
45E0A016
A0000700
D207D0A8
920CD063
D0937002
D09810FE
D088D201
05EF920D
D0938003
D098D090
47F0A106
D09058F0
12224770
D00447F0
587C0014
583C0010
000024B8
00000434
07D7D3F1
05EF05A0
B132F810
F811D090
A0600700
9203D063
D093B111
D0937002
D0AE5050
D2038000
D0904770
B14058F0
D0984180
D205D0B2
D090D202
D600D094
4120B183
05EF9213
D06358F0
90EBD00C
58E01000
41A0A088
9202D084
47F0F00C
10009200
5880D0A0
9502D084
54E0B078
8000D091
D063920E
FB22D093
4FE0D098
5880D088
B06005EF
F03C59DC
F0225020
D2033050
5030D004
000034B8
00000434
E3C3F0F2
4190D0B8
D092B080
B13CF810
9203D063
58F0B058
5879B06C
FA20D093
D0944150
D0909207
A0C8F911
B05005EF
D0825080
D0909211
D091D0B5
D0919180
58F0B054
D0634110
B05805EF
18AF41E0
50E0D088
07F80700
D207D0A0
03C1C3F2
D0AC58E0
F821D090
4780A062
90EFD098
D2018002
D0635880
70039502
10FE54E0
D2018000
920FD063
00104770
D00898EB
70504140
50DC0010
000044B8
00000000
PAGE 0002
40000780
T E X T
000000D8
000004B8 90EBD00C 58B0F010 5800F00C
50DC0018
9200D062 92919963 92C0D000 9202D063
FA11D092
B130F821 99A80009 F821D0AB D092D203
D092B080
FA11D092 B13AF821 D0B2D090 F821D0B5
4110B174
58F0B05C 95EF4119 B1144120 818358F0
05EF9204
D0635880 8979F821 D0908000 F821D093
D2017000
D091D201 79920004 9205D063 F821D090
B10F5860
B068D201 60000001 D2016002 D0949206
D0905050
D0989680 00084119 D09458F0 B06405EF
D063F811
D090B10C F8100092 B080FA11 D092B10A
8002D092
4780A0EE 92989963 4110B168 58F0B05C
9208D063
58F0B058 95EF9208 D0639210 D0634180
D09C4180
D0905080 99A99689 D0A04110 D09858F0
D063D202
D090D0B2 F9210009 B0D19200 D0904780
F921D091
B0CF9200 00014789 A1569280 D091D200
D0944780
A19E9212 99634119 B15C58F0 B05C05EF
05EF4110
D0B24120 818758F9 B05405EF 9212D063
B15058F0
B05C05EF 41198984 4120B183 58F0B054
9214D063
58F0B030 95EF47F9 47F0F00C 03C1E7F1
A0285830
80381B22 59293959 58F0B02C 47F0F062
4580A03A
07FA05A0 41000989 50DC001C 9200D062
47F0F00C
03C1C3F1 00099258 90EBD00C 58A0F008
10009200
D0A458E0 199859E9 D0884580 A03A47F0
00000258
90EBD00C 58A0F008 45E0A016 9203D084
100850E0
D0884580 A93047F9 A0860700 920BD063
80005870
D0A4FA21 00097000 F821D093 8002FA21
9503D084
4780A076 58600088 F872D098 D0904FE0
964ED098
2B006A00 00087000 600047F0 A0805880
D09447F0
A0805880 99889295 8000D090 58F0B060
D0A8F822
D0908000 5870D0AC FB22D090 7000F822
D0844780
A0E89503 99844789 A0FC5860 D088F872
B07890EF
D098964E 00082899 6A00D098 70006000
D091D201
8002D094 47F9A196 5880D088 D2058000
58F0B92C
05EFF014 91800091 4780F03C 5820D050
F03C58D0
D00450DC 99199189 D0004710 F03258D0
D00C07FE
58F0B030 97FF584C 00001244 47B0F056
4001504C
00005040 39549299 304C5030 D00818D3
5020D008
5020D060 07FEIC00 00001000 000014B8
000054B8
000064B8 000074B8 00000000 00000000
89300008
00000648 41660001 000002E4 000002AC
-----------------
図 15-8. オーバーレイ構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST の出力例 (2/4)
15-40
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
000500
000540
RECORD# 6
00000258
000520
00140014
000560
000580
0005A0
0005C0
0005E0
000600
000620
000640
000660
000680
0006A0
0006C0
0006E0
000700
000720
000740
000760
00000000
00000730
40D7D3F1
40C5D9D9
40C1C440
E3C5C440
000C041C
E3C5D9C5
00000740
00099748
04800620
900647F0
00033BC8
801C9206
804048D0
00224820
47F0808A
58F0F008
003C004C
07E2E8E2
00000000
00000738
E3C3F0F2
6D9D6BC5
C9E24002
C140C9E2
018C0C2C
C440000C
80000638
0000016C
41C90008
8206D2AF
00480A0A
70104150
900447F0
B07A4BD0
4AD0B086
07FF0000
D2071024
D7D9C9D5
LISTING OF LOAD MODULE PL1LOAD
00000000
00000000 00000000 00000000
00000740 00000748
80000000 00000001
6060C3D6
D4D7D3C5 E3C5C440 00000560
E7D7C5C3 E3C5C440
C1C440C9 E240F4F0
0C040C00 000005D4
002C002C 40C5D9D9
40F1F84E F4F1C940
C2E4E340 C140C9E2
0CIC0000 000005D4
00120012 40D7D3F1
040C050C 000C006C
000C020C 010C001C
00000748 00000242
80000534 00000748
80000534 00000748
000000A4 80000534
C08000D0 1C021AC1
95043008 47808200
4000C000 1BFF50FD
00101817 41000038
05804860 B08050E7
00309180 90064780
A05818C6 41D00020
1CCC1AD5 50D70014
80581B22 8D200008
41100001 19128C20
B0864740 807A1BCC
48I0B07E 1DC11AD2
4AD0B084 06208920
00081AD2 410D0000
00000000 50070034
003C004C 001058F0
00201002 00000000
00000004 00000000
E3000000 00000000
00000000 00000000
PAGE 0003
00000000
0C020000
00270027
4EF2F0C9
969968C5
49D9C5C1
E3C3F9F2
0009958C
0009921C
8993892C
D2AFC000
0A0A98EC
89189295
18499595
00084789
80009908
00000099
003C004C
00000000
00000000
00000544
40C2E4E3
E7D7C5C3
D3D3E840
6060C5D5
0000063B
80000534
8A060089
40009680
D00C07FE
701047F0
70104770
809648D7
41DCD001
47F0809E
58070034
00000000
00000000
TYPE 02 - RLD
RLD SIZE 236
R-PTR P-PTR
FL ADDR
FL ADDR
FL ADDR
FL ADDR
FL ADDR
FL ADDR
2
1
0C 000010
14
1
24 00002E
15
1
24 00029A
1
1
0D 0002B4 0C 0002EC
12
1
25 000448 24 000454
3
1
24 000478
13
1
24 000482
3
1
24 000490
12
1
25 0004A2 24 0004AA
2
2
0D 0004BC 0D 0004C0 0D 0004C4 0D 0004C8 0D 0004CC 0D 0004D0
0C 0004D4
4
2
8C 0004D8
5
2
8C 0004DC
1
2
0D 0004E0 PC 0004E4
2
2
0C 0004F0
1
2
0D 0004F8 0D 0004FC 0D 000500 0C 000504
16
2
9C 000508
17
2
9C 00050C
18
2
9C 000510
19
2
9C 000514
20
2
9C 0004E8
21
2
9C 000518
22
2
9C 00051C
23
2
0C 000520
-----------------
図 15-8. オーバーレイ構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST の出力例 (3/4)
第 15 章 AMBLIST
15-41
AMBLIST
RECORD# 7
LISTING OF LOAD MODULE PL1LOAD
PAGE 0004
TYPE 0E - RLD
RLD SIZE 236
R-PTR P-PTR
FL ADDR
FL ADDR
FL ADDR
FL ADDR
FL ADDR
FL ADDR
24
2
0C 000524
25
2
0C 000528
26
2
0C 00052C
2
2
09 00053D 09 000559 09 00058D 09 0005CD 0D 0005F8 0C 0005FC
25
2
0C 000600
2
2
08 000605
26
2
0C 000608
1
2
0C 00060C
2
2
08 000611
26
2
0C 000614
1
2
0C 000618
2
2
08 00061D
26
2
0C 000620
1
2
0C 000624
2
2
08 000629
26
2
0C 00062C
1
2
0C 000630
2
2
08 000635
1
8
0C 000718
10
9
8C 000728
27
26
24 000748
******END OF LOAD MODULE LISTING
図 15-8. オーバーレイ構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST の出力例 (4/4)
****LOAD MODULE PROCESSED EITHER BY VS LINKAGE EDITOR OR BINDER
LISTING OF LOAD MODULE MYMOD
PAGE 0001
RECORD#
CESD#
1
2
3
4
5
6
7
8
9
1
TYPE 20 - CESD
ESDID 1
ESD SIZE
SYMBOL TYPE
ADDRESS R/R/A ID/LENGTH(DEC)
A
00(SD)
000000
00
24
ENTA
03(LR)
000014
00
1
ENTB
03(LR)
000028
00
5
Q1
06(PR)
000000
03
4
B
00(SD)
000018
00
20
UNRES 02(ER)
000000
DANGLE 02(ER)
000000
$NULL 07(NULL) 000000
00
0
$NULL 07(NULL) 000000
00
0
144
(HEX)
18
1
5
4
14
0
0
図 15-9. 通常の (オーバーレイでない) 構造のロード・モジュールの LISTLOAD OUTPUT=MODLIST の出力例
15-42
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
LISTING OF PROGRAM OBJECT TESTPR
PAGE
1
THIS PROGRAM OBJECT WAS ORIGINALLY PRODUCED BY 5695DF108 AT LEVEL 01.00 ON 09/16/92 AT 09:42:47
-----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: A
AMODE: 24
ALIGNMENT: DOUBLE WORD
LENGTH:
24 (DEC)
MODULE OFFSET:
0 (DEC)
RMODE: 24
USABILITY: UNSPECIFIED
LENGTH:
18 (HEX)
MODULE OFFSET:
0 (HEX)
STORAGE: ANY
OVERLAY SEGMENT:
0
OVERLAY REGION:
0
===== IDRL =====
TRANSLATOR VER MOD
DATE
566896201
02
01
09/16/92
===== ESDs =====
ALPHA(PR)
ALIGNMENT: FULL WORD
LENGTH: 00000004
===== RLDs =====
SEC.OFF MOD.OFF TYPE
BDY
STATUS
REFERENCED SYMBOL
00000004 00000004 CPR
NONE
RES
$CUMULATIVE PSEUDO REGISTER LENGTH
00000008 00000008
PR
NONE
RES
(+)ALPHA
00000010 00000010 CPR
NONE
RES
$CUMULATIVE PSEUDO REGISTER LENGTH
00000014 00000014 CPR
NONE
RES
$CUMULATIVE PSEUDO REGISTER LENGTH
===== TEXT =====
00000000 C1C1C1C1 00000014 00000000 00000000
00000014 00000014
LISTING OF PROGRAM OBJECT TESTPR
PAGE
2
PSEUDO REGISTER
VECTOR LOC LENGTH
0
4
0
10
LENGTH OF PSEUDO REGISTERS
14
** END OF PROGRAM OBJECT LISTING
NAME
ALPHA
BETA
図 15-10. PDSE (プログラム・オブジェクトのバージョン 1) に関する LISTLOAD OUTPUT=MODLIST 出力の例
プログラム・オブジェクトについての MODLIST 出力の説明
LISTLOAD OUTPUT=MODLIST が作成するリストは複数の部分で構成されます
( 15-32 ページの図 15-7 を参照)。
各ページの最上部に表示される、ページ見出し。
ページ見出しは 1 つまたは 2 つのヘッディング行で構成され、次のフォーマッ
トです。
LISTING OF PROGRAM OBJECT xxxxxxxx
ヘッディング行の後には、LISTLOAD 制御ステートメントの TITLE パラメー
ターに入力した表題行が続きます。
バインダー生成プログラム・オブジェクトを識別するレコード (IDRB)。
IDRB レコードはレコード行に、次のフォーマットで表示されます。
THIS PROGRAM OBJECT WAS ORIGINALLY PRODUCED BY 5695DF108 AT LEVEL 02.10
ON mm/dd/yyyy AT hh:mm:ss
バインダー・プログラム ID、バージョンとレベル、バインディングの日時がこ
こに表示されます。IDRB 行の後には破線が続きます。
プログラム・オブジェクト内の各制御セクションについての個々のリストは、破線
で分けられます。
モジュール内の各制御セクションについて、ESD セクション定義 (SD) レコー
ドがフォーマット設定され、その後に次の順序ですべてのデータ・クラスが続き
ます。
1. IDRZ - SPZAP 識別データ
2. IDRL - 言語翻訳プログラム識別データ
3. IDRU - ユーザー提供識別データ
4. SYM - 内部記号辞書
第 15 章 AMBLIST
15-43
AMBLIST
5.
6.
7.
8.
ESD - 外部記号辞書
RLD - 再配置辞書
TEXT - CSECT の命令とデータ
ADATA - ADATA 情報
SD は 2 印刷行を占めます。
v 最初の行は定数 CONTROL SECTION、SEGMENT TABLE、ENTRY
TABLE、または MODULE SECTION で始まり、セクション名または共通名
を表示します。ユーザー定義名がない場合は、以下のように、バインダー生
成名が表示されます。
– $PRIVxxxxx - ここで x は、もともとブランク名または名前がないユーザ
ー・セクションに対する番号です。
– $BLANKCOM - モジュール用のマージ・クラスを含む、名前のない共通
$SUMMARY バインダー生成セクション。
v 2 番目の行には USABILITY、オーバーレイ・セグメントおよび領域を表示し
ます。USABILITY には、UNSPECIFIED、NON-REUSABLE、REUSABLE、
REENTRANT または REFRESHABLE の 1 つを含まなければなりません。
非オーバーレイ・モジュールの場合は、後の 2 つのフィールドにはゼロが含
まれます。 SYSTEM LE または LIGHTWEIGHT LE 属性を報告するため
に、3 行目が印刷される場合があります。
8 つのクラス・サブセクションのおのおのはフォーマットの ID 行で始まりま
す。
===== class name =====
IDR 明細は、単一セクションについてのみ表示される点を除いて、 15-63 ペー
ジの『LISTIDR 出力の説明』に記載されたフォーマットと同じです。クラスの
残りの部分については次に説明します。
v SYM データは各行に 40 バイトを表示します。
v ESD データは、各 ESD レコードに対して 3 から 4 行を占めます。最初の
行には外部名 (省略名、16 バイト以上の長さの名前の場合) と、それに続い
て括弧で ESD レコード・タイプが含まれます。残りのフォーマット設定され
たフィールドは、ESD レコード・タイプによって異なります。
– ED レコードは、エレメント定義を定義します。長さと様々な属性はセク
ションに含まれるクラスをバインドおよびロードするのに使用されます。
各 ED レコードは、3 印刷行を占めます。
1. 最初の行には以下の情報が表示されます。
- CLASS 名 - 16 バイトまで。
- LENGTH - 定義したクラス・エレメントの長さを 16 進数で表示。
- CLASS OFFSET - 16 進数。
- FORMAT - 最初のフィールドはクラス・レコード・フォーマットで
F (固定長レコード) または V (可変長レコード) で、それに続いて
括弧内にレコード・フォーマットの 16 進数値が続きます。
2. 2 番目の行には以下の情報が示されます。
- NAME SPACE - 16 進数。
15-44
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
- ALIGNMENT - DOUBLE WORD、QUAD WORD、または PAGE の
いずれかです。
- BIND METHOD - CATENATE または MERGE のいずれかです。
- RMODE - 24、64、ANY、または UNSPECIFIED のいずれかです。
3. 3 行目にはバインダーおよびローダー属性が記載されます。
- バインダー属性は DESCRIPTIVE DATA、TEXT、または
REMOVABLE です。
- ローダー属性は、NOLOAD、LOAD、DEFER、READ-ONLY のいず
れかです。 (または、充てん文字がない場合は FILL : UNSPEC が印
刷されている)。
– ER レコードは名前付きセクションからの外部参照を定義します。各 ER
レコードは 4 印刷行を占めます。
1. 最初の行には以下の情報が表示されます。
- TEXT TYPE - UNSPEC (指定なし)、INSTRUC (命令またはコー
ド)、DATA、または TRANS.DEF (変換プログラムが定義) のいずれ
かです。
- CLASS OFFSET - 16 進数。
2. 2 番目の行には以下の情報が示されます。
- TARGET SECTION - ターゲット・セクション名 (省略名、名前が
16 バイト以上の長さの場合)。
- TARGET CLASS - ターゲット・ラベルを含むクラスの名前。
3. 3 行目には以下の情報が記載されます。
- NAME SPACE - 16 進数。
- SCOPE - 名前の有効範囲 (SECTION、MODULE、LIBRARY、また
は IMP/EXP)。
- ELEMENT OFFSET - 16 進数。
4. 4 番目の印刷行には ER 状況と自動呼び出しを記載しています。
- ER 状況は、RESOLVED または UNRESOLVED のいずれかです。
- AUTOCALL は、AUTOCALL または NEVERCALL のいずれかで
す。
5. 5 行目にはバインダー属性が表示されます。指定可能な属性は、
XPL、STRONG または WEAK、MAPPED、INDIRECT、
GENERATED、または MANGLED です。
– LD レコードは、名前付きセクションのラベルまたは入り口点を定義して
います。各 LD レコードは 3 印刷行を占めます。
1. 最初の行には以下の情報が表示されます。
- CLASS NAME - 16 バイトまで。
- TEXT TYPE は、UNSPEC、INSTR、DATA または TRANS.DEF の
いずれかです。
- CLASS OFFSET - 16 進数。
2. 2 番目の行には以下の情報が示されます。
- NAME SPACE - 16 進数。
第 15 章 AMBLIST
15-45
AMBLIST
- SCOPE - 名前の有効範囲 (SECTION、MODULE、LIBRARY、また
は IMP/EXP)。
- ELEMENT OFFSET - 16 進数。
- AMODE - 24、31、64、MIN、ANY、または UNSPECIFIED のいず
れかです。
3. 3 行目にはバインダー属性が表示されます。指定可能な属性は、XPL
(xplink)、STRONG または WEAK、MAPPED、INDIRECT、
GENERATED (LD レコードがバインダーによって生成された)、または
MANGLED です。さらに、そのレコードに環境または関連データ
(ADA) を定義しているシンボル名が含まれている場合、そのシンボル
が印刷されます。
4. 拡張属性が存在する場合、14 行目には常駐クラスとオフセットがリス
トされます。
– PD (パート定義) および PR (パート参照) レコードはパートまたは疑似レ
ジスターを定義します。PR レコードはパート (セクション内の) のローカ
ル定義であるのに対して、PD レコードはすべての関連する PR (同じ名前
を持つ PR) に関するグローバル定義です。PR および PD レコードには、
同じフォーマット制御されたフィールドが含まれています。各レコードは
3 印刷行を占めます。
1. 最初の行には以下の情報が表示されます。
- CLASS 名 - 16 バイトまで。
- LENGTH - 16 進数で記載されます。
- CLASS OFFSET - 16 進数。
2. 2 番目の行には以下の情報が示されます。
- NAME SPACE - 16 進数。
- ALIGNMENT - BYTE、HALF WORD、FULL WORD、DOUBLE
WORD または PAGE のいずれかです。
- PRIORITY - エレメント内のパートの順序を制御します。
- SCOPE - パートの有効範囲 (SECTION、MODULE、LIBRARY、ま
たは IMP/EXP)。
3. 3 行目にはバインダー属性が表示されます。指定可能な属性は、
XPL、STRONG または WEAK、MAPPED、INDIRECT、
GENERATED、または MANGLED です。
v RLD レコードは RLD レコードごとに 1 行表示されます。関連するアドレ
ス定数のエレメント・オフセットによります。複数の RLD レコードが同じ
アドレス定数を参照する場合は、エレメント・オフセットは同じになりま
す。RLD データは次のもので構成されます。
– エレメント・オフセット - エレメント内の関連するアドレス定数のオフセ
ットを 16 進数で記載します。
– クラス・オフセット - クラス内の関連するアドレス定数のオフセットを
16 進数で記載します。
15-46
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
– ADCON TYPE - この RLD 項目に関連するアドレス定数のタイプ。サポ
ートされている 5 つのタイプは、BR (V- タイプ)、N-BR (A- タイプ)、
SEGM (クラス・セグメントのアドレス)、C-OF (Q- タイプ)、または CPR
(累積クラス長) です。
– 状況 - このフィールドはアドレス定数と関連した状況を識別します。有効
な状況は、RES (解決された)、UNRES (未解決の)、および N-REL (再配
置不能な定数) です。
– LENGTH - アドレス定数長を 16 進数で記載します。
– HOBCHG - V- タイプ・アドレス定数の高位ビットがバインダーにより変
更されました。可能な値は YES または NO です。
– 参照の NAME SPACE を 16 進数で記載します。
– TARGET NAME - 参照シンボル名。
– PARTRES - RLD がパート (PR) 上のアドレス定数を記述している場合、
常駐パートの名前となります。
– XATTR NAME - 拡張属性 (ある場合) を格納する場所を定義しているシ
ンボル。
– XATTR OFF - 拡張属性を格納するシンボル XATTR NAME からのオフ
セット。
v TEXT データがクラス名ごとに表示されます。テキスト・データは 16 進数
表示に加えて、EBCDIC フォーマットで表示されます。
v LISTLOAD OUTPUT=MODLIST 制御カード上の ADATA=YES により要求さ
れている場合は、ADATA 情報が、TEXT データのようにクラス名で 16 進
数と EBCDIC の両方で表示されます。
長い名前の省略名参照表がリストの終わりの前に表示され、長い名前付きリ
ストのフォーマット設定された部分に、すべての省略名 (長さが 16 バイト以
上の外部名) が表示されます。
トレーラー・レコード。
**
END OF PROGRAM OBJECT LISTING
ロード・モジュール/PDS についての MODLIST 出力の説明
LISTLOAD OUTPUT=MODLIST が作成するリストは複数の部分で構成されます
( 15-39 ページの図 15-8 および 15-42 ページの図 15-9 を参照)。
各ページの最上部に表示される、ページ見出し。
ページ見出しは 1 つまたは 2 つのヘッディング行で構成され、次のフォーマッ
トです。
LISTING OF LOAD MODULE PL1LOAD
ロード・モジュールの各レコードの個々のリスト。DASD の各レコードは、シ
ーケンス番号 (RECORD#)、およびタイプで識別されます。多くの場合、レコー
ドのサイズ情報もあります。この情報の後に、レコード・タイプに従ったフォー
マットのコンテンツが続きます。
後に続くフィールドの詳細については、z/OS MVS プログラム管理: 拡張機能
Appendix B. ロード・モジュール・フォーマットを参照してください。
第 15 章 AMBLIST
15-47
AMBLIST
TYPE 20 - CESD
これは、外部シンボルの定義または使用を含むレコードです。
v CESD# - バインダーにより割り当てられたシンボルの内部番号。
v SYMBOL - シンボルのプログラムで使用されている形での名前、またはその
省略形。
v TYPE - 外部シンボル辞書の項目の様々なタイプの説明については、z/OS
MVS プログラム管理: ユーザーズ・ガイドおよび解説書 の第 2 章を参照し
てください。
– ER - 外部参照
– WX - 弱い外部参照
– LR - ラベル参照
– SD - セクション定義、制御セクション (CSECT)
– PC - 専用コード
– CM - 共通域
– PR - 疑似レジスター
v ADDRESS - シンボルが定義されたバウンド・プログラム内のオフセット。
v SEGNUM - オーバーレイ構造モジュールのみ: オーバーレイ・セグメント番
号。
v R/R/A - オーバーレイ構造でないモジュールのみ: 16 進数で表示され、
AMODE、RMODE および読み取り専用属性を示す、ビット・コード化したバ
イト。3 つの属性の値は、論理和演算された値が表示されます。
– 08 - 読み取り専用
– 04 - RMODE=ANY (オフの場合は RMODE=24)
– 01 - AMODE=24
– 02 - AMODE=31
– 03 - AMODE=ANY
– 10 - AMODE=64
v ID/LENGTH - LR の参照シンボルの ESD 番号、SD、PC、CM、または PR
のセクションまたはフィールドの長さ
– (DEC) - 10 進数で表示された長さまたは ID
– (HEX) - 16 進数で表示された長さまたは ID
TYPE 0 - RLD (02、06、または 0E)
RLD レコード・タイプでは、AMBLIST は以下のカラムに情報を出力します。
v
v
R-PTR - ターゲット・エレメントの ESDID
P-PTR - アドレス定数または修正されるデータ・エリアを含むエレメントの
ESDID。
v FL - フラグ
v ADDR - アドレス
TYPE 0 - CONTROL (01、05、または 0D)
ロード・モジュールの各制御セクションの CONTROL レコード・リスト情報:
v CESD# - 制御セクションの CESD 番号
15-48
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
v LENGTH - 制御セクションの長さ
TEXT
このレコード・タイプは、実行のためにロードされたプログラムを含んでいま
す。テキスト・データは 16 進形式で表示されています。
トレーラー・レコード。
******END OF LOAD MODULE LISTING
LISTLOAD OUTPUT=XREF 出力
このセクションには、以下のような相互参照リストを含めて、LISTLOAD
OUTPUT=XREF 出力の例があります。
v
15-50 ページの図 15-11 は、複数のクラスを含むプログラム・オブジェクト・バ
ージョン 2 の出力を示しています。説明は、この図の後ろの説明を参照してくだ
さい。
v
15-56 ページの図 15-13 と 15-57 ページの図 15-14 により、プログラム・オブジ
ェクト・バージョン 1 の出力と、ロード・モジュールの出力を比較することがで
きます。
v
15-55 ページの図 15-12 に、セグメント・マップ・テーブルのサンプルを示しま
す。
リストには、次の部分があります。
v 数値マップ。モジュール内にほぼ現れた順番で情報を表示します。
v 数値的相互参照
v 英字マップ。記号名で英字順に情報を表示します。
v 英字相互参照
以下のリスト内で、ページ 1 はモジュール内の数値順マップを示します。ページ 2
はモジュールの数値相互参照リストを示します。ページ 4 は英字マップを示し、ペ
ージ 5 は英字相互参照リストを表示します。
注: 15-50 ページの図 15-11 に表示されているモジュールはオーバーレイ・フォー
マットではありません。オーバーレイ・フォーマットの場合は、各セグメント
は別々にフォーマット設定されます。
AMBLIST からのその他の出力とともに、各ページは標準ヘッディングで始まりま
す。各ページの最初の行はページ番号で、次のヘッディング定数の 1 つで始まりま
す。
v NUMERICAL MAP OF PROGRAM OBJECT ....
v NUMERICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT ....
v ALPHABETICAL MAP OF PROGRAM OBJECT ....
v ALPHABETICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT ....
メンバー名がヘッディングの後に続きます。名前が 16 文字を超える場合は、フォ
ーマット制御された 16 バイトの省略名がかわりに印刷されます。オプションの 2
番目の行は、LISTLOAD 制御ステートメント上でユーザーが提供する表題情報を印
刷するのに使用されます。4 つの部分のそれぞれに独自の副見出し行があり、それ
に続くその明細を説明しています。
第 15 章 AMBLIST
15-49
AMBLIST
A
** NUMERICAL MAP OF PROGRAM OBJECT LOADMOD1
**
PAGE
1
-----------------------------------------------------------------------------------------------------------------------CLASS NAME:
B_PRV
CLAS LOC ELEM LOC
LENGTH TYPE
ALIGNMENT
NAME
0
0 ED
BYTE
$PRIVATE
0
1 PD
BYTE
A
1
1 PD
BYTE
E
2
1 PD
BYTE
C
3
1 PD
BYTE
G
4
2 PD
HALF WORD
F
8
4 PD
FULL WORD
D
10
8 PD
DOUBLE WORD
B
0
0 ED
BYTE
SD1
CLASS LENGTH
0
-----------------------------------------------------------------------------------------------------------------------B
** NUMERICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT LOADMOD1
**
PAGE
2
CLAS LOC ELEM LOC
CLASS NAME
C6
C6
IN SECTION SD1 1
$CLASS_OFFSET
B_PRV
REFERS TO A 2
ADCON AT
12E
12E
IN SECTION SD1
$CLASS_OFFSET
B_PRV
REFERS TO B
ADCON AT
196
196
IN SECTION SD1
$CLASS_OFFSET
B_PRV
REFERS TO C
ADCON AT
1FE
1FE
IN SECTION SD1
$CLASS_OFFSET
B_PRV
REFERS TO D
ADCON AT
266
266
IN SECTION SD1
$CLASS_OFFSET
B_PRV
REFERS TO E
ADCON AT
2CE
2CE
IN SECTION SD1
$CLASS_OFFSET
B_PRV
REFERS TO F
ADCON AT
336
336
IN SECTION SD1
$CLASS_OFFSET
B_PRV
REFERS TO G
ADCON AT
39C
39C
IN SECTION SD1
$CLASS_LEN
B_PRV
REFERS TO $CLASS_LEN
-----------------------------------------------------------------------------------------------------------------------CLASS NAME:
B_TEXT
CLAS LOC ELEM LOC
LENGTH TYPE
ALIGNMENT
NAME
0
430 ED
DOUBLE WORD
SD1
430
238 ED
DOUBLE WORD
SD2
668
8 ED
DOUBLE WORD
SDX
668
0
LD
LD1
66C
4
LD
LD2
1000
30 ED
DOUBLE WORD
$BLANKCOM
3
2000
30 ED
DOUBLE WORD
CM1
CLASS LENGTH
0
-----------------------------------------------------------------------------------------------------------------------ADCON AT
図 15-11. B_PRV および B_TEXT クラス名のプログラム・オブジェクトに関する LISTLOAD OUTPUT=XREF の出力例
(1/3)
15-50
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
** NUMERICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT LOADMOD1
**
PAGE
3
CLAS LOC ELEM LOC
CLASS NAME
48
48
IN SECTION SD1
0
0
B_TEXT
REFERS TO SD1
ADCON AT
478
48
IN SECTION SD2
430
0
B_TEXT
REFERS TO SD2
ADCON AT
4F4
C4
IN SECTION SD2
66C
4
B_TEXT
REFERS TO LD2
668
0
IN SECTION SDX
ADCON AT
554
124
IN SECTION SD2
2000
0
B_TEXT
REFERS TO CM1
ADCON AT
604
1D4
IN SECTION SD2
2000
0
B_TEXT
REFERS TO CM1
LENGTH OF PROGRAM OBJECT
2030
-----------------------------------------------------------------------------------------------------------------------C ** ALPHABETICAL MAP OF PROGRAM OBJECT LOADMOD1
**
PAGE
4
ADCON AT
ENTRY NAME CLAS LOC ELEM LEN/LOC
$BLANKCOM
1000
30
$PRIVATE
0
0
A
0
1
B
10
8
C
2
1
CM1
2000
30
D
8
4
E
1
1
F
4
2
G
3
1
LD1
668
0
LD2
66C
4
SDX
668
8
CLASS NAME
SECTION NAME OR ENTRY TYPE
B_TEXT
(ED)
B_PRV
(ED)
B_PRV
(PD)
B_PRV
(PD)
B_PRV
(PD)
B_TEXT
(ED)
B_PRV
(PD)
B_PRV
(PD)
B_PRV
(PD)
B_PRV
(PD)
B_TEXT
SDX
B_TEXT
SDX
B_TEXT
(ED)
図 15-11. B_PRV および B_TEXT クラス名のプログラム・オブジェクトに関する LISTLOAD OUTPUT=XREF の出力例
(2/3)
第 15 章 AMBLIST
15-51
AMBLIST
SD1
0
0
B_PRV
(ED)
0
430
B_TEXT
(ED)
SD1
SD2
430
238
B_TEXT
(ED)
-----------------------------------------------------------------------------------------------------------------------D ** ALPHABETICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT LOADMOD1
**
PAGE
5
CLAS LOC ELEM LOC
CLASS NAME
$CLASS_LEN
B_PRV
39C
39C
$CLASS_OFFSET
B_PRV
C6
C6
$CLASS_OFFSET
B_PRV
12E
12E
$CLASS_OFFSET
B_PRV
196
196
2000
0
B_TEXT
554
124
2000
0
B_TEXT
604
1D4
$CLASS_OFFSET
B_PRV
1FE
1FE
$CLASS_OFFSET
B_PRV
266
266
$CLASS_OFFSET
B_PRV
2CE
2CE
$CLASS_OFFSET
B_PRV
336
336
66C
4
B_TEXT
668
0
4F4
C4
0
0
B_TEXT
48
48
430
0
B_TEXT
478
48
LENGTH OF PROGRAM OBJECT
2030
** END OF MAP AND CROSS-REFERENCE LISTING
SYMBOL
$CLASS_LEN
REFERENCED IN
A
REFERENCED IN
B
REFERENCED IN
C
REFERENCED IN
CM1
REFERENCED IN
CM1
REFERENCED IN
D
REFERENCED IN
E
REFERENCED IN
F
REFERENCED IN
G
REFERENCED IN
LD2
IN SECTION SDX
REFERENCED IN
SD1
REFERENCED IN
SD2
REFERENCED IN
1
SD1
SD1
SD1
3
SD1
SD2
SD2
SD1
SD1
SD1
SD1
2
SD2
SD1
SD2
図 15-11. B_PRV および B_TEXT クラス名のプログラム・オブジェクトに関する LISTLOAD OUTPUT=XREF の出力例
(3/3)
数値マップ
A 数値マップ は定義されたエレメント定義、パート、または複合 ESD 内の制御
セクションごとに 1 行印刷されます。明細行には、クラス・オフセット (16 進
数)、セクション・オフセット (ラベル/パート用) か長さ (制御セクション・エレメ
ント定義の場合) のいずれか、ESD レコード・タイプ、位置合わせ (LD/PD レコー
ド・タイプの場合)、およびラベル/パート、セクションまたはエレメント定義名が含
まれます。バインダーによって生成されたセクション、または名前のないユーザ
ー・セクションのバインダー生成名は、以下のように表示されます。
$PRIVxxxxxx - ここで xxxxxx は数字です。
$BLANKCOM
$SEGTAB
$ENTAB
他のすべての項目には、ラベル/パートに関してユーザーが割り振った有効な名前、
制御セクション/エレメント定義または名前付き共通域が含まれます。ラベル (LD)
または、パート (PD) タイプ ESD 項目に関しては、クラス・オフセットおよびラ
ベル/パート名は、ラベル/パートが前のセクション項目内に含まれていることを示す
ために行下げされます。
15-52
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
モジュールがオーバーレイ・フォーマットであれば、マップと相互参照は各セグメ
ントで変わります。この場合は、マップは以下のようなセグメント識別行で始まり
ます。
SEG. nnnnn ----------------------------------------------------
また以下のようなセグメント長行で終了します。
LENGTH OF SEGMENT
nnnnn
数値順マップは、リンケージ・エディターまたはバインダーが作成するロード・マ
ップと機能的に同等です。
数値相互参照
B 数値相互参照リストには、関連するアドレス定数の 16 進数クラス・オフセッ
トで順番に示されるモジュール内の各 RLD レコードについて 1 つの項目を含みま
す。モジュール内の A-、V-、および Q- タイプのアドレス定数ごとに RLD レコー
ドが 1 つあり、クラス参照 (RLD タイプ =21)、クラス長 (CXD)、またはローダ
ー・トークンごとに RLD レコードが 1 つあります。
各項目は RLD タイプと参照の解決の状況によって、2 行または 3 行で構成されま
す。解決済み再配置可能アドレス定数 (A タイプおよび V タイプ) は 3 印刷行必
要としますが、未解決参照と再配置不能な定数 (Q- タイプ) とクラス参照 (RLD タ
イプ =21) は 2 行のみです。3 つの行については次に説明します。
1 最初の行はアドレス定数自体について記載し、クラスとエレメント・オフセッ
トを 16 進数で、アドレス定数を含むセクション名を示します。すべてのアドレス
定数はセクション内に存在する必要があるため、常にユーザー定義のセクション名
か、$PRIV000001 や $BLANKCOM などのバインダー生成名の表記が存在すること
になります。 2 2 番目の行には、参照される記号またはターゲットの記号が記述
されます。これには、参照されるラベル/パートのクラスおよびエレメント・オフセ
ット、またはセクション/エレメント定義、および参照されるクラス名のクラス名が
含まれます (参照が解決済みであるか、次の定数のいずれかの場合)。
$UNRESOLVED - 強制参照 (ER) がバインディング中に解決できませんでし
た。
$UNRESOLVED(W) - 弱参照 (WX) がバインディング中に解決できませんでし
た。
$NEVER CALL - その記号はまったく呼び出されなかったという印が付けられ、
ライブラリーからその記号を解決するための試みが何もなされませんでした。
$CLASS-OFFSET - 参照はクラス・オフセット (Q- 定数) に対してです。
$CLASS-LEN - 参照はクラス長 (RLD type=40) に対してです。
2 番目の行には、定数ストリング REFERS TO に続いて、参照された記号の名前も
示しています。 RLD 項目がクラス・オフセットまたはクラス長用の場合は、定数
ストリング $CLASS_OFFSET または $CLASS_LEN が名前の代わりに表示されま
す。
3 3 番目の行は解決された A タイプと V タイプ・アドレス定数についてのみ印
刷されます。この行では参照ラベルを含むセクションについて説明し、モジュー
ル・オフセット (セクション・オフセットは、セクションについて常にゼロ) とセク
ション名を含んでいます。ターゲット・セクションに名前がない場合は、バインダ
第 15 章 AMBLIST
15-53
AMBLIST
ー生成名 ($PRIV000005、$BLANKCOM) の表記が印刷されます。 2 番目の行のタ
ーゲット名が含んでいるセクション名と同じ場合は、3 番目の行は 2 番目の行以上
の追加情報を提供しないので印刷されません。
最後の、または唯一のセグメント相互参照の後ろにプログラム・オブジェクトの長
さが続きます。
LENGTH OF PROGRAM OBJECT nnnn
クラスで RLD が使用不可能な場合は、次のメッセージがフォーマット制御された
詳細のかわりに表示されます。
**** NO ADCONS IN THIS CLASS ****
英字マップ
C 英字マップは、ラベル定義、パート定義、制御セクション、およびエレメント
定義 (ER および PR 以外) を英字順に、各 ESD 項目ごとに 2 行印刷します。数
値マップと同じ情報のすべてが、異なる順序で含まれます。この部分は常に新しい
ページで開始し、 ALPHABETICAL MAP OF PROGRAM OBJECT ..... という標準
のページ・ヘッディングが付いています。
最初の明細行にはラベル、セクションまたは共通名がリストされます。
2 番目の明細行には、クラス・オフセット、エレメント・オフセット (タイプ
LD/PD レコード) またはエレメント定義長 (すべての他のタイプ)、クラス名 (クラ
スを含む名前)、セクション/エレメントを含む名前 (タイプ LD/PD レコード) また
は ESD 項目タイプ (すべての他のタイプ) が含まれます。エレメント長は、これが
エレメント・オフセットからのものであることが分かるように字下げされます。モ
ジュールがオーバーレイの場合は、セグメント番号がセクション長さの右に印刷さ
れます。
英字相互参照
D 英字相互参照リストは、数値相互参照リストと同じ情報が、異なる順序で示さ
れます。報告書のこの部分は参照された名前 (アドレス定数内で参照されている記
号名) ごとの照合順序になっています。
英字相互参照は、新しいページで始まり、 ALPHABETICAL CROSS-REFERENCE
LIST OF PROGRAM OBJECT という標準のページ・ヘッディングを持ち、 4 つの
列があります (非オーバーレイの例では 3 つのみが表示される)。
1. クラス・オフセット。これはプログラム・オブジェクトのクラス内の名前付き項
目の 16 進数オフセットです。2 番目の行および 3 番目の明細行のクラス・オ
フセットは字下げされます。
2. エレメント・オフセット。これは、そのセクション内の名前付きラベルの 16 進
数オフセットです。ラベルではなくエレメントを参照する行は、エレメント・オ
フセットにゼロを必ず表示します。
3. オーバーレイ・セグメント。これはオーバーレイ・フォーマットのモジュールの
みに表示されます。
4. 記号。このフィールドは続くテキストで説明される 3 つの明細行になります。
表示された名前が特殊なセクション名の場合は、前述のバインダー生成名
($PRIVxxxxxx など) の 1 つでその名前が置き換えられます。
15-54
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
数値相互参照リストの場合と同様に、英字相互参照リストの明細は 2 または 3 行
で表示されます。この場合は、行 2 はオプションで、ラベルが解決されたアドレス
定数についてのみ表示されます (セクションに対して)。3 つの行については次に説
明します。
1 行 1 は、参照される (ターゲット) 記号を記述し、クラス・オフセット、エレ
メント・オフセットまたはゼロ、またオプションでセグメント番号 (オーバーレイ
の場合)、参照クラス名および記号名を表示します。参照が未解決の場合は、オフセ
ット・フィールドは定数「$UNRESOLVED - 強制参照 (ER) がバインディング中に
解決できませんでした。」でオーバーレイされます。RLD がタイプ 30 (クラス・
オフセット) または、タイプ 40 (クラス長) の場合は、オフセット・フィールドは
次の定数のいずれかでオーバーレイされます。
$CLASS_OFFSET - 参照はクラス・オフセットに対してです。
$CLASS_LEN - 参照はクラス長に対してです。
2 行 2 は、ラベルが解決したアドレス定数についてのみ表示されます (LD タイ
プ ESD 項目)。この行では、参照ラベルを含むセクションを記述し、クラス・オフ
セット、ゼロ・エレメント・オフセット、オプションのセグメント番号、セクショ
ン名を含んでいます。セクション名の前に定数 IN SECTION があり、行 1 の名前
フィールドからは字下げされています。
3 行 3 は、参照されるアドレス定数を記述し、クラスとエレメント・オフセッ
ト、オプションのセグメント番号、アドレス定数を含むセクションの名前を含みま
す。セクション名の前に定数 REFERENCED IN があり、前の行の名前フィールド
からは字下げされています。
RLD がプログラム・オブジェクトで使用不可能な場合は、次のメッセージがフォー
マットされた詳細の代わりに表示されます。
**** NO RLD DATA ***
相互参照リストは次の行で終わります。
**
CLASS
B_TEXT
C_CODE
C_@@DLLI
C_@@PPA2
B_LIT
C_WSA
END OF MAP AND CROSS-REFERENCE LISTING
** SEGMENT MAP TABLE **
SEGMENT
OFFSET
1
0
1
1B70
1
C3B8D8
1
C3D238
1
C3EBA8
2
0
LENGTH
1B6A
C39D68
1960
1970
100
38F66C
ATTRIBUTES
INITIAL LOAD
INITIAL LOAD
INITIAL LOAD
INITIAL LOAD
INITIAL LOAD
DEFER
図 15-12. LISTLOAD OUTPUT=XREF のセグメント・マップ・テーブルのサンプル
|
|
|
|
LISTLOAD OUTPUT=MAP
このセクションは、LISTLOAD OUTPUT=XREF 出力 の NUMERICAL MAP セク
ションと同じ出力を作成します。詳細については、 15-52 ページの『数値マップ』
を参照してください。
第 15 章 AMBLIST
15-55
AMBLIST
LISTLOAD OUTPUT=XREF 出力 (ロード・モジュールとプログラム・オブ
ジェクト・バージョン 1 との比較)
LISTLOAD OUTPUT=XREF,DDN=DD1,
MEMBER=MAINRTN
***** M O D U L E S U M M A R Y *****
MEMBER NAME: MAINRTN
MAIN ENTRY POINT:
00000000
LIBRARY:
DD1
AMODE OF MAIN ENTRY POINT: 31
NO ALIASES **
-----------------------------------------------------------------------------------------------------------------------**** LINKAGE EDITOR ATTRIBUTES OF MODULE ****
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 NOT-EXEC
7 MULTI-RCD
8 NOT-DC
9 ZERO-ORG
10 EP-ZERO
11 RLD
12 EDIT
13 NO-SYMS
14 F-LEVEL
15 NOT-REFR
-----------------------------------------------------------------------------------------------------------------------MODULE SSI: NONE
APFCODE:
00000000
RMODE:
ANY
*****LOAD MODULE PROCESSED BY VS LINKAGE EDITOR
NUMERICAL MAP AND CROSS-REFERENCE LIST OF LOAD MODULE MAINRTN
PAGE 0001
CONTROL SECTION
LMOD LOC
NAME
00
MAINRTN
168 $PRIVATE
ENTRY
LMOD LOC CSECT LOC
LENGTH TYPE
166 SD
BC PC
1D4
228
$PRIVATE
BC
6C
NAME
NONAME1M
PC
294
6C
NONAME2M
2E8
SUBRTN
102 SD
3F0
AAAAAAAA
54 CM
448 $BLANKCOM
54 CM
-----------------------------------------------------------------------------------------------------------------------LMOD LOC CSECT LOC
IN CSECT
REFERS TO SYMBOL AT LMOD LOC CSECT LOC
IN CSECT
AC
AC
MAINRTN
AAAAAAAA
3F0
00
AAAAAAAA
B0
B0
MAINRTN
NONAME1M
1D4
6C
$PRIVATE
B4
B4
MAINRTN
NONAME2M
294
6C
$PRIVATE
160
160
MAINRTN
SUBRTN
2E8
00
SUBRTN
394
AC
SUBRTN
$BLANKCOM
448
00
$BLANKCOM
LENGTH OF LOAD MODULE
4A0
ALPHABETICAL MAP OF LOAD MODULE MAINRTN
PAGE 0002
CONTROL SECTION
NAME
LMOD LOC
$BLANKCOM
448
$PRIVATE
168
$PRIVATE
228
AAAAAAAA
3F0
MAINRTN
00
ENTRY
NAME
LENGTH TYPE
54 CM
BC PC
BC PC
54 CM
166 SD
NONAME1M
NONAME2M
SUBRTN
1D4
294
6C
6C
$PRIVATE
$PRIVATE
2E8
102 SD
ALPHABETICAL CROSS-REFERENCE LIST OF LOAD MODULE MAINRTN
SYMBOL AT LMOD LOC CSECT LOC
IN CSECT
$BLANKCOM
448
00
$BLANKCOM
AAAAAAAA
3F0
00
AAAAAAAA
NONAME1M
1D4
6C
$PRIVATE
NONAME2M
294
6C
$PRIVATE
SUBRTN
2E8
00
SUBRTN
**
END OF MAP AND CROSS-REFERENCE LISTING
IS REFERRED TO BY LMOD LOC CSECT LOC
394
AC
AC
AC
B0
B0
B4
B4
160
160
図 15-13. ロード・モジュールの LISTLOAD OUTPUT=XREF の出力例
15-56
LMOD LOC CSECT LOC CSECT NAME
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
PAGE 0003
IN CSECT
SUBRTN
MAINRTN
MAINRTN
MAINRTN
MAINRTN
AMBLIST
LISTLOAD OUTPUT=XREF,DDN=DD1,
MEMBER=(MAINRTN,
THISISALONGALIASNAMEYOUMAYCHANGETHENAMEIFYOULIKEANYNAMEWILLDOOOO),
TITLE=(’XREF LISTINGS OF A LONG ALIAS NAME’,10)
***** M O D U L E S U M M A R Y *****
MEMBER NAME: MAINRTN
MAIN ENTRY POINT:
00000000
LIBRARY:
DD1
AMODE OF MAIN ENTRY POINT: 31
** ALIASES **
ALIAS ENTRY POINT
AMODE OF ALIAS ENTRY POINT
THISISALONGALIASNAMEYOUMAYCHANGETHENAMEIFYOULIKEANYNAMEWILLDOOOO
00000000
31
-----------------------------------------------------------------------------------------------------------------------****
ATTRIBUTES OF MODULE
****
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
8 NOT-DC
9 ZERO-ORG
10 RESERVED
11 RLD
12 EDIT
13 NO-SYMS
14 RESERVED
15 NOT-REFR
16 RESERVED
17 <16M
18 NOT-PL
19 NO-SSI
20 NOT-APF
21 PGM OBJ
22 RESERVED
23 RESERVED
24 RESERVED
25 RESERVED
26 RESERVED
27 RMODEANY
-----------------------------------------------------------------------------------------------------------------------MODULE SSI: NONE
APFCODE:
00000000
RMODE:
ANY
*****PROGRAM OBJECT PROCESSED BY BINDER
THIS PROGRAM OBJECT WAS ORIGINALLY PRODUCED BY 5695DF108 AT LEVEL 01.00 ON 09/16/92 AT 09:11:52
-----------------------------------------------------------------------------------------------------------------------NUMERICAL MAP AND CROSS-REFERENCE LIST OF PROGRAM OBJECT MAINRTN
PAGE
1
XREF LISTINGS OF A LONG ALIAS NAME
LMOD LOC SECT LOC
LENGTH TYPE
NAME
0
168 SD
MAINRTN
168
58 CM
AAAAAAAA
1C0
C0 PC
$PRIVATE
22C
6C
NONAME1M
280
C0 PC
$PRIVATE
2EC
6C
NONAME2M
340
108 SD
SUBRTN
448
58 CM
$BLANKCOM
-----------------------------------------------------------------------------------------------------------------------LMOD LOC SECT LOC
ADCON AT
AC
AC
IN SECTION MAINRTN
168
0
REFERS TO AAAAAAAA
ADCON AT
B0
B0
IN SECTION MAINRTN
22C
6C
REFERS TO NONAME1M
1C0
0
IN SECTION $PRIVATE
ADCON AT
B4
B4
IN SECTION MAINRTN
2EC
6C
REFERS TO NONAME2M
280
0
IN SECTION $PRIVATE
ADCON AT
160
160
IN SECTION MAINRTN
340
0
REFERS TO SUBRTN
ADCON AT
3EC
AC
IN SECTION SUBRTN
448
0
REFERS TO $BLANKCOM
LENGTH OF PROGRAM OBJECT
4A0
図 15-14. プログラム・オブジェクトの LISTLOAD OUTPUT=XREF の出力例 (1/2)
第 15 章 AMBLIST
15-57
AMBLIST
ALPHABETICAL MAP OF PROGRAM OBJECT MAINRTN
PAGE
2
XREF LISTINGS OF A LONG ALIAS NAME
ENTRY NAME LMOD LOC SECT LEN/LOC
SECTION NAME OR ENTRY TYPE
$BLANKCOM
448
58
(CM)
$PRIVATE
1C0
C0
(PC)
$PRIVATE
280
C0
(PC)
AAAAAAAA
168
58
(CM)
MAINRTN
0
168
(SD)
NONAME1M
22C
6C
$PRIVATE
NONAME2M
2EC
6C
$PRIVATE
SUBRTN
340
108
(SD)
-----------------------------------------------------------------------------------------------------------------------ALPHABETICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT MAINRTN
PAGE
3
XREF LISTINGS OF A LONG ALIAS NAME
LMOD LOC SECT LOC
SYMBOL
448
0
$BLANKCOM
3EC
AC
REFERENCED IN SUBRTN
168
0
AAAAAAAA
AC
AC
REFERENCED IN MAINRTN
22C
6C
NONAME1M
1C0
0
IN SECTION $PRIVATE
B0
B0
REFERENCED IN MAINRTN
2EC
6C
NONAME2M
280
0
IN SECTION $PRIVATE
B4
B4
REFERENCED IN MAINRTN
340
0
SUBRTN
160
160
REFERENCED IN MAINRTN
** END OF MAP AND CROSS-REFERENCE LISTING
図 15-14. プログラム・オブジェクトの LISTLOAD OUTPUT=XREF の出力例 (2/2)
15-58
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
|
LISTLOAD OUTPUT=BOTH 出力
|
|
LISTLOAD MEMBER=TESTLR5,OUTPUT=BOTH
|
***** M O D U L E S U M M A R Y *****
|
MEMBER NAME: TESTLR5
MAIN ENTRY POINT:
00000028
|
LIBRARY:
SYSLIB
AMODE OF MAIN ENTRY POINT: 24
|
NO ALIASES **
|
| ------------------------------------------------------------------------------------------------------------------------****
ATTRIBUTES OF MODULE
****
|
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
|
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
|
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
|
8 NOT-DC
9 ZERO-ORG
10 RESERVED
11 RLD
|
12 NOT-EDIT
13 NO-SYMS
14 RESERVED
15 NOT-REFR
|
16 RESERVED
17 <16M
18 NOT-PL
19 NO-SSI
|
20 NOT-APF
21 PGM OBJ
22 RESERVED
23 RESERVED
|
24 NOT-ALTP
25 RESERVED
26 RESERVED
27 RMODE24
|
28 RESERVED
29 RESERVED
30 RESERVED
31 RESERVED
|
32 MIGRATE
33 NO-PRIME
34 NO-PACK
35 RESERVED
|
36 RESERVED
37 RESERVED
38 RESERVED
39 RESERVED
|
| -----------------------------------------------------------------------------------------------------------------------MODULE SSI:
NONE
| APFCODE:
00000000
|
RMODE:
24
|
PO FORMAT:
1
|
XPLINK:
NO
|
*****PROGRAM OBJECT PROCESSED BY BINDER
|
| ***THE FOLLOWING ARE THE UNFORMATTED PDSE DIRECTORY ENTRY SECTIONS (PMAR AND PMARL)
| PMAR 001E0107 02C80400 00000000 00300000 00280000 00280000 00000000 0000
| PMARL 00320080 00000000 00010000 002C0000 01900000 00000000 01C00000 003C0000
013C0000 00200000 011C0000 00140000 0178
|
LISTING OF PROGRAM OBJECT TESTLR5
PAGE
1
|
|
| THIS PROGRAM OBJECT WAS ORIGINALLY PRODUCED BY 5695DF108 AT LEVEL 02.10 ON 03/13/2001 AT 15:02:16
| -----------------------------------------------------------------------------------------------------------------------MODULE SECTION: $SUMMARY
|
0
OVERLAY REGION:
0
| USABILITY: UNSPECIFIED OVERLAY SEGMENT:
| ===== ESDs =====
| B_PRV(ED)
CLASS:
B_PRV
LENGTH:
4 (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
|
NAME SPACE:
2
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
MERGE
RMODE:
UNS
|
TEXT
NOLOAD
FILL:
UNSPEC
|
| Q1(PD)
CLASS:
B_PRV
LENGTH:
4 (HEX)
CLASS OFFSET:
0 (HEX)
|
NAME SPACE:
2
ALIGNMENT:
FULL WORD
PRIORITY:
0 (HEX)
SCOPE:
UNSPEC
|
ATTRIBUTES:
WEAK
|
| -----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: A
|
0
OVERLAY REGION:
0
| USABILITY: UNSPECIFIED OVERLAY SEGMENT:
| ===== IDRL =====
TRANSLATOR VER MOD
DATE
|
566896201
02
01
03/13/2001
|
| ===== ESDs =====
| B_TEXT(ED)
CLASS:
B_TEXT
LENGTH:
18 (HEX)
CLASS OFFSET:
0 (HEX)
FORMAT: F(0001)
|
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
CATENATE
RMODE:
24
|
TEXT
LOAD
FILL:
UNSPEC
|
| A(LD)
CLASS:
B_TEXT
TEXT TYPE:
UNSPEC
CLASS OFFSET:
0 (HEX)
|
NAME SPACE:
1
SCOPE:
MODULE
ELEMENT OFFSET:
0 (HEX)
AMODE:
24
|
ATTRIBUTES:
GENERATED,STRONG
|
| ENTA(LD)
CLASS:
B_TEXT
TEXT TYPE:
UNSPEC
CLASS OFFSET:
14 (HEX)
|
NAME SPACE:
1
SCOPE:
MODULE
ELEMENT OFFSET:
14 (HEX)
AMODE:
24
|
ATTRIBUTES:
STRONG
|
| ENTA(ER)
TEXT TYPE:
UNSPEC
CLASS OFFSET:
14 (HEX)
|
TARGET SECTION: A
TARGET CLASS:
B_TEXT
|
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
14 (HEX)
|
RESOLVED
AUTOCALL
|
ATTRIBUTES:
STRONG
|
|
| 図 15-15. PDSE 用の LISTLOAD OUTPUT=BOTH についての出力例 (1/4)
|
|
第 15 章 AMBLIST
15-59
AMBLIST
ENTB(ER)
TEXT TYPE:
TARGET SECTION: B
NAME SPACE:
1
RESOLVED
ATTRIBUTES:
STRONG
B_PRV(ED)
CLASS:
B_PRV
SCOPE:
AUTOCALL
LENGTH:
UNSPEC
LIBRARY
CLASS OFFSET:
TARGET CLASS:
ELEMENT OFFSET:
0 (HEX)
CLASS OFFSET:
LISTING OF PROGRAM OBJECT TESTLR5
28 (HEX)
B_TEXT
10 (HEX)
0 (HEX)
FORMAT: F(0001)
PAGE
2
CONTROL SECTION: A
===== ESDs =====
NAME SPACE:
2
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
MERGE
RMODE:
UNS
TEXT
NOLOAD
FILL:
UNSPEC
Q1(PR)
CLASS:
B_PRV
LENGTH:
4 (HEX)
CLASS OFFSET:
0 (HEX)
NAME SPACE:
2
ALIGNMENT:
FULL WORD
PRIORITY:
0 (HEX)
SCOPE:
UNSPEC
ATTRIBUTES:
WEAK
===== RLDs =====
CLASS:
B_TEXT
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
XATTR NAME
XATTR OFF
00000006 00000006 BR RES 0004 NO
1
(+)ENTA
0000000C 0000000C C-OF RES 0004 NO
2
(+)Q1
00000010 00000010 BR RES 0004 NO
1
(+)ENTB
===== TEXT =====
CLASS:
B_TEXT
00000000 07FEC1C1 C1C10000 00140000 00000000 00000028 C5D5E3C1
..AAAA..............ENTA........*
-----------------------------------------------------------------------------------------------------------------------CONTROL SECTION: B
USABILITY: UNSPECIFIED
OVERLAY SEGMENT:
0
OVERLAY REGION:
0
===== IDRL =====
TRANSLATOR VER MOD
DATE
566896201
02
01
03/13/2001
===== ESDs =====
B_TEXT(ED)
CLASS:
B_TEXT
LENGTH:
14 (HEX)
CLASS OFFSET:
18 (HEX)
FORMAT: F(0001)
NAME SPACE:
1
ALIGNMENT:
DOUBLE WORD
BIND METHOD:
CATENATE
RMODE:
24
TEXT
LOAD
FILL:
UNSPEC
B(LD)
CLASS:
B_TEXT
TEXT TYPE:
UNSPEC
CLASS OFFSET:
18 (HEX)
NAME SPACE:
1
SCOPE:
MODULE
ELEMENT OFFSET:
0 (HEX)
AMODE:
24
ATTRIBUTES:
GENERATED,STRONG
ENTB(LD)
CLASS:
B_TEXT
TEXT TYPE:
UNSPEC
CLASS OFFSET:
28 (HEX)
NAME SPACE:
1
SCOPE:
MODULE
ELEMENT OFFSET:
10 (HEX)
AMODE:
24
ATTRIBUTES:
STRONG
ENTB(ER)
TEXT TYPE:
UNSPEC
CLASS OFFSET:
28 (HEX)
TARGET SECTION: B
TARGET CLASS:
B_TEXT
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
10 (HEX)
RESOLVED
AUTOCALL
ATTRIBUTES:
STRONG
UNRES(ER)
TEXT TYPE:
UNSPEC
CLASS OFFSET:
0 (HEX)
TARGET SECTION:
TARGET CLASS:
B_TEXT
NAME SPACE:
1
SCOPE:
LIBRARY
ELEMENT OFFSET:
0 (HEX)
LISTING OF PROGRAM OBJECT TESTLR5
PAGE
3
図 15-15. PDSE 用の LISTLOAD OUTPUT=BOTH についての出力例 (2/4)
|
15-60
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
CONTROL SECTION: B
===== ESDs =====
UNRESOLVED
AUTOCALL
ATTRIBUTES:
STRONG
===== RLDs =====
CLASS:
B_TEXT
ELEM.OFF CLS.OFF TYPE STATUS LENG HOBCHG NSPACE
TARGET NAME
PARTRES
00000006 0000001E BR RES 0004 NO
1
(+)ENTB
0000000C 00000024 BR UNRES 0004 NO
1
(+)UNRES
===== TEXT =====
CLASS:
B_TEXT
00000018 07FEC2C2 C2C20000 00280000 00000000 C5D5E3C2
** END OF PROGRAM OBJECT LISTING
** NUMERICAL MAP OF PROGRAM OBJECT TESTLR5
XATTR NAME
XATTR OFF
..BBBB..........ENTB............*
**
PAGE
1
-----------------------------------------------------------------------------------------------------------------------RESIDENT CLASS:
B_TEXT
CLAS LOC ELEM LOC
LENGTH TYPE
ALIGNMENT
NAME
0
18 ED
DOUBLE WORD
A
14
14
LD
ENTA
18
14 ED
DOUBLE WORD
B
28
10
LD
ENTB
CLASS LENGTH
30
-----------------------------------------------------------------------------------------------------------------------** NUMERICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT TESTLR5
**
PAGE
2
CLAS LOC ELEM LOC
TARGET CLASS
6
6
IN SECTION A
14
14
B_TEXT
REFERS TO ENTA
0
0
IN SECTION A
ADCON AT
C
C
IN SECTION A
$CLASS_OFFSET
B_PRV
REFERS TO Q1
ADCON AT
10
10
IN SECTION A
28
10
B_TEXT
REFERS TO ENTB
18
0
IN SECTION B
ADCON AT
1E
6
IN SECTION B
28
10
B_TEXT
REFERS TO ENTB
18
0
IN SECTION B
ADCON AT
24
C
IN SECTION B
*
*
****
REFERS TO $UNRESOLVED
-----------------------------------------------------------------------------------------------------------------------RESIDENT CLASS:
B_PRV
CLAS LOC ELEM LOC
LENGTH TYPE
ALIGNMENT
NAME
0
4 ED
DOUBLE WORD
$PRIV000003
0
4 PD
FULL WORD
Q1
0
0 ED
DOUBLE WORD
A
CLASS LENGTH
0
-----------------------------------------------------------------------------------------------------------------------** NUMERICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT TESTLR5
**
PAGE
3
ADCON AT
**** NO ADCONS IN THIS CLASS ****
LENGTH OF PROGRAM OBJECT
30
-----------------------------------------------------------------------------------------------------------------------** ALPHABETICAL MAP OF PROGRAM OBJECT TESTLR5
**
PAGE
4
ENTRY NAME CLAS LOC ELEM LEN/LOC
$PRIV000003
0
4
A
0
18
A
0
0
B
18
14
ENTA
14
14
ENTB
28
10
Q1
0
4
CLASS NAME
SECTION NAME OR ENTRY TYPE
B_PRV
(ED)
B_TEXT
(ED)
B_PRV
(ED)
B_TEXT
(ED)
B_TEXT
A
B_TEXT
B
B_PRV
(PD)
図 15-15. PDSE 用の LISTLOAD OUTPUT=BOTH についての出力例 (3/4)
|
第 15 章 AMBLIST
15-61
AMBLIST
-----------------------------------------------------------------------------------------------------------------------** ALPHABETICAL CROSS-REFERENCE LIST OF PROGRAM OBJECT TESTLR5
**
PAGE
5
CLAS LOC ELEM LOC
TARGET CLASS
*
*
****
14
14
B_TEXT
0
0
6
6
28
10
B_TEXT
18
0
10
10
28
10
B_TEXT
18
0
1E
6
$CLASS_OFFSET
B_PRV
C
C
LENGTH OF PROGRAM OBJECT
30
** END OF MAP AND CROSS-REFERENCE LISTING
SYMBOL
$UNRESOLVED
ENTA
IN SECTION A
REFERENCED IN
ENTB
IN SECTION B
REFERENCED IN
ENTB
IN SECTION B
REFERENCED IN
Q1
REFERENCED IN
A
A
B
A
| 図 15-15. PDSE 用の LISTLOAD OUTPUT=BOTH についての出力例 (4/4)
LISTIDR 出力
LISTIDR DDN=DD1,MEMBER=TLIST
***** M O D U L E S U M M A R Y *****
MEMBER NAME: TLIST
MAIN ENTRY POINT:
0000000E
LIBRARY:
DD1
AMODE OF MAIN ENTRY POINT: 24
NO ALIASES **
-----------------------------------------------------------------------------------------------------------------------****
ATTRIBUTES OF MODULE
****
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
8 NOT-DC
9 ZERO-ORG
10 EP > ZERO
11 RLD
12 EDIT
13 NO-SYMS
14 F-LEVEL
15 NOT-REFR
-----------------------------------------------------------------------------------------------------------------------MODULE SSI: NONE
APFCODE:
00000000
RMODE:
24
*****LOAD MODULE PROCESSED EITHER BY VS LINKAGE EDITOR OR BINDER
LISTIDR FOR LOAD MODULE TLIST
PAGE 0001
B
CSECT
YR/DAY
SPZAP
DATA
A
1972/271
92240
B
1972/271
NO IDENT
------------------------------------------------------------------------------------------------------------------------
A
THIS LOAD MODULE WAS PRODUCED BY LINKAGE EDITOR 5695DF108 AT LEVEL 21.01 ON DAY 271 OF YEAR 1992.
-----------------------------------------------------------------------------------------------------------------------C
CSECT
TRANSLATOR
VR.MD
YR/DY
A
566896201
02.01
1972/271
B
566896201
02.01
1972/271
D1
566896201
02.01
1972/271
UNRES
566896201
02.01
1992/034
------------------------------------------------------------------------------------------------------------------------
D
CSECT
YR/DAY
USER
A
1972/271
ANOTHERONE
B
1972/271
myprogram
------------------------------------------------------------------------------------------------------------------------
図 15-16. リンケージ・エディターまたはバインダーが処理したロード・モジュールについての LISTIDR 出力例
15-62
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
LISTIDR
MEMBER=(LOADMOD2)
***** M O D U L E
00020905
S U M M A R Y *****
MEMBER NAME: LOADMOD2
MAIN ENTRY POINT:
00000000
LIBRARY:
SYSLIB
AMODE OF MAIN ENTRY POINT: 31
NO ALIASES **
-----------------------------------------------------------------------------------------------------------------------****
ATTRIBUTES OF MODULE
****
** BIT STATUS
BIT STATUS
BIT STATUS
BIT STATUS **
0 NOT-RENT
1 NOT-REUS
2 NOT-OVLY
3 NOT-TEST
4 NOT-OL
5 BLOCK
6 EXEC
7 MULTI-RCD
8 NOT-DC
9 ZERO-ORG
10 RESERVED
11 RLD
12 EDIT
13 NO-SYMS
14 RESERVED
15 NOT-REFR
16 RESERVED
17 <16M
18 NOT-PL
19 NO-SSI
20 NOT-APF
21 PGM OBJ
22 RESERVED
23 RESERVED
24 NOT-ALTP
25 RESERVED
26 RESERVED
27 RMODEANY
28 RESERVED
29 RESERVED
30 RESERVED
31 RESERVED
32 MIGRATE
33 NO-PRIME
34 NO-PACK
35 RESERVED
36 RESERVED
37 RESERVED
38 RESERVED
39 RESERVED
-----------------------------------------------------------------------------------------------------------------------MODULE SSI: NONE
APFCODE:
00000000
RMODE:
ANY
CREATED BY: 00000001
A
*****PROGRAM OBJECT PROCESSED BY BINDER
***THE FOLLOWING ARE THE UNFORMATTED PDSE DIRECTORY ENTRY SECTIONS (PMAR AND PMARL)
PMAR 001E0206 02C00412 00000000 04500000 00000000 00000000 00000000 0000
PMARL 005200C0 00000000 00020000 04500000 02380000 08180000 0EF40000 00500000
01240000 00200000 01040000 00020000 01740001 00000000 04500000 00000000
00001995 154F0205 408FC2D7 C2C6F6F4 F5F5
LISTIDR FOR PROGRAM OBJECT LOADMOD2
PAGE
1
-----------------------------------------------------------------------------------------------------------------------THIS PROGRAM OBJECT WAS ORIGINALLY PRODUCED BY 5695DF108 AT LEVEL 01.01 ON 06/03/95 AT 20:54:08
-----------------------------------------------------------------------------------------------------------------------BDATE
PTF NUMBER
CSECT:
SDX
04/16/2001 ZAPIDR01
04/16/2001 ZAPIDR02
04/16/2001 ZAPIDR03
04/16/2001 ZAPIDR04
04/16/2001 ZAPIDR05
04/16/2001 ZAPIDR06
04/16/2001 ZAPIDR07
04/16/2001 ZAPIDR08
04/16/2001 ZAPIDR09
-----------------------------------------------------------------------------------------------------------------------CTRANSLATOR VER MOD
DATE
CSECT:
CM1
566896201
02
01
04/16/2001
CSECT:
SDX
566896201
02
01
04/16/2001
CSECT:
SD1
566896201
02
01
04/16/2001
CSECT:
SD2
566896201
02
01
04/16/2001
-----------------------------------------------------------------------------------------------------------------------DDATE
USER DATA
CSECT:
$MODULE LEVEL DATA
04/16/2001 THIS IS A TEST
CSECT:
SD1
04/16/2001 USER IDR TEST 2
04/16/2001 USER IDR TEST 3
------------------------------------------------------------------------------------------------------------------------
図 15-17. バインダーが処理したプログラム・オブジェクトについての LISTIDR 出力例
LISTIDR 出力の説明
15-62 ページの図 15-16 と 図 15-17 に示すように、 IDR リストには破線で分けら
れた 4 つのセクションがあります。その 4 つのセクションには次のものが含まれ
ます。
A
リンケージ・エディター ID またはバインダー識別レコード (IDRB)。識別
第 15 章 AMBLIST
15-63
AMBLIST
レコードは単一行に表示されます。この行は、バインダーまたはリンケー
ジ・エディター・プログラムの ID、バージョンとリリース番号、およびバ
インディングの日時を示します。
注: バインディングの時刻はプログラム・オブジェクトについてのみリスト
されます。
B
存在する場合は、SPZAP IDR 項目 (IDRZ) のリスト。IDRZ レコードが存
在する場合は、セクションごとに 2 行以上でフォーマット設定されます。
最初の行は関連する CSECT 名、また 2 番目の行とそれ以降には修正日付
と最大 8 バイトの PTF 番号、または SPZAP IDRDATA 制御ステートメ
ントで入力されたその他のデータが含まれます。制御セクションの各修正に
は 1 つの明細行があります。ロード・モジュール出力の場合は、 IDRZ レ
コードがセクションごとに 1 行でフォーマット設定されます。
C
言語翻訳プログラム IDR レコードのリスト (IDRL)。これらの項目は
OUTPUT=ALL が指定されるか、または LISTIDR 制御ステートメントでデ
フォルトがとられる場合のみフォーマット設定されます。IDRL レコードも
存在する場合は、CSECT ごとに 2 行以上でフォーマット設定されます。セ
クション名は最初の行に表示され、変換プログラム ID、バージョンとリリ
ース、変換の日付は 2 行目以降に表示されます。そのセクションについて
のオブジェクト・コードの作成時に組み込まれた、各コンパイラー、アセン
ブラーまたはほかの言語プロダクトについて、変換プログラム・データが 1
行あります。ロード・モジュール出力の場合は、 IDRL レコードがセクシ
ョンごとに 1 行でフォーマット設定されます。プログラム・オブジェクト
のブランク CSECT 名は、$BLANKCOM として表示されます。ロード・モ
ジュールでは、$BLANKCM と表示されます。
D
存在する場合は、ユーザー提供の IDR データのリスト (IDRU)。IDRU レ
コードは、通常 CSECT ごとに 2 行表示されます。最初の行はセクション
名を表示し、2 番目の行は入力日付と、ユーザーがバインダーの IDENTIFY
制御ステートメントに入力した、最大 80 バイトのデータを表示します。セ
クション名がモジュール・レベル・セクションの場合は (’00000001’x とし
て識別される)、定数 $MODULE LEVEL DATA がセクション名の場所に印
刷されます。
|
|
|
プログラム・オブジェクトの場合は、セクション内に使用できるデータがない場合
は、フォーマット設定された明細ではなく次のメッセージが表示されます。
NO SPZAP DATA EXISTS FOR THIS PROGRAM OBJECT
NO BINDER DATA EXISTS FOR THIS PROGRAM OBJECT
NO TRANSLATION DATA EXISTS FOR THIS PROGRAM OBJECT
NO IDENTITY/USER DATA EXISTS FOR THIS PROGRAM OBJECT
ロード・モジュールの場合は、 SPZAP データが使用できなければ、フォーマット
設定された明細ではなく次のメッセージが表示されます。
THIS LOAD MODULE CONTAINS NO INFORMATION SUPPLIED BY SPZAP
15-64
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMBLIST
LISTLPA 出力
MODIFIED
NAME
IGC00020
IGC0006I
MODIFIED
NAME
IGC0005E
IGC0006I
PAGEABLE
NAME
AHLACFV
AHLDSP
AHLFI0
AHLFRR
AHLFSVC
AHLPINT
AHLSBCU1
AHLSBUF
AHLSETEV
AHLSRB
AHLSTAE
AHLTACFV
AHLTDIR
AHLTEXT
AHLTF0R
AHLTLSR
AHLTPID
AHLTSRB
AHLSTAE
AHLTSYFL
AHLTUSR
AHLTXSYS
AHLVCON
AHLWTOMD
AMDSYS01
AMDSYS03
AMDSYS05
AMDUSRFD
AMDUSRFF
AMDUSRF9
CVAFGTF
DCMBE1
DCM181
DCM183
DCM271
LINK PACK AREA MAP ALPHABETICALLY BY NAME
EP ADDR
MAJOR LPDE NAME NAME
LOCATION LENGTH
LOCATION LENGTH
IGC0005E -------- -----00B42000
-------- -----IGGC019BN -------- -----00B419C0
-------- -----N 00.12SEC VIRT
LINK PACK AREA MAP NUMERICALLY BY ENTRY POINT
EP ADDR
MAJOR LPDE NAME NAME
LOCATION LENGTH
LOCATION LENGTH
IGGC019BN -------- -----00B37FA0
-------- -----IGC00020 -------- -----00B419C0
-------- -----N 00.12SEC VIRT
LINK PACK AREA MAP ALPHABETICALLY BY NAME
EP ADDR
MAJOR LPDE NAME NAME
LOCATION LENGTH
LOCATION LENGTH
AHLDMPMD
819B595E AHLTVTAM
AHLEXT
81963962 AHLTXSYS
AHLFPI
8193A926 AHLTSYFL
AHLFSSCH
8198F7EA AHLTSYSM
AHLMCER
8193A9D8 AHLTSYFL
AHLREADR 01977C08 000003F8
8198F748 AHLTSYSM
AHLSBL0K
81991F4A AHLWSMOD
AHLSETD
81991A90 AHLWSMOD
01926000 00001708
AHLSFE0B
01928000 00001998 81928000
AHLSRM
819639EE AHLTXSYS
AHLSVC
8198F8C6 AHLTSYSM
AHLTCCWG 0192A000 00002378
819B596A AHLTVTAM
AHLTDSP
81926A58 AHLSETD
AHLTFCG
01956920 000006E0 81956920
0192D000 000016D0
AHLTFRR
01954570 00000A90 81954570
AHLTPI
819717D2 AHLTPID
AHLTSLIP 0192F000 00001C50
01971468 00000B98 81971468
AHLTSRM
AHLTPID
81971770
AHLTSVC
AHLTFOR
01931000 00002768
819547B4
AHLTSYSM 0198F508 00000AF8
0193A908 000006F8
8193A908
AHLTVTAM 019B5940 000006C0
019299C0 00000640
819299C0
AHLVCOFF 019B6F40 000000C0
01963850 000007B0
81963850
AHLWSMOD 019916B0 00000950
01989EE8 00000118
81989EE8
AMDSYS00 01934000 00001208
AHLSETD
81926E4C
AMDSYS02 019BB648 00000548
01936000 00002AD8
81936000
AMDSYS04 0193B000 00002038
01939000 00001828
91039000
01975178 99999358
01961C08 000003F8
81975178
AMDSYS06 00BF1008 000006C8
00F28000 00001E60
00F28000
AMDUSRFE
IMDUSRFF
00C4C000
AMDUSRF8
00B8E230 000003F8
00B8E230
CCKRIUWT
00C4E730 000008D0
00C4E730
DCMBE0
DCM3B3
00F26000 00001360
00C56328
DCM180
00CB8078 00000F88
00C54020 00000FE0
00CB8078
DCM182
00C26318 00000CE8
00F24000 000014E0
DCM270
00C26318 DCM270
00E1E830 000007D0
DCM272
00F24000
EP ADDR
MAJOR
00B37FA0
00B414D8
200K SYS 276K
LPDE
NAME
EP ADDR
MAJOR
00B414D8
00B42000
200K SYS 276K
LPDE
NAME
MAJOR LPDE
AHLSETD
AHLTSYSM
AHLTSYFL
AHLTSYFL
AHLTSETD
NAME
EP ADDR
81926EBE
8198F660
8193A9FC
8193A946
81926450
81977C08
819916B0
81926000
819917EE
81963A62
8198F61A
8191A000
81971658
8192D000
81954694
8197147E
8192F000
8195458C
81931000
8198F508
819B5940
819B6F40
819916B0
81934000
819BB648
8193B000
81961C08
00BF1008
00C08590
00C48000
00C56328
00F26000
00C54020
AHLWSMOD
AHLWSMOD
AHLTXSYS
AHLTSYSM
AHLTPID
AHLTFOR
AHLTPID
AHLTFOR
IMDUSRF8
ISTAICIR
DCM3B3
00F24000
00E1E830
図 15-18. LISTLPA 出力例
第 15 章 AMBLIST
15-65
15-66
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 16 章 SPZAP
SPZAP は問題プログラム状態で実行する保守援助プログラムです。SPZAP を使用
してプログラムとデータ・セットを動的に更新し保守することができます。SPZAP
を使用して現行レベルのオペレーティング・システムでモジュールまたはプログラ
ムに適用する必要がある修正を適用することができます。
SPZAP は次のものを含む、多くの機能を提供します。
v SPZAP の検査と修正機能を使用して、プログラムを再コンパイルせずに、 PDS
のロード・モジュール・メンバー内または PDSE のプログラム・オブジェクト・
メンバー内の命令を置換する処置のみが必要なプログラミング・エラーを修正す
ることができます。
v SPZAP の修正機能を使用して、正しくない命令を挿入してプログラムにトラップ
を設定することができます。正しくない命令は強制的に異常終了を引き起こしま
す。異常終了の結果のストレージ・ダンプは、処理中の予測可能な時点でのスト
レージの内容を示すので、価値のある診断ツールです。
v SPZAP を使用して直接アクセス装置のデータを直接置換して、入出力エラーまた
はプログラミング・エラーの結果として破壊されている VTOC またはデータ・
レコードを再構築することができます。
v IBM サポートから助言を得て、コンポーネント・トレースを使用しないシステ
ム・コンポーネントでトレースを開始することができます。IBM サポートは
SPZAP 保守援助プログラムを使用して、これらのコンポーネント内でトレースを
開始するための方法をお教えします。
v PDS 内の任意のロード・モジュール、または PDSE 内のプログラム・オブジェ
クトについてディレクトリー項目のシステム状況索引 (SSI) を更新します。 PDS
の任意のロード・モジュールまたは PDSE のプログラム・オブジェクト内の
CSECT 識別レコード (IDR) を更新します。
主要トピック
以下のトピックで、SPZAP について説明します。
v 『SPZAP の計画』
v 16-2 ページの『データの検査と修正』
v 16-16 ページの『システム状況索引 (SSI) の更新』
v 16-17 ページの『SPZAP の実行』
v 16-34 ページの『SPZAP 出力の読み取り』
SPZAP の計画
SPZAP は、直接アクセス記憶装置 (DASD) 上のデータのための編集機能を提供す
るアプリケーションです。インストール先のセキュリティー保護方式を使用するこ
とによって、SPZAP (およびデータ・セットを更新できる他のアプリケーション) を
使用してデータに損傷を与えることから保護してください。
v データ・セットの保護については、「z/OS DFSMS データ・セットの使用法」の
章『データ・セットの保護』を参照してください。
© Copyright IBM Corp. 1988, 2008
16-1
SPZAP
v VTOC の保護については、「z/OS DFSMSdfp Advanced Services」の章『VTOC お
よび VTOC 索引の保護』を参照してください。
RACF を使用しているインストール先は、GDASDVOL と DASDVOL のリソー
ス・プロファイルを組み合わせてこの保護を確立してください。これらのプロフ
ァイルについては、「z/OS Security Server RACF セキュリティー管理者のガイ
ド」を参照してください。
IBM は、VTOC の機密性が特に高いことを認識しています。 VTOC の場合は、
SPZAP が更新要求を処理する前にコンソール・オペレーターは、メッセージ
AMA117D に応答する必要があります。この許可は、インストール先のセキュリ
ティー保護方式の使用による許可に加えて与えられなければなりません。
データの検査と修正
データの検査
検査機能は VERIFY ステートメントで制御します。 VERIFY を使用すると、PDS
のロード・モジュール・メンバー内の特定の位置の内容、PDSE または z/OS UNIX
ファイルのプログラム・オブジェクト・メンバー、直接アクセス・データ・セット
の特定の物理レコード、またはデータ PDSE のメンバーのレコードを、内容を置き
換える前に調べることができます。指定した位置の内容が VERIFY ステートメント
に指定した内容と一致しない場合は、続く REP 操作は実行されません。
注: プログラム・オブジェクト以外のデータが入った PDSE は、PDSE データ・ラ
イブラリーと呼ばれます。
SPZAP の修正機能は REP (置換) 制御ステートメントで制御します。 REP 制御ス
テートメントを使用すると、PDS のロード・モジュール・メンバー内の特定の位置
の命令またはデータ、PDSE または z/OS UNIX ファイル内のプログラム・オブジ
ェクト、直接アクセス・データ・セット内の物理レコードまたは PDSE データ・ラ
イブラリーのメンバーのレコードを置き換えることができます。
データを置換する際に起こりうるエラーを避けるために、REP 操作の前に必ず
VERIFY 操作を指定する必要があります。
データの修正 SPZAP は、実行可能プログラムの内容を検査および修正して、エラ
ーを訂正する際にしばしば使用されます。実行可能プログラムは、次の 2 つの形式
のいずれでも構いません。
v ロード・モジュール。リンケージ・エディターによって作成され、PDS に保管さ
れます。
v プログラム・オブジェクト。プログラム管理バインダーによって作成され、PDSE
または z/OS UNIX ファイルに保管されます。
注: このトピックで以降に行う PDSE のプログラム・オブジェクトへの参照は、す
べて z/OS UNIX ファイルのプログラム・オブジェクトにも適用されます。
さらに、SPZAP は、実行可能プログラム以外のデータの検査および修正に使用でき
ます。その種のデータの例を以下に示します。
16-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
v 非 VSAM 順次 (QSAM/BSAM) または直接編成 (BDAM/ISAM) データ・セッ
ト。
v VSAM 順次または索引付きデータ・セット。
v PDSE データ・ライブラリー (上記の注を参照)。
SPZAP によってサポートされないデータ・セットのタイプが、以下のようにいくつ
かあります。
v 拡張順次 (ストライピングされた) データ・セット
v ロード・モジュール以外を含む PDS
以下のトピックを参照してください。
v 『ロード・モジュールまたはプログラム・オブジェクトの検査および修正』
v 16-12 ページの『データ・レコードの検査と修正』
ロード・モジュールまたはプログラム・オブジェクトの検査および修正
ロード・モジュールまたはプログラム・オブジェクト内のデータを検査あるいは修
正するには、NAME ステートメントで、SPZAP にファイルの該当するメンバーの
名前を指定する必要があります。ロード・モジュールは、JCL に組み込まれた
SYSLIB DD ステートメントで識別される PDS のメンバーでなければなりません。
プログラム・オブジェクトは、JCL に組み込まれた SYSLIB DD ステートメントで
識別される PDSE のメンバー、または z/OS UNIX ディレクトリー内のファイルで
なければなりません。
z/OS UNIX ファイル・システム内にあるプログラム・オブジェクトを検査あるいは
修正するには、DSNAME パラメーターではなく、SYSLIB DD ステートメントの
PATH パラメーターを使用します。 PATH は、プログラム・オブジェクトであるフ
ァイルが入ったディレクトリーを識別するのに使用します。ファイルを識別する場
合は、NAME ステートメントを使用します。
PDS のロード・モジュール・メンバーまたは PDSE のプログラム・オブジェクト・
メンバーで、複数の制御セクション (CSECT) を含んでいる場合は、検査または修正
される CSECT の名前を SPZAP に与える必要があります。 NAME ステートメン
トに CSECT 名を指定しない場合は、 SPZAP は処理する制御セクションがロー
ド・モジュールを検索して最初に検出したものであると想定します。
ユーザーの NAME および REP 制御ステートメントに応えて、PDS のロード・モ
ジュール・メンバーまたは PDSE のプログラム・オブジェクト・メンバー内の
CSECT を SPZAP が更新する場合は、そのロード・モジュールまたはプログラム・
オブジェクトと関連した CSECT 識別レコード (IDR) に保守記述データも必ず記録
されます。この機能は、NAME ステートメントと関連したすべての REP ステート
メントが処理された後で自動的に実行されます。IDR に記録する必要があるすべて
の任意指定のユーザー・データは IDRDATA ステートメントで指定する必要があり
ます。IDRDATA ステートメントの説明については、 16-23 ページの『SPZAP 制御
ステートメント』を参照してください。
第 16 章 SPZAP
16-3
SPZAP
例: 単一の CSECT ロード・モジュールの検査と修正
この例は、単一の CSECT を含むロード・モジュールを検査し修正する方法を示します。
//ZAPCSECT
//STEP
//SYSPRINT
//SYSLIB
//SYSIN
NAME
VERIFY
REP
SETSSI
IDRDATA
DUMP
/*
JOB
MSGLEVEL=(1,1)
EXEC
PGM=AMASPZAP
DD
SYSOUT=A
DD
DSNAME=SYS1.LINKLIB,DISP=OLD
DD
*
IEEVLNKT
0018
C9C8,D2D9,D1C2,C7D5
0018
E5C6,D3D6,E6F0,4040
01211234
71144
IEEVLNKT
SYSLIB DD ステートメント: SPZAP が処理する、モジュール IEEVLNKT を含むシステム・ライブラリー
SYS1.LINKLIB を定義します。
NAME 制御ステートメント: 続く制御ステートメントで定義された操作をモジュール IEEVLNKT で実行するこ
とを、SPZAP に指示します。
VERIFY 制御ステートメント: SPZAP がモジュール IEEVLNKT のオフセット X'0018' の 16 進データを調べ、
このステートメントに指定した 16 進データと同じであることを確認するように要求します。データが同じであ
れば、SPZAP は次のステートメントを順番に処理します。データが違う場合は、SPZAP はそのモジュールに要
求されている REP と SETSSI 操作を実行しません。ただし、処理を中断する前に、要求されている DUMP 操
作は実行します。またモジュール IEEVLNKT の 16 進イメージを SYSPRINT データ・セットにダンプします。
REP 制御ステートメント: VERIFY ステートメントが正しく行われた場合 SPZAP は、モジュール IEEVLNKT
内のオフセット X'0018' のデータをこの制御ステートメントで指定したデータで置換します。
SETSSI 制御ステートメント: VERIFY ステートメントが正しく行われた場合、SPZAP は、モジュール
IEEVLNKT のディレクトリー項目内のシステム状況情報を、ステートメントで指定した SSI データで、置換し
ます。新しい SSI には、次のものが含まれます。
v 01 の変更レベル
v 21 のフラグ・バイト
v 1234 の通し番号
IDRDATA 制御ステートメント: REP 操作が正しく行われた場合、SPZAP は、モジュール IEEVLNKT 内の
IDR をデータ 71144 で更新します。
DUMP 制御ステートメント: モジュール IEEVLNKT の 16 進イメージを SYSPRINT データ・セットにダンプ
することを要求します。 REP ステートメントの後ろに DUMP ステートメントが来るので、そのイメージは
VERIFY 操作が正しく行われた場合は SPZAP が行った変更を反映します。
16-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
例: ロード・モジュール内の CSECT の変更
この例では、モジュール置換 PTF ではなく、IBM 提供の SPZAP 修正の形式の PTF を適用する方法を示しま
す。
//PTF40228
//STEP
//SYSPRINT
//SYSLIB
//SYSIN
NAME
IDRDATA
VERIFY
VERIFY
REP
REP
SETSSI
DUMPT
/*
JOB
MSGLEVEL=(1,1)
EXEC
PGM=AMASPZAP
DD
SYSOUT=A
DD
DSNAME=SYS1.NUCLEUS,DISP=OLD
DD
*
IEANUC01 IEWFETCH
LOCFIX01
01F0 47F0C018
0210 5830C8F4
01F0 4780C072
0210 4130C8F4
02114228
IEANUC01 IEWFETCH
SYSLIB DD ステートメント: 入力モジュール IEANUC01 を含むライブラリー (SYS1.NUCLEUS) を定義しま
す。
SYSIN DD ステートメント:
入力ストリームを定義します。
NAME 制御ステートメント: このステートメントのすぐ後の制御ステートメントで定義する操作を、ロード・モ
ジュール IEANUC01 に含まれる CSECT IEWFETCH で実行すべきことを SPZAP に指示します。
IDRDATA 制御ステートメント: いずれかの REP 操作が正しく実行された場合、SPZAP は CSECT IEWFETCH
のためのモジュール IEANUC01 内の IDR をデータ LOCFIX01 で、更新します。
VERIFY 制御ステートメント: 制御セクション IEWFETCH 内の位置 X'01F0' と X'0210' の内容を、VERIFY 制
御ステートメントで指定したデータと比較することを SPZAP に要求します。比較した結果が等しい場合は、
SPZAP は続く制御ステートメントを順番に処理します。ただし、その位置のデータと VERIFY 制御ステートメ
ントで指定したデータが等しくない場合は、 SPZAP は CSECT IEWFETCH の 16 進イメージを SYSPRINT デ
ータ・セットにダンプします。それ以降の REP と SETSSI ステートメントは無視されます。指定した DUMPT
機能は、 SPZAP が処理を終了する前に実行されます。
REP 制御ステートメント: SPZAP は CSECT IEWFETCH の先頭からのオフセット X'01F0' と X'0210' のデー
タを、対応する REP ステートメントに指定した 16 進データで、置換します。
SETSSI 制御ステートメント: 置換操作が有効になった後で、SPZAP はモジュール IEANUC01 のディレクトリ
ー内のシステム状況情報を、SETSSI ステートメントに指定された SSI データで置換します。新しい SSI には、
02 の変更レベル、11 のフラグ・バイト、および 4228 の通し番号が含まれます。
DUMPT 制御ステートメント: SPZAP はロード・モジュール IEANUC01 の CSECT IEWFETCH についての変
換されたダンプを生成します。
第 16 章 SPZAP
16-5
SPZAP
例: 2 つの CSECT の検査と修正 (その 1)
この JCL を使用して、同じロード・モジュール内の 2 つの CSECT を検査し
修正します。
//CHANGIT
//STEP
//SYSPRINT
//SYSLIB
//SYSIN
NAME
VERIFY
REP
IDRDATA
SETSSI
DUMPT
NAME
VERIFY
REP
IDRDATA
SETSSI
DUMPT
/*
JOB
MSGLEVEL=(1,1)
EXEC
PGM=AMASPZAP
DD
SYSOUT=A
DD
DSNAME=SYS1.LINKLIB,DISP=OLD
DD
*
IEFX5000 IEFQMSSS
0284 4780,C096
0284 4770,C096
PTF01483
01212448
IEFX5000 IEFQMSSS
IEFX5000 IEFQMRAW
0154 4780,C042
0154 4770,C042
PTF01483
01212448
IEFX5000 IEFQMRAW
SYSLIB DD ステートメント: SPZAP が変更するロード・モジュール
IEFX5000 を含むシステム・ライブラリー SYS1.LINKLIB を定義します。
16-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
例: 第 1 の制御ステートメントの説明 (その 2)
NAME 制御ステートメント #1: すぐ後に続く制御ステートメントで要求され
る操作がロード・モジュール IEFX5000 内の CSECT IEFQMSSS で実行され
ることを、SPZAP に指示します。
VERIFY 制御ステートメント #1: CSECT IEFQMSSS 内のオフセット X'0284'
の 16 進データを調べ、この制御ステートメントで指定したデータと同じであ
ることを SPZAP に確認するよう要求します。データが同じ場合は、SPZAP
は制御ステートメントの処理を続けます。データが同じではない場合は、
SPZAP は CSECT IEFQMSSS について REP または SETSSI を実行しません
が、 DUMPT 操作は実行します。また CSECT IEFQMSSS の 16 進ダンプを
提供します。
REP 制御ステートメント #1: SPZAP はこの制御ステートメントに指定した
16 進数データで、CSECT IEFQMSSS 内のオフセット X'0284' のデータを置
換します。
IDRDATA 制御ステートメント #1: 最初の REP 操作が正しく行われた場合、
SPZAP は CSECT IEFQMSSS についてモジュール IEFX5000 内の IDR をデ
ータ PTF01483 で、更新します。
SETSSI 制御ステートメント #1: モジュール IEFX5000 のディレクトリー項
目内のシステム状況情報を、指定した SSI データで置換するよう、 SPZAP
に要求します。新しい SSI には、 01 の変更レベル、21 のフラグ・バイト、
および 2448 の通し番号が含まれます。
DUMPT 制御ステートメント #1: CSECT IEFQMSSS の変換されたダンプを提
供します。
第 16 章 SPZAP
16-7
SPZAP
例: 2 番目の制御ステートメントの説明 (その 3)
NAME 制御ステートメント #2: このステートメントのすぐ後の制御ステート
メントで定義する操作が、ロード・モジュール IEFX5000 内の CSECT
IEFQMRAW で実行されることを指示します。
VERIFY 制御ステートメント #2: CSECT IEFQMRAW の先頭からの、オフセ
ット X'0154' で VERIFY 機能を実行するように SPZAP に要求します。
VERIFY 操作が正しく実行されると、 SPZAP は続く制御ステートメントを順
番に処理できます。 VERIFY が受け入れられない場合、SPZAP は次の REP
または SETSSI 操作を実行しませんが、 CSECT IEFQMRAW の 16 進のダン
プ・イメージを SYSPRINT データ・セットにダンプし、要求に応じて
DUMPT 操作が実行されます。
REP 制御ステートメント #2: SPZAP は、CSECT IEFQMRAW の先頭からの
16 進オフセット X'0154' のデータを、この制御ステートメントで指定した 16
進データで置換します。
IDRDATA 制御ステートメント #2: 2 番目の REP 操作が正しく行われた場
合、SPZAP は、モジュール IEFX5000 内の IDR を CSECT IEFQMRAW に
ついて、データ PTF01483 で更新します。
SETSSI 制御ステートメント #2: SPZAP は、直前の SETSSI と同じ機能を実
行します。ただし、これは 2 番目の VERIFY が受け入れられている場合にの
み実行されます。
DUMPT 制御ステートメント #2: SPZAP は、制御セクション IEFQMRAW
で DUMPT 機能を実行します。
16-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
例: UNIX の CSECT の検査と修正
この JCL を使用して、UNIX の制御セクション PRINTF を検査し、修正しま
す。
//ZAPUNIX EXEC PGM=AMASPZAP
//SYSPRINT DD SYSOUT=A
//SYSLIB
DD PATH=’/sj/sjpl/binder/unixzap/’,
// PATHDISP=(KEEP,KEEP)
//SYSIN
DD *
NAME
LOADMOD1 PRINTF
VERIFY
0000 58F0C210
REP
0000 68F0D210
DUMP
LOADMOD1 PRINTF
/*
SYSLIB DD ステートメント: SPZAP が処理するプログラム・オブジェクト
LOADMOD1 が入っているディレクトリー ‘/sj/sjpl/binder/unixzap/’ を定義しま
す。
SYSIN DD ステートメント: 入力ストリームを定義します。
NAME 制御ステートメント: 続く制御ステートメントで定義した操作を、プ
ログラム・オブジェクト LOADMOD1 の制御セクション PRINTF で実行する
ように SPZAP に指示します。
VERIFY 制御ステートメント: 制御セクション PRINTF の位置 X'0000' の内
容を、VERIFY 制御ステートメントで指定したデータと比較するように
SPZAP に要求します。比較した結果が等しい場合は、 SPZAP は続く制御ス
テートメントを順番に処理します。データが一致しない場合は、SPZAP は
CSECT PRINTF の 16 進イメージを SYSPRINT データ・セットにダンプしま
す。後続の REP 制御ステートメントは無視されます。
REP 制御ステートメント: SPZAP は、CSECT PRINTF の先頭からのオフセ
ット X'0000' のデータを指定した 16 進データで置換します。
DUMP 制御ステートメント: プログラム・オブジェクト LOADMOD1 の 16
進イメージの制御セクション PRINTF を SYSPRINT データ・セットにダンプ
するよう要求します。DUMP ステートメントは REP ステートメントの後ろに
あるので、VERIFY 操作が正しく行われた場合、そのイメージには、SPZAP
が行った変更が反映されます。
第 16 章 SPZAP
16-9
SPZAP
例: CSECT を修正するために SPZAP を使用する (パート 1)
この JCL を使用して、プログラム・オブジェクト内の CSECT を検査し、修
正します。
//UPDATE JOB
//ZAPSTEP EXEC
//SYSPRINT DD
//SYSLIB
DD
//SYSIN
DD
NAME
VERIFY
REP
REP
MSGLEVEL=(1,1)
PGM=AMASPZAP
SYSOUT=A
DSN=SYS1.USERLIB,DISP=OLD
*
LONG#
ALIASNAME
PDSPROCR
000070
58E0,9118
000074 50E0,9434,9140,9058,47E0,C0A8,45E0,C476,94BF,9058,#
181D,58D0,D004,1FFF,43F0,A046,1F00,BF07,A047
00009A 1861,1870,1F55,0E64,98EC,D00C,07FE
SYSLIB DD ステートメント: LONGALIASNAME という別名のプログラム・
オブジェクトを含む、ライブラリー SYS1.USERLIB を定義します。 (LONG
の後の継続文字 (#) に注意してください。) このプログラム・オブジェクト内
の 1 つの CSECT が変更されます。
SYSIN DD ステートメント:
入力ストリームを定義します。
NAME 制御ステートメント: この制御ステートメントはカラム 72 に ‘#’ が
あり、2 番目の制御ステートメントに続きます。継続ステートメントの最初の
18 カラムはブランクで無視されます。この継続ステートメントのストリング
ALIASNAME はストリング LONG と連結されて、メンバー名
LONGALIASNAME となります。このステートメントは、1 つのレコード内に
NAME LONGALIASNAME PDSPROCR として継続することができることに注
意してください。いずれの方法でも、NAME ステートメントは、SPZAP が
VERIFY と 2 つの REP ステートメントを、別名 LONGALIASNAME を持つ
プログラム・オブジェクト・メンバー内の 1 つの CSECT PDSPROCR に使用
することを示します。
注: 継続ステートメントの先行ブランクは無視されます。文字のない最初のカ
ードはスキップされます。そのため、最初のカードと 2 番目の部分の、オ
ペランドを分離する場合は、最初のカードのオペランドの部分がカラム 71
を超えることが重要です。カラム 71 がブランクであれば、2 番目のカー
ドの非ブランク・ストリングは新しいオペランドを示します。
VERIFY 制御ステートメント: CCHHR ステートメントに定義されたデータ・
レコードの先頭から 16 進変位 X'000070' のデータを調べ、この制御ステート
メントに指定した 16 進データと同じであることを確認するよう SPZAP に要
求します。データが同じであれば、SPZAP は次の制御ステートメントを順番
に処理します。データが同じではない場合は、SPZAP は REP を実行せず、
ABSDUMPT 操作を実行します。また、CCHHR ステートメントで定義したデ
ータ・レコードのフォーマット設定された 16 進イメージを SYSPRINT デー
タ・セットにダンプします。
16-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
例: CSECT を修正するために SPZAP を使用する (パート 2)
REP 制御ステートメント #1: SPZAP は、この制御ステートメントに指定し
た 16 進数データで、CSECT PDSPROCR 内のオフセット X'000074' のデータ
を置換します。このステートメントの カラム 72 に非ブランク (#) を含んで
いることは、 2 番目の制御ステートメントに続くことを示していることに注
意してください。
REP 制御ステートメント #2: SPZAP は、この制御ステートメントに指定し
た 16 進データで、CSECT PDSPROCR 内のオフセット X'00009A' のデータ
を置換します。
CSECT 内のデータへのアクセス
次の説明で取り上げられている制御ステートメントの詳しい説明は、 16-23 ページ
の『SPZAP 制御ステートメント』を参照してください。
CSECT が検出され、 VERIFY および REP ステートメントでオフセット・パラメ
ーターを使用すると、SPZAP は検査され置き換えられるデータを検出することがで
きます。オフセット・パラメーターは 16 進表記で指定され、 CSECT の開始から
のデータの相対的な変位を定義します。たとえば、VERIFY ステートメントに 16
進オフセット X'40' が指定してあれば、SPZAP は NAME ステートメントで識別し
た CSECT の開始から 64 バイトの位置を検出し、その点からデータの検証を開始
します。
通常は、検査されるかまたは修正される命令に関連したアセンブリー・リスト・ア
ドレスを、 VERIFY または REP ステートメントのオフセット値として使用するこ
とができます。ただし、ある CSECT がその他の CSECT とともにアセンブルさ
れ、アセンブリー・リスト内のその起点がゼロではない場合は、アセンブリー・リ
スト内の位置は CSECT 内のデータの正しい変位を反映しません。参照するデータ
のアセンブリー・リスト・アドレスから CSECT の開始を区別しているアセンブリ
ー・リスト・アドレスを引いて、正しい変位を計算する必要があります。
ただし、BASE 制御ステートメントを使用するとそのような計算の手間を除去しア
センブリー・リスト位置を使用することができます。 BASE 制御ステートメント
は、 SPZAP への入力において、CSECT を識別する NAME ステートメントのすぐ
後ろに続けて入れてください。BASE ステートメント内のパラメーターは CSECT
が開始した時点の、アセンブリー・リスト・アドレス (16 進) になります。 SPZAP
はこの値を、BASE ステートメントに続くすべての VERIFY または REP ステート
メントに指定したオフセットから減算し、差をデータの変位として使用します。
16-12 ページの図 16-1 は、複数の制御セクションを示しているアセンブリー・リス
トの例です。2 番目の CSECT (IEFCVOL2) を参照する場合に、 SPZAP への入力
に位置 0398 の BASE ステートメントを含めることができます。その後、続く
LOAD 命令 (L R2,CTJCTAD) を参照する場合は、 SPZAP 入力ストリーム内に続い
ている VERIFY または REP ステートメントで、オフセット X'039A' を使用するこ
とができます。
第 16 章 SPZAP
16-11
SPZAP
LISTING TITLE
LOC
OBJECT CODE
ADDR1 ADDR2 STMT
000000
SOURCE STATEMENT
1 IEFCVOL1 CSECT
10000017
.
.
.
000384 00000000
378
379
000388 00000000
380
00038C D200 1001 8000 00000 00000 381
382
000392 D200 1001 1000 00001 00000 383
384
000398
000398 0590
00039A
00039A 5820 C010
386
387
388
00010 389
VCNQMSSS
*
VCMSG15
MVCMSG
*
MVCBLNKS
*
DC
V(IEFQMSSS)
DC
V(IEFVMG15)
MVC 0(1,R1),0(R8)
MVC
1(1,R1),0(R1)
CSECT
BALR R9.0
USING *,R9
L
R2,LCTJCTAD
55800017
56000017
56100017
56200017
56300017
56400017
56500017
56600017
56700017
56800017
56900017
.
.
.
図 16-1. 複数の制御セクションを示すアセンブリー・リストの例
データ・レコードの検査と修正
データ・レコードを検査し修正する方法は、データ・レコードが PDSE 上にある
か、あるいは VTOC か順次データ・セットのようなその他のタイプのデータ・セッ
ト上にあるかによって異なります。
PDSE 内にないレコード
注: 次の情報は、PDS には適用されません。 SPZAP は、ロード・モジュールが入
った PDS のみをサポートします。
PDSE 内にない特定のデータ・レコードを検査あるいは修正するには、CCHHR 制
御ステートメントを使用して、その直接アクセス・アドレスを指定する必要があり
ます。この CCHHR アドレスは、SYSLIB DD 制御ステートメント内に定義された
直接アクセス・データ・セットの範囲内になければなりません。
CCHHR 制御ステートメントを使用すると、SPZAP は、検査または修正する物理レ
コードを読み取ります。次に、後続の VERIFY および REP ステートメントで指定
されたオフセット・パラメーターが、レコード内で検査または置き換えられるデー
タを探すために使用されます。これらの 16 進オフセットは、レコードの開始から
相対的なデータの変位を定義し、任意のキー・フィールドの長さを含んでいる必要
があります。
CCHHR 制御ステートメントで識別されるレコードについて REP 操作を要求する場
合は、SPZAP はメッセージ AMA112I を発行して、ユーザーが要求するレコードを
提供します。
16-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
z/OS V1R7 以降では、SPZAP の V1R7 以降のリリースを使用するとき、
DSNTYPE=LARGE データ・セットがサポートされます。
PDSE 内のレコード
PDSE データ・ライブラリー内の特定のデータ・レコードを検査または修正する場
合は、 NAME 制御ステートメントの次に RECORD 制御ステートメントを使用し
て、その直接アクセス・アドレスを指定します。 RECORD と NAME のこの組み
合わせは、 PDSE データ・ライブラリー・メンバー内の特定の位置についてのポイ
ンターとして機能します。
CCHHR 制御ステートメントは PDSE には適用されません。 CCHHR 制御ステー
トメントで PDSE 内のデータにアクセスを試みると、すべてエラーになります。
CCHHR ステートメントの直後に VER|VERIFY、REP、IDRDATA、または SETSSI
制御ステートメントを続けると、すべてエラーのフラグが立って、無視されます。
特定のレコードの相対レコード番号を判別する場合は、次のように指定して SPZAP
を呼び出します。
NAME membernam
ABSDUMP(T) 1 99999999
結果はメンバー内のすべてのレコードについて、レコード長、相対レコード番号、
およびその他の従属情報を表示します。
第 16 章 SPZAP
16-13
SPZAP
例: データ・レコードの検査と修正
この例では、修正されるデータ・セットはボリューム目録です。
//ZAPIT
JOB
MSGLEVEL=(1,1)
//STEP
EXEC
PGM=AMASPZAP
//SYSPRINT
DD
SYSOUT=A
//SYSLIB
DD
DSNAME=FORMAT4.DSCB,DISP=OLD,
//
UNIT=3390,VOLUME=SER=111111,DCB=(KEYLEN=44)
//SYSIN
DD
*
CCHHR
0005000001
VERIFY
2C
0504
REP
2C
0A08
REP
2E
0001,03000102
ABSDUMPT
ALL
/*
SYSPRINT DD ステートメント: メッセージ・データ・セットを定義します。
SYSLIB DD ステートメント: 制御ステートメントで指定した操作を実行する際に、 SPZAP でアクセスするデ
ータ・セットを定義します。この例では、通し番号が 111111 の 3390 ボリューム上の、VTOC (フォーマット 4
DSCB) を定義します。 DCB=(KEYLEN=44) を指定しているので、ABSDUMPT 制御ステートメントが作成する
ダンプには、44 バイト・キーである dsname が表示されます。これは VERIFY または REP 制御ステートメン
トでは必要がないことに注意してください。
CCHHR 制御ステートメント: 次の制御ステートメントで指定した操作を実行している間に、SYSLIB DD ステ
ートメントで定義したデータ・セット内の直接アクセス・レコード・アドレス “0005000001” に SPZAP がアク
セスすることを示します。
VERIFY 制御ステートメント: CCHHR ステートメントに定義されたデータ・レコードの先頭から 16 進変位
X'2C' のデータを調べ、この制御ステートメントに指定した 16 進データと同じであることを SPZAP が確認す
ることを要求します。データが同じであれば、SPZAP は次の制御ステートメントを順番に処理します。データが
同じではない場合は、SPZAP は REP を実行せず、 ABSDUMPT 操作を実行します。また、CCHHR ステート
メントで定義したデータ・レコードのフォーマット設定された 16 進イメージを SYSPRINT データ・セットに
ダンプします。
REP 制御ステートメント: レコードの先頭からの変位 2C で始まるデータの 8 バイトが REP 制御ステートメ
ント内の 16 進データで置き換えられます。変位 2C 値は、レコードの開始にある 44 バイトのキーで使用でき
ます。
ABSDUMPT 制御ステートメント: SPZAP は、データ・セット全体を SYSPRINT データ・セットに SPZAP が
ダンプします。 SYSLIB DD ステートメントに DCB=(KEYLEN=44) が指定してあるので、44 バイトの dsname
もダンプされます。
注: VTOC を修正する必要がある場合は、メッセージ AMA117D がオペレーターに対して発行され、修正の許可
を求めます。
16-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
例: SPZAP を使用したデータ・レコードの修正
この例は、PDSE データ・ライブラリー内のレコードを検査し修正する方法を
示します。
//UPDDATA JOB MSGLEVEL=(1,1)
//ZAPSTEP EXEC PGM=AMASPZAP
//SYSPRINT DD SYSOUT=A
//SYSLIB
DD DSN=IBMUSER.LMD.PDSE,DISP=OLD
//SYSIN
DD *
NAME
USERDATA
RECORD
0003
VER
000010
04B3,9017
REP
000014
10C7,C5E3,C4E2
ABSDUMP
3
3
SYSLIB DD ステートメント: 制御ステートメントで指定した操作を実行する
ために、 SPZAP がアクセスするデータ・セットを定義します。この例では、
専用 PDSE データ・ライブラリーを定義します。 NAME ステートメントはメ
ンバーを USERDATA として識別します。これについては 16-39 ページの図
16-8 に示します。
SYSIN DD ステートメント: SPZAP 制御ステートメントを含む入力ストリー
ムを定義します。
NAME 制御ステートメント: このステートメントの直後の制御ステートメント
を USERDATA という名のメンバーに対して実行することを、SPZAP に知ら
せます。
RECORD 制御ステートメント: メンバー USERDATA の 3 番目のレコード
である、相対レコード 3 に SPZAP がアクセスすることを示します。レコー
ド 3 は、続く VERIFY と REP 操作のオブジェクトです。
VERIFY 制御ステートメント: SPZAP が、16 進変位 X'0010' のデータを検査
して、指定されたストリングと比較することを要求します。異なる場合は、こ
の VERIFY にはエラー・メッセージが出され、フラグが付けられ、そのレコ
ード 3 の内容が表示され、次の REP ステートメントはフラグが付けられ無視
されます。
REP 制御ステートメント: 先行する VERIFY ステートメントが正常に完了し
た場合、SPZAP は、メンバー USERDATA のレコード 3 内のオフセット
X'000014' のデータを、データ X'10C7C5E3C4E2' に置き換えます。前の
VERIFY ステートメントにエラーのフラグが付けられた場合は、このステート
メントにもエラーのフラグが付けられ、データは置換されません。
ABSDUMP 制御ステートメント: SPZAP は、メンバー USERDATA のレコー
ド 3 を表示します。レコード 3 は VERIFY が完了しても失敗しても表示さ
れます。
第 16 章 SPZAP
16-15
SPZAP
システム状況索引 (SSI) の更新
SSI 内の既存データを、ユーザー独自のデータでオーバーレイするために、SETSSI
制御ステートメントを使用することができます。 SETSSI 制御ステートメントの詳
しい説明は、 16-23 ページの『SPZAP 制御ステートメント』を参照してください。
SSI はロード・モジュールのディレクトリー項目内に、リンケージ・エディターが
作成する 4 バイトのフィールドです。これは、ロード・モジュールについて行われ
るすべての修正をトラッキングするために非常に役立ちます。SPZAP は、関連する
モジュール内のデータを更新すると必ず、システム状況索引を自動的に更新しま
す。
すべてのロード・モジュールにシステム状況情報がある訳ではありません。システ
ム状況情報を持っているものについては、 SSI はディレクトリー項目内の、ユーザ
ー・データ・フィールドの最後の 4 バイトに置かれます。図 16-2 では、ロード・
モジュール・ディレクトリー項目内の SSI の位置を示します。
┌───────────────┬───────────┬──────┬────────────────────┬────────────┐
* Member Name
*
TTR
*
C * User Data Field
* SSI
*
* 1
8 * 9
11 * 12 * 13 to 70 maximum * variable *
└───────────────┴───────────┴──────┴────────────────────┴────────────┘
図 16-2. ロード・モジュール・ディレクトリー項目内の SSI バイト
図 16-3 では、 SSI フィールドと対応するロード・モジュール・プログラムに行わ
れる変更のタイプを示すフラグ・ビットの構成を示します。
SSI 情報の最初のバイトには、メンバーの変更レベルが入っています。ロード・モ
ジュールを最初にインストールしたときは、その変更レベルは 1 に設定されます。
その後、変更レベルは、そのプログラムの新しいバージョンを含む各リリースごと
に 1 増加します。IBM がリリースしたプログラムのいずれかの SSI に変更を行う
場合は、意図的に行う場合を除いて、この保守レベル標識を破壊しないように注意
してください。変更レベルのバイトをその元の値のまま保存する場合は、 SETSSI
機能を使用する前に SSI に含まれている情報を知っておいてください。LIST 保守
援助プログラムの LISTLOAD 制御ステートメントを使用すると、必要な情報を得
ることができます。
16-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
図 16-3. システム状況索引フィールド内のフラグ・バイト
SSI の 2 番目のバイトは、フラグ・バイト と呼ばれます。フラグ・バイト内のビ
ットには、メンバーの保守状況を反映する情報が含まれています。SPZAP を使用す
る場合は、8 つのビットのうち 2 つのみに注意を払う必要があります。
v ローカル修正フラグである、ビット 2 は、ユーザーが特定のメンバーを修正した
ことを示します。(これは IBM が提供する一時修正または PTF による修正を反
映する目的で使用することはありません。) SPZAP は、ロード・モジュールを正
しく修正すると、このローカル修正フラグ・ビットを 1 に設定します。
v プログラム一時修正フラグ、ビット 3 は IBM 許可 PTF がシステム・ライブラ
リーに適用され、IBM モジュール内のエラーを訂正した時に 1 に設定されま
す。
フラグ・バイト内のその他のすべてのビットは、 SETSSI 操作が行われる前のまま
SSI 内で保持され、通常のシステム保守手順を妨げることはありません。
システム状況索引の 3 番目と 4 番目のバイトは、 PTF 番号の最初の数字と最後の
3 つの数字を識別するシーケンス番号を保管します。SPZAP は、SETSSI 制御ステ
ートメントを使用して変更を要求する場合以外に、これらのバイトを変更すること
はありません。
SPZAP の実行
ジョブ・ストリームへの入力として制御ステートメントを使用するか、または選択
したマクロの一部として動的に SPZAP を実行することができます。
v 16-19 ページの『SPZAP を実行するために JCL と制御ステートメントを使用す
る』
第 16 章 SPZAP
16-17
SPZAP
v
16-21 ページの『SPZAP を動的に呼び出す』
操作上の考慮事項
SPZAP を実行する場合に次の点に注意してください。
v SPZAP は、システムの OPEN マクロを使用します。そのため、SPZAP は
OPEN 処理中に生じるアクセス検査が正しく完了しなかった場合、RACF 保護デ
ータ・セットを修正または検査することができません。
v モジュールは PDS 内のロード・モジュールまたは PDSE 内のプログラム・オブ
ジェクトとすることができます。 SPZAP は PDSE 内のプログラム・オブジェク
トをインプレースで更新するのではなく、置換します。プログラム・オブジェク
トの特定のコピーへの接続を確立するために BLDL マクロを使用するユーザー
は、新しいコピーへのアクセスを行うために BLDL を再び呼び出す必要がありま
す。
SPZAP を使用して変更したプログラム・オブジェクトを管理し、その変更したオ
ブジェクトを使用するために LLA を使用している場合は、オペレーターはその
プログラム・オブジェクトのディレクトリー項目に関する LLA をリフレッシュ
する必要があります。リフレッシュしないと、LLA が更新される前のバージョン
のプログラム・オブジェクトをロードし続けます。
ロード・モジュールまたはプログラム・オブジェクトが他のユーザーにより使用
中である場合や、LLA を介してロード処理中である場合は、SPZAP 自体は識別
できません。
参照 PDSE とそのデータ構造については、z/OS DFSMS データ・セットの使用法
を参照してください。
v システム・ライブラリーなどの満了しないデータ・セットは、 OPEN 時に出され
る満了メッセージに r xx,‘U’ と応答しないと修正することはできません。
v SPZAP を使用して IPL 時にのみ仮想記憶域内で常駐になるオペレーティング・
システム・モジュールを修正する場合は、変更されたモジュールの新しいバージ
ョンを呼び出すために再度の IPL が必要です。 (この要件は、SYS1.PARMLIB
内のすべてのモジュール、SYS1.PARMLIB の LPALSTxx メンバーで指定された
すべてのデータ・セット、および SYS1.NUCLEUS 内のすべてのモジュールに適
用されることに注意してください。)
SPZAP 自身は、IPL 時以外にいつモジュールがロードされるかを判別することは
できません。
v SYSLIB DD ステートメントは、連結された、またはマルチボリュームのデー
タ・セットを定義することはできません。
v SPZAP は、SYSLIB 装置として直接アクセス記憶装置 (DASD) のみをサポート
します。
v SYS1.LINKLIB などのシステム・データ・セットを修正する場合は、 SYSLIB
DD ステートメントに DISP=OLD を指定してください。
16-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
SPZAP を実行するために JCL と制御ステートメントを使用する
SPZAP を呼び出す 1 つの方法はジョブ・ストリームを通じて行う方法です。
SPZAP を実行している時に使用する必要がある JCL ステートメントは、次のとお
りです。
v JOB ステートメント
v EXEC ステートメント
v SYSPRINT DD ステートメント
v SYSLIB DD ステートメント
v SYSABEND DD ステートメント
v SYSIN DD ステートメント
これらの JCL ステートメントを、 16-23 ページの『SPZAP 制御ステートメント』
の制御ステートメントとともに使用すると、SPZAP でより多くの機能を実行するこ
とができるようになります。
また SPZAP を実行する場合は、ユーザーのプログラムで使用できる領域サイズを
計算する必要があります。 AMASPZAP の実行に必要な最小領域サイズは、200 キ
ロバイトです。
通常は、EXEC ステートメントでは REGION パラメーターは必要ありませんが、
REGION=120K (または、200K より小さいその他の値) を指定すると、SPZAP はメ
ッセージ AMA154I を発行し、戻りコード 16 で処理を停止します。さらに、プロ
グラム管理バインダーの領域サイズが小さすぎる場合は、SPZAP がメッセージ
AMA154I を発行します。SYSLIB メンバーが非常に大きく REGION=4M または
REGION=6M が必要な場合に、この問題が起こる場合があります。
JCL ステートメント
JOB ステートメント
ジョブの開始をマークします。
EXEC ステートメント
SPZAP を呼び出します。 PGM=AMASPZAP または PGM=IMASPZAP のいず
れかを指定して実行するプログラムとして AMASPZAP を識別します。これは
AMASPZAP の別名です。
注: SPZAP が正常に処理を完了するための領域サイズが、最低 200K であるこ
とを確認する必要があります。
ユーザーが指定できる唯一の有効なパラメーターは PARM=IGNIDRFULL で、
このパラメーターを指定すると、そのモジュールについての IDR がいっぱいに
なった場合に、 CSECT の更新 (NAME と REP によって) に関係する標準の
制約事項を、SPZAP が指定変更することができます。
注:
1. PARM=IGNIDRFULL を IBM 提供のモジュールに使用しないでください。
2. PARM=IGNIDRFULL は、SYSLIB がプログラム・オブジェクト・ライブラ
リーの場合には意味がありません。プログラム・オブジェクト・ライブラリ
ー・メンバーに関連する IDRZ レコードの数に制限はありません。
SYSPRINT DD ステートメント
システム・プリンター、磁気テープ・ボリューム、または直接アクセス・ボリュ
第 16 章 SPZAP
16-19
SPZAP
ームに書き込まれるメッセージ用の順次出力データ・セットを定義します。この
ステートメントは SPZAP を実行するたびに必要です。
SYSLIB DD ステートメント
制御ステートメントに指定した操作を実行する場合に SPZAP がアクセスする直
接アクセス・データ・セットを定義します。DSNAME パラメーターと
DISP=OLD または DISP=SHR が必要です。VOLUME と UNIT パラメーター
は、データ・セットがカタログされていない場合にのみ必要です。このステート
メントでは、連結したまたはマルチボリュームのデータ・セットを定義すること
はできません。SPZAP を実行するためには、必須です。
注:
1. このデータ・セットが VTOC の場合は、DSNAME=FORMAT4.DSCB を指
定する必要があります。修正するために VTOC (すなわち DSCB) 内のレコ
ードにアクセスする場合は、SPZAP はコンソールにメッセージ AMA117D
を発行します。ただし、VTOC で ABSDUMPT 操作を行う場合は、メッセ
ージは発行されません。
2. 標準の VSAM 処理では、ACB を使用してデータ・セットにアクセスする必
要があります。しかし、SPZAP は、DCB を使用したオープンのみをサポー
トするため、VSAM データ・セットを操作するために必要な正しい情報を入
手しません。 SPZAP でブロック・サイズの不一致が報告された場合は、
SYSLIB DD ステートメントにブロック・サイズを明示的に指定すれば、
SPZAP の通常サイズの処理をオーバーライドします。
SYSABEND DD ステートメント
SPZAP が異常終了した場合に使用される順次出力データ・セットを定義しま
す。そのデータ・セットは、プリンター、磁気テープ・ボリューム、または直接
アクセス・ボリュームに書き出すことができます。このステートメントはオプシ
ョンです。
SYSIN DD ステートメント
SPZAP 制御ステートメントを含む入力ストリーム・データ・セットを定義しま
す。
戻りコード
SPZAP が終了すると、次のいずれかの戻りコードが汎用レジスター 15 に置かれま
す。
コード 意味
16-20
00
正常終了。
04
警告。ここで注意を正す処置を取らないと、将来にエラーを引き起こす結果
になります。
08
SPZAP 入力ステートメントにエラーが含まれているか、またはオペレータ
ーの介入で指定変更されました。ステートメントの構文を検査し、エラーの
原因を判別してください。
12
要求された JCL ステートメントがない、または正しくオープンされなかっ
たデータ・セットを指定しました。SPZAP は即時に終了します。
16
誤ったブロック・サイズなどの JCL エラーで永続入出力エラーが発生しま
した。SPZAP は即時に終了します。領域サイズが小さすぎる可能性があり
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
ます。 REGION=200K が許容される最小値です。ただし、プログラム・オ
ブジェクトが非常に大きい場合に、プログラム管理バインダーが 4M また
は 6M を必要とする場合があります。
20
DUMP、DUMPT、VER、または REP 処理を使用している場合に、指定し
た BLOCKSIZE よりも大きい、特定の制御セクションについての制御レコ
ードを SPZAP が検出しました。 SPZAP は即時に終了します。
SPZAP を動的に呼び出す
選択したマクロから SPZAP を実行することができます。SPZAP は、CALL、
LINK、XCTL、または ATTACH マクロを使用して、実行時にアプリケーション・
プログラムで呼び出すことができます。標準の DDNAME を使用しない場合は、プ
ログラムで SPZAP が使用するデータ・セットの代替 DDNAME のリストを提供す
る必要があります。
プログラムは、SPZAP を使用して VTOC を更新するためには、実行に APF 許可
を得る必要があります。ほかの SPZAP 機能は、プログラムの呼び出しに許可を必
要としません。
SPZAP を呼び出すために使用するこれらのマクロの一般形式を、次に示します。
(anyname)
(anyname)
(anyname)
(anyname)
CALL AMASPZAP,(oplist,ddnamlst),VL
XCTL EP=AMASPZAP
LINK EP=AMASPZAP,PARAM=(oplist,ddnamlst),VL=1
ATTACH EP=AMASPZAP,PARAM=(oplist,ddnamlst),VL=1
anyname
マクロ・ステートメントの任意指定のステートメント・ラベルを示します。
EP
SPZAP プログラムの入り口点。
PARAM
プログラムから SPZAP に渡すパラメーターをサブリストとして指定します。
oplist
オプションなしを意味するゼロのハーフワード、または、ゼロ以外のハーフワー
ドのいずれかを指定します (この後には、長さをバイトで指定した文字ストリン
グを続けます)。使用可能なパラメーター値については、 16-19 ページの『JCL
ステートメント』の EXEC ステートメントに関する情報を参照してください。
ddnamlst
SPZAP 処理中に使用されるデータ・セット用の代替 DD 名を含む可変長リスト
の名前を指定します。すべての標準の DD 名 (SYSPRINT、SYSLIB、および
SYSIN) を使用する場合は、このパラメーターを省略することができます。
DDNAME リストはハーフワード境界で開始する必要があります。最初の 2 バ
イトには、リストの残りの部分のバイト数が含まれます。リストのフォーマット
は固定され、各項目は 8 バイトです。8 バイト以下の名前はすべて左寄せさ
れ、ブランクで埋められます。名前がリスト内に残っている場合は、項目には 2
進数のゼロが含まれる必要があります。その場合は、標準名がとられます。リス
トを短くして、DD 名リストの終わりから名前を省略することができます。
リスト内の 8 バイト項目のシーケンスは、次のとおりです。
第 16 章 SPZAP
16-21
SPZAP
項目
0-7
8-15
16-23
24-31
32-39
40-47
標準名
該当なし
該当なし
該当なし
SYSLIB
SYSIN
SYSPRINT
VL | VL=1
アドレス・パラメーター・リストの最後のワードで、高位ビットが 1 に設定さ
れることを示します。
注: DD 名リストの名前を指定しない場合は、oplist アドレスの高位ビットがオ
ンに設定されていることを確認してください。VL|VL=1 をコーディングす
ることにより、ビットが正しく設定されます。
図 16-4 は機能的に等しい 2 つの SPZAP の動的呼び出しの例です。
EXSPZAP
CSECT
USING *,15
ASSUME REG15 IS BASE
MODID
MODULE ID AND DATE IN PROLOG
SAVE (14,12)
SAVE REGISTERS
BALR 12,0
ESTABLISH BASE REGISTER
USING *,12
ST
13,SAVEAREA+4
CHAIN NEW SAVEAREA TO PREVIOUS
LR
2,13
TEMPORARILY SAVE ADDRESS OF OLD SAVEAREA
LA
13,SAVEAREA
INIT REG13 WITH ADDRESS OF NEW SAVEAREA
ST
13,8(0,2)
CHAIN PREVIOUS SAVEAREA TO NEW
*************************************************************************
*
*
*
THIS EXAMPLE SHOWS TWO FUNCTIONALLY EQUIVALENT DYNAMIC
*
*
INVOCATIONS OF SPZAP.
*
*
NO OPTIONS ARE PASSED.
*
*
THE DDNAME FOR THE SYSLIB FILE IS CHANGED TO TESTLIBR.
*
*
THE DDNAME FOR THE SYSIN FILE IS NOT CHANGED.
*
*
THE DDNAME FOR THE SYSPRINT FILE IS CHANGED TO PRINTOUT.
*
*
*
*************************************************************************
LINKZAP1 LINK EP=AMASPZAP,PARAM=(OPTLIST,DDLIST),VL=1
LINKZAP2 LINK EP=AMASPZAP,PARAM=(0,DDLIST),VL=1
L
13,SAVEAREA+4
LOAD ADDRESS OF PREVIOUS SAVEAREA
RETURN (14,12),T,RC=0 RETURN TO CALLER
OPTLIST DC
H’0’
NO OPTIONS ARE PASSED TO AMASPZAP
DDLIST
DS
0H
ALIGN DDNAMES TO HALFWORD BOUNDARY
DC
H’48’
LENGTH OF THE CHARACTER STRING
*
CONTAINING DDNAME OVERRIDES
DC
24XL1’00’
FIRST 24 CHARACTERS ARE IGNORED
DC
CL8’TESTLIBR’
CHANGE SYSLIB FILE TO DDNAME OF TESTLIBR
DC
8XL1’00’
USE SYSIN FILE FOR INPUT OF CONTROL
*
STATEMENTS
DC
CL8’PRINTOUT’
CHANGE SYSPRINT FILE TO DDNAME OF
*
PRINTOUT
SAVEAREA DC
18F’0’
REGISTER SAVEAREA
END
図 16-4. SPZAP の動的呼び出しのサンプル・アセンブラー・コード
16-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
SPZAP 制御ステートメント
SPZAP 制御ステートメント (JCL 内のユーザーの入力ストリーム、またはシステ
ム・コンソールを通して入力される) は、 SPZAP の特定の実行中に行う処理機能
について定義します。
システム・コンソールから、その他の SPZAP 制御ステートメントを入力するため
に、CONSOLE 制御ステートメントを使用できます。
SPZAP の実行を定義する制御ステートメントは、次のとおりです。
v ABSDUMP または ABSDUMPT
v BASE
v CCHHR
v CHECKSUM
v コメント (*)
v CONSOLE
v DUMP または DUMPT
v IDRDATA
v NAME
v RECORD
v REP
v SETSSI
v VERIFY
SPZAP 制御ステートメントのコーディング規則: SPZAP の制御ステートメントを
コーディングする場合は、次の規則に従ってください。
v SPZAP 制御カードのサイズは、80 バイトです。これには、71 バイトの制御情報
を含めることができます。
v ステートメントは、71 桁目までの任意のカラムで開始できます。
v ステートメントの操作名は、必ずパラメーターの前に置いて、最初のステートメ
ントで完了する必要があります。操作名を継続することはできません。
v 指定する操作と最初のパラメーターとの間には、最低 1 つのブランクが必要で
す。
v パラメーターとパラメーターの間にも、最低 1 つのブランクが必要です。
v 見やすさのために、データ・フィールド・パラメーターをコンマでフォーマット
設定することができますが、データ・フィールド内にブランクを入れることはで
きません。
v データとオフセット値は 2 つの 16 進数の繰り返しとして指定することができま
す。
v ほとんどの制御ステートメントの最後の必須パラメーターとそのブランク区切り
文字の後の、残りの部分はコメントのために使用することができます。例外は、
NAME と DUMP 制御ステートメントです。これらのステートメントのいずれか
らか CSECT パラメーターを省略した場合は、ロード・モジュール・パラメータ
ーの後ろの空欄をコメント用に使用することはできません。
v アスタリスクで始まるレコードは、コメント・ステートメントであると見なされ
ます。
v コメント・ステートメント (単一のアスタリスクで始まるステートメント) を、継
続することはできません。
第 16 章 SPZAP
16-23
SPZAP
v プログラム・オブジェクトのメンバー名および CSECT 名は、1024 文字まで使用
できます。
v SYSLIB が PDSE または z/OS UNIX ファイルを参照するときは、以下のよう
に、非コメント・ステートメントを続けることができます。
– 継続される制御カードの 72 カラム目には、ブランク以外の文字を含めなけれ
ばなりません。
– すぐ後に続くカードの文字ストリング (最初のブランク以外の文字で始まる)
は、先行のカードの 71 カラム目に連結されます。AMASPZAP は、連結され
たカードの先行ブランクを無視しますが、カードを変更せずに SYSPRINT 上
に表示します。
– 必要に応じてステートメントを継続することができます。ただし、最後のパラ
メーターに続くコメント欄を継続することはできません。
– 省略したパラメーターを示すための単一のアスタリスク (*) を使用できるパラ
メーターがあっても、継続するカード上で最初のブランク以外の文字にアスタ
リスクを使用することはできません。継続するステートメントが単一のアスタ
リスクで始まらないように、注意してステートメントの切れ目を選んでくださ
い。
次に SPZAP 制御ステートメントについての詳細な説明を英字順に示します。
{ABSDUMP|ABSDUMPT}{startaddr stopaddr | startrec stoprec |
membername | ALL}
このステートメントは次のものを、SYSLIB DD ステートメントの指定に従って
ダンプする場合に使用することができます。
v 物理レコードのグループ
v PDSE データ・ライブラリーのメンバーに属するレコードのグループ
v PDS のいつのロード・モジュール・メンバー、またはすべてのロード・モジ
ュール
v PDSE の全メンバー
v プログラム・オブジェクトを含む PDSE のディレクトリー
各レコードと関連するキーをフォーマット設定する場合は、
DCB=(KEYLEN=nn) は、SYSLIB DD ステートメントでも指定する必要があり
ます。ここで “nn” はレコード・キーの長さです。 VTOC をダンプする場合
は、 DCB=(KEYLEN=44) を指定する必要があることに注意してください。
PDS ディレクトリーをダンプする場合は、DCB=(KEYLEN=8) を指定してくだ
さい。 ABSDUMP が作成するのは 16 進の印刷出力のみであるのに対し、
ABSDUMPT は 16 進データ、EBCDIC 変換、およびデータと同等の簡略記号
を印刷します。 16-34 ページの『SPZAP 出力の読み取り』を参照してくださ
い。変数は次のとおりです。
startaddr
ダンプする最初のレコードの直接アクセス装置絶対アドレス。このアドレス
は cccchhhhrr (シリンダー、トラックおよびレコード番号) という 16 進形
式で指定する必要があります。このパラメーターは正確に 10 桁の長さが必
要です。
stopaddr
ダンプする最後のレコードの直接アクセス装置絶対アドレスで、開始アドレ
スと同じフォーマットでなければなりません。
16-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
レコードのこの方式のダンプを使用する場合は、両方のアドレスを必ず指定
しなければなりません。また、両方のアドレスは SYSLIB DD ステートメ
ントで定義したデータ・セットの範囲内になければなりません。開始アドレ
ス内に指定したレコード番号は有効なレコード番号でなければなりません。
0 のレコード番号を指定すると、READ ルーチンはそのようなレコードを
スキップするので、SPZAP がそれを 1 に変更します。停止アドレスとして
指定するレコード番号は有効なレコード番号でなくともかまいませんが、無
効なレコード番号を指定した場合は、停止アドレスに指定したトラックの最
後のレコードまでダンプが続けられます。
startrec
表示する PDSE データ・ライブラリーの、メンバーの最初の相対レコード
の値。このパラメーターは 1 から 8 桁の長さにすることができます。メン
バーの最初のレコードの startrec 値は 1 です。
注: ABSDUMP|ABSDUMPT startrec stoprec は、SYSLIB が PDSE データ・
ライブラリーで、member がそのライブラリーの有効なメンバーである
場合に NAME member ステートメントに続いて指定した場合にのみ有
効になります。
stoprec
表示する PDSE データ・ライブラリーのメンバーの最後の相対レコードの
値です。このパラメーターは 1 から 8 桁の長さにすることができます。
stoprec の値で最後の物理レコードの相対レコード値より大きい値を指定す
ると、メンバーの最後のレコードを印刷したあとで印刷は停止します。
stoprec の値が startrec の値より小さい場合は、レコードは表示されませ
ん。次の 2 つのステートメントを使用して、 PDSE データ・ライブラリー
のメンバーのすべてのレコードを表示することができます。
NAME member
ABSDUMP|ABSDUMPT
1 99999999
membername
SYSLIB DD ステートメントで指定されている、 PDS または PDSE のメン
バー名です。その名前は PDS のロード・モジュール・メンバー、または
PDSE データ・ライブラリーのメンバーを参照することができます。どちら
の場合も、この変数を指定すると、メンバー全体がダンプされます。(PDSE
のプログラム・オブジェクト・メンバーには、DUMP/DUMPT を使用してく
ださい。)
ALL
SYSLIB DD ステートメントで定義したデータ・セット全体をダンプするこ
とを指定します。そのデータ・セットに割り振ったスペースをどれほどダン
プするかは、データ・セットが編成される方法によって異なります。
v 順次データ・セットの場合、SPZAP はファイルの終わりまでダンプしま
す。
v 索引付き順次および直接アクセス・データ・セットの場合、 SPZAP はす
べてのエクステントをダンプします。
v PDS の場合、 SPZAP は、すべてのリンケージ・エディターの制御レコ
ードを (存在する場合) 含む、すべてのエクステントをダンプします。
第 16 章 SPZAP
16-25
SPZAP
v PDSE データ・ライブラリーの場合、SPZAP はディレクトリーおよびラ
イブラリーのすべてのメンバーの一覧を表示します。データ・セットが、
プログラム・オブジェクトを含む PDSE の場合、SPZAP はディレクトリ
ーだけを表示します。
BASE xxxxxx
SPZAP が、続く VERIFY と REP ステートメントで指定するオフセット値を調
整するために使用します。このステートメントは、CSECT 用の VERIFY およ
び REP ステートメントで指定されるオフセットが、 CSECT の開始アドレスが
位置ゼロではないアセンブリー・リストから入手される場合に使用されます。
たとえば、CSECT ABC がアセンブリー・リストの位置 X'000400' で開始し、
この CSECT 内で置換されるデータの位置が X'000408' であると仮定します。
このデータの CSECT 内の実際の変位は X'08' です。ただし、X'000400' を指定
する BASE ステートメントを SPZAP 入力ストリームの REP ステートメント
の前に含める場合は、オフセット X'0408' (アセンブリー・リストの位置
X'000408' から入手される) REP ステートメントで指定することができます。
SPZAP が REP ステートメントを処理する場合は、ベース値 X'000400' をオフ
セット X'0408' から減算し、そのデータの CSECT 内の正しい変位を判別する
ことができます。変数は次のとおりです。
xxxxxx
6 文字の 16 進オフセットで、続く VERIFY および REP 操作のベースと
して使用されます。この値は、検査または修正しようとしている CSECT の
アセンブリー・リスト開始アドレスを反映するものとしてください。
注: BASE ステートメントは、 SPZAP 入力ストリーム内の NAME ステー
トメントのすぐ後ろに置いてください。NAME ステートメントは、
SPZAP 操作に含める制御セクションを識別します。指定したベース値
は CSECT についてのすべての VERIFY、REP、および SETSSI 操作が
処理されるまで有効です。
16-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
例: BASE 制御ステートメントの使用
この例では、BASE 制御ステートメントを使用して、開始アドレスがアセンブリー・リストのゼロ位置と一致し
ない CSECT を検査し修正する方法を示します。
//MODIFY
//STEP
//SYSPRINT
//SYSLIB
//SYSIN
NAME
BASE
IDRDATA
VERIFY
REP
DUMP
JOB
EXEC
DD
DD
DD
MSGLEVEL=(1,1)
PGM=AMASPZAP
SYSOUT=A
DSNAME=SYS1.LINKLIB,DISP=OLD
*
IEFMCVOL IEFCVOL2
0398
MOD04
039A 5820C010
039A 47000000
IEFMCVOL
IEFCVOL2
SYSLIB DD ステートメント: システム・ライブラリー、SYS1.LINKLIB を定義します。そのライブラリーは、
修正される CSECT IEFCVOL2 を含む、モジュール IEFMCVOL を含んでいます。
SYSIN DD ステートメント: SPZAP 制御ステートメントを含む入力ストリームを定義します。
NAME 制御ステートメント: このステートメントのすぐ後の制御ステートメントで定義する操作を、ロード・モ
ジュール IEFMCVOL 内の CSECT IEFCVOL2 で実行すべきことを SPZAP に指示します。
BASE 制御ステートメント: 続く VERIFY および REP ステートメントのオフセットを再調整するために使用す
るベース値を SPZAP に提供します。
IDRDATA 制御ステートメント: REP 操作が正しく行われた場合、SPZAP は、モジュール IEFMCVOL 内の
CSECT IEFCVOL2 に関する IDR を、データ MOD04 で更新します。
VERIFY 制御ステートメント: オフセット X'039A' のデータを検証するよう SPZAP に要求します。前の BASE
ステートメントで指定したベース値 X'0398' を、CSECT IEFCVOL2 内のデータの変位を判別するためにこのオ
フセットから減算します。そのため、SPZAP は CSECT IEFCVOL2 の開始から実際の変位 X'0002' バイトの位
置にあるデータを調べ、この制御ステートメントに指定した 16 進データと同じであることを確認します。デー
タが同じ場合、SPZAP は遭遇する順番に次のステートメントの処理を続けます。データが同じではない場合、
SPZAP は REP、SETSSI、または IDRDATA 機能は実行せず、 DUMP 操作のみを実行します。また、CSECT
IEFCVOL2 の 16 進イメージを SYSPRINT データ・セットにダンプします。
REP 制御ステートメント: SPZAP は、CSECT IEFCVOL2 の変位 X'0002' (オフセット 039A からベース値
0398 を引く) のデータをこの制御ステートメントに指定した 16 進データで置換します。
DUMP 制御ステートメント: CSECT IEFCVOL2 の 16 進イメージを SYSPRINT データ・セットにダンプする
よう SPZAP に要求します。REP ステートメントの後ろに DUMP ステートメントがあるので、そのイメージは
SPZAP (受け入れられなかった検査がないと想定します) が行った変更を反映します。
CCHHR レコード・アドレス
直接アクセス装置上の、修正され検査される物理レコードを識別します。レコー
ドは、 SYSLIB DD ステートメントで定義されたデータ・セット内にある必要
があります。REP または VERIFY ステートメントに続くすべてのステートメン
トは、指定したレコード内のデータを参照します。変数は次のとおりです。
第 16 章 SPZAP
16-27
SPZAP
レコード・アドレス
置換され検査されるデータを含むレコードの実際の直接アクセス・アドレ
ス。cccchhhhrr 形式の 10 桁の 16 進数として指定しなければなりません。
ここで、cccc はシリンダー、hhhh はトラック、および rr はレコード番号
です。たとえば、 0001000A01 はシリンダー 1、トラック 10 のレコード
1 をアドレスします。ゼロのレコード番号は誤りで、デフォルトの値は 1
です。
注: SPZAP への入力に複数の CCHHR ステートメントを定義することができま
す。ただし、各 CCHHR ステートメントに関連した VERIFY、REP および
SETSSI ステートメントは、適用する特定の CCHHR ステートメントのす
ぐ後ろに続く必要があります。
CHECKSUM [hhhhhhhh]
フルワード・チェックサム (パリティー検査) を印刷または検査するために使用
します。先行する CHECKSUM ステートメントまたは SPZAP 初期設定が、2
つのフルワードに分けられる単一のストリングに論理的に連結されるので、すべ
ての 16 進のオペランドの合計がチェックサムです。たとえば、ストリング
12345678FACE はチェックサム 0D025678 を生成します。各 CHECKSUM ステ
ートメントは累積したチェックサム値をゼロにリセットします。
CHECKSUM ステートメントは、修正の SPZAP タイプの転記の際に生じるこ
とがある書き誤りを検出するのに有効です。CHECKSUM はエラーを防ぐこと
はできません。メッセージを発行するのみです。CHECKSUM ステートメント
の処理時までに、すべての前の置換が行われます。
hhhhhhhh
チェックサムと比較する 8 つの 16 進文字。2 つの値が等しい場合は、チ
ェックサムが正しく、またリセットされたことを示すメッセージが書き出さ
れます。
オペランド欄がブランクの場合は、チェックサムの実際の値を指定し、その
チェックサムがリセットされたことを示すメッセージが書き出されます。
CHECKSUM 制御ステートメントのオペランドが正しくない場合は、すでに
処理された REP と SETSSI ステートメントには影響しません。
オペランドが有効ではない、またはチェックサムとは等しくない場合は、オ
ペランドが誤っているか、またはチェックサム・エラーである、というメッ
セージが書き出されます。続くすべての REP と SETSSI ステートメント
は、次の NAME または CCHHR ステートメントが検出されるまで無視さ
れます。直前に処理されたステートメントの結果は影響されません。
* (コメント)
ステートメント内の最初のブランク以外の文字がアスタリスクの場合は、
SPZAP はそのステートメントをコメントと見なし、SPZAP 入力ストリームと出
力一覧に注釈をつけるのに使用します。アスタリスクはどの場所にでも指定する
ことができますが、アスタリスクの次には少なくとも一つのブランクを続けなけ
ればなりません。
16-28
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
入力ストリームにはコメント・ステートメントを任意の数だけ含めることができ
ますが、コメント・ステートメントを継続することはできません。SPZAP が、
コメントを認識すると全ステートメントを SYSPRINT に指定したデータ・セッ
トに書き込みます。
CONSOLE
SPZAP 制御ステートメントがシステム・コンソールから入力されることを示し
ます。
このステートメントが入力ストリームで検出されると、次のメッセージが、オペ
レーターに書き出されます。
AMA116A
ENTER AMASPZAP CONTROL STATEMENT OR END
それからオペレーターは、この制御ステートメントの説明のはじめで説明した仕
様を順守する、任意の SPZAP 制御ステートメントを入力します。コンソールか
ら、オペレーターの入力を読み取り、検査し、処理するたびに、そのメッセージ
が再発行され、 “END” が応答されるまで、追加の入力をコンソールから入力す
ることができます。SPZAP は、ファイルの終わり条件が検出されるまで、入力
ストリームからの制御ステートメントの処理を続けます。
注:
1. 制御ステートメントは、コンソールから大文字、小文字のどちらを使用して
も入力することができますが、AMASPZAP は小文字の大文字変換はしませ
ん。
2. コンソールから入力した制御ステートメントを継続することはできません。
例: コンソールから SPZAP 制御ステートメントを入力する
この例では、SPZAP 制御ステートメントをコンソールから入力できるよう
にする方法を示します。
//CONSOLIN
JOB
//STEP
EXEC
//SYSPRINT
DD
//SYSLIB
DD
//SYSIN
DD
CONSOLE
/*
MSGLEVEL=(1,1)
PGM=AMASPZAP
SYSOUT=A
DSNAME=SYS1.LINKLIB,DISP=OLD
*
SYSLIB DD ステートメント: 更新するモジュールを含むデータ・セット
を定義します。
SYSIN DD ステートメント: 入力ストリームを定義します。
CONSOLE 制御ステートメント: SPZAP 制御ステートメントが、コンソ
ールから入力されることを示します。
{DUMP|DUMPT} member [csect | ALL | * ] [class-name]
PDS 内のロード・モジュールまたは PDSE 内のプログラム・オブジェクトの特
定の制御セクションまたはすべての制御セクションをダンプします。DUMP は
16 進の印刷出力のみを作成し、一方 DUMPT は 16 進データ、EBCDIC 変
第 16 章 SPZAP
16-29
SPZAP
換、およびデータと同等の簡略記号 ( 16-34 ページの『SPZAP 出力の読み取
り』 を参照) を印刷します。変数は次のとおりです。
member
ダンプする制御セクションを含む、PDS 内のロード・モジュール、または
PDSE 内のプログラム・オブジェクトのメンバー名。(注意: この変数、
‘member’ は、SYSLIB DD ステートメントで定義された PDS または PDSE
のメンバーの名前と対応していなければなりません。)
csect | ALL | *
ダンプする予定の特定の制御セクションの名前を定義します。 PDS 内のロ
ード・モジュール、または、PDSE 内のプログラム・オブジェクトのすべて
の CSECT をダンプするには、CSECT 名のかわりに “ALL” を指定しま
す。変数をすべて省略した場合、または、プログラム・オブジェクトの場合
のみ “*” をコーディングすると、SPZAP はロード・モジュールまたはプロ
グラム・オブジェクトの最初の CSECT だけをダンプするものと見なしま
す。
SPZAP がメンバー内で検索できない CSECT 名を指定した場合は、SPZAP
はメンバー内のすべての CSECT をダンプします。
注: スペース割り振り (DS ステートメント) のみを含む CSECT に DUMP
または DUMPT を適用すると、ステートメントの出力とダンプ完了メ
ッセージの間に出力は作成されません。
class-name
プログラム・オブジェクトに関してのみ、ダンプしたいテキストのクラスを
指示します。デフォルトは、B_ テキストです。B_*、C_*、または、D_*
を指定すると、SPZAP はアスタリスクの前にあるストリングで始まるすべ
てのテキスト・クラスをダンプします。CSECT 名を省略して、クラス名を
指定したい場合は、CSECT 名にアスタリスクを一つ指定してクラス名を続
けます。
クラス名に指定できる値については、「z/OS MVS プログラム管理: ユーザ
ーズ・ガイドおよび解説書」を参照してください。
注: SPZAP は、小文字入力を大文字に変換しませんので、クラス名を正し
い文字シフトで入力するように注意してください。
IDRDATA xxxxxxxx
SPZAP に、ロード・モジュール内の SPZAP CSECT 識別レコードに、最大 8
バイトのユーザー・データを置くよう指示します。これは NAME ステートメン
トと関連する REP 操作が実行され、ロード・モジュールをリンケージ・エディ
ターが処理して CSECT 識別レコードを含むようにされた場合にのみ行われま
す。変数は次のとおりです。
xxxxxxxx
8 バイト以下のユーザー・データ (埋め込まれたブランクなし) で、指定さ
れたロード・モジュールの SPZAP IDR のユーザー・データ・フィールド
に置かれます。 8 バイトを超える文字が変数フィールドにある場合は、最
初の 8 文字が使用されます。
16-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
注: IDRDATA ステートメントは、 NAME ステートメントとともに使用される
場合にのみ有効です。関連する NAME ステートメント、または NAME ス
テートメントと関連する BASE ステートメントの後ろに続いている必要が
あり、 DUMP、DUMPT、ABSDUMP または ABSDUMPT ステートメント
の前になければなりません。CCHHR ステートメントと関連した IDRDATA
ステートメントは無視されます。
NAME member [csect | * ] [class-name]
続く VERIFY、REP、SETSSI、または IDRDATA 操作のオブジェクトとなる、
PDS のロード・モジュール・メンバー、PDSE のプログラム・オブジェクト・
メンバー、あるいは z/OS UNIX ファイル内の CSECT を識別します。変数は
次のとおりです。
member
検査するか、修正するデータを含む CSECT を組み込んだ、PDS に属する
ロード・モジュール、PDSE に属するプログラム・オブジェクト、または
z/OS UNIX ファイルのメンバー名。ロード・モジュール、またはプログラ
ム・オブジェクトは、 SYSLIB DD ステートメントで定義したデータ・セ
ットのメンバーでなければなりません。
csect | *
検査または置換されるデータを含む特定の制御セクションの名前。この変数
を省略した場合、またはプログラム・オブジェクトの場合のみに “*” をコ
ーディングした場合、SPZAP は、PDS 内のロード・モジュール、PDSE 内
のプログラム・オブジェクト、または z/OS UNIX ファイルの最初の
CSECT が使用されるものと見なします。ロード・モジュールまたはプログ
ラム・オブジェクト内に CSECT が 1 つしかない場合は、この変数は不要
です。
SPZAP がメンバー内で検索できない CSECT 名を指定した場合は、SPZAP
は要求されているどのような処理も実行しません。そのかわりに、メンバー
内のすべての CSECT の 16 進ダンプを生成します。(ダンプされたテキス
トのクラスは、クラス名変数上に指定されており、デフォルトは B_ テキス
トです。)
class-name
プログラム・オブジェクトに関してのみ、変更したいテキストのクラスを指
示します。デフォルトは、B_ テキストです。CSECT 名を省略して、クラ
ス名を指定したい場合は、CSECT 名にアスタリスクを 1 つ指定してクラス
名を続けます。
クラス名に指定できる値については、「z/OS MVS プログラム管理: ユーザ
ーズ・ガイドおよび解説書」を参照してください。
注: SPZAP は、小文字入力を大文字に変換しませんので、クラス名を正し
い文字シフトで入力するように注意してください。
SPZAP への入力には、複数の NAME ステートメントを定義することができる
ことに注意してください。ただし、各 NAME ステートメントに関連した
VERIFY、REP および SETSSI ステートメントは、適用する NAME ステート
メントのすぐ後ろに続く必要があります。
第 16 章 SPZAP
16-31
SPZAP
NAME member
続く VERIFY、REP、ABSDUMP、ABSDUMPT または RECORD 操作のオブジ
ェクトになる、データ・ライブラリーのメンバーを識別します。変数は次のとお
りです。
member
データ・ライブラリーのメンバー名で、内容が表示され、検査と置換の一方
あるいは両方の対象となります。
RECORD nnnnnnnn
このステートメントは PDSE データ・ライブラリーのメンバー内の特定のレコ
ードを識別し、NAME member ステートメントに続く必要があります。ここで
member はメンバーの名前を指定します。NAME と RECORD の組み合わせは
VER|VERIFY と可能な場合 REP が実行されるレコードを定義します。
nnnnnnnn は 1 から 8 文字 の 10 進数からなり、調べる相対レコードを指定し
ます。先行ゼロは無視されます。たとえば、メンバー内の最初のレコードは 1
または 01 または 00000001 として指定できます。
REP offset data
NAME、NAME/RECORD 組み合わせ、または CCHHR ステートメントで前に
定義した、 CSECT または物理レコード内の指定した位置のデータのを修正し
ます。REP ステートメントに指定したデータの offset 変数フィールドで規定さ
れたレコードまたは CSECT 位置のデータを、置換します。
SPZAP はメッセージ AMA122I を発行し、変更が行われる前の特定の位置の内
容を記録します。
注: IBM では、データを置換する前に、REP 機能により変更しようとしている
内容が期待通りの内容であることを VER/VERIFY を使用して確認すること
をお勧めしています。ただし、VER/VERIFY ステートメントに指定するオ
フセットおよび長さは、次に続く REP ステートメントと正確に一致する必
要はありません。VERIFY が一つでも成功すれば、次に続く複数の REP ス
テートメントを検証することができます。
offset
CSECT またはデータ・レコード内で置換されるデータの 16 進変位を提供
します。この変位アドレスは フルワード境界をアドレスする必要はありま
せんが、 2 の倍数の桁数の 16 進数で指定する必要があります (0D、
02C8、001C52)。
オフセット値が、修正するデータ・レコード (物理ブロック) または
CSECT の範囲外の場合は、置換操作は実行されません。キー付きのレコー
ド内のデータを置き換える場合は、キーの長さを変位の計算に含める必要が
あります。すなわち、オフセット・ゼロは、キーの最初のバイトでデータの
部分ではありません。
data
その位置に挿入されるデータのバイトを定義します。オフセット変数の場合
と同様に、定義するデータのバイト数は、2 桁の 16 進数字の倍数として指
定する必要があります。必要であれば、変数内のデータはコンマ (ブランク
16-32
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
は不可) で分離することができます。ただし、コンマの間の桁数は 2 の倍
数でなければなりません。たとえば、REP データ変数は次のようになりま
す。
4160B820 (without commas)
または、以下のようになります
4160,B820 (with commas).
修正するすべてのデータが 1 つの REP ステートメント (72 バイト) に収
まらない場合は、別の REP ステートメントをコーディングすることができ
ます。
注:
1. SPZAP は、直前の NAME ステートメントで指定した、または暗黙的に指定
した CSECT を正しく修正した場合は、システム状況索引 (SSI) を自動的に
更新することを考慮してください。
2. 1 つの CSECT に複数の VERIFY と REP 操作を実行する場合は、すべて
の VERIFY ステートメントがすべての REP ステートメントの前にくるよう
にしてください。この手順を行うと、1 つの VERIFY が受け入れられない
場合に、すべての REP 操作を確実に無視することができます。
3. 最初の REP ステートメントの前に VERIFY ステートメントを指定する必要
はありません。ただし、SPZAP が VERIFY ステートメントを検知した時点
で、 SPZAP が続く REP 要求のいずれかの処理をする前に、その VERIFY
ステートメントは満たされていなければなりません。
4. 修正するために VTOC (たとえば、データ・セット制御ブロック (DSCB))
内のレコードをアクセスする場合は、 SPZAP がコンソールにメッセージ
AMA117D を発行します。ただし、VTOC で ABSDUMPT 操作を行う場合
は、メッセージは発行されません。
SETSSI xxyynnnn
PDS 内のロード・モジュール・メンバーまたは PDSE 内のプログラム・オブジ
ェクト・メンバーについてのディレクトリー項目に、ユーザー提供のシステム状
況情報を書き込みます。SSI 項目は、ロード・モジュールまたはプログラム・オ
ブジェクト・メンバーがリンク・エディットされた時に作成される必要がありま
す。変数は次のとおりです。
xxyynnnn
このメンバーの SSI フィールドに書き込みたい 4 バイトのシステム状況情
報です。各バイトは、次のように示される 2 つの 16 進数として提供され
ます。
xx
- 変更レベル
yy
- フラグ・バイト
nnnn - modification serial number
いずれかの直前の VERIFY または REP 操作で SPZAP がエラーを検出する
と、SETSSI 機能は実行されません。
注: SSI 項目内のすべてのビットが SETSSI ステートメントで設定 (リセット)
される訳ではないので、それを使用する場合は、重要な保守情報を変更しな
いように気を付けてください。 SPZAP はメッセージ SETSSI 操作が実行
される前の SSI の状態を記録するために AMA122I を発行します。 16-16
ページの『システム状況索引 (SSI) の更新』を参照してください。
第 16 章 SPZAP
16-33
SPZAP
{VERIFY|VER} offset expected-content
CSECT 内または物理レコード内の指定した位置の、データをステートメントに
指定したデータと比較します。
offset
検査するデータの CSECT またはレコード内での変位です。
この変位はフルワード境界に位置合わせする必要はありませんが、 0D、
021C、014682 などのように 2 の倍数の桁数 16 進数として指定する必要が
あります。このオフセット値が、前の NAME、 NAME/RECORD、または
CCHHR ステートメントで定義したデータ・レコードまたは CSECT の範囲
外の場合は、 VERIFY ステートメントは受け入れられません。この offset
値と予測される内容のストリングの長さを加えたものが、前の
NAME、NAME/RECORD の組み合わせ、または CCHHR ステートメントで
定義したデータ・レコードまたは CSECT の範囲外の場合は、 VERIFY ス
テートメントは受け入れられず、エラー・フラグが付けられます。キー付き
レコードを検査する場合は、キーの長さを変位の計算に含める必要がありま
す。すなわち、オフセット・ゼロはキーの最初のバイトです。
expected-content
指定した位置で予測されるデータのバイトを定義します。オフセット変数の
場合と同様に、定義するデータのバイト数は、2 桁の 16 進数字の倍数とし
て指定する必要があります。必要であれば、パラメーター内のデータを、コ
ンマ (ブランクは不可) で区切ることができますが、コンマの間の桁数は 2
の倍数でなければなりません。たとえば、予測される内容は次のようにする
ことができます。
5840C032 (without commas),
または、以下のようになります
5840,C032 (with commas)
すべてのデータが 1 つの VERIFY ステートメント (80 バイトの論理レコ
ード) に収まらない場合は、別の VERIFY ステートメントを定義しなけれ
ばなりません。
注: 比較している 2 つのフィールドが一致しない場合、すなわち、VERIFY 操
作が受け入れられない場合は、続く REP または SETSSI 操作は、次の
NAME または CCHHR 制御ステートメントが検出されるまで行われませ
ん。SPZAP は VERIFY 操作が失敗した各 CSECT またはレコードの定様
式ダンプを提供します。
SPZAP 出力の読み取り
検査されるか、または置換されたデータを検査する目的で、SPZAP は 2 つの異な
るダンプ・フォーマットを提供します。これらのダンプ (ユーザーが指定した
SYSPRINT データ・セットに書き出される) は、フォーマット設定された 16 進タ
イプ、または変換されたフォーマットになります。両方のフォーマットは、次にそ
れぞれのタイプがどのように見えるかを示す例を使って詳しく説明します。
フォーマット設定された 16 進ダンプ: DUMP または ABSDUMP を制御ステート
メントとして使用する場合は、結果の印刷出力は要求されたデータの 16 進表示で
す。 16-36 ページの図 16-5 は、フォーマット設定された 16 進ダンプのサンプルを
示します。ヘッディング行は、それぞれのブロックの始めに印刷されます。このヘ
16-34
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
ッディングは、ブロックの 16 進直接アクセス・アドレス (ABSDUMP のみ)、レコ
ード長、テキストのクラス (プログラム・オブジェクトのみ)、および 印刷されるデ
ータを含む CSECT とメンバーの名前 (ダンプが特定の CSECT またはロード・モ
ジュールの場合) で構成されます。各印刷行はその後、左に 3 バイトあけて、それ
ぞれ 4 データ・バイトの 8 グループが続く変位アドレスになります。次のメッセ
ージが、ダンプ印刷出力の最後の行の下に印刷されます。
AMA113I
COMPLETED DUMP REQUIREMENTS
変換されたダンプ: 制御ステートメント DUMPT と ABSDUMPT は命令コード変
換と、ダンプ内に含まれるデータの EBCDIC 表現も提供します。 16-36 ページの図
16-6 では、変換されたダンプのフォーマットを示します。データの各ハーフワード
の最初のバイトは、変換ができる場合はその簡略命令コードに変換されます。指定
された同等の簡略記号がない場合は、スペースはブランクのままです。このコード
の変換された行とブランクは、対応する 16 進行の下に直接印刷されます。データ
の各バイトの EBCDIC 表示は、それらのバイトが有効な印刷可能文字に変換されな
い場合は、ピリオドを使用して、テキストの対応する行の右に 2 行印刷されます。
第 16 章 SPZAP
16-35
SPZAP
DUMP
IEHMVESN ALL
**CCHHR000000
000020
000040
000060
000080
0000A0
0000C0
0000E0
000100
000120
000140
000160
000180
0001A0
0001C0
0001E0
000200
000220
000240
000260
000280
0022001108 RECORD LENGTH- 0850
47F0F014
0EC5E2D5 60E6D9C1
D04850D0 10045010
D00818D1
9200C2F4 D20EC2F5 C2F49108
9200C2FC D203C320 C31C95FF
951858EO 96484520
95705820
0A1495FF C3274780
910A9108
C2084710
90F89110
C2084710
0A1447F0
910A9180
C1FC4780
50210000
92B01000
0A1495FF
C2FC9200 C30094F7 A0429101
10149601
101748E0
F0044CE0
E0104110
F0000A0A 1B444340
918CD505 30041004
47F09192
000C1B14 41400001
D2031000
D2051004
301C1B33 403096FC
96FCD201 100A96FC 5010C224
47F09236
5810C224
95801002
00011932
4770922C
41220001
00105822
00284832
00005930
91023003
47109270
41220002
D2052004
C4122
000C5020
000600
000620
000640
000660
000680
0006A0
0006C0
0006E0
000700
41F0C014
F0004EE0
58E09648
00000708
96C25881
1000D24F
07FE58B0
4180C001
00000000
D205F000
C080F337
07FE1BDD
04000668
00001288
F000B000
C31C4100
41F00018
43A0400B
100441FF
F001C080
7FFF0000
41800668
478096D8
41BB0050
0280181B
50E09648
D760E4D7
5810D000
C20C4710
C32A4770
C2640700
C20C4710
90F80700
9168947F
C3344780
C2094780
F0069101
C2245810
D505301C
301095FF
D201100A
4240C224
47709236
402096FC
92B44780
47F09246
C2009640
MEMBER NAME IEHMVESN CSECT NAME IEHMVSSN
60606000
90ECD00C 189F5010
D0484110
9200D00C 92FFD008 9140C20A 4780904A
90E69500
C2FC4780 9064D203
C3009664
908A4180
C00141F0 001450E0
964845E0
45109098
00000000
50210000
92801000
91685820
C2749581
20114770
90D09102
451090D8
00000000
50210000
92801000
C1FC47F0 908A0700
45109100
00000000
96DC41A0 C0089200
C2F49200 C2F89200
91689102
C2094710
91685810
C27458F0
10204710
915E4100
E00847F0
91624100
C2245830
C27C4833 000E95FF 30024780
10044780
91E84111
000C4640
917A4140
30024780
91C0D205 10043004
47F091C6
96FC4130 00019580
10024780
91E24030
9110C208
47109204
9102C208
47109204
D20196FC 100A4820
96FC4122 00014130
D201100A 96FC9140 C2094710
92B85820
92B81233
47809268
91203012
47809268
D203C228 C2005820
C200D203 200030
C20947F0
C2004143
00
0006D201
96F0F004
58F09660
1BF8189F
95801008
50B0C320
41110000
45E09518
**CCHHR- 0022001108 RECORD LENGTH- 0850
000000
00000724
0000073F
00000750
000020
E340D9C5 C340D6D9 40E4D5D3
000040
C4C1E3C1 40E2C5E3 0F404040
000060
40E3D640 E5D6D3E4 D4C54DE2
000080
D640E5D6 D3E4D4C5 4DE25D51
0000A0 C1D9C540 D5D6E340 D4D6E5C5
0000C0 C2C5D340 E3D9C1C3 D240C1D3
0000E0 C5C8F3F3 F5C940D7 C5D9D4C1
000100
40E6D9C9 E3C9D5C7 40E4E2C5
000120
C5D3E24E 40D5D640 D4D6D9C5
000140
C5E2E2C5 C44B58B0
HMA1131 COMPLETED DUMPB REQUIREMENTS
00000761
C1C2C5D3
40404040
5D1CD5D6
C9C5C8F3
C461C3D6
D3D6C3C1
D5C5D5E3
D940D6E4
40D3C1C2
41FF0005
58FF0000
D503C31C
4770969A
1BBB43B0
0A0AD707
58E09648
41FF0001
D219C014
97004780
96FFC334
C32806B0
C31CC31C
45209570
4111000C
F0019200
96D89500
07FE58B0
42B0C328
1BFF07FE
47F09112
46009604
C33C07FE
C3284780
C32058F0
41F00008
9600C334
8CA00000
MEMBER NAME IEHMVESN CSECT NAME IEHMVSSN
00000775
00000793
000007E6
19E4D5C9
C5C440E3 C1D7C50F C9C5C8F3 F6F1C940
40C4C1E3 C140E2C5 E312C3D6 D7C9C5C4
E340D4D6 E5C5C460 C3D6D7C9 C5C440E3
F3F1C940 E4E2C5D9 40D3C1C2 C5D3E240
D7C9C5C4 4B40D5D6 40E4E2C5 D940D3C1
E3C5C440 C6D6D940 C9D5D7E4 E34B66C9
40C961D6 40C5D9D9 D6D940E6 C8C9D3C5
E3D7E4E3 40E3D9C1 C9D3C5D9 40D3C1C2
C5D3E240 E6C9D3D3 40C2C540 D7D9D6C3
図 16-5. フォーマット設定された 16 進ダンプの例
DUMPT IEANUC05 SUTFPL59
**CCHHR- 01AB000416
000000
000020
000040
000060
47F0
BC
18BF
LR
0014
F01C
SRP
41C0
LA
B362
LTXR
0000 0048
RECORD LENGTH- 000068
16E2
OR
BEFF
ICM
0048
E4E3
41F0
LA
ED22
ED-0000 0048
C6D7 D3F5
MVZ
0000 5800
L
A00C 0006
MEMBER NAME
F940 F9F8
CP
CP
B064 18A1
LR
ED32 B00C
ED--
IEANUC05
F1F0 F540
MVO
50D0 A004
ST
C00E 58D0
L
CSECT NAME
SUTFPL59
C8C2
C2F6 F6F0 F600
50A0
ST
D004
D008 98F1 D010
LM
98EC D00C 07FE
LM
BCR
90EC
STM
18DA
LR
0000
D00C
B365
LXR
0000
*.00..SUTFPL50 98*
*105 HBB6606.....*
*.......0........*
*&...&....1......*
*................*
*................*
*........
*
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I AMASPZAP PROCESSING COMPLETED
図 16-6. 変換されたダンプの例
16-38 ページの図 16-7 は、プログラム・オブジェクト・モジュールの CSECT 出力
(DUMP/DUMPT を介して獲得した出力) を示しています。
16-36
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP
注:
1. **CCHHR** 値はありません。プログラム管理バインダーは、独自の DASD ス
トレージを管理し、物理位置を戻しません。
2. **RECORD LENGTH : は CSECT またはモジュールの長さを示し、 CSECT ま
たはモジュールを含む物理レコードの長さは戻しません。
3. プログラム管理バインダーは、名前の付いた、または名前の付かない共通域用の
テキストは戻しません。共通セクションの長さが示されます。メッセージ
AMA152I はテキストが戻されなかったことを示します。
4. SPZAP は、MEMBER NAME と CSECT NAME を必要な行数だけ表示しま
す。名前の長さは、1024 文字までです。
5. SPZAP は、プログラム・オブジェクト内の共通ストレージに CSECT NAME で
はなく、タグ COMMON NAME でラベルを付けます。名前付き共通域がその名
前を表示します。無名共通域は $BLANK COMMON としフラグが付けられま
す。専用コードがサブ・ヘッダー CSECT NAME: $PRIVATE CODE を付けて表
示されます。
6. **UNINITIALIZED DATA SKIPPED が表示される場合があります。
7. IGWSPZAP は、PDS/E または z/OS UNIX ファイル内のプログラム・オブジェ
クト、または PDS/E 内のデータにアクセスするまたは更新するときに制御を受
け取る SPZAP の部分です。リストとメッセージは、PDS を処理するときには
AMASPZAP を参照し、PDSE または z/OS UNIX ファイルを処理するときには
IGWSPZAP を参照します。
第 16 章 SPZAP
16-37
SPZAP
IGWSPZAP INSPECTS, MODIFIES, AND DUMPS CSECTS OR SPECIFIC DATA RECORDS ON DIRECT ACCESS STORAGE.
DUMP
MAINRTN ALL
01770000
**RECORD LENGTH: 000000C0 CLASS: B_TEXT
00000000
00000020
00000040
00000060
00000080
000000A0
90ECD00C
07FE0000
00000000
00000000
C6C9D5C5
40404040
05C050D0
00000000
00000000
00000000
C440C9D5
40404040
C02241E0
00000000
00000000
00000000
40C140E4
40404040
**RECORD LENGTH: 00000058 CLASS: B_TEXT
MEMBER NAME:
CSECT NAME:
C01E50E0
00000000
00000000
E3C8C9E2
D5D5C1D4
40404040
MAINRTN
$PRIVATE CODE
D00818DE 58D0D004
00000000 00000000
00000000 00000000
40C9E240 C140D4C5
C5C440C3 E2C5C3E3
40404040 40404040
58E0D00C
00000000
00000000
E2E2C1C7
40404040
40404040
980CD014
00000000
00000000
C540C4C5
40404040
001E8000
FF800A23
58D0C062
00000001
00000001
E240C6D9
40404040
40404040
D5D6E640
58B0C0A6
98ECD00C
00000001
00000001
D6D440E3
40404040
40404040
MEMBER NAME: MAINRTN
COMMON NAME: AAAAAAAA
AMA152I NO TEXT DATA FOR THIS SECTION
**RECORD LENGTH: 00000108 CLASS: B_TEXT
00000000
00000020
00000040
00000060
00000080
000000A0
000000C0
000000E0
00000100
90ECD00C
C9D540E3
D24FB004
07FE0000
00000001
00000001
C8C540E4
40404040
00500000
05C050D0
C8C540C3
C0AA9200
00000001
00000001
00000001
D5C3D6D4
40404040
00000000
C06241F0
C1D3D3C5
B002D201
00000001
00000001
00000001
D4D6D540
40404040
**RECORD LENGTH: 00000058 CLASS: B_TEXT
MEMBER NAME:
CSECT NAME:
C05E50FD
C440D9D6
B000C0FA
00000001
00000001
00000448
40404040
40404040
MAINRTN
SUBRTN
000818DF
E4E3C9D5
184B1814
00000001
00000001
C7D9C5C5
40404040
40404040
4510C034
C5400000
0A231BFF
00000001
00000001
E3C9D5C7
40404040
40404040
MEMBER NAME: MAINRTN
COMMON NAME: $BLANK COMMON
AMA152I NO TEXT DATA FOR THIS SECTION
**RECORD LENGTH: 00000168 CLASS: B_TEXT
00000000
00000020
00000040
00000060
00000080
000000A0
000000C0
000000E0
00000100
00000120
00000140
00000160
90ECD00C
D24FC0B6
C10A9200
1BFF07FE
00000000
00000000
E3C9D5C7
D4C1C9D5
40404040
C5D9E240
40404040
00000340
05C050D0
50001814
B002D201
00000000
00000000
00000000
E240C6D9
40E2C5C3
40404040
C3D6D4D4
40404040
00500000
C06241F0
0A235850
B000C15E
00000000
00000000
00000000
D6D440E3
E3C9D6D5
40404040
D6D540E2
40404040
**RECORD LENGTH: 000000C0 CLASS: B_TEXT
00000000
00000020
00000040
00000060
00000080
000000A0
90ECD00C
07FE0000
00000000
00000000
40C9D540
40404040
05C050D0
00000000
00000000
00000000
C1D5D6E3
40404040
C02241E0
00000000
00000000
00000000
C8C5D940
40404040
MEMBER NAME:
CSECT NAME:
C05E50F0
C0AED24F
184B1814
00000000
00000000
00000168
C8C540C3
40404040
00000000
C5C3E3C9
40404040
MAINRTN
MAINRTN
D00818DF
C0B65000
0A2358F0
00000000
00000000
8000022C
C1D3D3C9
40404040
C8C940C6
D6D54040
40404040
4140C0B2
18140A23
C15A05EF
00000000
00000000
800002EC
D5C740D9
40404040
D9D6D440
40404040
40404040
18140A23
58B0C0A6
58D0C062
00000000
00000000
00500000
D6E4E3C9
40404040
E3C8C540
40404040
40404040
5850C0AA
D24FB004
98ECD00C
00000000
00000000
C7D9C5C5
D5C5E240
40404040
C3C1D3D3
40404040
40404040
MEMBER NAME:
CSECT NAME:
C01E50E0
00000000
00000000
E3C8C9E2
C3E2C5C3
40404040
MAINRTN
$PRIVATE CODE
D00818DE 58D0D004
00000000 00000000
00000000 00000000
40C9E240 C4C1E3C1
E340E6C9 E3C840D5
40404040 40404040
58E0D00C
00000000
00000000
40C4C5C6
D640D5C1
40404040
980CD014
00000000
00000000
C9D5C5C4
D4C54040
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I IGWSPZAP PROCESSING COMPLETED
図 16-7. PDSE プログラム・オブジェクト・モジュールについてフォーマット設定された 16
進ダンプの例
図 16-8 は PDSE データ・ライブラリーのメンバーの出力を示します。ABSDUMPT
0001 0500 の前には NAME membername ステートメントがあるはずです (表示され
ません)。
注: **CCHHR** 値はありません。RECORD NUMBER: は、印刷するメンバーの相
対レコード番号の 8 桁値を示します。RECORD LENGTH: は、レコード長を示
し、 MEMBER NAME: は NAME membername ステートメントに指定されたと
おりのメンバー名を表示します。
16-38
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
IGWSPZAP INSPECTS, MODIFIES, AND DUMPS CSECTS OR SPECIFIC DATA RECORDS ON DIRECT ACCESS STORAGE.
NAME
USERDATA
03520001
ABSDUMPT 0001 0050
03530001
**RECORD NUMBER: 0000000001, RECORD LENGTH: 000050
000000 02C5 E2C4 4040 4040 4040 0030 4040 0001
STH STH STH
STH
000020 E7E3 D5C4 E2E3 D240 0200 0000 4040 4040
CLC
MVC
STH STH
000040 4040 4040 4040 4040 F0F2 F4F8 F0F0 F0F1
STH STH STH STH SRP
SRP SRP
MEMBER NAME: USERDATA
C7C5 E3C3 E2C5 C3E3 0000 0000 0200 0530
BALR
E2E3 C1D9 E3C4 4040 0200 0000 4040 4040
STH
STH STH
**RECORD NUMBER: 0000000002, RECORD LENGTH: 000050
000000 02C5 E2C4 4040 4040 4040 0020 4040 0004
STH STH STH
STH
000020 D7C1 D4C1 F1F4 F0C9 0200 0000 4040 4040
XC NC
MVO SRP
STH STH
000040 4040 4040 4040 4040 F0F2 F4F9 F0F0 F0F1
STH STH STH STH SRP
SRP SRP
MEMBER NAME: USERDATA
D7D9 D5E3 D3C9 D5C5 0200 0000 4040
XC CLC MVZ CLC
STH
4040 4040 4040 4040 4040 4040 4040
STH STH STH STH STH STH STH
**RECORD NUMBER: 0000000003, RECORD LENGTH: 000050
000000 02E3 E7E3 4000 0000 4040 0038 4040 0001
STH
STH
STH
000020 F24B F2F4 F400 90EC D00C 18CF 1FFF 43F0
PACK PACK
STM
LR
SLR IC
000040 0000 190F 47D0 C050 F0F2 F5F0 F0F0 F0F1
CR
BC
SRP
SRP SRP
MEMBER NAME: USERDATA
47F0 F016 10C7 C5E3 C3E2 C5C3 E340 40F9
BC SRP LPR
STH
C52C 1F00 BF07 C52D 581D 0008 1A01 58FD
SLR ICM
L
AR L
4040
STH
4040
STH
*.ESD............*
*USERDATA........*
*XTNDSTK.........*
*STARTD..........*
*........02480001*
*................*
*.ESD............*
*PRNTLINE........*
*PAMA140I........*
*................*
*........02490001*
*................*
*.TXT............*
*.00..USERDATA..9*
*2.244..........0*
*E.....E.........*
*.......&02500001*;
*................*
....
**RECORD NUMBER: 0000000028, RECORD LENGTH: 000050
000000 02D9 D3C4 4040 4040 4040 0020 4040 4040
MVZ STH STH STH
STH STH
000020 0004 0001 0C00 046C 0005 0001 0C00 0470
BASSM SPM
BASSM SPM
000040 4040 4040 4040 4040 F0F2 F7F5 F0F0 F0F1
STH STH STH STH SRP
SRP SRP
MEMBER NAME: USERDATA
0002 0001 1C00 003C 0003 0001 0C00 0468
MR
BASSM SPM
4040 4040 4040 4040 4040 4040 4040 4040
STH STH STH STH STH STH STH STH
**RECORD NUMBER: 0000000029, RECORD LENGTH: 000050
000000 02C5 D5C4 4040 4040 4040 4040 4040 4040
CLC STH STH STH STH STH STH
000020 F2F5 F6F6 F8F9 F6F2 F0F1 40F0 F2F0 F1F9
PACK
ZAP
SRP STH PACK MVO
000040 F0F4 F9F2 F2F4 F440 F0F2 F7F6 F0F0 F0F1
SRP CP
PACK
SRP
SRP SRP
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I IGWSPZAP PROCESSING COMPLETED
MEMBER NAME: USERDATA
4040 4040 4040 4040 4040 4040 4040 4040
STH STH STH STH STH STH STH STH
F2F2 F4F4 C37D D7D3 61C1 E27D 4040 F0F1
PACK
XC
STH SRP
*.RLD............*
*................*
*.......%........*
*................*
*........02750001*
*................*
*.END............*
*................*
*2566896201.02019*
*2244C’PL/AS’..01*
*0492244.02760001*
*................*
図 16-8. PDSE データ・ライブラリーの変換されたダンプの例
第 16 章 SPZAP
16-39
16-40
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 17 章 AMATERSE
|
|
|
|
AMATERSE は問題プログラム状態で実行する保守援助プログラムです。データ・
セットのコピーを別のサイトに送信する場合、特に FTP を送信手段として使用する
場合など、AMATERSE を使用して圧縮できます。補完的な解凍サービスが提供さ
れていて、受信サイトで同様のデータ・セットを作成します。
|
以下のトピックで、AMATERSE について説明します。
|
v 『AMATERSE の計画』
|
v 『AMATERSE の起動』
|
v
17-3 ページの『問題プログラムから AMATERSE を起動する』
|
v
17-4 ページの『制約事項』
|
v
17-5 ページの『割り振りの考慮事項』
|
v
17-5 ページの『スペースの考慮事項』
|
|
AMATERSE の計画
|
|
|
|
AMATERSE は、z/OS ダンプやトレースなど、診断資料を IBM やベンダーのサイ
トへ送信する準備をするためのアプリケーションです。資料が届くと、AMATERSE
は同様のデータ・セットを作成する手段を提供して、問題の診断をサポートしま
す。
|
|
|
TRSMAIN ユーティリティー (http://techsupport.services.ibm.com/390/trsmain.html を参
照) を以前使用したことがある場合は、 AMATERSE を z/OS に正式に取り込む準
備として以下の変更が行われたことがわかるでしょう。
|
|
|
v TRSMAIN ではなく AMATERSE がアプリケーションのプログラム名として優先
して使用されています。TRSMAIN は AMATERSE への別名のエントリー・ポイ
ントとして出荷されています。
|
|
|
|
v TRSMAIN ユーティリティーで要求された DD 名 INFILE および OUTFILE
は、それぞれ SYSUT1 および SYSUT2 に置き換えられました。AMATERSE の
TRSMAIN エントリー・ポイントを起動した場合は、 DD 名 INFILE および
OUTFILE がデフォルトとして残ります。
|
|
v AMATERSE は、リンク・リストの一部であるライブラリー MIGLIB に入れられ
ます。AMATERSE を起動するのに、STEPLIB の DD 名は必要ありません。
|
|
|
v ほとんどすべての場合において、AMATERSE、TRSMAIN ユーティリティー、
VM terse を交換して使用できます。この規則の例外については、 17-4 ページの
『制約事項』 を参照してください。
|
|
|
|
|
AMATERSE の起動
17-2 ページの図 17-1 は、AMATERSE を起動する JCL の例を示しています。小文
字のテキストは、変更が必要なデータを示しています。
© Copyright IBM Corp. 1988, 2008
17-1
AMATERSE
|
|
|
|
|
|
//jobname JOB
//stepname
//SYSPRINT
//SYSUT1
//SYSUT2
//
|
|
|
|
|
|
|
|
...
EXEC PGM=AMATERSE,PARM=aaaaa
DD SYSOUT=*,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=12901)
DD DISP=bbb,DSN=your.input.dataset.name
DD DISP=ccc,DCB=ddd,DSN=your.output.dataset.name
SPACE=space_parameters
図 17-1. AMATERSE JCL の例
以前に TRSMAIN プログラムを使用して AMATERSE を起動した場合は、前の
DD 名を使用し続けることができます。しかし、TRSMAIN ではなく AMATERSE
を使用することを選んだ場合は、DD 名が変更されていることに注意してくださ
い。INFILE がSYSUT1 に、OUTFILE が SYSUT2 に置き換わっています。
EXEC ステートメントのパラメーター
|
例の aaaaa を以下の値のうちの 1 つで置き換えます。
|
|
PACK データ・セットのレコードを、シンプル・フォーマットと呼ばれる出力にな
るよう圧縮します。
|
|
|
|
SPACK
データ・セットのレコードを、コンプレックス・フォーマットと呼ばれる出
力になるよう圧縮します。SPACK オプションは、PACK オプションよりも
約 3 倍時間がかかりますが、多くの場合、出力はずっと小さくなります。
|
|
|
重要: PACK または SPACK で圧縮されたデータ・セットは、決して変更
してはいけません。それらのデータ・セットが変更されると、UNPACK ル
ーチンが元のデータ・セットを再構成できなくなります。
|
|
|
|
UNPACK
PACK または SPACK の操作の逆を行います。データ・セットをうっかり
複数回圧縮してしまった場合は、 UNPACK 機能を同じ回数使用して復元し
ます。
|
DD ステートメントについての追加情報
|
DD 名 SYSPRINT、SYSUT1 および SYSUT2 が必要です。
|
|
v SYSUT1 DD ステートメントが欠落していると、RC X'10' エラー・メッセージが
表示されます。
|
RC X’10’, AMA522E INPUT DATASET HAS AN UNSUPPORTED DATASET ORGANIZATION
v SYSUT2 DD ステートメントが欠落していると、RC X'28' エラー・メッセージが
表示されます。
|
|
|
RC X’28’, AMA518E UNABLE TO OPEN OUTPUT DATASET
|
|
|
|
|
SYSPRINT ステートメント
この DD は、すべてのメッセージがプログラムのどこから送信されるかを
定義します。これは RECFM=FBA および 121 から 133 の間の LRECL で
あることが必要です。LRECL のリーガルな倍数のブロック・サイズはいず
れもサポートされます。
|
|
注: DCB 情報は DD ステートメントで指定される必要はなく、正しい値に
デフォルト設定されます。
17-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMATERSE
SYSUT1 ステートメント
この DD は、PACK または SPACK パラメーターが EXEC ステートメン
トで指定されている場合に、データ・セットが圧縮されることを定義しま
す。UNPACK が指定されている場合は、圧縮されたデータ・セットが復元
されることを定義します。特別な考慮事項については、 17-4 ページの『制
約事項』を参照してください。
|
|
|
|
|
|
注: TRSMAIN エントリー・ポイントが使用される場合は、 INFILE ステー
トメントが SYSUT1 の代わりに使用されます。
|
|
SYSUT2 ステートメント
この DD は、データ・セットが圧縮された出力を受信することを定義しま
す。PACK または SPACK が EXEC ステートメントで指定されている場
合、これは圧縮された出力を受信するデータ・セットです。UNPACK が指
定されている場合は、これは復元された出力を受信するデータ・セットで
す。 17-5 ページの『割り振りの考慮事項』および 17-5 ページの『スペース
の考慮事項』を参照してください。
|
|
|
|
|
|
|
|
戻りコード
|
|
AMATERSE が終了すると、次のいずれかの戻りコードが汎用レジスター 15 に置
かれます。
|
コード 意味
|
0
正常終了。
|
4
ファイル操作のエラー。
|
8
ファイル操作のエラー。
|
10
サポートされないデータ・セット・フォーマット。
|
12
指定されたデータ・セットで操作が行えません。
|
16
無効な入力が指定されました。
|
20
無効な入力が指定されました。
|
24
ファイル操作の重大エラー。
|
28
ファイル操作の重大エラー。
|
32
無効なデバイス。
|
36
バッファー・ストレージに障害が起きました。
|
64
重大エラー。1111 で異常終了。
|
99
システムまたはユーザーの異常終了が発生しました。
|
|
問題プログラムから AMATERSE を起動する
|
プログラムから AMATERSE を起動するには、以下の情報を指定します。
|
|
v EXEC ステートメントの PARM パラメーターにおける PACK または SPACK
または UNPACK
|
|
v 呼び出し側プログラムが DD 名をオーバーライドする場合は、AMATERSE プロ
グラムで処理されるデータ・セットの DD 名。
第 17 章 AMATERSE
17-3
AMATERSE
図 17-2は、サポートされているすべての代替 DD 名を使用して AMATERSE を起
動する方法を示しています。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*
Invoke AMATERSE to perform SPACK processing
LINK EP=AMATERSE,PARAM=(PARM,DDNAMES),VL=1
.
.
.
*
PARM
PARMLEN
PARMTEXT
*
*
*
DDNAMES
DDNAMEL
DDNAMTT
Request SPACK option
DS
0H
EXEC PARM= data
DC
Y(L’PARMTEXT) Length of data
DC
C’SPACK’
AMATERSE processing option
Request MYPRINT, MYSYSUT1, and MYSYSUT2 instead
of SYSPRINT, SYSUT1, and SYSUT2 respectively
DS
0H
DDNAME override data
DC
Y(DDNAME9-DDNAMET) Length of data
DS
0C
DDNAME override list
DC
5XL8’0’
Not used by AMATERSE
SYSPRINT DC
CL8’MYPRINT’ Instead of SYSPRINT
DC
XL8’0’
Not used by AMATERSE
SYSUT1
DC
CL8’MYSYSUT1’ Instead of SYSUT1
SYSUT2
DC
CL8’MYSYSUT2’ Instead of SYSUT2
DDNAME9 DS
0C
End of list
図 17-2. AMATERSE のパラメーター
このタイプのパラメーター・リストのより正式な記述については、z/OS DFSMSdfp
Utilitiesの「アプリケーション・プログラムからユーティリティー・プログラムを起
動する」を参照してください。AMATERSE はその章で「optionsaddr」および
「ddnameaddr」と呼ばれるものをサポートします。そこに記載されているように、
「hdingaddr」はサポートされません。DD 名 SYSPRINT、SYSUT1、および
SYSUT2 は AMATERSE でサポートされています。そこに示されている DD 名
SYSIN、SYSUT3、および SYSUT4 は、サポートされません。
制約事項
|
|
v 順次データ・セットはサポートされます。VSAM データ・セットおよび直接
(DSORG=DA) データ・セットはサポートされません。
|
|
|
|
|
v 区分データ・セットは、MVS AMATERSE のみによりサポートされます。 MVS
の AMATERSE で圧縮されて VM に送信された PDS は、AMATERSE で復元
できません。これにより、VM TERSE から戻りコード 1007 または 1009 が戻さ
れます。PDS は直接アクセス・ストレージ・デバイス (DASD) へ圧縮すること
が必要です。
|
|
v 拡張区分データ・セット (PDSE) は、MVS AMATERSE のみによりサポートされ
ます。
|
|
|
v AMATERSE で復元されたファイルで LRECL が 32K より大きいものは処理さ
れません。ただし、 RECFM=VBS データ・セットは最大 64K LRECL まで可能
です。
|
|
v ラージ・フォーマット (DSNTYPE=LARGE) データ・セットは、AMATERSE を
圧縮と復元の両方で使用することが必要な場合があります。
|
|
v FB レコード・フォーマットのデータ・セットは、FBS データ・セットに圧縮お
よび解凍することができます。しかし、解凍操作中には、空ではない DISP=MOD
17-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMATERSE
|
|
|
|
の出力データ・セットの拡張は、FB データ・セットとなるのでできません。こ
れに対してエラー・メッセージが発行されます。
割り振りの考慮事項
|
|
|
|
|
AMATERSE で圧縮された (PACK または SPACK で作成された) データ・セット
は、固定長またはブロックされた固定長のフォーマット (RECFM) で、レコード長
(LRECL) が 1024、リーガル・ブロック・サイズ (BLKSIZE) はいくつでもかまいま
せん。これらの値は、DD ステートメントで明示的に指定される必要はありませ
ん。
|
|
|
|
|
|
|
|
AMATERSE で復元された (UNPACK で作成された) データ・セットは、元の
RECFM および LRECL と一致することが必要です。DCB 情報は DD ステートメ
ントには入れず、AMATERSE プログラムに設定させるようにします。既存のデー
タ・セットに解凍する場合は、DCB パラメーターで互換性の確認がされます。
RECFM は、可変から未定義、および未定義から可変を除くすべての場合におい
て、同じであることが必要です。元が可変 (V) フォーマットのデータを未定義 (U)
フォーマットに、またはその逆にするよう DCB パラメーターを指定すると、警告
メッセージが書き込まれ、操作が行われます。
|
|
スペースの考慮事項
|
|
出力データ・セット SYSUT2 にスペースを割り振るときに、必要なサイズ情報を推
定する必要があります。
|
|
|
|
v PACK または SPACK オプション: AMATERSE で圧縮されたデータ・セット
は、元のサイズの約半分になると予想されます。予想よりも大きなサイズを割り
振り、SPACE 値に RLSE 関数を使用して、使用しない部分を解放してシステム
に戻します。
|
|
|
|
v UNPACK オプション: データ・セットにランダムなデータが入っている場合は、
圧縮されたデータ・セットのサイズの 3 倍から 5 倍を割り振ります。データ・
セットにリスト、文書、メッセージのタイプのデータが入っている場合は、圧縮
されたデータ・セットのサイズの 5 倍から 10 倍を割り振ります。
|
割り振られたスペースが不十分な場合、ABEND X'B37' が発行されます。
|
Not Enough Space Allocated for the Output Data Set
第 17 章 AMATERSE
17-5
AMATERSE
17-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
|
第 18 章 ダンプの抑制
システムは必要がないダンプを要求することがあります。不要なダンプでシステ
ム・リソースが使われないようにするために、それらを抑制してください。不要な
ダンプの理由とそれらを抑制する方法は、次のとおりです。
v 重複ダンプ。システムは再発する問題についてダンプを要求することがありま
す。問題が最初に起きた時に書き出されたダンプを、診断で使用することができ
ます。追加のダンプは不要です。また、問題が 1 つに関して、システムが複数の
ダンプを要求することがあります。再発する問題の診断が完了しても、修正はシ
ステムにはまだ実際に行われていません。
重複ダンプを避けるために、ダンプ分析重複回避機能 (DAE) を使用してくださ
い。『DAE を使用してダンプを抑制』を参照してください。
v 特定の異常終了コードについてのダンプ。いくつかの異常終了コードの場合、続
くメッセージで必要な問題データが提供されます。これらの異常終了コードのダ
ンプを除くために、SLIP を使用してください。 18-12 ページの『ダンプを抑制す
るために SLIP コマンドを使用する』を参照してください。
v アプリケーション・プログラムの異常終了についてのダンプ (必要ない場合)。
18-13 ページの『ダンプを抑制するために ABEND マクロを使用する』を参照し
てください。
v インストール・システムでは不要であると判断したダンプ。特定のダンプを不要
であると判断する場合は、インストール・システム出口についてルーチンをコー
ディングして、これらのダンプを抑制することができます。 18-13 ページの『ダ
ンプを抑制するためにインストール・システム出口ルーチンを使用する』を参照
してください。
このトピックでは、予測されるダンプを抑制する方法についてリストし、意図した
ダンプを受け取らなかった理由を説明します。 18-14 ページの『ダンプが抑制され
る理由の判別』を参照してください。
DAE を使用してダンプを抑制
ダンプ分析重複回避機能 (DAE) は、すでに持っているダンプと重複するダンプを抑
制します。DAE が重複するダンプを抑制するたびに、システムは重複したデータを
集めたり、データ・セットに重複したものを書き出すことはありません。この方法
では、DAE は重複しないもののみをダンプして、ダンプの数を最小化することによ
り、ダンプ管理の効率を改善します。
この項目では DAE を使用してダンプを抑制する方法を次の手順で説明します。
v
18-2 ページの『ダンプ抑制の実行』
– 18-5 ページの『頻繁に再発するダンプを管理する』
v
18-6 ページの『DAE ダンプ抑制の計画』
– 18-6 ページの『ADYSETxx parmlib メンバーの選択と作成』
– 18-8 ページの『DAE データ・セットの定義』
v
18-9 ページの『DAE データ・セットのアクセス』
– 18-10 ページの『抑制ダンプを生成する』
© Copyright IBM Corp. 1988, 2008
18-1
ダンプ抑制
v
18-12 ページの『DAE の停止、開始、および変更』
参照
v 症状と症状ストリングについては、「z/OS MVS 診断: 解説書」を参照してくださ
い。
v ADYSETxx と IEACMD00 parmlib メンバーについては、「z/OS MVS 初期設定
およびチューニング 解説書」を参照してください。
v VERBEXIT DAEDATA サブコマンドについては、「z/OS MVS IPCS コマンド」
を参照してください。
v データ・セット逐次化については、「z/OS MVS 計画: グローバル・リソース逐次
化」を参照してください。
v データ・セットへのアクセスを制御する方法については、「z/OS Security Server
RACF コマンド言語 解説書」を参照してください。
ダンプ抑制の実行
ダンプ抑制を実行するために、使用できるデータがある場合 DAE は症状ストリン
グを構築します。症状ストリングに最小の問題データを含んでいる場合は、DAE は
症状ストリングを使用して、ソフトウェア・エラーに関して要求される重複した
SVC ダンプまたは SYSMDUMP ダンプを認識します。インストール・システム・
パラメーターで抑制を要求する場合、 DAE は重複しているダンプを抑制します。
次に DAE 処理を説明します。
1. DAE は問題データを入手します。DAE はシステム診断作業域 (SDWA) または
ダンプを要求する SDUMP または SDUMPX マクロ内の SYMREC パラメータ
ー内の値からデータを受信します。
v ESTAE ルーチンまたは障害を起こしたプログラムの機能リカバリー・ルーチ
ン (FRR) はモジュール・レベルの情報、たとえば障害を起こしたロード・モ
ジュール名と障害を起こした CSECT 名などの情報を提供します。
v システムは、異常終了コードと理由コード、障害を起こした命令、およびレジ
スター/PSW の相違などのシステム・レベル・データを提供します。
障害を起こしたコンポーネントが、障害を起こしたロード・モジュール名また
は CSECT 名を提供しない場合、可能であれば、システムが名前を判別しま
す。この場合、名前は IEANUC0x となります。
2. DAE は症状ストリングを形成します。DAE は症状を形成するために問題データ
の各フィールドに説明キーワードを追加します。DAE は RETAIN 症状ではなく
MVS 症状を形成します。DAE は要求されたダンプ用の症状を症状ストリングに
結合します。
次の表には必須とオプションの症状を示します。SDWA フィールド名は、障害
を起こしたプログラムがダンプの抑制をするために、提供する必要がある症状を
指定します。表には MVS と RETAIN® 症状の両方があるので、DAE が使用す
る MVS 症状を、ユーザーが RETAIN データベースを検索するために使用する
RETAIN 症状と関連付けることができます。MVS 症状ストリングは、ヌルでは
ない症状を最低 5 つ含まなければなりません。DAE はテーブルに示す順で症状
をストリングに置きます。
必須症状 は最初に必ず存在しなければなりません。
18-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
症状
SDWA フィールド
MVS キーワード
RETAIN キーワード
障害を起こしたロード・モ
ジュールの名前
SDWAMODN
MOD/name
RIDS/name#L
障害を起こした CSECT 名
SDWACSCT
CSECT/name
RIDS/name
オプションの症状 は必須症状の後になければなりません。DAE は有効な症状ス
トリングを作成するために、これらのオプションの症状を、最低 3 つは必要で
す。
症状
SDWA フィールド
MVS キーワード
RETAIN キーワード
コンポーネント ID ベース
を持つプロダクト/コンポー
ネント ID
SDWACID、SDWACIDB
PIDS/name
PIDS/name
システム完了 (異常終了) コ
ード
AB/S0hhh
AB/S0hhh
ユーザー完了 (異常終了) コ
ード
AB/Udddd
AB/Udddd
REXN/name
RIDS/name#R
障害を起こした命令域
FI/area
VALU/Harea
PSW/レジスター差
REGS/hhhhh
REGS/hhhhh
異常終了コードを伴う、ま
たはダンプを要求したマク
ロの REASON パラメータ
ーからの理由コード
HRC1/nnnn
PRCS/nnnn
SUB1/name
VALU/Cname
リカバリー・ルーチン名
SDWAREXN
サブコンポーネントまたは
モジュール副次機能
SDWASC
3. DAE はダンプの症状ストリングを直前の同じタイプのすなわち SVC ダンプま
たは SYSMDUMP の症状ストリングと比較させようとします。DAE が一致を
検出すると、DAE はダンプが重複していると見なします。
|
|
|
|
DAE が開始すると、使用されるアクティブな症状ストリングを選択して、どの
ダンプを抑制するかを決めます。アクティブな症状とは、ストリングがこの 60
日間に固有なダンプについて作成されたか、またはそのダンプ・カウントがこの
60 日間に更新されたものです。
シスプレックス内のシステムは、 DAE データ・セットを共有して、シスプレッ
クス間で重複したダンプを抑制します。シスプレックス内の各システムは、独自
の DAE データ・セットを使用することができますが、次のような理由で、シス
プレックス内のシステムで DAE データ・セットを共有することをお勧めしま
す。
v DAE はダンプを 1 つのシステムに書き出し、シスプレックス内のほかのシス
テムで重複しているものを抑制することができます。
v 各システム用のデータ・セットではなく、DAE 専用のデータ・セットだけが
必要になります。
第 18 章 ダンプの抑制
18-3
ダンプ抑制
データ・セットについてのお勧めする名前も含め、詳しい情報は 18-8 ページの
『DAE データ・セットの定義』を参照してください。
4. DAE はストレージ内の症状ストリングを更新し、ダンプがダンプ・データ・セ
ットに書き出されるときに、更新が必要な DAE データ・セット内の症状ストリ
ングを更新します。
v 重複しない症状ストリングについては、DAE は新しいレコードを追加しま
す。レコードは症状ストリング、最初と最後のオカレンスの日付、オカレンス
の番号についてのイベント・カウント、およびストリングを提供するシステム
の名前を含んでいます。
v 重複する症状ストリングの場合は、DAE はストリングのイベント・カウン
ト、最後のオカレンス日付、およびストリングを検出した最後のシステムの名
前を更新します。
更新が要求される場合は、DAE はキャプチャーされたダンプについて着信ダン
プ要求を検査します。着信ダンプ症状ストリングがキャプチャーされたダンプ・
キュー上の任意のダンプと一致する場合は、更新は抑制されます。 DAE デー
タ・セットが更新されると、更新が行われます。
シスプレックス内では、ほかのシステムのストレージ内ストリングへの変更は共
有 DAE データ・セットが更新された後で行われます。誤動作が複数システム上
でほぼ同時に発生する場合は、複数のダンプが生成されます。ただし、システム
ごとに 1 つです。ほかのシステムでのダンプは、ダンプの 1 つが書き出された
後で抑制され、 DAE データ・セットが更新され、さらに更新が別のシステムに
伝搬します。
元のダンプを持つシステムが、キャプチャーしたダンプを書き出す前に失敗する
と、ダンプは次に要求された時に抑制されません。
5. DAE がダンプの抑制を行える場合、 DAE は重複ダンプを抑制します。
SVCD の ACTION、TRDUMP、または NOSUP を SLIP コマンドで指定する
と、コマンドは DAE 抑制を指定変更し、システムがダンプを書き出します。ま
た、DUMP オペレーター・コマンドが要求したダンプは抑制の対象となりませ
ん。
DAE がダンプを抑制しない場合は、症状ストリングがダンプ・ヘッダーに表示
されます。 IPCS VERBEXIT DAEDATA サブコマンドを使用してそれを見るこ
とができます。DAE は、ダンプがなぜ抑制されなかったかを示す通知メッセー
ジも発行します。
DAE は次のすべてが真となった場合にダンプを抑制します。
v DAE がダンプ内で最小の症状のセットを見付ける。
v そのダンプの症状ストリングが同じタイプの前のダンプの症状ストリングと一
致する。
v 以下のいずれかが真の場合。
– 現行の ADYSETxx parmlib メンバーが要求しているダンプについて
SUPPRESS を指定し、 VRADAE キーが SDWA 内にある。
– 現行の ADYSETxx parmlib メンバーが要求しているダンプのタイプについ
て SUPPRESSALL を指定し、 VRANODAE キーが SDWA にない。
18-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
次の表では SUPPRESS と SUPPRESSALL キーワードを ADYSETxx parmlib メ
ンバーに指定した場合に、VRADAE と VRANODAE キーがダンプ抑制に与える
影響を示します。SUPPRESS の場合は、VRANODAE キーは指定してもしなく
てもかまいません。システムはそれを検査しません。表では、ダンプからの症状
ストリングが前の症状ストリングと一致していると想定します。
ADYSETxx
オプション
SDWA 内の
VRADAE キー
SDWA 内の
VRANODAE キー
ダンプの抑制
SUPPRESS
あり
該当なし
あり
SUPPRESS
なし
該当なし
なし
SUPPRESSALL
あり
なし
あり
SUPPRESSALL
なし
あり
なし
SUPPRESSALL
なし
なし
あり
SUPPRESSALL
あり
あり
なし
ダンプを抑制しない確実なただ 1 つの方法は、 ADYSETxx parmlib メンバーの
内容にかかわらず、 SDWA に VRANODAE キーを指定することです。
頻繁に再発するダンプを管理する
DAE を使用すると頻繁に再発するダンプを自動的に抑制するので、サポート要員は
ダンプがいつ取られるかを注意している必要はありません。ただし、ダンプ要求が
多い場合は、ダンプが抑制されている場合でもシステム・パフォーマンスに影響を
与えます。その傾向は知らされずに何時間にも及ぶ場合があります。ユーザーに影
響を与えないように、サポート要員がとる処置を支援するために、システムに高頻
度のダンプ要求について通知させることができます。
通知を受けたい場合は、 NOTIFY パラメーターを ADYSETxx parmlib メンバーの
SVCDUMP ステートメントに追加し、通知のしきい値を設定します。 SVCDUMP
ステートメントにも UPDATE を必ず指定してください。デフォルトのしきい値
は、同じ症状ストリングについて 30 分で 3 回のダンプ要求です。通知時間はダン
プの開始からではなく、ダンプの完了または抑制から測定されます。
通知はイベント通知機能 (ENF) が行います。ENF 出口ルーチンを使用して、次の
ことを行えます。
v サポート要員にメッセージまたはビープ音での信号を使用して通知します。
v 自動化を使用します。
すべてのプログラムで ENF 信号を受信することができます。First Failure Support
Technology™ (FFST™) がアクティブな場合、この ENF 信号への応答に汎用アラー
トを発行します。
DAE が停止しさらに再始動する場合は、DAE はしきい値に達するまでダンプのカ
ウントを開始します。
各システムで独自の DAE データ・セットを持っている場合は、システムについて
の通知が出されます。シスプレックスのシステムで DAE データ・セットを共有し
ている場合は、シスプレックスについての通知が出されます。たとえば、共有 DAE
データ・セットがあり、ADYSETxx parmlib メンバーに NOTIFY(4,25) を指定して
第 18 章 ダンプの抑制
18-5
ダンプ抑制
あれば、25 分間に、同じまたは異なるシステムで同じ症状ストリングについて 4
つのダンプが要求されると、通知が行われます。
注: 通知しきい値を超えるシスプレックス内のシステムが、通知を行うシステムで
す。
DAE ダンプ抑制の計画
DAE ダンプ抑制の計画は初期プログラム・ロード (IPL) の前に行われるタスクで構
成されます。システム・プログラマーは次のタスクを行います。
v ADYSETxx parmlib メンバーの選択と作成
v DAE データ・セットの定義
ADYSETxx parmlib メンバーの選択と作成
IPL 時に使用する ADYSETxx parmlib メンバーを選択し作成します。3 つの
ADYSETxx メンバーが提供されています。
v ADYSET00 は、DAE を開始し 400 の症状ストリングを仮想記憶域に保持しま
す。IBM 提供の ADYSET00 メンバーには次のものが含まれます。
DAE=START,RECORDS(400),
SVCDUMP(MATCH,SUPPRESSALL,UPDATE,NOTIFY(3,30)),
SYSMDUMP(MATCH,UPDATE)
インストール・システムで提供するプログラムで計画的に必要なので、
ADYSET00 は SYSMDUMP ダンプを抑制しません。抑制したい場合は、
ADYSETxx メンバーを変更して SYSMDUMP ダンプを抑制してください。
v ADYSET01 は、DAE 処理を停止します。IBM 提供の ADYSET01 メンバーには
次のものが含まれます。
DAE=STOP
DAE がアクティブであるシスプレックスで DAE 表示機能の TAKEDUMP (T)
アクションを使用する場合は、ADYSET01 の内容を次のように変更する必要があ
ります。
DAE=STOP,GLOBALSTOP
v ADYSET02 は、ADYSET00 と同じパラメーターが含まれます。
IBM 提供の IEACMD00 parmlib メンバーは SET DAE=00 コマンドを発行し、こ
のコマンドは IPL 時に ADYSET00 を活動化します。DAE を IPL 時に開始させた
くない場合は、IEACMD00 を変更して SET DAE=01 を指定してください。
シスプレックスの場合は、それぞれのシステムで同じ ADYSETxx パラメーター値
を使用することをお勧めします。同じ値を使用する場合は、共有 SYS1.PARMLIB
を使用してください。インストール・システムで SYS1.PARMLIB を共有していな
い場合は、 SYS1.PARMLIB 内の ADYSETxx と IEACMDxx メンバーを、各シス
テムで同じにしてください。共有 ADYSETxx または同一の ADYSETxx メンバー
では、 DAE データ・セットを共有するために SHARE(DSN) を指定してくださ
い。
ADYSETxx メンバーで SUPPRESSALL を指定するようにお勧めします。この指定
はコンポーネントまたはプログラムが、システム診断作業域 (SDWA) に VRADAE
18-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
キーを指定してダンプ抑制を要求していない場合でも、ダンプの抑制を要求しま
す。 SUPPRESSALL は、ほとんどダンプを抑制の対象とすることができるので便利
です。
例: シスプレックス内のシステムについての ADYSETxx メンバー
シスプレックス内のシステムは DAE データ・セット SYS1.DAESHARE を共
有します。そこで、DAE は、いずれかのシステムで前にとられたことのある
ダンプとの重複を抑制することができます。このメンバーでは SUPPRESSALL
をも指定されています。
DAE=START,RECORDS(400),
SVCDUMP(MATCH,SUPPRESSALL,UPDATE,NOTIFY(3,30)),
SYSMDUMP(MATCH,UPDATE)
SHARE(DSN,OPTIONS),
DSN(SYS1.DAESHARE)
ADYSET00 メンバーは RECORDS(400) を指定します。ユーザーのシステムでダン
プを抑制せず、一致している症状ストリングが DAE データ・セットにある場合、
ストレージ内の 400 を上回るレコードが必要になります。IBM サポートの援助を
受けてください。
DAE 処理を変更するために parmlib メンバーを変更する。システムが実行されて
いる間に新しい ADYSETxx parmlib メンバーを作成し、ダンプの DAE データ・セ
ットまたはパラメーターを変更します。parmlib メンバーを変更する際に必要なオペ
レーターの処置については、 18-12 ページの『シスプレックス内の DAE 処理の変
更』 を参照してください。
シスプレックスのすべてのシステムが DAE データ・セットを共用する場合、もう
1 つの利点があります。それは、少なくとも SHARE(DSN) を含んでいる
ADYSETxx メンバーを使用して、各システムで DAE を開始した後です。 DAE 値
をすべてのシステムで同じ値に設定できる 1 つのオペレーター・コマンドがありま
す。これは、GLOBAL パラメーターを含んでいる ADYSEYxx メンバーについて
SET DAE= コマンドを発行することによって行われます。DAE データ・セットを
共用するすべてのシステムで有効になります。
例: GLOBAL を指定した ADYSETxx メンバー
次の ADYSET04 メンバーは、すべてのシステムで使用される DAE データ・
セットを SYS1.DAESH2 に変更し、すべてのシステムのダンプ・オプション
を変更します。
DAE=START,RECORDS(400),
SVCDUMP(MATCH,SUPPRESSALL,UPDATE,NOTIFY(3,30)),
SYSMDUMP(MATCH,UPDATE)
SHARE(DSN,OPTIONS),
DSN(SYS1.DAESH2)
GLOBAL(DSN,OPTIONS)
オペレーター・コマンドを使用して行われた変更のいずれも、システムを次回 IPL
すると、保持できません。 IPL 時に、各システムは、IEACMD00 に指定したメン
第 18 章 ダンプの抑制
18-7
ダンプ抑制
バーまたは使用している COMMNDxx メンバーを再び使用します。永続する効果を
持つ変更を行う場合は、次のいずれかを行ってください。
v ADYSET00 で変更を行えば、デフォルトの IEACMD00 が DAE を開始します。
v ADYSETxx メンバーで変更を行い、COMMNDxx メンバーを更新して、SET
DAE=xx ステートメントを用いて ADYSETxx を開始します。次に該当する
IEASYSxx メンバーを更新して、CMD=xx ステートメントを組み込みます。完了
したら、IEACMD00 メンバー内の SET DAE=00 を除去して、2 つのコマンドが
シーケンスから外れて完了していないことを確認してください。
DAE データ・セットの定義
システム・データ・セットを定義する場合は、DAE データ・セットを定義します。
システムを IPL するか、または DAE が停止し再開する場合は、 DAE は前に使用
した DAE データ・セットを継続して使用します。
1. DD ステートメントに DAE データ・セットを定義します。単一システムでは、
SYS1.DAE というデフォルトの名前を使用してください。シスプレックス内のシ
ステムで共有される DAE データ・セットには別の名前を使用してください。
例: 単一システムの DAE データ・セット
次の DD ステートメントの例は、単一システムで使用する DAE データ・
セット用のものです。
//DAE
//
//
DD
DSN=SYS1.DAE,DISP=(,CATLG),VOL=(,RETAIN,SER=SG2001),
DCB=(RECFM=FB,LRECL=255,DSORG=PS,BLKSIZE=0),
UNIT=3390,SPACE=(TRK,(6,2))
シスプレックスでは、各システムは独自の DAE データ・セットを持ちますが、
シスプレックス内のすべてのシステムで DAE データ・セットを共有することを
お勧めします。
例: シスプレックス・システムでの共有 DAE データ・セット
次の DD ステートメントの例は、シスプレックス内のシステムで共有する
DAE データ・セット用のものです。このステートメントは、 DAE デー
タ・セットを共有マスター・カタログまたは、各システムのマスター・カ
タログにカタログします。
//DAE
//
//
DD
DSN=SYS1.DAESHARE,DISP=(,CATLG),VOL=(,RETAIN,SER=SG1055),
DCB=(RECFM=FB,LRECL=255,DSORG=PS,BLKSIZE=0),
UNIT=3390,SPACE=(TRK,(12,2))
ユーザーのダンプを階層ストレージ・マネージャー (HSM) で管理する場合は、
60 日の HSM 除去時間を 60 日の DAE レコードの経時に対応するものと見な
してください。
|
|
|
2. グローバル・リソース逐次化などの、逐次化コンポーネントを使用して DAE デ
ータ・セットの保全性を提供します。
単一システムでは、DAE データ・セットはローカル・リソースです。デフォル
トの DAE データ・セット、SYS1.DAE は、デフォルトのグローバル・リソース
18-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
逐次化リソース名リスト (RNL) でローカル・リソースとして定義されます。別
の名前の DAE データ・セットを指定する場合は、その名前を SYSTEMS 排他
RNL に追加し、複数のシステムが同じ DAE データ・セット名を、物理的に別
のデータ・セットに使用することを避けるようにしてください。
シスプレックス内のシステムでは、共有 DAE データ・セットはグローバル・リ
ソースです。グローバル・リソース逐次化でそれをグローバル・リソースとして
使用するには、いずれかを実行してください。
v SYS1.DAE 以外の名前を DAE データ・セットに付けてください。たとえば、
SYS1.DAESHARE です。
v SYS1.DAE という名前を使用する場合は、デフォルトの SYSTEMS 除外 RNL
から DAE データ・セット項目を削除してください。DAE データ・セット項
目は、 SYSDSN SYS1.DAE です。
説明は、「z/OS MVS 計画: グローバル・リソース逐次化」を参照してくださ
い。
3. DAE データ・セットへのアクセスを制御します。単一システムまたはシスプレ
ックス内で DAE を共有するすべてのシステムで、リソース・アクセス管理機能
(RACF) を使用してアクセスを制御してください。RACF ADDSD コマンドを入
力し、その DAE データ・セットについてのデータ・セット・プロファイルを定
義します。
DAE データ・セットのアクセス
1 つのシステムが使用するか、またはシスプレックス内のシステムで共有される
DAE データ・セットは次のようにしてアクセスします。
v IPCS DAE 表示パネルを呼び出す
v 抑制ダンプを生成する
v DAE データ・セットを編集する
IPCS DAE 表示パネルを呼び出す
パネルを呼び出す方法については、「z/OS MVS IPCS ユーザーズ・ガイド」の
『IPCS オプション 3.5』を参照してください。パネルで、次のことができます。
v 次の内容に入力し、データ・セットが含んでいる症状ストリングを表示すること
ができます。
ダンプの日付
ストリングの最後の日付
ダンプが要求された回数
ダンプを要求した最後のシステム
v 症状、システム名、日付、などについて項目リストを検索してください。
v 症状ストリングについてシスプレックス・ダンプ登録簿 (またはダンプ登録簿が
活動状態のもの) を調べてください。
v 症状ストリングのダンプ表題を表示してください。
第 18 章 ダンプの抑制
18-9
ダンプ抑制
抑制ダンプを生成する
抑制されたダンプを入手したい場合があります。最初のダンプが無視され破棄さ
れ、その後そのダンプが頻繁に要求されたので、そのダンプを分析したい場合で
す。IPCS TAKEDUMP オプションを通じて抑制されたダンプを入手するために、以
下のことをしてください。
1. TAKEDUMP アクションを呼び出す TSO ユーザー ID をカスタマイズする。次
のことを確かめてください。
v MVS オペレーター SET コマンド、および DAE がシスプレックスでアクテ
ィブである場合は ROUTE コマンドを発行する権限をもっている
v DAE データ・セットへの RACF UPDATE アクセス権をもっている
2. ADYSET01 メンバー (または複数) に DAE=STOP (またはシスプレックスでは
DAE=STOP,GLOBALSTOP) を含める。
3. アクティブな IKJTSOxx メンバーの AUTHCMD NAMES セクションにプログ
ラム名 ADYOPCMD を含んでいることをチェックする。
4. シスプレックスで、少なくとも SHARE(DSN) が入っている ADYSETxx メンバ
ーを使用して DAE を開始すると、最大の利点が実現されます。― 共用デー
タ・セットの活動を使用可能化する。
5. IPCS DAE ダイアログ・パネルを使用して、関係のある症状ストリングを示して
いる行でアクション・コード T (TAKEDUMP オプション) を発行する。
IPCS DAE ダイアログの TAKEDUMP オプションを処理するために、DAE 処理を
停止し、ダイアログ処理が発生し、関係するシステムで DAE 処理が再始動されま
す。特定のシステムが、前に使用していたパラメーターとは異なる DAE パラメー
ターを使用することになる場合があります。次の検討で起こる可能性のある結果を
解説します。
この検討に 2 つのシステム (SY1 と SY2)、および 5 つの ADYSETxx メンバーが
関係します。G1 と G2 で終わるメンバーには、GLOBAL(DSN,OPTIONS) パラメー
ターが含まれます。S1 と S2 で終わるメンバーには、GLOBAL オプションを指定
しない SHARE(DSN,OPTIONS) があります。下の表の中央の列は、TSO ユーザー
が TAKEDUMP 要求を発行しているシステムを示します。
開始の状態
SY1
SY2
SY1
SY2
G1
G1
SY1
G1
G11
S1
S2
SY1
S1
S12
S1
S2
SY2
S2
S22
S1
G1
SY1
S1
S12
S1
G2
SY2
G2
G22
G2
S2
SY2
S2
S22
00
*
SY1
00
*3
注:
1. GLOBAL(DSN) システムは同期したままです。
18-10
最終の状態
TSO
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
2. すべてのシステムが GLOBAL(DSN) モードで「ない」場合、システムは、IPCS
TAKEDUMP ダイアログが実行するシステムで最後にアクティブであったメンバ
ーを使用して、始動します。
3. DAE データ・セットを共用していないシステムですべての作業が行われた場合
には、他のシステムに変更は行われません。ここで、ADYSET00 にはデフォル
トの IBM― 提供の値が含まれています。
4. タスクを実行するために必要なコマンドは、それぞれのコマンドのディスパッチ
ング優先順位で TSO ユーザーによって出されます。システムは、そのディスパ
ッチング優先順位があるために TSO ユーザーをディスパッチできないことがあ
り、したがって、アクションがタイムリーに完了できないことがあります。
システムは症状ストリングについて、次のダンプを生成します。そのダンプの後
で、DAE は症状ストリングについてダンプの抑制を再開します。
注: アクション・コードの T を指定しているにもかかわらず、ダンプが抑制される
ことがあります。DAE 抑制以外の理由について、 18-14 ページの『ダンプが抑
制される理由の判別』を参照してください。
DAE データ・セットの編集
対話式システム生産性向上機能 (ISPF) による編集を使用して、DAE データ・セッ
トを編集します。ISPF 編集については、「z/OS ISPF ダイアログ開発者 ガイドと
リファレンス」を参照してください。DAE データ・セットに対する WRITE アクセ
ス権限が必要です。ISPF 編集では、次に説明する編集マクロ ADYUPDAT を使用
してください。
編集セッションでは、コマンド行に次のいずれかをタイプし、ダンプの症状ストリ
ング行にカーソルを置き、 ENTER を押してください。カーソルがコマンド行にあ
る場合は、最初の症状ストリングを使用します。DAE はこれらの処置の前に停止
し、後で再び開始しなければならないことに注意してください。
ADYUPDAT TAKEDUMP
ADYUPDAT NODUMP
ADYUPDAT TAKEDUMP は、この症状ストリングについて次のダンプを生成する
ことを要求します。SLIP はまだダンプを抑制します。
ADYUPDAT NODUMP は、TAKEDUMP が有効な場合、無効にします。それ以外
の場合は、NODUMP は処置を取りません。
編集セッションでは、指定した日数以内に更新されなかったすべての症状ストリン
グも削除することもできます。削除を有効にするために、 DAE データ・セットを
SAVE する必要があります。削除を要求する場合は、コマンド行で次のように入力
します。
ADYUPDAT CLEANUP nnn
ここで、
nnn
この期間 (日数) レコードが更新されなかった場合、削除のために選択され
ることになります。デフォルトは 180 日です。
ADYUPDAT は常に、コマンドの結果を反映する状況メッセージを発行します。
第 18 章 ダンプの抑制
18-11
ダンプ抑制
DAE の停止、開始、および変更
ADYSET00 parmlib メンバーが使用され、DAE データ・セットが割り振られると、
DAE は IPL 中に開始します。通常は、 DAE はシステムが実行している間中実行
しているべきです。
次のステップを使用して、オペレーターが DAE の停止と開始を行うことができま
す。これらのステップを行う理由の 1 つは、別のパラメーターを含む別の
ADYSETxx parmlib メンバーに変更するためです。
DAE の停止
オペレーターは、DAE=STOP ステートメントが入っている ADYSET01 parmlib メ
ンバーを指定した SET DAE コマンドを使用して、DAE を停止することができま
す。
SET DAE=01
DAE の開始
オペレーターは、DAE=START パラメーターが入っている ADYSETxx parmlib メ
ンバー、すなわちインストール・システム提供の ADYSET03 parmlib メンバーなど
を指定した SET DAE コマンドを使用して、DAE を開始することができます。
SET DAE=03
シスプレックス内の DAE 処理の変更
オペレーターは必要であれば、シスプレックス内ですべての DAE 処理を変更でき
ます。たとえば、オペレーターは次の手順で、シスプレックス内のすべてのシステ
ムで、異なる ADYSETxx メンバーを使用させることができます。
1. IBM 提供の ADYSET01 メンバーを使用して DAE 処理を停止します。
ROUTE *ALL,SET DAE=01
シスプレックス内のすべてのシステムの DAE 処理を停止させる別の方法は、
SET DAE コマンドで GLOBALSTOP パラメーターを含む ADYSETxx メンバー
を指定することです。
2. たとえば、ADYSET04 メンバーを使用して DAE 処理を開始します。
ROUTE *ALL,SET DAE=04
ダンプを抑制するために SLIP コマンドを使用する
ある種のダンプはほとんど必要がありません。たとえば、ある種の異常終了コード
では、問題の解決に十分な診断情報を得ることができます。これらのコードについ
て、不要なダンプを抑制するために SLIP オペレーター・コマンドを IEASLPxx
parmlib メンバーに指定します。 IBM 提供の IEASLP00 メンバーには、ほとんど
不要な異常終了ダンプを抑制するための SLIP コマンドが含まれています。
ダンプを抑制するために SLIP を使用すると、症状ダンプ情報を含んでいるメッセ
ージ IEA995I も抑制されます。システムはその異常終了について LOGREC エラ
ー・レコードに書くことができます。
18-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
ある異常終了コードについてのダンプを抑制する場合は、 SLIP オペレーター・コ
マンドに次の ACTION パラメーターの 1 つを指定します。すべての SLIP コマン
ドを IEASLPxx parmlib メンバーに置き、その IEASLPxx メンバーを、通常使用し
ている COMMNDxx または IEACMDxx メンバー内にある次のコマンドで活動化さ
せます。
CMD=’SET SLIP=xx’
SLIP パラメーター
抑制されるダンプ
ACTION=NODUMP
すべてのダンプ
ACTION=NOSVCD
SVC ダンプ
ACTION=NOSYSA
ABEND SYSABEND ダンプ
ACTION=NOSYSM
ABEND SYSMDUMP ダンプ
ACTION=NOSYSU
ABEND SYSUDUMP ダンプ
たとえば、異常終了コード X'B37' についての SVC ダンプと ABEND SYSMDUMP
ダンプを抑制する場合は、次の指定を IEASLPxx に追加します。
SLIP SET,COMP=B37,ACTION=(NOSVCD,NOSYSM),END
参照
v IEASLPxx メンバーについては、「z/OS MVS 初期設定およびチューニング 解説
書」を参照してください。
v SLIP オペレーター・コマンドについては、「z/OS MVS システム・コマンド」を
参照してください。
ダンプを抑制するために ABEND マクロを使用する
DUMP パラメーターを指定せずに ABEND マクロを発行して、プログラムでダン
プを抑制することができます。症状ダンプが診断に十分な情報を提供できる場合
は、アプリケーション・プログラマーは DUMP パラメーターを指定しないでくだ
さい。
参照
ABEND マクロについては、「z/OS MVS プログラミング: アセンブラー・サービス
解説書 ABE-HSP」を参照してください。
ダンプを抑制するためにインストール・システム出口ルーチンを使用する
インストール・システムで、ダンプを抑制するためにインストール・システム出口
ルーチンを追加することができます。ジョブ名、異常終了コード、またはジョブ名
診断作業域 (SDWA) 内のほかの情報に基づき異常終了ダンプを抑制したい場合は、
IEAVTABX を使用してください。ダンプ・ヘッダーまたは DAE の情報をもとに、
SVC または SYSMDUMP ダンプを廃棄したい場合は、IEAVTSEL を使用してくだ
さい。異なるタイプのダンプを抑制したい場合は、JES2 出口 4 または JES3 出口
IATUX34 を使用して抑制してください。
第 18 章 ダンプの抑制
18-13
ダンプ抑制
出口
処理
ダンプ抑制
IEAVTABX
すべての ABEND ダンプの
前
1 つまたは複数のルーチン
で、要求されたダンプを抑制
するために、戻りコード 8
をレジスター 15 に入れるこ
とができます。
IEAVTSEL
1 つまたは複数のルーチンで
SVC ダンプまたは ABEND
SYSMDUMP ダンプの後で、 ダンプ・データ・セットをク
ダンプが DAE によって抑制 リアすることができます。
されていない場合
JES2 出口 4 または JES3
IATUX34
すべての JCL ステートメン
トについて
ダンプを抑制するために、
DD ステートメントの
DSNAME パラメーターを
DUMMY に変更することが
できます。
参照
v IEAVTABX と IEAVTSEL については、「z/OS MVS 導入システム出口」を参照
してください。
v JES2 出口 4 ルーチンについては、「z/OS JES2 Installation Exits」を参照してく
ださい。
v JES3 IATUX34 出口ルーチンについては、「z/OS JES3 Customization」を参照し
てください。
ダンプが抑制される理由の判別
意図されたダンプが欠落している場合は、理由を判別するためにこのリストを使用
してください。以下のリストには、このトピックで説明された方法を含め、ダンプ
が抑制される理由が説明されます。問題判別の計画を立てる場合に、これらの方法
のすべてに注意を払い、意図したダンプがインストール・システムで抑制されるこ
とのないようにしてください。
v ダンプの DAE 抑制。 18-1 ページの『DAE を使用してダンプを抑制』を参照し
てください。
v 異常終了コードについてのすべてのダンプを抑制する SLIP コマンド。 18-12 ペ
ージの『ダンプを抑制するために SLIP コマンドを使用する』を参照してくださ
い。
v DUMP パラメーターを指定しない ABEND マクロ。 18-13 ページの『ダンプを
抑制するために ABEND マクロを使用する』を参照してください。
v ダンプを抑制する MVS インストール・システム出口ルーチン。 18-13 ページの
『ダンプを抑制するためにインストール・システム出口ルーチンを使用する』を
参照してください。
v ダンプされるアドレス・スペース内のプログラムのリソース・アクセス管理機能
(RACF) による制御。RACF 1.8.1 以降、インストール・システムではプログラム
の ABEND ダンプを FACILITY クラスを使用して保護することができます。こ
の保護により、ユーザーがダンプにアクセスできなくなります。
18-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
ダンプ抑制
v PROBDESC エリア内の SYSDCOND と IEASDUMP.QUERY ルーチンでブロ
ックされたほかのシステム上のダンプ。シスプレックス内のほかのシステムのダ
ンプは、 REMOTE パラメーターを指定した DUMP コマンドまたは SDUMPX
マクロで要求することができます。PROBDESC パラメーターで指定したエリアに
SYSDCOND を含む場合は、ほかのシステム上のダンプは、ほかのシステムで次
のいずれかの条件の場合に書き出されません。
– IEASDUMP.QUERY ルーチンが存在しない
– 0 のコードを戻す IEASDUMP.QUERY ルーチンがない
v CHNGDUMP コマンドで抑制されたダンプ。CHNGDUMP コマンドが SVC ダン
プについて NODUMP を指定する場合、
– システム上のすべての SVC ダンプが抑制されます。
– DUMP コマンドまたは SDUMPX マクロに REMOTE パラメーターを含んで
いる場合は、ローカル・システム上のダンプとシスプレックス内のほかのシス
テムのダンプが抑制されます。
v ほかのシステムのダンプは、ほかのシステム上の CHNGDUMP コマンドで抑制
されます。DUMP コマンドまたは SDUMPX マクロに REMOTE パラメーターが
含まれ、シスプレックス内のほかのシステムで入力された CHNGDUMP コマン
ドに NODUMP が SVC ダンプについて指定された場合は、ほかのシステムの
SVC ダンプが抑制されます。ローカル・システム上のダンプは書き出されます。
ダンプをほかのデータ・セットに置くこともでき、その場合は受信したメッセージ
に指定された元のデータ・セットにはありません。
v JES2 出口 4 または JES3 出口 IATUX34 にあるインストール・システム出口
ルーチンで、ダンプ・データ・セット名を変更することができます。
v DUMPDS オペレーター・コマンドで SVC ダンプ出力の宛先を変更することが
できます。そのコマンドでは、SVC ダンプ出力を別の SYS1.DUMPxx データ・
セットに宛先変更することができます。
参照
v プログラム・ダンプへのアクセスを制御する FACILITY クラスについては、
「z/OS Security Server RACF セキュリティー管理者のガイド」を参照してくださ
い。
v DUMP, DUMPDS, および SLIP コマンドについては、「z/OS MVS システム・コ
マンド」を参照してください。
v IEAVTABX と IEAVTSEL 出口ルーチンについては、「z/OS MVS 導入システム
出口」を参照してください。
v SDUMPX マクロについては、「z/OS MVS Programming: Authorized Assembler
Services Reference LLA-SDU」を参照してください。
v IEASDUMP.QUERY ルーチンについては、「z/OS MVS Programming: Authorized
Assembler Services Guide」を参照してください。
v JES2 出口 4 ルーチンについては、「z/OS JES2 Installation Exits」を参照してく
ださい。
v JES3 IATUX34 出口ルーチンについては、「z/OS JES3 Customization」を参照し
てください。
第 18 章 ダンプの抑制
18-15
ダンプ抑制
18-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
第 19 章 メッセージ
システムは、次の目的でメッセージを出します。
v オペレーターまたはシステム・プログラマーにシステムの処理内の問題と進ちょ
くについて通知します
v オペレーターに処置を取ることと判断を行うことを依頼します
v アプリケーション・プログラマーに、システムがアプリケーション・プログラム
を実行する方法と、アプリケーション・プログラム内の問題について通知します
システムは基本制御プログラム・コンポーネント、さまざまなサブシステム、プロ
ダクト、およびアプリケーションからのメッセージを出します。システムのもとで
実行しているアプリケーションもそれぞれのメッセージを出すことができます。
主要トピック
以下のトピックで、メッセージについて説明します。
v 『メッセージの生成』
v 19-2 ページの『メッセージの受取り』
v 19-4 ページの『診断を目的としたメッセージ処理の計画』
メッセージの生成
任意のプログラムでマクロを発行するか、またはオペレーターにコマンドを入力さ
せて、システムにメッセージを発行させることができます。マクロとコマンドは次
のとおりです。
v LOG オペレーター・コマンドは SYSLOG にメッセージを書き込みます
v WTL マクロは SYSLOG にメッセージを書き込みます
v WTO マクロはオペレーターに対しメッセージを書き出します
v WTOR マクロはオペレーターに対しメッセージを書き出し、応答を要求します
関連活動については、次を使用してください。
v DOM マクロはコンソールの表示画面から、オペレーター・メッセージまたはメ
ッセージのグループを削除します
v REPLY オペレーター・コマンドはメッセージに応答します
v WRITELOG オペレーター・コマンドは SYSLOG を開始、停止、または印刷し、
SYSLOG の出力クラスを変更します
参照
v DOM については「z/OS MVS Programming: Authorized Assembler Services
Reference ALE-DYN」を、WTO、WTOR、および WTL マクロについては「z/OS
MVS Programming: Authorized Assembler Services Reference SET-WTO」を参照し
てください。
v LOG、REPLY、および WRITELOG コマンドについては、「z/OS MVS システ
ム・コマンド」を参照してください。
© Copyright IBM Corp. 1988, 2008
19-1
メッセージ
メッセージの受取り
WTO と WTOR マクロによって、システムは次の場所でメッセージを出します。宛
先コードによって、メッセージの表示と印刷場所が決まります。
v コンソール
v 拡張コンソール
v ハードコピー・ログ
v ジョブ・ログ
v SYSOUT データ・セット
WTL マクロによって、システムは SYSLOG にメッセージを出します。
アクセス方式は、次のいずれかの場所に、直接メッセージを出します。
v 表示端末
v 出力データ・セット
コンソール
マスター権限を持つコンソールに送信されるメッセージは、オペレーターを対象に
しています。システムはコンソールに送信されるすべてのメッセージを、そのメッ
セージが表示されたかどうかにかかわらず、ハードコピー・ログに書き出します。
ハードコピー・ログ
ハードコピー・ログは、次のすべてのシステム・メッセージ・トラフィックの記録
です。
v すべてのコンソールとの間のメッセージ
v オペレーターが入力したコマンドと応答
ダンプ内では、これらのメッセージはマスター・トレース内に示されます。JES3 で
は、ハードコピー・ログは常に SYSLOG に書き出されます。JES2 では、ハードコ
ピー・ログは通常は SYSLOG に書き出されますが、インストール・システムで選
択すると、コンソール・プリンターに書き出すことができます。
システム・ログ
SYSLOG は ジョブ入力サブシステム (JES2 または JES3) で提供する SYSOUT デ
ータ・セットです。SYSOUT データ・セットは、直接アクセス記憶装置 (DASD) 上
の出力スプール・データ・セットです。SYSLOG を定期的に印刷して、問題の有無
を確認してください。 SYSLOG は次のもので構成されます。
v WTL マクロを使用して発行されたすべてのメッセージ
v LOG オペレーター・コマンドで入力されたすべてのメッセージ
v 通常はハードコピー・ログ
v すべてのシステム・コンポーネントまたはプログラムから SYSLOG に経路指定
されるすべてのメッセージ
ジョブ・ログ
ジョブ・ログに送信されるメッセージは、ジョブを実行依頼するプログラマーを対
象としています。JCL JOB ステートメントの MSGCLASS パラメーターに、ジョ
ブ・ログ用のシステム出力クラスを指定してください。
19-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
メッセージ
SYSOUT データ・セット
SYSOUT データ・セットに送信されるメッセージは、プログラマーを対象としてい
ます。これらのメッセージはアセンブラーまたはコンパイラー、リンケージ・エデ
ィターとローダー、およびアプリケーション・プログラムが発行します。
1 つのプログラムについてのすべてのメッセージを、同じ SYSOUT リストに表示
させるためには、SYSOUT データ・セットと JCL JOB ステートメントの
MSGCLASS パラメーターに同じクラスを指定してください。
症状ダンプの受取り
症状ダンプは、異常終了を診断するための基本的な診断情報を提供するメッセージ
IEA995I または番号のないメッセージのいずれかのシステム・メッセージです。症
状ダンプ情報で、問題を診断するための十分な情報を提供できる場合があります。
例: 症状ダンプ出力
次の例では、異常終了 X'0C4' 理由コード X'4' の症状ダンプを示します。症状
ダンプは、以下の情報を示します。
v アクティブなロード・モジュール ABENDER は、アドレス X'00006FD8' に
あります。
v 障害が起こった命令は、ロード・モジュール ABENDER のオフセット X'12'
にあります。
v 障害を起こしたタスクのアドレス・スペース ID (ASID) は X'000C' です。
IEA995I SYMPTOM DUMP OUTPUT
SYSTEM COMPLETION CODE=0C4 REASON CODE=00000004
TIME=16.44.42 SEQ=00057 CPU=0000 ASID=000C
PSW AT TIME OF ERROR 078D0000
00006FEA ILC 4 INTC 04
ACTIVE LOAD MODULE=ABENDER
ADDRESS=00006FD8 OFFSET=00000012
DATA AT PSW 00006FE4 - 00105020 30381FFF 58E0D00C
GPR 0-3 FD000008 00005FF8 00000014 00FD6A40
GPR 4-7 00AEC980 00AFF030 00AC4FF8 FD000000
GPR 8-11 00AFF1B0 80AD2050 00000000 00AFF030
GPR 12-15 40006FDE 00005FB0 80FD6A90 00006FD8
END OF SYMPTOM DUMP
症状ダンプは、次の場所に表示されます。
v SYSUDUMP と SYSABEND ABEND ダンプの場合、メッセージ IEA995I 内。こ
れは、ジョブ・ログに経路指定されます。
v SYSMDUMP ABEND ダンプの場合、ジョブ・ログ内のメッセージ IEA995I 内と
ダンプ・ヘッダー・レコード内。
v SVC ダンプの場合、ダンプ・ヘッダー・レコード内。
v 拡張タイム・シェアリング・オプション (TSO/E) 環境の場合、 TSO/E PROFILE
コマンドで WTPMSG オプションを指定した場合は端末装置に表示されます。
v DISPLAY DUMP,ERRDATA オペレーター・コマンドへの応答の場合、直接アク
セス装置上の SYS1.DUMPxx データ・セットからの情報を表示するために使用さ
れます。
第 19 章 メッセージ
19-3
メッセージ
症状ダンプの情報が診断のために十分な場合は、ダンプ用の DD ステートメントを
付けないでください。
参照
v マスター・トレースの情報については、 9-1 ページの『第 9 章 マスター・トレ
ース』を参照してください。
v JOB ステートメントについては、「z/OS MVS JCL 解説書」を参照してくださ
い。
v ABEND ダンプ・ヘッダー・レコードについての情報は、 5-1 ページの『第 5 章
ABEND ダンプ』を参照してください。
v SVC ダンプ・ヘッダー・レコードについての情報は、 2-1 ページの『第 2 章
SVC ダンプ』を参照してください。
v PROFILE コマンドについては、「z/OS TSO/E コマンド解説書」を参照してくだ
さい。
診断を目的としたメッセージ処理の計画
インストール・システムで、診断を最適なものとするためにさまざまな方法でメッ
セージ処理を変更することができます。
ご使用のシステムでは、以下のことが行えます。
v メッセージ位置の制御
v メッセージの抑制
v メッセージ処理の自動化
v 処置メッセージは保持できません
v 症状ダンプ・メッセージ (IEA995I) の抑制
このセクションでは、ユーザーのインストール・システムについてメッセージ処理
を最適化するために必要な情報を検出することができます。
メッセージ位置の制御
インストール・システムで次の変更が行えます。
v 制御する特定のメッセージの宛先コード
v どのコンソールにメッセージを表示するか
以下の方式を使用して宛先コードを変更するか指定します。
v WTO または WTOR マクロは、そのマクロが作成したメッセージについて宛先
コードを指定します。
v WTO/WTOR インストール・システム出口ルーチンで、任意の WTO または
WTOR メッセージについての宛先コードを変更します。この出口ルーチンは、
MPFLSTxx parmlib メンバーの USEREXIT パラメーターで指定されるルーチン
です。
v JES3 の MSGROUTE 初期設定ステートメントで、 JES3 コンソール・メッセー
ジの宛先コードを変更します。
v JES3 の CONSOLE 初期設定ステートメントで、 JES3 コンソールが受信するメ
ッセージを制御することができます。
19-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
メッセージ
v サブシステム・インターフェース聴取者は宛先コードを変更することができま
す。
メッセージの抑制
インストール・システムでメッセージを抑制するために、次の処理を行うことがで
きます。抑制されたメッセージはコンソールには表示されません。
v MPFLSTxx parmlib メンバーで、メッセージの抑止を指定できます。抑止された
メッセージはコンソールに表示されませんが、ハードコピー・ログには書き込ま
れます。
v WTO/WTOR インストール・システム出口ルーチンで、任意の WTO/WTOR メッ
セージを抑制したり、あるいは抑制を指定変更したりすることができます。この
出口ルーチンは、MPFLSTxx parmlib メンバーの USEREXIT パラメーターで指
定されるルーチンです。
v JES2 のインストール・システム出口ルーチン、Exit 10 を使用して、JES2 主タ
スクが発行するメッセージを抑制することができます。
v JES3 のインストール・システム出口ルーチン、IATUX31 を使用して JES3 コン
ソールに経路指定されるメッセージを抑制することができます。
v CONTROL V オペレーター・コマンドを使用して、コンソールに表示されるメッ
セージ・レベルを指定して、メッセージを抑制することができます。
v VARY オペレーター・コマンドを使用して、表示されるメッセージの宛先コード
を指定して、コンソールが受信するメッセージを変更することができます。
v CONSOLxx parmlib メンバーの CONSOLE ステートメントの LEVEL キーワー
ドも、コンソールに表示されるメッセージ・レベルを指定して、メッセージを抑
制することができます。ROUTCODE キーワードは、コンソールで表示されるメ
ッセージの宛先コードを指定することができます。
メッセージ処理の自動化
MPFLSTxx parmlib メンバーを使用して、メッセージを NetView などの自動化サブ
システムに経路指定することを指定できます。自動化サブシステムは、オペレータ
ーの介入なしで、オペレーターが実行すべき処置を実行することができます。
処置メッセージを保持しない
MPFLSTxx parmlib メンバーでは、処置メッセージ保存機能 (AMRF) を使用してメ
ッセージを保持しないように指定することができます。オペレーターは、保持され
ていない画面処置メッセージを再呼び出しすることはできません。
症状ダンプ (IEA995I) の抑制
次の表では、ABEND ダンプについての症状ダンプを抑制する方法をリストしま
す。これらの方法ではメッセージ IEA995I のみを抑制します。症状ダンプは、その
位置に表示されたままです。
ダンプ・タイプ
SYSABEND
ABEND
症状ダンプを抑制するために使用する
CHNGDUMP オペレーター・コマンド
症状ダンプを抑制す
るために使用する
parmlib メンバー
CHNGDUMP SET,SYSABEND,SDATA=(NOSYM) IEAABD00
第 19 章 メッセージ
19-5
メッセージ
症状ダンプを抑制するために使用する
CHNGDUMP オペレーター・コマンド
症状ダンプを抑制す
るために使用する
parmlib メンバー
SYSMDUMP
ABEND
CHNGDUMP SET,SYSMDUMP=(NOSYM)
IEADMR00
SYSUDUMP
ABEND
CHNGDUMP SET,SYSUDUMP,SDATA=(NOSYM) IEADMP00
ダンプ・タイプ
参照
v メッセージ表示の制御、メッセージの抑制、AMRF、およびシスプレックス内の
メッセージの自動化については、「z/OS MVS 計画: 操作」を参照してください。
v WTO と WTOR マクロについては、「z/OS MVS プログラミング: アセンブラ
ー・サービス解説書 第 2 巻 (IARR2V-XCTLX)」を参照してください。
v MPFLSTxx と CONSOLxx メンバーについては、「z/OS MVS 初期設定およびチ
ューニング 解説書」を参照してください。
v USEREXIT パラメーターで名付けられている出口ルーチンおよび IEAVMXIT に
ついては、「z/OS MVS 導入システム出口」を参照してください。
v JES3 初期設定ステートメントについては、「z/OS JES3 初期設定およびチューニ
ング 解説書」を参照してください。
v 出口 10 については、「z/OS JES2 Installation Exits」を参照してください。
v IATUX31 出口については、「z/OS JES3 Customization」を参照してください。
v CONTROL V と CHNGDUMP オペレーター・コマンドについては、「z/OS MVS
システム・コマンド」を参照してください。
19-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
付録. アクセシビリティー
アクセシビリティー機能は、運動障害または視覚障害など身体に障害を持つユーザ
ーがソフトウェア・プロダクトを快適に使用できるようにサポートします。 z/OS
のアクセシビリティーの主要機能により、ユーザーは以下のことができるようにな
ります。
v 画面読み上げ機能および画面拡大機能などの支援機能の使用
v キーボードのみを使用して、特定の機能または画面を使用したのと同等の機能を
操作
v 色、コントラスト、フォント・サイズなど表示属性のカスタマイズ
支援機能の使用
画面読み上げ機能などの支援機能は、z/OS のユーザー・インターフェースを使用し
て機能します。この支援機能を使用して z/OS インターフェースにアクセスする場
合、その特定情報については支援機能の資料を参照してください。
ユーザー・インターフェースのキーボード・ナビゲーション
ユーザーは、TSO/E または ISPF を使用して z/OS ユーザー・インターフェースに
アクセスできます。TSO/E および ISPF インターフェースへのアクセス方法につい
ては、「z/OS TSO/E 入門」、「z/OS TSO/E ユーザーズ・ガイド」、および「z/OS
ISPF ユーザーズ・ガイド 第 1 巻」を参照してください。上記の資料には、キーボ
ード・ショートカットまたはファンクション・キー (PF キー) の使用方法を含む
TSO/E および ISPF の使用方法が記載されています。それぞれの資料では、PF キ
ーのデフォルトの設定値とそれらの機能の変更方法についても説明しています。
z/OS 情報
z/OS についての情報は、画面読み上げ機能を使用して、以下の Web サイトのイン
ターネット・ライブラリーにある z/OS ブックの BookServer/Library Server 版でア
クセスできます。
http://www.ibm.com/servers/eserver/zseries/zos/bkserv/
© Copyright IBM Corp. 1988, 2008
A-1
A-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
特記事項
本書は米国 IBM が提供する製品およびサービスについて作成したものであり、本
書に記載の製品、サービス、または機能が日本においては提供されていない場合が
あります。日本で利用可能な製品、サービス、および機能については、日本 IBM
の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービス
に言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能
であることを意味するものではありません。これらに代えて、IBM の知的所有権を
侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用す
ることができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの
評価および検証は、お客様の責任で行っていただきます。
IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を
保有している場合があります。本書の提供は、お客様にこれらの特許権について実
施権を許諾することを意味するものではありません。実施権についてのお問い合わ
せは、書面にて下記宛先にお送りください。
〒106-8711
東京都港区六本木3-2-12
日本アイ・ビー・エム株式会社
法務・知的財産
知的財産権ライセンス渉外
以下の保証は、国または地域の法律に沿わない場合は、適用されません。 IBM お
よびその直接または間接の子会社は、本書を特定物として現存するままの状態で提
供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むす
べての明示もしくは黙示の保証責任を負わないものとします。国または地域によっ
ては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限
を受けるものとします。
この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的
に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随
時、この文書に記載されている製品またはプログラムに対して、改良または変更を
行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のた
め記載しただけであり、決してそれらの Web サイトを推奨するものではありませ
ん。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありませ
ん。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うこと
のない、自ら適切と信ずる方法で、使用もしくは配布することができるものとしま
す。
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプロ
グラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の
相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする
方は、下記に連絡してください。
IBM Corporation
© Copyright IBM Corp. 1988, 2008
B-1
特記事項
Mail Station P300
2455 South Road
Poughkeepsie, NY 12601-5400
USA
本プログラムに関する上記の情報は、適切な使用条件の下で使用することができま
すが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、
IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれ
と同等の条項に基づいて、 IBM より提供されます。
この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示さ
れない場合があります。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。よ
り具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品
などの名前が含まれている場合があります。これらの名称はすべて架空のものであ
り、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎませ
ん。
著作権使用許諾:
本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を
例示するサンプル・アプリケーション・プログラムがソース言語で掲載されていま
す。お客様は、サンプル・プログラムが書かれているオペレーティング・プラット
フォームのアプリケーション・プログラミング・インターフェースに準拠したアプ
リケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式
においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することが
できます。このサンプル・プログラムは、あらゆる条件下における完全なテストを
経ていません。従って IBM は、これらのサンプル・プログラムについて信頼性、
利便性もしくは機能性があることをほのめかしたり、保証することはできません。
お客様は、IBM のアプリケーション・プログラミング・インターフェースに準拠し
たアプリケーション・プログラムの開発、使用、販売、配布を目的として、いかな
る形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布する
ことができます。
プログラミング・インターフェース情報
本書の情報は、z/OS のプログラミング・インターフェースとして使用されることを
意図して記述されたものではありません。
本書には、プログラムを作成するユーザーが z/OS のサービスを使用するためのプ
ログラミング・インターフェースが記述されています。この情報は、章またはセク
ションの始まりの文によって、あるいは下記の表示によって、その出現箇所を識別
できます。
プログラミング・インターフェース情報
プログラミング・インターフェース情報 の終り
B-2
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
特記事項
商標
以下は、International Business Machines Corporation の米国およびその他の国におけ
る商標です。
v CICS
v CT
v DB2
v DFSMS
v FFST
v First Failure Support Technology
v Hiperspace
v IBM
v IBMLink
v IMS
v MVS
v MVS/ESA
v NetView
v OS/390
v RACF
v RETAIN
v RMF
v S/390
v SOMobjects
v SP
v Sysplex Timer
v VTAM
v z/Architecture
v z/OS
v z/VM
v zSeries
v 3090
UNIX は The Open Group の米国およびその他の国における登録商標です。
Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation
の米国およびその他の国における商標です。
他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。
特記事項
B-3
B-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
索引
日本語, 数字, 英字, 特殊文字の順に配列されてい
ます。なお, 濁音と半濁音は清音と同等に扱われて
います。
［ア行］
アクセシビリティー A-1
圧縮
ダンプで使用 2-10
アドレス
一般的な不良 7-2
アドレス・スペース
コンポーネント・トレースのバッファー 11-11
アドレッシング・モード
システム・トレース・イベント 8-13
異常終了
Logrec エラー・レコードで示される 14-1
異常終了コード
STATUS FAILDATA 報告書で 2-47
異常終了ダンプ
一覧表 5-2
異常終了の分析
異常終了コードの入手 5-26
理由コードの入手 5-26
印刷
スタンドアロン・ダンプ 4-58
トランザクション・ダンプ 3-5
ABEND ダンプ 5-9
SNAP ダンプ 6-4, 6-5
SVC ダンプ 2-23
SYSABEND ダンプ 5-10
インストール・システム出口ルーチン
ダンプのカスタマイズ 5-21, 5-23, 5-25, 6-5
ダンプの抑制 18-13
エラー
Logrec 内のレコード 14-1
エラー ID
STATUS WORKSHEET 報告書で 2-45
VERBEXIT LOGDATA 内の 2-53
エラー統計
定義 14-8
延期
要約ダンプ 2-31
延期ロック
システム・トレース・イベント 8-21
オーバーレイ、記憶
パターン認識における 7-1
オブジェクト・モジュール
AMBLIST 保守援助プログラムの 15-16
© Copyright IBM Corp. 1988, 2008
オブジェクト・モジュール (続き)
z/OS UNIX 15-16
オブジェクト・モジュールまたは GOFF
AMBLIST 保守援助プログラムを使用した現行情報の
リスト 15-7
オブジェクト・モジュール・リスト
入手 15-9
オプション
ダンプ内容 2-19, 5-11
折り返し
コンポーネント・トレース・データ・セットの
11-18
［カ行］
解釈、ソフトウェア・レコードの 14-24
外部書き出しプログラム
ソース JCL 11-16
外部割り込み
レコード 10-25
概要
SNAP ダンプ 6-1
拡張順次データ・セット
大きなダンプの保持 2-7
拡張プログラム間通信
APPC/MVS を参照 11-31
カスタマイズ
ダンプ内の中核域 2-35, 3-10, 5-19
マスター・トレース 9-2
仮想記憶間処理モード
問題データ 7-5
仮想記憶間命令
システム・トレース・イベント 8-11
仮想索引機能
VLF を参照 11-152
仮想ストレージ・ダンプ
記述 4-1
スタンドアロン・ダンプの 4-6
カタログ
再構築する 16-20
環境データ 14-8
定義 14-8
レコード・ヘッダー情報 14-9
監視プログラム
システム・トレース・イベント 8-29
キー、長さ、データ・フォーマット
SDWAVRA 14-30
キーボード A-1
X-1
機能不良レコード
Logrec データ・セットの
サイズ 14-8
内容 14-8
レコード・ヘッダー 14-9
Logrec ログ・ストリームの
サイズ 14-8
内容 14-8
共通ストレージ・トレース
選択理由 1-6
許可プログラム
要求ダンプ 2-14
記録可能拡張部分
SDWA 内の 14-31
記録制御バッファー 14-22
記録制御バッファー (RCB) 14-22
組み合わせ、GTF トレース・オプションの
クリア
トランザクション・ダンプ 3-5
SVC ダンプ 2-23
グローバル・リソース逐次化
コンポーネント・トレース 11-55
検査
外部書き出しプログラム 11-25
コンポーネント・トレース 11-25
検索、Logrec データ・セットからの情報の
EREP プログラムの使用 14-11
検出、Logrec バッファーの 14-23
検出、WTO バッファーの 14-23
高速ダンプ 4-1
高速ダンプ・プログラム
例 4-19
高速版
スタンドアロン・ダンプの 4-13
高速版スタンドアロン・ダンプ 4-6
項目
システム・トレース 8-4
固定リンク・パック域
マップする 15-6
コピー
トランザクション・ダンプ 3-5
SVC ダンプ 2-23
コピー、ダンプの
テープから DASD 4-55
複数の装置から DASD への 4-56
DASD から DASD 4-55
コンポーネント・トレース
オプション
OPS の 11-120
外部書き出しプログラムの開始 11-20
外部書き出しプログラムの停止 11-21
記述 11-1
X-2
10-30
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
コンポーネント・トレース (続き)
グローバル・リソース逐次化のための
SYSGRS 11-55
検査 11-25
サブレベル 11-1, 11-4
サブレベル・トレース
検査 11-26
システム間拡張サービス用の SYSXES 11-164
システム・ロガー用の SYSLOGR 11-97
シスプレックス 11-22
選択理由 1-5
データ索引 (DLF) 用の SYSDLF 11-51
トレースの開始 11-14, 11-20, 11-23
トレースの停止 11-15, 11-21, 11-25
トレース・データの表示 11-28
分散 SOM のための SYSDSOM 11-53
割り振りコンポーネント用 SYSIEFAL 11-67
APPC/MVS コンポーネント用の SYSAPPC 11-31
IBM Health Checker for z/OS 11-62
IOS コンポーネント・トレースの SYSIOS 11-73
JES 共通結合サービス用の SYSJES 11-80
JES2 サブシステム用の SYSjes2 11-93
LLA 用の SYSLLA 11-96
OPS コンポーネント用の SYSOPS 11-118
RRS コンポーネント用の SYSRRS 11-123
RSM 用の SYSRSM 11-132
SPI コンポーネント用の SYSSPI 11-151
SYSOMVS for z/OS UNIX 11-105
System REXX コンポーネント用 SYSAXR 11-47
VLF コンポーネント用の SYSVLF 11-152
WLM コンポーネント用の SYSWLM 11-156
XCF コンポーネント用の SYSXCF 11-159
［サ行］
サービス要求処理モード
問題データ 7-5
サブチャネル開始データ
レコード 10-28
サブチャネル再開データ
レコード 10-28
サブチャネル停止操作
GTF レコード 10-26
サブレベル
コンポーネント・トレース 11-1, 11-4
サブレベル・トレースの検査 11-26
時刻
システム・トレース・イベント 8-40
ダンプ内の表示 2-20
時刻、ダンプの 2-46, 2-47
自己ダンプ
スタンドアロン・ダンプの 4-49
システム間拡張サービス
コンポーネント・トレース 11-164
システム再始動
スタンドアロン・ダンプ用 4-48
システム状況索引
機能 16-16
システム制御 (CC-012) フレーム 4-43
システム・イベント
GTF によるトレース 10-1
システム・サービス
システム・トレース・イベント 8-31
システム・データ・レコード
GTF トレース・レコード
不定様式 10-99
システム・トレース 8-1
アドレッシング・モード・トレース項目 8-13
オプションの更新 8-9
カスタマイズ 8-1
項目 8-4
項目 ID 8-5
出力のフォーマット設定 8-3
出力の読み取り 8-4
ダンプで出力を受けとる 8-3
ダンプ内のフォーマット 2-54
ダンプ内の例 8-4
トレース・テーブルのサイズの拡大 8-1
分岐トレース項目 8-10
分岐命令のトレース 8-2
ACR トレース項目 8-7
ALTR トレース項目 8-9
BSG トレース項目 8-11
CALL トレース項目 8-19
CLKC トレース項目 8-19
CSCH トレース項目 8-16
DSP トレース項目 8-15
EMS トレース項目 8-19
EXT トレース項目 8-19
HSCH トレース項目 8-16
I/O トレース項目 8-19
MCH トレース項目 8-19
MOBR トレース項目 8-13
MODE トレース項目 8-13
MSCH トレース項目 8-16
PC トレース項目 8-11
PGM トレース項目 8-23
PR トレース項目 8-11
PT トレース項目 8-11
RCVY トレース項目 8-24
RSCH トレース項目 8-16
RST トレース項目 8-19
SPER トレース項目 8-23
SPR2 トレース項目 8-23
システム・トレース (続き)
SRB トレース項目 8-15
SS トレース項目 8-19
SSAR トレース項目 8-11
SSCH トレース項目 8-16
SSRB トレース項目 8-15
SSRV トレース項目 8-31
SUSP トレース項目 8-21
SVC トレース項目 8-29
SVCE トレース項目 8-29
SVCR トレース項目 8-29
TIME トレース項目 8-40
USRn トレース項目 8-41
WAIT トレース項目 8-15
システム・トレース・テーブル
拡大 8-1
システム・モード
STATUS FAILDATA 報告書で 2-48
システム・リソース・マネージャー・データ
レコード 10-28
システム・ロガー・コンポーネント
コンポーネント・トレース 11-97
シスプレックス
コンポーネント・トレース・データ・セット 11-17
システム内のコンポーネント・トレース 11-22
実記憶域管理プログラム
RSM を参照 11-132
自動化
メッセージの 19-5
修正されたリンク・パック域
マップする 15-6
受信
マスター・トレース 9-3
主ストレージ・ダンプ
記述 4-1
スタンドアロン・ダンプの 4-6
出力 4-52, 4-53
AMBLIST 保守援助プログラム 15-17
SPZAP で 16-34
順次データ・セット
拡張
大きなダンプの保持 2-7
ショートカット・キー A-1
障害を起こした命令 2-48
使用可能
要約ダンプ 2-31
詳細編集報告書
作成
EREP 14-24
IPCS の VERBEXIT LOGDATA サブコマンド
14-24
症状レコード 14-31
索引
X-3
詳細編集報告書 (続き)
ソフトウェア・レコード 14-24
消失イベント・レコード
GTF トレースの 10-51
症状
SVC ダンプ内の表示 2-21
症状ストリング
抑制ダンプを生成する 18-10
DAE データ・セットの表示 18-9
症状ダンプ
受信 19-3
抑制 19-5
症状レコード 14-24
解釈 14-31
詳細編集報告書 14-31
使用不能
要約ダンプ 2-31
初期設定エラー・メッセージ
スタンドアロン・ダンプで 4-8
ジョブ制御言語ステートメント、IFCDIP00 内の 14-5
JCL の例 14-5
身体障害 A-1
スケジュールされた SVC ダンプ 2-46
スタンドアロン・ダンプ 4-1
コンポーネント・トレース・レコードを含む 11-15
仕様
アドレス範囲 4-22
サブプール 4-22
選択理由 1-4
ダンプ調整オプション、追加記憶域のダンプ 4-22
データ・スペース 4-24, 4-25
分析 4-60
外部症状の収集 4-61
システム状態の判別 4-61
使用可能待機 4-64
使用可能ループ 4-69
使用不能待ち状態 4-68
使用不能ループ 4-70
初期データの収集 4-60
保管される問題データ 4-71
IPCS 症状の収集 4-61
保守援助プログラム 4-1, 4-22
エラー条件 4-8
仮想ストレージ・ダンプ 4-6
再始動 4-48
再初期設定 4-49
作成 4-8
自己ダンプ 4-49
システム再始動 4-48
シスプレックス内でスタンドアロン・ダンプを実
行する 4-50
実行 4-21, 4-42, 4-43, 4-49
X-4
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
スタンドアロン・ダンプ (続き)
保守援助プログラム (続き)
主ストレージ・ダンプ 4-6
出力 4-52, 4-53
常駐ボリュームの初期設定 4-8, 4-39
スタンドアロン・ダンプの再始動 4-48
ストレージ・ダンプ 4-49
生成、追加記憶域の要求 4-21
装置選択 4-8
待機理由コード 4-46
待機理由コード、処理完了 4-48
ダンプ 4-49
ダンプのコピー、テープから DASD 4-55
ダンプのコピー、複数装置から DASD 4-56
ダンプのコピー、DASD から DASD 4-55
ダンプを印刷、IPCS を使用して 4-58
ダンプを表示、IPCS を使用して 4-57
ダンプ・プログラムの実行 4-43, 4-48, 4-49
中央記憶装置ダンプ 4-6
中核 4-6
追加記憶域のダンプ 4-21
データ・スペース 4-24, 4-25
不定様式出力 4-52, 4-53
マクロ・パラメーター 4-14, 4-15, 4-16, 4-17,
4-18, 4-21, 4-39
マクロ・メッセージ 4-37
待ち状態 4-44, 4-49
マッピング、中核 4-6
命令アドレス・トレース 4-7
メッセージ出力 4-8
戻りコード 4-37
理由コード 4-44, 4-49
例 4-19
1 ステップ生成 4-8, 4-34, 4-37
2 段階生成 4-8, 4-38, 4-39
3480 メッセージ 4-59
3490 メッセージ 4-59
3590 メッセージ 4-59
AMDSADMP マクロ、コーディング 4-19
AMDSADMP マクロのアセンブリー 4-38
AMDSADMP マクロのコーディング、高速ダンプ
用 4-13
DD ステートメント 4-36
dvolser 4-59
IPCS LIST サブコマンド、自己ダンプ 4-50
JCL 例 4-34, 4-38
スタンドアロン・ダンプがサポートするコンソール
4-14
スタンドアロン・ダンプによりダンプされた CSA 4-6
スタンドアロン・ダンプによりダンプされた
LSQA 4-7
スタンドアロン・ダンプによりダンプされた PSA 4-6
スタンドアロン・ダンプによりダンプされた SQA 4-6
スタンドアロン・ダンプによりダンプされたサブプール
4-7
スタンドアロン・ダンプ例
作動可能の判別 4-67
システム活動の判別 4-64
システム状態の判別 4-62
実記憶域データの獲得 4-65
使用可能ループの認識 4-69
症状データの収集 4-61
使用不能待ち状態の分析 4-68
スタンドアロン・ダンプ使用の 4-19
ストレージ・データの獲得 4-66
モジュールの判別 4-64
リソース競合の判別 4-65
PSW の読み取り 4-63
TCB が通常の待機状態かどうかを調べる 4-68
ストライピング
ダンプで使用 2-10
ストレージ内のトレース・テーブル 9-5
ストレージ・オーバーレイ
パターン認識における 7-1
判別
損傷区域 7-1
制御ステートメント
AMBLIST 保守援助プログラムの 15-2, 15-16
SPZAP で 16-23
z/OS UNIX 15-16
制御レコード
GTF トレース・レコード
不定様式 10-95
制御レジスター
ダンプ内のフォーマット 2-54
セキュリティー
APPC/MVS コンポーネントの問題 11-42
ゼロ・ページ
ダンプ抑止 4-7
ソース JCL
コンポーネント・トレース外部書き出しプログラムの
11-16
ソース索引レコード
GTF トレースの 10-50
相違点、出力内の
z/OS UNIX 15-16
ソフトウェア
エラー 14-1
ソフトウェア・レコード 14-11, 14-24
解釈 14-24
詳細編集報告書 14-24
［タ行］
待機理由コード
スタンドアロン・ダンプの実行 4-46
テープのアンロード 4-48
タイプ、レコードの
ソフトウェア・レコード 14-11
ANR レコード 14-10
CRW レコード 14-10
DASD-SIM リカバリー・レコード 14-10
DDR レコード 14-10
EOD レコード 14-10
ETR リカバリー・レコード 14-10
IOS リカバリー・レコード 14-10
IPL レコード 14-10
LMI リカバリー・レコード 14-10
MCH レコード 14-10
MDR レコード 14-10
MIH レコード 14-11
OBR レコード 14-11
SLH レコード 14-11
タイム・スタンプ・レコード
GTF トレースの 10-50
Logrec データ・セット
記録方法 14-9
フォーマット 14-10
ユーザーが指定した間隔で更新される 14-9
タスク処理モード
問題データ 7-5
ダンプ
異常終了コードで抑制する 18-12
インストール・システム出口ルーチンによる抑制
18-13
オプション表示 2-19, 5-11
カスタマイズ 5-19
記述 1-3
検出 2-20
時刻 2-20
事前割り振りデータ・セット 2-7
自動割り振りデータ・セット 2-2, 3-2
ダンプが抑制される理由 18-14
ダンプ分析
SVC 2-38
SVC の要約 2-38
頻繁に再発する場合の通知 18-5
頻繁に再発する場合の抑制 18-4
抑制 18-1
ゼロ・ページ・ダンプ 4-7
抑制ダンプを要求する 18-10
ABEND ダンプの内容のカスタマイズ 5-18
ABEND マクロで抑制する 18-13
DAE による抑制 18-1
索引
X-5
ダンプ (続き)
RACF による抑制 18-14
SLIP トラップで抑制する 18-12
SVC ダンプの表題 2-20
ダンプ選択
スタンドアロン・ダンプ 1-1
ABEND ダンプ 1-1
SNAP ダンプ 1-1
SVC ダンプ 1-2
ダンプ調整オプション
スタンドアロン・ダンプ用 4-22
ダンプ表題 2-44
仕様 15-3, 15-4, 15-5, 15-6
AMBLIST 保守援助プログラム
LISTIDR 制御ステートメント 15-5, 15-6
LISTLOAD 制御ステートメント 15-3
LISTOBJ 制御ステートメント 15-4
ダンプ分析と除去 3-2
DAE を参照 18-1
ダンプ・グラブ・バッグ 7-1
ストレージ・オーバーレイ 7-1
ダンプ・データ・セット
DSNTYPE=LARGE 3-2
チャネル・プログラム・データ
レコード 10-25
中央記憶装置ダンプ
記述 4-1
スタンドアロン・ダンプの 4-6
中核
ダンプ 2-35, 3-10, 5-19
AMBLIST 保守援助プログラムを使用したマッピング
15-15
抽出
ダンプから得られる GTF トレース・データ 10-41
ツールと保守援助プログラム
概要 1-3
選択 1-1
通知
頻繁に再発するダンプ 18-5
データ
診断のための 7-1
データ検査
SPZAP の使用 16-2
データ索引機能
DLF を参照 11-51
データ修正
SPZAP の使用 16-2, 16-4, 16-5, 16-6, 16-14, 16-27
データ脱落レコード
GTF トレース・レコード
不定様式 10-96
データ・スペース
コンポーネント・トレースのバッファー 11-11
X-6
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
データ・セット
ダンプ用の自動割り振り 2-2, 3-2
ABEND ダンプの受信 5-4
ディスク初期設定プログラム - IFCDIP00 14-3
ディスパッチ
システム・トレース・イベント 8-15
出口 4
JES2 用
ダンプの抑制 18-14
出口ルーチン
ダンプの抑制 18-13
同期 SVC ダンプ 2-46
統合
GTF トレースから得られるデータ 10-41
動的呼び出し
SPZAP で 16-21
特記事項 B-1
トランザクション・ダンプ
印刷 3-5
概要 3-1
カスタマイズ 3-6
クリア 3-5
コピー 3-5
自動割り振りデータ・セット 3-2
ダンプ内容の要約 3-9
ダンプ・データ・セットの計画 3-2
同期 3-1
内容 3-6
非同期 3-1
表示 3-5
要求 3-4
トランザクション・トレース
概要 12-1
トランザクション・トレース用の SYSTTRC 11-152
トレース
記述 1-5, 1-6
トレース、機能リカバリー・ルーチン操作の 10-27
トレース、サブチャネル修正操作の 10-27
トレース、入出力割り込みの 10-26
トレース、プログラム割り込みの 10-27
トレース、SLIP トラップの 10-28
トレース、VTAM ネットワーク活動の 10-27
トレース選択
コンポーネント・トレース 1-2
システム・トレース 1-2
マスター・トレース 1-2
GFS トレース 1-2
GTF トレース 1-2
トレース・データ・セット
コンポーネント・トレースの 11-16
トレース・テーブル
マスター・トレースの 9-5
［ナ行］
入出力操作
システム・トレース・イベント
入出力トレース・レコード
不定様式 10-106
入出力割り込み
GTF レコード 10-26
8-16
［ハ行］
ハードウェア
エラー 14-1
ハードコピー・ログ
およびマスター・トレース 9-1
ハイパースペース・データ
ダンプ 2-25, 3-7, 5-11, 6-6
バッファー
コンポーネント・トレースの 11-11
Logrec 14-22
汎用レジスター
ダンプ内のフォーマット 2-54
表示
コンポーネント・トレース・データ 11-28
トランザクション・ダンプ 3-5
ABEND ダンプ 5-9
SVC ダンプ 2-23
表題
ダンプ内の表示 2-20
フォーマット、Logrec バッファーの 14-23
フォーマット設定
マスター・トレース 9-4
フォーマット設定、Logrec バッファーの 14-23
複数のエラー・イベント 2-51
物理的使用不能処理モード
問題データ 7-5
不定様式 GTF レコード
システム・データ・レコード 10-99
制御レコード 10-95
データ脱落レコード 10-96
ユーザー・トレース・レコード 10-97
不定様式出力
GTF の 10-94
不定様式ダンプ 4-1
トランザクション・ダンプ 3-5
SVC ダンプ 2-23
SYSMDUMP ダンプ 5-10
不定様式ダンプ・プログラム
例 4-19, 4-20
プログラム
システム・トレース・イベント 8-23
プログラム・イベント
GTF によるトレース 10-1
プログラム・オブジェクト
リスト 15-3
AMBLIST 保守援助プログラムの 15-16
AMBLIST 保守援助プログラムの出力 15-3, 15-4
AMBLIST 保守援助プログラムを使用した現行情報の
リスト 15-9
CSECT を修正するために SPZAP を使用する
例 16-10
z/OS UNIX 15-16
プログラム・オブジェクト・モジュール
レコードを修正するために SPZAP を使用する
例 16-15
プログラム・チェック
保管された問題データ 4-72
プロンプト指示
要求方法 10-31
GTF の 10-31
分岐
システム・トレース・イベント 8-10
分岐命令
トレース 8-2
ページング可能リンク・パック域
マップする 15-6
ヘッダー・レコード
機能不良レコード 14-9
Logrec データ・セットの
記録ルーチンで使用される 14-9
フォーマット 14-9
EREP で使用される 14-9
保持
メッセージ
AMRF で 19-5
保守援助プログラムとツール
記述 1-3
選択 1-1
保守援助プログラムの選択
AMATERSE 1-2
AMBLIST 1-2
DAE 1-2
IPCS 1-3
Logrec データ・セット 1-2
SLIP 1-3
SPZAP 1-2
［マ行］
マージ
コンポーネントおよび GTF トレース
マクロ展開メッセージ
スタンドアロン・ダンプで 4-8
10-43
索引
X-7
マシン・チェック
問題データ 7-7
マスター・トレース 9-1, 9-5
およびハードコピー・ログ 9-1
開始 9-2
カスタマイズ 9-2
受信 9-3
ダンプ出力 9-4
停止 9-2
トレース・テーブルの項目 9-7
トレース・テーブルのヘッダー 9-6
フォーマット設定 9-4
要求 9-2
待ち状態コード
スタンドアロン・ダンプの実行 4-44, 4-49
マップする
中核 15-15
リンク・パック域 15-6, 15-15
命令アドレス・トレース 4-7
選択理由 1-5
メッセージ 19-1
位置のカスタマイズ 19-4
カスタマイズ処理 19-4
受信 19-2
生成 19-1
SPZAP から 16-35
メッセージ表示
スタンドアロン・ダンプ・プログラム 4-59
3480 装置 4-59
3490 装置 4-59
3590 装置 4-59
モード
仮想記憶間処理モード 7-5
サービス要求処理モード 7-5
処理の 7-5
タスク処理モード 7-5
物理的使用不能処理モード 7-5
ロック処理モード 7-5
モジュール
問題データ 7-5
モジュールの要約
バインダーが処理するモジュールの AMBLIST 出力
15-18, 15-63
リンケージ・エディターが処理するモジュールの
AMBLIST 出力 15-17, 15-62
戻りコード 4-37
SPZAP から 16-20
問題
ソフトウェア検出 5-26
ハードウェア検出 5-26
問題データ
ダンプからの 7-1
X-8
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
問題データ (続き)
モジュールから得られる 7-5
リンケージ・スタックから得られる
7-3
［ヤ行］
ユーザー
システム・トレース・イベント 8-41
ユーザー・データ・レコード
不定様式 10-97
GTF トレース・レコード 10-97
ユーザー・トレース・データ
レコード 10-29, 10-30
要約ダンプ 2-38
延期 2-31
使用可能 2-31
使用不能 2-31
トランザクション・ダンプ内の 3-9
ABEND ダンプ内の 5-16
SVC ダンプ 2-31
抑制
異常終了コードによるダンプ 18-12
インストール・システム出口ルーチンによるダンプ
18-13
症状ダンプ 19-5
ダンプが抑制される理由 18-14
ダンプの 18-1
頻繁に再発するダンプ 18-4
メッセージの 19-5
抑制ダンプを生成する 18-10
ABEND マクロによるダンプ 18-13
DAE によるダンプ 18-1
RACF によるダンプの 18-14
SLIP トラップによるダンプ 18-12
［ラ行］
ライブラリー索引機能
LLA を参照 11-96
リカバリー
システム・トレース・イベント 8-24
リカバリー作業域
問題データ 7-6
リカバリー・ルーチン
ダンプのカスタマイズ 5-20, 5-22, 5-24
リストする、リンク・パック域を 15-6
リストする、CSECT 識別レコードを 15-5
理由コード
スタンドアロン・ダンプの実行 4-44, 4-49
リンク・パック域
マップする 15-6
AMBLIST 保守援助プログラム 15-6
リンク・パック域 (続き)
AMBLIST 保守援助プログラムを使用したマッピング
15-14, 15-62
リンケージ・スタック
診断のための分析 7-3
レコード
エラー 14-1
GTF トレース 10-44
Logrec データ・セットのレコード 14-10
Logrec データ・セットまたは Logrec ログ・ストリ
ームからの 14-24
Logrec ログ・ストリームのレコード 14-10
レコード、Logrec データ・セットの 14-10
レコード、Logrec ログ・ストリームの 14-10
レジスター
ダンプ内のフォーマット 2-54
ロード・モジュール
リスト 15-3
AMBLIST 保守援助プログラムの出力 15-3, 15-4
AMBLIST 保守援助プログラムを使用した現行情報の
リスト 15-9
ロード・モジュールまたはプログラム・オブジェクト内
の CSECT
AMBLIST 保守援助プログラムを使用したマッピング
15-9
ロード・モジュール・リスト
AMBLIST 保守援助プログラムの出力 15-11
ログ・ストリーム
JCL 仕様 14-15
ロック処理モード
問題データ 7-5
［ワ行］
割り込み
監視プログラム 10-28, 10-36
コード 10-36
システム・トレース・イベント 8-19
プログラム 10-27, 10-36
I/O 10-34
SVC 割り込み 10-28, 10-36
割り振り
コンポーネント・トレース 11-67
ダンプ・データ・セットの事前割り振り 2-7
ダンプ・データ・セットの自動化 2-2, 3-2
［数字］
2 次エクステント
計算 2-9
割り振り 2-8, 2-9
SPACE 要件 2-8
2 段階生成
オーバーライド 4-41
マイグレーション 4-40
A
ABDUMP= パラメーター
GTF の 10-8
ABEND ダンプ
オプション表示 5-11
獲得 5-4
カスタマイズ 5-18
選択理由 1-3
ダンプ内容の要約 5-16
内容 5-10
分析 5-25
SYSABEND ダンプ分析 5-25
SYSUDUMP ダンプ分析 5-25
ABEND マクロ
ダンプのカスタマイズ 5-19, 5-20, 5-22, 5-24
ダンプの抑制 18-13
ABEND ダンプの要求 5-8
ABSDUMP/ABSDUMPT 制御ステートメント
パラメーター 16-24, 16-25
例 16-14
SPZAP で 16-14, 16-24, 16-25
AB= パラメーター
GTF の 10-8
ACR (代替 CPU リカバリー)
システム・トレース・イベント 8-7
問題データ 7-6
ACR トレース項目
システム・トレースの 8-7
ADATA= パラメーター
LISTLOAD 制御ステートメント 15-4
ALIB パラメーター
AMDSADMP マクロ 4-17
ALL パラメーター
ダンプ・オプション 5-12
ALLNUC パラメーター
ダンプ・オプション 2-26, 3-7, 5-12
ALLPA パラメーター
ダンプ・オプション 5-12, 6-6
ALLPDATA パラメーター
ダンプ・オプション 5-12
ALLPSA パラメーター
ダンプ・オプション 2-26, 3-7
ALLSDATA パラメーター
ダンプ・オプション 5-12
ALLVNUC パラメーター
ダンプ・オプション 5-12, 6-6
索引
X-9
ALTR トレース項目
システム・トレースの 8-9
AMATERSE 保守援助プログラム 17-1
選択理由 1-6
AMBLIST 出力
入手 15-2
AMBLIST 制御ステートメントの組み合わせ 15-2
AMBLIST 保守援助プログラム
記述 15-1
機能 15-7
出力 15-17
制御ステートメント
コーディングの規則 15-2
選択理由 1-6
中核の内容のマッピング 15-15
リンク・パック域内のモジュールのマッピング
15-14
CSECT 内の実行可能コードの修正のトレース 15-13
CSECT をロード・モジュールまたはプログラム・オ
ブジェクト内でマップする 15-9
JCL ステートメント 15-2
LISTIDR 制御ステートメント 15-5
LISTLOAD 制御ステートメント 15-3
LISTLPA 制御ステートメント 15-6
LISTOBJ 制御ステートメント 15-4
AMDSADDD ユーティリティー 4-27, 4-28
カタログ要件 4-31
構文 4-29, 4-30, 4-31
スペース要件 4-31
装置要件 4-31
特性 4-28
呼び出し 4-28
CLEAR オプション 4-30
DEFINE オプション 4-30
REALLOC オプション 4-30
vollist 要求 4-30
volser 要件 4-30
AMDSADMP マクロ 4-13
アセンブリー 4-38
高速ダンプのフォーマット 4-14
構文
高速ダンプ用 4-13
パラメーター
マクロ 4-21
ALIB= 4-17
COMPACT= 4-17
CONSOLE= 4-14
DDSPROMPT= 4-18
DUMP= 4-16
IPL= 4-14
LNKLIB= 4-18
MINASID 4-17
X-10
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
AMDSADMP マクロ (続き)
パラメーター (続き)
MODLIB= 4-18
MSG= 4-16
NUCLIB= 4-18
OUTPUT= 4-15
PROMPT 4-16, 4-21
REUSEDS= 4-17
SYSUT= 4-15
ULABEL= 4-14
VOLSER= 4-14
複数の版のアセンブル 4-39
例 4-19
2 段階生成 4-38
DUMP キーワード 4-22
JCL 例 4-38
symbol 4-14, 4-39
SYS1.MACLIB データ・セット
アセンブリー 4-38
AMRF (処置メッセージ保存機能)
メッセージ保持 19-5
ANR レコード 14-10
APPC/MVS (拡張プログラム間通信/MVS)
コンポーネント・トレース 11-31
ASIDP トレース・オプション
GTF の 10-24
プロンプト指示 10-32
B
BAKR 命令
システム・トレース・イベント
BALR 命令
システム・トレース・イベント
BASE 制御ステートメント
パラメーター 16-26
例 16-27
SPZAP で 16-11, 16-26, 16-27
BASR 命令
システム・トレース・イベント
BASSM 命令
システム・トレース・イベント
BR トレース項目
システム・トレースの 8-10
BRANCH パラメーター
要約ダンプの制御 2-31
BSG トレース項目
システム・トレースの 8-11
8-10
8-10
8-10
8-10
C
CALL トレース項目
システム・トレースの 8-19
CALLRTM マクロ
ダンプのカスタマイズ 5-20, 5-22, 5-24
ABEND ダンプの要求 5-8
CANCEL オペレーター・コマンド
ABEND ダンプの要求 5-9
CB パラメーター
ダンプ・オプション 5-12, 6-6
CCHHR 制御ステートメント
パラメーター 16-28
SPZAP で 16-12, 16-27, 16-28
CCW トレース・オプション
GTF の 10-25
CCW トレース・レコード
定様式 10-52
不定様式 10-101
CCWN パラメーター、GTF CCWP の 10-32, 10-33
CCWP トレース・オプション
プロンプト指示 10-32
DATA パラメーター 10-33
GTF の 10-25, 10-32, 10-33
I パラメーター 10-33
IOSB パラメーター 10-34
PCITAB パラメーター 10-34
S パラメーター 10-33
SI パラメーター 10-33
CC-012 システム制御フレーム 4-43
CHECKSUM 制御ステートメント
パラメーター 16-28
SPZAP で 16-28
CHNGDUMP オペレーター・コマンド
症状ダンプの抑制 19-5
ダンプのカスタマイズ 2-36, 3-11, 5-21, 5-23, 5-25
ダンプ・オプションの変更 2-19, 5-11
CLKC トレース項目
システム・トレースの 8-19
COMPACT パラメーター
AMDSADMP マクロの 4-17
CONSOLE 制御ステートメント
例 16-29
SPZAP で 16-29
CONSOLE= パラメーター
AMDSADMP マクロの 4-14
SYSC 定数の指定 4-15
COPYDUMP サブコマンド
コンポーネント・トレース・データを獲得するための
11-28
COPYTRC サブコマンド
コンポーネント・トレースの 11-29
COUPLE パラメーター
ダンプ・オプション 2-26, 3-7
CRW レコード 14-10
CSA パラメーター
ダンプ・オプション 5-12
CSCH トレース項目
システム・トレースの 8-16
CSCH トレース・オプション
GTF の 10-25
CSCH トレース・レコード
定様式 10-54
CSECT
データのアクセス 16-11
CSECT 内の実行可能コードの修正のトレース 15-13
CSECT 識別レコード (IDR)
印刷 15-62
CSECT 名
NAME 制御ステートメント
SPZAP で 16-3
CTIAXRxx parmlib メンバー
SYSAXR コンポーネント・トレースの 11-48
CTIHZS00 parmlib メンバー
SYSHZS コンポーネント・トレース用の 11-63
CTIIEFxx parmlib メンバー
SYSIEFAL コンポーネント・トレース用 11-67
CTnAPPxx parmlib メンバー
SYSAPPC コンポーネント・トレースの 11-31
CTnBPXxx parmlib メンバー
SYSOMVS コンポーネント・トレースの 11-106
CTnGRSxx parmlib メンバー
SYSGRS コンポーネント・トレースの 11-56
CTnIOSxx parmlib メンバー
SYSIOS コンポーネント・トレースの 11-75
CTnJESON parmlib メンバー
SYSJES コンポーネント・トレースの 11-83
CTnJESxx parmlib メンバー
SYSJES コンポーネント・トレースの 11-83
CTnLOGxx parmlib メンバー
SYSLOGR コンポーネント・トレースの 11-101
CTnOPSxx parmlib メンバー
SYSOPS コンポーネント・トレースの 11-118
CTnRRSxx parmlib メンバー
SYSRRS コンポーネント・トレース用の 11-124
CTnRSMxx parmlib メンバー
SYSRSM コンポーネント・トレースの 11-133
CTnXCFxx parmlib メンバー
SYSXCF コンポーネント・トレースの 11-160
CTnXESxx parmlib メンバー
SYSXES コンポーネント・トレースの 11-166
CTRACE
コンポーネント・トレース 11-1
索引
X-11
CTRACE サブコマンド
FULL 報告書 11-122
SHORT 報告書 11-122
SYSAPPC コンポーネント・トレースの 11-36
SYSAXR コンポーネント・トレースの 11-50
SYSOMVS コンポーネント・トレースの 11-109
SYSOPS コンポーネント・トレースの 11-121
SYSWLM コンポーネント・トレースの 11-157
SYSXCF コンポーネント・トレースの 11-162
SYSXES コンポーネント・トレースの 11-168
D
DAE (ダンプ分析重複回避機能)
記述 18-1
DAE データ・セット
管理 18-9
古い症状ストリングの除去 18-9
編集 18-9
DAE 表示パネル
呼び出し 18-9
DAE 保守援助プログラム
選択理由 1-6
DASD ダンプ・プログラムへの出力
例 4-20
DASD (直接アクセス記憶装置) 4-1, 4-8, 4-14, 4-35,
4-39
タイプ 4-26
データ・セット 4-26
割り振り 4-27
AMDSADDD ユーティリティー 4-27
IPCS SADMP ユーティリティー 4-27
DASD-SIM リカバリー・レコード 14-10
data
SPZAP での検査 16-2
SPZAP を使用した修正 16-2
DATA パラメーター、GTF CCWP の 10-32, 10-33
DCB パラメーター
コンポーネント・トレース・データ・セットの
11-18
DD ステートメント
スタンドアロン・ダンプで 4-37, 4-54
SYSIN データ・セット 4-36
SYSPRINT データ・セット 4-36
SYSPUNCH データ・セット 4-38
ログオン・プロシージャー内 5-8
AMBLIST 保守援助プログラム
anyname 15-2
SYSIN データ・セット 15-2
SYSPRINT データ・セット 15-2
IFCDIP00 内の 14-5
X-12
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
DD ステートメント (続き)
SPZAP で
SYSABEND データ・セット 16-20
SYSIN データ・セット 16-5, 16-20, 16-27, 16-29
SYSLIB データ・セット 16-3, 16-4, 16-5, 16-6,
16-14, 16-18, 16-20, 16-27, 16-29
SYSPRINT データ・セット 16-14, 16-19
SYSLIB データ・セット 4-37
SYSMDUMP 5-7
SYSOUT 5-7, 6-2
SYSUT2 ステートメント 4-54
DDN= パラメーター
LISTIDR 制御ステートメント 15-6
LISTLOAD 制御ステートメント 15-3
LISTOBJ 制御ステートメント 15-5
DDR レコード 14-10
DDSPROMPT パラメーター
AMDSADMP マクロの 4-18
DEBUG= パラメーター
GTF の 10-9
DEFAULTS パラメーター
ダンプ・オプション 2-26, 3-7
DIAGxx parmlib メンバー
GFS トレースを要求するための 13-1
DISPLAY オペレーター・コマンド
ダンプ・オプションの表示 2-19, 5-11
SVC ダンプの検出 2-20
SYS1.DUMPxx 情報 19-3
DIV (data-in-virtual) 11-137
DLF (データ索引機能)
コンポーネント・トレース 11-51
DM パラメーター
ダンプ・オプション 5-12, 6-6
DSNTYPE 11-16
DSOM (分散 SOMobjects)
コンポーネント・トレース 11-53
DSP トレース項目
システム・トレースの 8-15
DSP トレース・オプション
GTF の 10-25
DSP トレース・レコード
広範囲の
不定様式 10-101
最小限の
不定様式 10-101
定様式 10-55
DUMP オペレーター・コマンド
ダンプのカスタマイズ 2-37
SVC ダンプの要求 2-15
DUMP キーワード 4-22
DUMP コマンド
コンポーネント・トレースを獲得するための 11-13
DUMP コマンド (続き)
SLIP コマンド 11-13
DUMP パラメーター
AMDSADMP マクロの 4-16, 4-21
DUMPDS オペレーター・コマンド
SYS1.DUMPxx データ・セットのクリア 2-23
DUMPDS コマンド
データ・セットの使用可能化 2-18
DUMPOPT または DUMPOPX パラメーター
ダンプのカスタマイズ 5-20, 5-22, 5-24
DUMP/DUMPT 制御ステートメント
パラメーター 16-30
SPZAP で 16-4, 16-5, 16-7, 16-8, 16-27, 16-29,
16-30
DUMP/DUMPT 制御ステートメント例
ロード・モジュール内の CSECT の修正 16-4
2 つの CSECT の検査と修正 16-5
2 番目の制御ステートメントの説明 16-7
CSECT を修正するために SPZAP を使用する 16-8
dvolser 4-59
E
EID (イベント ID)、GTF 用の 10-92
EMS トレース項目
システム・トレースの 8-19
ENQ パラメーター
ダンプ・オプション 5-12
EOD レコード 14-10
RDE オプション 14-10
EOD レコードで 14-10
ERR パラメーター
ダンプ・オプション 5-12, 6-6
ESTAE または ESTAEX マクロ
ダンプのカスタマイズ 5-20, 5-22, 5-24
ESTAI パラメーター
ダンプのカスタマイズ 5-20, 5-22, 5-24
ETR リカバリー・レコード 14-10
EXT トレース項目
システム・トレースの 8-19
EXT トレース・オプション
GTF の 10-25
EXT トレース・レコード
広範囲の
不定様式 10-102
最小限の
不定様式 10-103
定様式 10-59
F
FID (フォーマット ID) 10-93
FID (フォーマット ID)、GTF 用の 10-93
FLIH (第 1 レベル割り込みハンドラー)
問題データ
外部 FLIH による保管 4-73
I/O FLIH による保管 4-73
SVC FLIH による保管 4-71
FLPA パラメーター
LISTLPA 制御ステートメント 15-7
FORCE ARM コマンド 10-23
FRR (機能リカバリー・ルーチン)
ダンプのカスタマイズ 5-20, 5-22, 5-24
FRR (機能リカバリー・ルーチン) データ
レコード 10-27
FRR トレース・レコード
定様式 10-61
G
GFS トレース
要求 13-1
goff リスト
GOFF レコード付きの LISTOBJ の AMBLIST 出力
15-24
GRSQ パラメーター
ダンプ・オプション 2-26, 3-7, 5-12
GTF START コマンド・パラメーター
parm メンバー
BLOK= 10-8
SIZE= 10-8
GTF カタログ式プロシージャー
IBM デフォルト 10-3, 10-4
GTF トレース
選択理由 1-5
ASIDP オプション 10-24
CCWP オプション 10-25
CSCH オプション 10-25
DSP オプション 10-25
EXT オプション 10-25
HSCH オプション 10-26
IO オプション 10-26
IOX オプション 10-26
JOBNAMEP オプション 10-26
MSCH オプション 10-27
PCI オプション 10-27
PI オプション 10-27
PIP オプション 10-27
RNIO オプション 10-27
SI オプション 10-27
SIOP オプション 10-27
索引
X-13
GTF トレース (続き)
SLIP オプション 10-28
SRM オプション 10-28
SSCH オプション 10-28
SSCHP オプション 10-28
SVC オプション 10-28
SVCP オプション 10-28
SYS オプション 10-28
SYSM オプション 10-29
SYSP オプション 10-29
TRC オプション 10-29
USR オプション 10-29
GTF トレース・イベント
レコード 10-29
GTF トレース・オプション
オプションの組み合わせ 10-30
プロンプト指示 10-31
USRP オプション 10-30
XSCH オプション 10-30
GTF (汎用トレース機能)
開始 10-17
システム・イベントに関する GTF トレースの指定
10-38
システム・イベントの指定 10-39
装置に記録されたデータで開始 10-24
トレース・オプションの組み合わせ 10-30
プロンプト指示 10-31
GTF の開始 10-20
内部トレース・モードによる 10-18
プロンプト指示 10-31
START コマンド 10-17
STOP コマンド 10-22, 10-23
SYS1.PARMLIB 中にあるプロンプト指示キーワード
10-37
SYS1.PARMLIB へのトレース・オプションの格納
10-18, 10-19
VTAM リモート・ネットワーク活動のトレース
10-21
GTF (汎用トレース機能) トレース
カスタマイズ 10-5
カタログ式プロシージャー 10-3, 10-4
カタログ式プロシージャーの設定 10-6
記憶要件の決定 10-12
コンポーネント・トレースによるマージ 10-43
索引付き VTOC 処理中のイベントのトレース 10-2
システム・データ・レコード 10-100
不定様式 10-99
システム・トレースとの併用 10-2
受信 10-40
出力の宛先 10-1
出力を印刷するための IPCS の使用 10-2
消失イベント・レコード 10-51
X-14
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
GTF (汎用トレース機能) トレース (続き)
制御レコード 10-95
ソース索引レコード 10-50
タイム・スタンプ・レコード 10-50
データ脱落レコード 10-96
不定様式 10-97
定様式出力 10-48
トレース・オプションの定義 10-5
トレース・レコードの生成 10-2
トレース・レコードのフォーマット 10-24
入出力トレース・レコード
不定様式 10-106
不定様式出力 10-94
要求理由 10-1
レコード 10-44
CCW トレース・レコード
定様式 10-52
不定様式 10-101
CSCH トレース・レコード
定様式 10-54
DSP トレース・レコード
定様式 10-55
DSP の広範囲トレース・レコード
不定様式 10-101
DSP の最小限トレース・レコード
不定様式 10-101
EXT トレース・レコード
定様式 10-59
EXT の広範囲トレース・レコード
不定様式 10-102
EXT の最小限トレース・レコード 10-103
FRR トレース・レコード
定様式 10-61
GTF の 10-1
GTF の開始
開始方法 10-14
START コマンド 10-14
HEXFORMAT トレース・レコード 10-63
HSCH トレース・レコード
定様式 10-54
IBM 提供のカタログ式プロシージャー 10-4
IBM デフォルト 10-3
IOX トレース・レコード
定様式 10-64
LSR トレース・レコード
定様式 10-66
MSCH トレース・レコード
定様式 10-67
parmlib メンバー・オプション 10-3
PGM トレース・レコード
定様式 10-69
GTF (汎用トレース機能) トレース (続き)
PI トレース・レコード
定様式 10-69
PI の広範囲トレース・レコード
不定様式 10-107
PI の最小限トレース・レコード
不定様式 10-107
RNIO トレース・レコード
定様式 10-70
RR の広範囲トレース・レコード
不定様式 10-107
RR の最小限トレース・レコード
不定様式 10-108
RSCH トレース・レコード
定様式 10-71
SDSP トレース・レコード
定様式 10-55
SLIP DEBUG トレース・レコード
不定様式 10-112
SLIP トレース・レコード
定様式 10-72
不定様式 10-108
SLIP 標準トレース・レコード
不定様式 10-111
SLIP ユーザー・トレース・レコード
不定様式 10-111
SRB トレース・レコード
定様式 10-78
SRM トレース・レコード
定様式 10-79
SRM の広範囲トレース・レコード
不定様式 10-112
SRM の最小限トレース・レコード
不定様式 10-113
SSCH トレース・レコード
定様式 10-80
不定様式 10-113
STAE トレース・レコード
定様式 10-82
SUBSYS トレース・レコード
定様式 10-63
SVC トレース・レコード
定様式 10-83
SVC の広範囲トレース・レコード
不定様式 10-113
SVC の最小限トレース・レコード
不定様式 10-114
SYSTEM トレース・レコード
定様式 10-63
USR トレース・レコード
定様式 10-85
GTF (汎用トレース機能) トレース (続き)
USR トレース・レコード用の EID (イベント
ID) 10-92
USR トレース・レコード用の FID (フォーマット
ID) 10-93
XSCH トレース・レコード
定様式 10-91
GTFTRACE サブコマンド
ダンプまたはデータ・セットからの出力 10-48
GTF トレースをフォーマット設定するための 10-40
H
HEXFORMAT トレース・レコード
定様式 10-63
HSCH トレース項目
システム・トレースの 8-16
HSCH トレース・オプション
GTF の 10-26
HSCH トレース・レコード
定様式 10-54
I
IATUX34 インストール・システム出口
JES3 用
ダンプの抑制 18-14
IBM Health Checker for z/OS
コンポーネント・トレース 11-62
TRACE コマンド 11-64
ID
システム・トレース項目の 8-5
定様式の GTF フォーマット・トレース・レコードの
10-46
IDRC (改良データ記録機能) 特性
COMPACT パラメーター 4-17
IDRDATA 制御ステートメント
パラメーター 16-30
例 16-4, 16-5, 16-7, 16-8, 16-27
SPZAP で 16-4, 16-5, 16-7, 16-8, 16-27, 16-30
IEAABD00 parmlib メンバー
ダンプのカスタマイズ 5-20
ダンプ抑制で 19-5
IEACMD00 parmlib メンバー
ダンプのカスタマイズ 2-36, 3-11
IEADMP00 parmlib メンバー
ダンプのカスタマイズ 5-23
ダンプ抑制で 19-5
IEADMR00 parmlib メンバー
ダンプのカスタマイズ 5-22
ダンプ抑制で 19-5
索引
X-15
IEASLPxx parmlib メンバー
SLIP オペレーター・コマンド 18-12
IEAVADFM 出口
ダンプのカスタマイズ 5-21, 5-25, 6-5
IEAVADUS 出口
ダンプのカスタマイズ 5-21, 5-25, 6-5
IEAVTABX インストール・システム出口
ダンプの抑制 18-14
IEAVTABX 出口
ダンプのカスタマイズ 5-21, 5-23, 5-25
IEAVTSDT プログラム 2-46
IEAVTSEL インストール・システム出口
ダンプの抑制 18-14
IFCDIP00 保守援助機能
機能 14-3
Logrec データ・セットの再初期設定 14-5
JCL の例 14-5
Logrec データ・セットの初期設定 14-3
Logrec データ・セットへのスペースの再割り振り
14-4
JCL の例 14-4
IFCDIP00 - ディスク初期設定プログラム
アプリケーション 14-3
Logrec データ・セットの再初期設定 14-3
Logrec データ・セット・サイズの変更 14-3
IO トレース・オプション
GTF の 10-26
IO パラメーター
ダンプ・オプション 5-12, 6-6
IOP トレース・オプション
プロンプト指示 10-34
GTF の 10-34
IOS
コンポーネント・トレース 11-73
IOS リカバリー・レコード 14-10
IOSB パラメーター、GTF CCWP の 10-32, 10-34
IOX トレース・オプション
GTF の 10-26
IOX トレース・レコード
定様式 10-64
IO=SSCH= キーワード
プロンプト指示 10-35
GTF の 10-35
IPCS SADMP ユーティリティー 4-4
IPCS サブコマンド
VERBEXIT LOGDATA
ストレージ内 Logrec バッファーをフォーマット
設定するための 14-23
IPCS 保守援助プログラム
選択理由 1-6
IPL レコード 14-10
RDE オプション 14-10
X-16
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
IPL/故障率レコーダー
機能 14-9
IPL= パラメーター
AMDSADMP マクロの 4-14
I/O トレース項目
システム・トレースの 8-19
J
JCL ステートメント
AMBLIST 保守援助プログラム 15-2
SPZAP 保守援助プログラム 16-19
JES 共通結合サービス
コンポーネント・トレース 11-80
JES2 サブシステム
コンポーネント・トレース 11-93
JOBNAMEP トレース・オプション
プロンプト指示 10-36
GTF の 10-26, 10-36
JPA パラメーター
ダンプ・オプション 5-12, 6-6
L
LIST 保守援助プログラム
記述 15-1
計画 15-1
制御ステートメント
LISTLOAD ステートメント 16-16
LISTIDR 制御ステートメント
パラメーター
DDN= 15-6
MEMBER= 15-6
TITLE= 15-6
フォーマット 15-5
例 15-12, 15-14
AMBLIST 保守援助プログラム 15-5, 15-6, 15-12,
15-14
OUTPUT= 15-5
MODLIB パラメーター 15-6
LISTLOAD 制御ステートメント
パラメーター
ADATA= 15-4
DDN= 15-3
MEMBER= 15-3
OUTPUT= 15-3
RELOC= 15-4
TITLE= 15-3
フォーマット 15-3
例 15-11, 15-12, 15-15
AMBLIST 保守援助プログラム 15-3, 15-4, 15-11,
15-12, 15-15
LISTLOAD 制御ステートメント (続き)
LIST で 16-16
SSI をリストする 16-16
LISTLPA 制御ステートメント
フォーマット 15-6
例 15-15
AMBLIST 保守援助プログラム 15-6, 15-7, 15-15
FLPA パラメーター 15-7
MLPA パラメーター 15-7
PLPA パラメーター 15-7
LISTOBJ 制御ステートメント
パラメーター
MEMBER= 15-5
TITLE= 15-4
フォーマット 15-4
例 15-8, 15-9, 15-12
AMBLIST 保守援助プログラム 15-4, 15-5, 15-8,
15-9, 15-12
DDN パラメーター 15-5
LLA (ライブラリー索引機能)
コンポーネント・トレース 11-96
LMI リカバリー・レコード 14-10
LNKLIB パラメーター
AMDSADMP マクロの 4-18
LOGDATA 動詞 14-23
Logrec
印刷方法 14-14
記録制御バッファー 14-22
バッファー、記録制御 14-22
バッファーのフォーマット設定 14-23
フォーマット設定 14-23
Logrec エラー・レコード
カスタマイズ 14-33
診断のための 14-1
内容 14-8
Logrec 記録メディア
計画 14-2
Logrec データ・セット
永続的に装着されたボリュームの必要 14-5
エラー記録 14-8
目的 14-1
エラー・レコードの目的 14-1
共用不能データ・セット 14-8
記録されるレコードのタイプ 14-10
再 IPL
JCL の例 14-4
再初期設定 14-3
JCL の例 14-4
サイズ 14-3
初期設定 14-3
スペース割り振り 14-3
再割り振り 14-4
Logrec データ・セット (続き)
スペース割り振り (続き)
JCL の例 14-4
タイプ、レコードの 14-10
タイム・スタンプ・レコード 14-10
フォーマット 14-10
ヘッダー・レコード
機能 14-9
フォーマット 14-9
Logrec データ・セット - IFCDIP00 による再初期設定
記述 14-5
JCL の例 14-5
Logrec データ・セット - IFCDIP00 による再割り振り
記述 14-4
JCL の例 14-4
Logrec データ・セットの再初期設定
訂正不能エラー 14-5
Logrec データ・セットの初期設定 14-3
Logrec データ・セットのソフトウェア・レコード
解釈 14-24
症状レコード 14-24
出力 14-32
SDWA タイプ 14-24
出力 14-25
Logrec データ・セット保守援助プログラム
選択理由 1-6
LOGREC バッファー
ダンプ内のフォーマット 2-51
Logrec ログ・ストリーム
イベント・ヒストリーの作成の例 14-22
エラー記録 14-8
目的 14-1
エラー・レコードの目的 14-1
記録されるレコードのタイプ 14-10
システム・ロガー・ユーティリティーの使用例 14-6
タイプ、レコードの 14-10
定義 14-5
ヒストリー・データ・セットの作成の例 14-21
レコードの入手 14-15
LPA パラメーター
ダンプ・オプション 5-12, 6-6
LSQA パラメーター
ダンプ・オプション 5-12, 6-6
LSR トレース・レコード
定様式 10-66
M
MCH トレース項目
システム・トレースの
MCH レコード 14-10
8-19
索引
X-17
MCIC (マシン・チェック割り込みコード)
問題識別 7-7
MDR レコード 14-10
membername
GTF の 10-14
MEMBER= パラメーター
LISTIDR 制御ステートメント 15-6
LISTLOAD 制御ステートメント 15-3
LISTOBJ 制御ステートメント 15-5
MERGE サブコマンド
コンポーネント・トレース・データの結合とフォーマ
ット設定 11-29
MIH レコード 14-11
MINASID パラメーター
AMDSADMP マクロの 4-17
MLPA パラメーター
LISTLPA 制御ステートメント 15-7
MOBR トレース項目
システム・トレースの 8-13
MODE トレース項目
システム・トレースの 8-13
MODE= パラメーター
GTF の 10-6
MODLIB パラメーター
AMDSADMP マクロの 4-18
LISTIDR 制御ステートメント 15-6
MSCH トレース項目
システム・トレースの 8-16
MSCH トレース・オプション
GTF の 10-27
MSCH トレース・レコード
定様式 10-67
MSG= パラメーター
AMDSADMP マクロの 4-16
N
NAME 制御ステートメント
パラメーター 16-31
例 16-4, 16-5, 16-7, 16-8, 16-27
SPZAP で 16-3, 16-4, 16-5, 16-7, 16-8, 16-27, 16-31
NOALL パラメーター
ダンプ・オプション 2-26, 3-7
NOALLPSA パラメーター
ダンプ・オプション 2-26, 3-7
NODEFAULTS パラメーター
ダンプ・オプション 2-26, 3-7
NOPROMPT パラメーター
GTF の 10-8
NOPSA パラメーター
ダンプ・オプション 2-26, 3-7
X-18
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
NOSQA パラメーター
ダンプ・オプション 2-26, 3-7
NOSUM パラメーター
ダンプ・オプション 2-26, 3-7
NOSYM パラメーター
ダンプ・オプション 5-12
NP パラメーター
GTF の 10-8
NUC パラメーター
ダンプ・オプション 5-12, 6-6
NUCLIB パラメーター
AMDSADMP マクロの 4-18
O
OBR レコード 14-11
OPS (操作サービス・コンポーネント)
コンポーネント・トレース 11-118
OUTPUT= パラメーター
AMDSADMP マクロの 4-15
LISTIDR 制御ステートメント 15-5
LISTLOAD 制御ステートメント 15-3
P
PARM オプション
IGNIDRFULL 16-19
JCL EXEC ステートメントの
SPZAP 保守援助プログラム 16-19
parmlib ライブラリー
IEADMCxx メンバー 2-16
IEASLPxx メンバー 2-16
PC トレース項目
システム・トレースの 8-11
PCDATA パラメーター
ダンプ・オプション 5-12, 6-6
PCI トレース・オプション
GTF の 10-27
PCITAB パラメーター、GTF CCWP の 10-32, 10-34
PGM トレース項目
システム・トレースの 8-23
PGM トレース・レコード
定様式 10-69
PI トレース・オプション
GTF の 10-27
PI トレース・レコード
広範囲の
不定様式 10-107
最小限の
不定様式 10-107
定様式 10-69
PIP トレース・オプション
GTF の 10-27
PLPA パラメーター
LISTLPA 制御ステートメント 15-7
PR トレース項目
システム・トレースの 8-11
PROMPT パラメーター
AMDSADMP マクロの 4-16, 4-21
PSA パラメーター
ダンプ・オプション 2-26, 3-7
PSW パラメーター
ダンプ・オプション 5-12, 6-6
PSWREGS データ
ダンプ内 2-41
PT トレース項目
システム・トレースの 8-11
Q
Q パラメーター
ダンプ・オプション
5-12, 6-6
R
RCVY トレース項目
システム・トレースの 8-24
RDE オプション 14-10
IPL レコードで 14-10
RECORD 制御ステートメント
SPZAP で 16-13
REGS パラメーター
ダンプ・オプション 5-12, 6-6
RELOC= パラメーター
LISTLOAD 制御ステートメント 15-4
REP 制御ステートメント
可変 16-32
例 16-4, 16-5, 16-7, 16-8, 16-27
SPZAP で 16-2, 16-4, 16-5, 16-7, 16-8, 16-27, 16-32
REUSEDS パラメーター
AMDSADMP マクロの 4-17
RGN パラメーター
ダンプ・オプション 5-12
RNIO 定様式トレース・レコード
定様式 10-70
RNIO トレース・オプション
GTF の 10-27
RR トレース・レコード
広範囲の
不定様式 10-107
最小限の
不定様式 10-108
RRS (リソース・リカバリー・サービス)
コンポーネント・トレース 11-123
RSCH トレース項目
システム・トレースの 8-16
RSCH トレース・レコード
定様式 10-71
RSM (実記憶管理プログラム)
コンポーネント・トレース 11-132
RST トレース項目
システム・トレースの 8-19
S
SA パラメーター
ダンプ・オプション 5-12, 6-6
SADMP メッセージ
状況情報
3480 装置 4-59
表示装置の例 4-59
MSADMP#U 4-59
NTRDY メッセージ 4-59
RSADMP# 4-59
RSADMP# U 4-59
SADMP# 4-59
SADMP= パラメーター
GTF の 10-7
SAH パラメーター
ダンプ・オプション 5-12, 6-6
SA= パラメーター
GTF の 10-7
SDSP トレース・レコード
定様式 10-55
SDUMPX 4K SQA バッファー
内容 2-57
SDUMPX マクロ
SVC ダンプの要求 2-14
SDUMP= パラメーター
GTF の 10-7
SDWA (システム診断作業域)
記録可能拡張部分 14-31
SDWAVRA (SDWA 可変記録域)
キー、長さ、データ・フォーマット 14-30
SD= パラメーター
GTF の 10-7
SETRP マクロ
ダンプのカスタマイズ 5-20, 5-22, 5-24
ABEND ダンプの要求 5-8
SETSSI 制御ステートメント
パラメーター 16-33
例 16-4, 16-5, 16-7, 16-8
SPZAP で 16-4, 16-5, 16-7, 16-8, 16-16, 16-33
索引
X-19
SIGA トレース項目
システム・トレースの 8-16
SIO トレース・オプション
GTF の 10-27
SIOP トレース・オプション
GTF の 10-27
SLH レコード 14-11
SLIP オペレーター・コマンド
制御ダンプ内容 2-35, 3-10
ダンプの抑制 18-12
SVC ダンプの要求 2-16
SLIP コマンド
SDUMPX 4K SQA バッファー・データ 2-57
SLIP 作業域データ 4-70
SLIP 作業域
内容 4-70
SLIP データ
レコード 10-28
SLIP デバッグ・トレース・レコード
定様式 10-77
不定様式 10-112
SLIP トレース・オプション
GTF の 10-28
SLIP 標準トレース・レコード
定様式 10-75
不定様式 10-111
SLIP 保守援助プログラム
選択理由 1-6
SLIP ユーザー・トレース・レコード
定様式 10-75, 10-76
不定様式 10-111
SNAP ダンプ
概要 6-1
カスタマイズ 6-5
選択理由 1-3
内容 6-5
要求 6-1
SNAP マクロ
ダンプを要求するための 6-4
SNAP または SNAPX マクロ
ダンプのカスタマイズ 5-20, 5-22, 5-24
SNAP ダンプの要求 6-3
SPER トレース項目
システム・トレースの 8-23
SPI (サービス・プロセッサー・インターフェース)
コンポーネント・トレース 11-151
SPLS オプション
ダンプのカスタマイズ 5-19, 5-20, 5-24
SPLS パラメーター
ダンプ・オプション 5-12, 6-7
SPR2 トレース項目
システム・トレースの 8-23
X-20
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SPZAP 保守援助プログラム
記述 16-1
システム状況情報の更新 16-16
出力 16-34
制御ステートメント
コーディングの規則 16-23
マクロ 16-4, 16-5, 16-7, 16-8, 16-27, 16-29
ABSDUMP 16-14, 16-24
ABSDUMPT 16-14, 16-24
BASE ステートメント 16-11, 16-26, 16-27
CCHHR ステートメント 16-12, 16-27
CHECKSUM ステートメント 16-28
CONSOLE ステートメント 16-29
DUMPT 16-4, 16-5, 16-7, 16-8, 16-27, 16-29
IDRDATA ステートメント 16-4, 16-5, 16-7,
16-8, 16-27, 16-30
NAME ステートメント 16-3, 16-4, 16-5, 16-7,
16-8, 16-27, 16-31
RECORD ステートメント 16-13
REP ステートメント 16-2, 16-4, 16-5, 16-7,
16-8, 16-27, 16-32
SETSSI ステートメント 16-4, 16-5, 16-7, 16-8,
16-16, 16-33
VERIFY ステートメント 16-2, 16-4, 16-5, 16-7,
16-8, 16-27, 16-34
* 16-28
選択理由 1-7
操作上の考慮事項 16-18
データ・レコード
検査 16-2, 16-12
修正 16-2, 16-12
動的呼び出し
マクロ形式 16-21
例 16-22
プログラム・オブジェクト
検査 16-3
修正 16-3
戻りコード 16-20
例
実行 16-4
ロード・モジュール
検査 16-3
修正 16-3
ロード・モジュールのアクセス 16-11
JCL ステートメント 16-19
SPZAP 使用のモニター 16-1
SPZAP 例
UNIX の CSECT の検査と修正 16-9
SQA バッファー、SDUMPX の
内容 2-57
SQA パラメーター
ダンプ・オプション 5-12, 6-7
SRB 定様式トレース・レコード
GTF トレースの 10-78
SRB トレース項目
システム・トレースの 8-15
SRM データ
レコード 10-28
SRM トレース・オプション
GTF の 10-28
SRM トレース・レコード
広範囲の
不定様式 10-112
最小限の
不定様式 10-113
定様式 10-79
SS トレース項目
システム・トレースの 8-19
SSAR トレース項目
システム・トレースの 8-11
SSCH トレース項目
システム・トレースの 8-16
SSCH トレース・オプション
GTF の 10-28
SSCH トレース・レコード
定様式 10-80
不定様式 10-113
SSCHP トレース・オプション
プロンプト指示 10-36
GTF の 10-28, 10-36
SSI (システム状況索引)
フィールド 16-16
フラグ・バイト 16-16, 16-17
SSRB トレース項目
システム・トレースの 8-15
SSRV トレース項目
システム・トレースの 8-31
STAE トレース・レコード
定様式 10-82
START コマンド 10-22
GTF の 10-14
status
マスター・トレースの 9-2
SYS1.DUMPxx データ・セットの 2-19
STATUS サブコマンド
FAILDATA 報告書 2-47
REGISTERS 報告書 2-54
SYSTEM 報告書 2-46
WORKSHEET 報告書 2-44
STOP コマンド 10-22
STORE STATUS
スタンドアロン・ダンプ 4-43
STORE STATUS コマンド 4-7, 4-43, 4-49
SUBPLST オプション
ダンプのカスタマイズ 5-19, 5-20, 5-24
SUBSYS トレース・レコード
定様式 10-63
SUBTASKS パラメーター
ダンプ・オプション 2-31, 5-12, 6-7
マクロ・パラメーター・リストで 5-19
SUM パラメーター
ダンプ・オプション 5-12
SUMDUMP 出力 2-38, 2-39
SUMLIST アドレス範囲
ダンプ内 2-40, 2-41
SUMLSTA アドレス範囲
ダンプ内 2-40, 2-41
SUMMARY サブコマンド
TCBERROR 報告書 2-49
SUSP トレース項目
システム・トレースの 8-21
SUSPEND パラメーター
要約ダンプの制御 2-31
SVC D
SYSTRACE 報告書内の例 2-54
SVC ダンプ
印刷 2-23
オプション表示 2-19
概要 2-1
カスタマイズ 2-25
クリア 2-23
コピー 2-23
コンポーネント・トレース・レコードを含む 11-15
事前割り振りデータ・セット 2-7
自動割り振りデータ・セット 2-2
症状ダンプ 19-3
スケジュールされた 2-1
選択理由 1-4
ダンプ内容の要約 2-31
ダンプ・データ・セットの計画 2-2
データ・セット 2-18
デバッグ・ヒント 2-38
同期 2-1
内容 2-24
非同期 2-1
表示 2-23
分岐入力 SDUMPX 用の SUMDUMP 出力 2-40
要求 2-13
要約ダンプ 2-1
抑制 18-1
DUMPDS コマンド 2-18
IPCS を使用した分析 2-42
SVC ダンプの SUMDUMP 出力 2-39
SVC ダンプの要約 2-1
索引
X-21
SVC ダンプ例
DISPLAY DUMP,ERRDATA コマンド 2-22
IPCS VERBX SUMDUMP コマンド 2-39
SVC トレース項目
システム・トレースの 8-29
SVC トレース・オプション
GTF の 10-28
SVC トレース・レコード
広範囲の
不定様式 10-113
最小限の
不定様式 10-114
定様式 10-83
SVC 割り込み
レコード 10-28
SVCE トレース項目
システム・トレースの 8-29
SVCP トレース・オプション
プロンプト指示 10-36
GTF の 10-28, 10-36
SVCR トレース項目
システム・トレースの 8-29
SWA パラメーター
ダンプ・オプション 5-12, 6-7
SYMREC マクロ 14-31
SYS トレース・オプション
特定のトレース・オプションの組み合わせ 10-30
GTF の 10-28, 10-30
SYS1.DUMPxx データ・セット
可用性 2-19
状況判別 2-19
制御 2-12
内容の判別 2-20
表示情報 19-3
SVC ダンプの受信 2-14
指定 2-11
SYS1.LPALIB ライブラリー 16-18
SYS1.MACLIB
AMDSADMP マクロ
アセンブリー 4-38
SYSABEND
分析方法 5-1
SYSABEND DD ステートメント 16-20
SYSABEND ダンプ
カスタマイズ 5-20
症状ダンプ 19-3
分析 5-25
SYSAPPC コンポーネント・トレース
トレース要求オプション 11-31
フォーマット設定オプション 11-36
CTnAPPxx parmlib メンバー 11-31
FMH-5 トレース・データ 11-42
X-22
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
SYSAPPC コンポーネント・トレース (続き)
FULL 報告書 11-42
SHORT 報告書 11-40
SUMMARY 報告書 11-41
TRACE コマンド 11-32
SYSAXR コンポーネント・トレース
トレース要求オプション 11-48
フォーマット設定オプション 11-50
CTIAXRxx parmlib メンバー 11-48
TRACE コマンド 11-48
SYSDLF コンポーネント・トレース
FULL 報告書 11-52
SYSDSOM コンポーネント・トレース
FULL 報告書 11-54
SYSGRS コンポーネント・トレース
トレース要求オプション 11-56
CTnGRSxx parmlib メンバー 11-56
SHORT 報告書 11-61
TALLY 報告書 11-61
TRACE コマンド 11-57
SYSHZS コンポーネント・トレース
出力 11-65
トレース要求オプション 11-63
フォーマット 11-65
例 11-65
CTIHZS00 parmlib メンバー 11-63
SHORT 報告書 11-65
SYSIEFAL コンポーネント・トレース
トレース要求オプション 11-67
CTIIEFxx parmlib メンバー 11-67
FULL 報告書 11-72
SHORT 報告書 11-72
TRACE コマンド 11-68
SYSIN DD ステートメント 16-5, 16-20, 16-27
スタンドアロン・ダンプで 4-36
AMBLIST 保守援助プログラムで使用される 15-2
SPZAP で使用する 16-29
SYSIOS コンポーネント・トレース
トレース要求オプション 11-75
CTnIOSxx parmlib メンバー 11-75
SHORT 報告書 11-78
TRACE コマンド 11-75
SYSJES コンポーネント・トレース
検査 11-26
フォーマット設定オプション 11-86
要求 11-82
要求サブレベル 11-81
CTnJESxx parmlib メンバー 11-83
TRACE コマンド 11-83
SYSjes2 コンポーネント・トレース
フォーマット設定オプション 11-94
要求 11-94
SYSjes2 コンポーネント・トレース (続き)
要求サブレベル 11-93
SYSLIB DD ステートメント 16-3, 16-4, 16-5, 16-6,
16-14, 16-18, 16-20, 16-27
スタンドアロン・ダンプで 4-37
SPZAP で使用する 16-29
SYSLOGR コンポーネント・トレース
出力 11-105
トレース要求オプション 11-103
CTnLOGxx parmlib メンバー 11-101
SYSM トレース・オプション
GTF の 10-29
SYSMDUMP
分析方法 5-1
SYSMDUMP ダンプ
カスタマイズ 5-22
事前割り振りデータ・セット 5-5
症状ダンプ 19-3
抑制 18-1
VIO データ・セットへの 5-5
SYSOMVS コンポーネント・トレース
トレース要求オプション 11-108
フォーマット設定オプション 11-109
CTnBPXxx parmlib メンバー 11-106
FULL 報告書 11-111
SUMMARY 報告書 11-116
TRACE コマンド 11-107
SYSOPS コンポーネント・トレース
トレース要求オプション 11-118
トレース・オプション 11-120
フォーマット設定オプション 11-121
CTnOPSxx parmlib メンバー 11-118
TRACE コマンド 11-119
SYSOUT データ・セット
ABEND ダンプの受信 5-9
SYSP トレース・オプション
GTF の 10-29
SYSPRINT DD
AMBLIST 保守援助プログラムで使用される 15-2
SYSPRINT DD ステートメント 16-14, 16-19
スタンドアロン・ダンプで 4-36
SYSPUNCH DD ステートメント
スタンドアロン・ダンプで 4-38
SYSRRS コンポーネント・トレース
トレース要求オプション 11-124
CTnRRSxx parmlib メンバー 11-124
FULL 報告書 11-131
SHORT 報告書 11-130
SUMMARY 報告書 11-131
TALLY 報告書 11-132
TRACE コマンド 11-125
SYSRSM コンポーネント・トレース
トレース要求オプション 11-133
CTnRSMxx parmlib メンバー 11-133
FULL 報告書 11-149
TRACE コマンド 11-134
System REXX コンポーネント
System REXX コンポーネントを参照。 11-47
System REXX コンポーネント (System REXX コンポー
ネント)
コンポーネント・トレース 11-47
SYSTEM トレース・レコード
定様式 10-63
SYSTRACE サブコマンド
ダンプ出力 8-4
SYSUDUMP
分析方法 5-1
SYSUDUMP ダンプ
カスタマイズ 5-23
症状ダンプ 19-3
分析 5-25
SYSUT2 DD ステートメント 4-54
SYSUT= パラメーター
AMDSADMP マクロの 4-15
SYSVLF コンポーネント・トレース
トレース要求オプション 11-153
FULL 報告書 11-154
SYSWLM コンポーネント・トレース
トレース要求オプション 11-157
フォーマット設定オプション 11-157
FULL 報告書 11-158
TRACE コマンド 11-157
SYSXCF コンポーネント・トレース
トレース要求オプション 11-159
フォーマット設定オプション 11-162
CTnXCFxx parmlib メンバー 11-160
FULL 報告書 11-163
TRACE コマンド 11-160
SYSXES コンポーネント・トレース
検査 11-26
トレース要求オプション 11-166, 11-167
フォーマット設定オプション 11-168
CTnXESxx parmlib メンバー 11-166
SHORT 報告書 11-170
TRACE コマンド 11-167
S|I|SI パラメーター、GTF CCWP の 10-33
T
TIME トレース項目
システム・トレースの
TIME= パラメーター
GTF の 10-8
8-40
索引
X-23
TITLE= パラメーター
LISTIDR 制御ステートメント 15-6
LISTLOAD 制御ステートメント 15-3
LISTOBJ 制御ステートメント 15-4
TRACE オペレーター・コマンド
マスター・トレース状況の判別 9-2
TRACE コマンド
IBM Health Checker for z/OS 11-64
SYSAPPC コンポーネント・トレースの 11-32
SYSAXR コンポーネント・トレースの 11-48
SYSGRS コンポーネント・トレースの 11-57
SYSIEFAL コンポーネント・トレース用 11-68
SYSIOS コンポーネント・トレースの 11-75
SYSJES コンポーネント・トレースの 11-83
SYSOMVS コンポーネント・トレースの 11-107
SYSOPS コンポーネント・トレースの 11-119
SYSRRS コンポーネント・トレース用の 11-125
SYSRSM コンポーネント・トレースの 11-134
SYSWLM コンポーネント・トレースの 11-157
SYSXCF コンポーネント・トレースの 11-160
SYSXES コンポーネント・トレースの 11-167
TRC トレース・オプション
GTF の 10-29
TRT パラメーター
ダンプ・オプション 5-12, 6-7
TTRC (トランザクション・トレース)
トランザクション・トレース 11-152
U
ULABEL= パラメーター
AMDSADMP マクロの 4-14
USR トレース・オプション
GTF の 10-29, 10-30
USR トレース・レコード
定様式 10-85
USRn トレース項目
システム・トレースの 8-41
USRP トレース・オプション
プロンプト指示 10-36
GTF の 10-29, 10-30, 10-36
V
VERBEXIT MTRACE サブコマンド
ダンプ出力 9-4
マスター・トレースをフォーマット設定するための
9-3
VERBEXIT サブコマンド
LOGDATA 報告書 2-51
TRACE 報告書 2-54
X-24
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
VERIFY 制御ステートメント
パラメーター 16-34
例 16-4, 16-5, 16-7, 16-8, 16-27
SPZAP で 16-2, 16-4, 16-5, 16-7, 16-8, 16-27, 16-34
VLF (仮想索引機能)
コンポーネント・トレース 11-152
VOLSER= パラメーター
AMDSADMP マクロの 4-14
VSAM オブジェクト
アクセス 16-20
VTAM ネットワーク活動
レコード 10-27
W
WAIT トレース項目
システム・トレースの 8-15
WLM (ワークロード管理機能)
コンポーネント・トレース 11-156
WRAP パラメーター
TRACE CT コマンド 11-18
WTO 記録制御バッファーの場所 14-23
X
XCF(システム間カップリング・ファシリティー)
コンポーネント・トレース 11-159
XSCH トレース項目
システム・トレースの 8-16
XSCH トレース・オプション
GTF の 10-30
XSCH トレース・レコード
定様式 10-91
xsd リスト
XSD レコード付きの LISTOBJ の AMBLIST 出力
15-23
Z
z/OS UNIX
コンポーネント・トレース 11-105
ファイル・サポート 15-16
例 15-16
AMBLIST 保守援助プログラム 15-16
NAME 制御ステートメント 16-3
REP ステートメント 16-2
SPZAP 例
CSECT の検査と修正 16-9
VERIFY ステートメント 16-2
［特殊文字］
* 制御ステートメント
SPZAP で 16-28
索引
X-25
X-26
z/OS V1R9.0 MVS 診断: ツールと保守援助プログラム
򔻐򗗠򙳰
プログラム番号: 5694-A01, 5655-G52
Printed in Japan
GA88-8561-09