ユーザー・ノートの作成と管理

ユーザー・ノートは、対話式ユーザーが任意の保管場所に対して追加できるコメントです。ヒストリー・ファイルの障害項目に保管され、すべてのユーザーが使用できます。

ユーザー・ノートは、Interactive Reanalysis Report 画面から NOTE コマンドを使用して作成できます。詳しくは、NOTEを参照してください。

または、次の画面を上書きすることにより、ユーザー・ノートを作成することができます。

ダンプ・ストレージ (Dump Storage)
関連ストレージ域 (Associated Storage Areas)
イベント関連ストレージ域 (イベント n プログラム name のストレージ域)
16 進ダンプ・ストレージ (Hex-Dumped Storage)

以下では、これらを簡単に「ストレージ域」画面と呼びます。

ノートが表示されるストレージ域にカーソルを合わせ、16 進数字と区別可能な 1 つ以上の文字を入力して Enter を押すと、ユーザー・ノートが作成されます。例えば、Dump Storage 画面の例にある Dump Storage 画面の場合、アドレス 17C01389 ストレージにカーソルを置き、「This is」と入力すると、次のような画面が表示されます。

  File  View  Services  Help
──────────────────────────────────────────────────────────────────────────────
Dump Storage                                                 17C01380-17C013D7
Command ===> ________________________________________________ Scroll ===> CSR 
JOBNAME: IDIVPCOB  SYSTEM ABEND: 0C7              MVS2     2019/08/12 13:46:58

Address  Offset     Hex                                 EBCDIC / ASCII  
         Module IDISCBL1 program IDISCBL1 + X'640', source line # 32
         Event 1 Program IDISCBL1 GPR 1 + X'1051'
         Event 1 Program IDISCBL1 GPR 10 + X'1300'
         Event 1 Program IDISCBL1 GPR 11 + X'1008'
         Event 1 Program IDISCBL1 GPR 12 + X'1348'
         Event 1 Program IDISCBL1 GPR 14 + X'680'
         Event 1 Program IDISCBL1 GPR 3 + X'600'
         Event 1 Program IDISCBL1 GPR 4 + X'1544'
17C01380            20004160 61345060 51This i s10C310A *...-/.&-..K.....*
17C01390       +10  D2035110 310E5860 20085060 5114D20B *K......-..&-..K.*
17C013A0       +20  51183112 58602004 50605128 58602008 *.....-..&-...-..*
17C013B0       +30  5060512C D2175130 311E98EC D00C07FE *&-..K.....q.}...*
         Module IDISCBL1 CSECT CEESG005
17C013C0       +40  E2F0F0F5 00140001 00000000 00000000 *S005............*
17C013D0       +50  00000000 00000000                   *........        *
         Module IDISCBL1 CSECT CEEBETBL
 F1=Help   F3=Exit   F7=Up     F8=Down  F10=Prev  F11=Next

Enter を押すと ISPF 編集パネルが表示され、入力したテキストで初期設定されます。

  File  Edit  Edit_Settings  Menu  Utilities  Compilers  Test  Help
────────────────────Volume: ───────────────────────────────────────────────────
EDIT       Note.17C01389                                   Columns 00001 00072
Command ===> ________________________________________________ Scroll ===> PAGE
****** ***************************** Top of Data ******************************
000001 This is
****** **************************** Bottom of Data ****************************















 F1=Help      F2=Split     F3=Exit      F4=:tf       F5=Rfind     F6=Rchange
 F7=Up        F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

必要な行を追加し、ノート作成が完了します。後でノート画面が縮小した場合、ノートはその行のみ表示されるため、最初の行は見出しとして使用する必要があります。

最後のノートは次のようになります。

  File  Edit  Edit_Settings  Menu  Utilities  Compilers  Test  Help
────────────────────Volume: ───────────────────────────────────────────────────
EDIT       Note.17C01389                                   Columns 00001 00072
Command ===> ________________________________________________ Scroll ===> PAGE
****** ***************************** Top of Data ******************************
000001 This is an important reminder!
000002 The contents of storage at this offset into this module could be
000003 significant for the understanding of the error that caused this fault.
****** **************************** Bottom of Data ****************************













 F1=Help      F2=Split     F3=Exit      F4=:tf       F5=Rfind     F6=Rchange
 F7=Up        F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

PF3 を押すとストレージ域画面に戻ります。新規に作成され、属するストレージの前に挿入されたユーザー・ノートが表示されます。

  File  View  Services  Help
──────────────────────────────────────────────────────────────────────────────
Dump Storage                                                 17C01380-17C013D7
Command ===> ________________________________________________ Scroll ===> CSR 
JOBNAME: IDIVPCOB  SYSTEM ABEND: 0C7              MVS2     2019/08/12 13:46:58

Address  Offset     Hex                                 EBCDIC / ASCII  
         Module IDISCBL1 program IDISCBL1 + X'640', source line # 32
         Event 1 Program IDISCBL1 GPR 1 + X'1051'
         Event 1 Program IDISCBL1 GPR 10 + X'1300'
         Event 1 Program IDISCBL1 GPR 11 + X'1008'
         Event 1 Program IDISCBL1 GPR 12 + X'1348'
         Event 1 Program IDISCBL1 GPR 14 + X'680'
         Event 1 Program IDISCBL1 GPR 3 + X'600'
         Event 1 Program IDISCBL1 GPR 4 + X'1544'
17C01380            20004160 61345060 51                *...-/.&-.       *
- This is an important reminder!
  The contents of storage at this offset into this module could be
  significant for the understanding of the error that caused this fault.
17C01389        +9                      08D203 510C310A *         .K.....*
17C01390       +10  D2035110 310E5860 20085060 5114D20B *K......-..&-..K.*
17C013A0       +20  51183112 58602004 50605128 58602008 *.....-..&-...-..*
17C013B0       +30  5060512C D2175130 311E98EC D00C07FE *&-..K.....q.}...*
 F1=Help   F3=Exit   F7=Up     F8=Down  F10=Prev  F11=Next

デフォルトでは、すべてのユーザー・ノートは「展開」されて表示され、それはノートの前にある負符号 (-) のポイント・アンド・シュート・フィールドで示されます。このフィールドにカーソルを置いて Enter を押すと、ノートは次のように縮小されます。

  File  View  Services  Help
──────────────────────────────────────────────────────────────────────────────
Dump Storage                                                 17C01380-17C013D7
Command ===> ________________________________________________ Scroll ===> CSR 
JOBNAME: IDIVPCOB  SYSTEM ABEND: 0C7              MVS2     2019/08/12 13:46:58

Address  Offset     Hex                                 EBCDIC / ASCII  
         Module IDISCBL1 program IDISCBL1 + X'640', source line # 32
         Event 1 Program IDISCBL1 GPR 1 + X'1051'
         Event 1 Program IDISCBL1 GPR 10 + X'1300'
         Event 1 Program IDISCBL1 GPR 11 + X'1008'
         Event 1 Program IDISCBL1 GPR 12 + X'1348'
         Event 1 Program IDISCBL1 GPR 14 + X'680'
         Event 1 Program IDISCBL1 GPR 3 + X'600'
         Event 1 Program IDISCBL1 GPR 4 + X'1544'
17C01380            20004160 61345060 51                *...-/.&-.       *
+ This is an important reminder!
17C01389        +9                      08D203 510C310A *         .K.....*
17C01390       +10  D2035110 310E5860 20085060 5114D20B *K......-..&-..K.*
17C013A0       +20  51183112 58602004 50605128 58602008 *.....-..&-...-..*
17C013B0       +30  5060512C D2175130 311E98EC D00C07FE *&-..K.....q.}...*
         Module IDISCBL1 CSECT CEESG005
17C013C0       +40  E2F0F0F5 00140001 00000000 00000000 *S005............*
 F1=Help   F3=Exit   F7=Up     F8=Down  F10=Prev  F11=Next

ポイント・アンド・シュート・フィールドが正符号 (+) になり、「縮小」されていることを示します。このポイント・アンド・シュート・フィールドにカーソルを置くことで、縮小または展開ビューを切り替えられます。

以下の 2 つの追加のアクション文字 (大/小文字は区別されません) を使用して、ポイント・アンド・シュート・フィールドを上書きすることも可能です。

D: ユーザー・ノートの削除に使用します。
E: ユーザー・ノートの編集に使用します。

現行の障害項目に存在するすべてのユーザー・ノートを表示するには、対話式レポートの任意の画面のコマンド行から NOTELIST コマンドを入力するか、View アクション・バーのプルダウン・メニューから「List User Notes」オプションを選択します。結果は、User Note List 画面の例に示す例のように表示されます。

図 1. User Note List 画面の例

  File  View  Services  Help
───────────────────────────────────────────────────────────────────────────────
User Note List                                                 Line 1 Col 1 80
Command ===> ________________________________________________ Scroll ===> CSR 
JOBNAME: IDIVPCOB  SYSTEM ABEND: 0C7              MVS2     2019/08/12 13:46:58

- Collapse all / + Expand all
{The following line commands are available: E (Edit), D (Delete), S (Show), +
(Expand), - (Collapse). To enter a line command, overtype the +/- sign in
column 1, or simply place the cursor on the +/- sign and press Enter to
perform the default expand/collapse action indicated.}

    Address  Text                                                              
-   17C01389 This is an important reminder!
             The contents of storage at this offset into this module could be
             significant for the understanding of the error that caused this fa
-   17C01610 So is this!





 F1=Help      F3=Exit      F5=RptFind   F6=Actions   F7=Up        F8=Down
F10=Left     F11=Right

この画面のオプションのヘルプ・テキストに示されるように、各ユーザー・ノートの前に示されるポイント・アンド・シュート・フィールドは、ストレージ域画面と同様に特定のアクションを要求するために上書き入力できます。

また、User Note List 画面では、最上部にある「Expand all」または「Collapse all」ポイント・アンド・シュート・フィールドを選択することで、同期的に展開または縮小できます。ノートの展開または縮小という状態は、User Note List 画面と Dump Storage 画面で共通です。そのため、一方の画面に加えられた変更は、もう一方の画面に反映されます。

ユーザー・ノートに関連するストレージを表示するには、S 行コマンドを使用するか、アドレスのポイント・アンド・シュート・フィールドにカーソルを置き、Enter キーを押します。

ユーザーが対話式レポートを終了する際、ユーザー・ノートはヒストリー・ファイルの障害項目に保管されます。このとき、ユーザー・ノートが追加または変更されていた場合、User Notes Update プロンプトの例の例に示す画面のように、障害項目の更新の確認プロンプトが出されます。

図 2. User Notes Update プロンプトの例

  File  View  Services  Help
_ ┌──────────────────────────── User Notes Update ────────────────────────────┐
I │                                                                           │
C │ User notes have been added or modified for the current fault entry. Press │
J │ Enter to update the fault entry with the current user notes, or press     │
  │ PF3/PF12 to exit from the interactive report without updating the fault   │
F │ entry.                                                                    │
M │                                                                           │
  │ History file DSN  . : 'IDI.HIST'                                          │
S │ Fault ID  . . . . . : F00264                                              │
i │                                                                           │
  │  F1=Help     F3=Exit    F12=Cancel                                        │
  └───────────────────────────────────────────────────────────────────────────┘
  4. Storage Areas
  5. Messages
  6. Language Environment Heap Analysis
  7. Abend Job Information
  8. Fault Analyzer Options

{Fault Analyzer maximum storage allocated: 2.61 megabytes.}

*** Bottom of data.
 F1=Help      F3=Exit      F5=RptFind   F6=Actions   F7=Up        F8=Down
F10=Left     F11=Right

この画面で Enter を押すと、ヒストリー・ファイルの障害項目をリフレッシュします。PF3 または PF12 を押すと、ユーザー・ノートは更新せずに対話式レポートを終了します。