このドキュメントでは ADAFIN ユーティリティについて説明します。
次のトピックについて説明します。
ファイル情報ユーティリティ ADAFIN を使用すると、選択した 1 つ以上のファイルについて、次の情報を表示できます。
FDT
ディスクリプタ情報
データストレージ、ノーマルインデックス、またはアッパーインデックスのブロック数とその用途
（選択された 1 つ以上のファイル）。
このユーティリティは多機能ユーティリティです。
| データセット | 環境 変数／ 論理名 |
記憶 媒体 |
追加情報 |
|---|---|---|---|
| アソシエータ | ASSOx | ディスク | |
| データストレージ | DATAx | ディスク | |
| コントロールステートメント | stdin/ SYS$INPUT |
ユーティリティマニュアル | |
| ADAFIN メッセージ | stdout/ SYS$OUTPUT |
メッセージおよびコード | |
| WORK | WORK1 | ディスク |
このユーティリティはチェックポイントを書き込みません。
次のコントロールパラメータを使用できます。
ADAM_DS = keyword
M DBID = number
DESCRIPTOR = { = | : }{ * | (string [,string]...) }
FDT
M FILE = { * | (number [-number] [,number [-number]]...) }
D [NO]HISTOGRAM
USAGE = (keyword [,keyword [,keyword]])
ADAM_DS = keyword
このパラメータは、ADAM ファイルの USAGE=DS と組み合わせて使用できます。これにより、情報を表示するための ADAM ファイルのデータセクションを選択します。次のキーワードを使用できます。
| キーワード | 説明 |
|---|---|
| FULL | DS スペースすべてを選びます。 |
| ADAM | ADAM エリアだけを選びます。 |
| OVERFLOW | ADAM オーバーフローエリアだけを選びます。 |
DBID = number
このパラメータは、使用対象となるデータベースを選択するためのものです。
DESCRIPTOR = { = | : }{ * | (string [,string]...) }
この機能は、情報を表示するためのディスクリプタのリストを定義するものです。複数のファイルを選択する場合、全ディスクリプタに対する場合（DESCRIPTOR = *）にのみ情報は要求できます。
DESCRIPTOR 機能は、ニュークリアスが稼動している状態で、選択ファイルが更新用にオープンされていない場合にだけ実行できます。この機能は、FILE パラメータとともに選択する必要があります。
DESCRIPTOR 機能は並列更新（例えば ADAINV REINVERT）に対して同期を取りません。
adafin: file=13, descriptor=ca
Database 76, File 13 (MISCELLANEOUS ) 27-OCT-2006 08:08:17
Descriptor CA , Format: A , Options: NU
min max ave
---------------------------------------------------------
Length 1 233 20.59
ISNs per value 1 2 1.08
Values: different: 86 total: 93
ASSO-Blocks: NI: 2 UI: 1
adafin: file=(11,12), descriptor=*
Database 1, File 11 (EMPLOYEES-NAT ) 27-OCT-2006 08:09:39
Descriptor AA , Format: A , Options: UQ
min max ave
-------------------------------------------------------------------------
Length 8 8 8.00
ISNs per value 1 1 1.00
Values: different: 1,107 total: 1,107
ASSO-Blocks: NI: 5 UI: 1
Descriptor AE , Format: A , Options: None
min max ave
-------------------------------------------------------------------------
Length 3 17 6.78
ISNs per value 1 19 1.37
Values: different: 804 total: 1,107
ASSO-Blocks: NI: 4 UI: 1
Descriptor AH , Format: P , Options: NC
min max ave
-------------------------------------------------------------------------
Length 4 4 4.00
ISNs per value 1 43 1.20
Values: different: 921 total: 1,107
ASSO-Blocks: NI: 4 UI: 1
Descriptor AJ , Format: A , Options: NU
min max ave
-------------------------------------------------------------------------
Length 3 20 8.52
ISNs per value 1 141 3.60
Values: different: 307 total: 1,107
ASSO-Blocks: NI: 3 UI: 1
Descriptor AO , Format: A , Options: None
min max ave
-------------------------------------------------------------------------
Length 6 6 6.00
ISNs per value 1 99 6.62
Values: different: 167 total: 1,107
ASSO-Blocks: NI: 2 UI: 1
Descriptor AP , Format: A , Options: NU
min max ave
-------------------------------------------------------------------------
Length 2 25 12.56
ISNs per value 1 75 4.67
Values: different: 237 total: 1,107
ASSO-Blocks: NI: 3 UI: 1
Descriptor AZ , Format: A , Options: NU,MU
min max ave
-------------------------------------------------------------------------
Length 3 3 3.00
ISNs per value 1 843 86.28
Values: different: 21 total: 1,812
ASSO-Blocks: NI: 2 UI: 1
Super-Descriptor H1 , Format: B , Options: NU
Parent field(s): AU ( 1 - 2) U
AV ( 1 - 2) U
min max ave
-------------------------------------------------------------------------
Length 4 4 4.00
ISNs per value 1 93 4.17
Values: different: 259 total: 1,081
ASSO-Blocks: NI: 2 UI: 1
Phonetic-Descriptor PH , Format: A , Options: None
Parent field(s): AE A
min max ave
-------------------------------------------------------------------------
Length 3 3 3.00
ISNs per value 1 33 1.82
Values: different: 608 total: 1,107
ASSO-Blocks: NI: 3 UI: 1
Sub-Descriptor S1 , Format: A , Options: None
Parent field(s): AO ( 1 - 4) A
min max ave
-------------------------------------------------------------------------
Length 4 4 4.00
ISNs per value 1 208 85.15
Values: different: 13 total: 1,107
ASSO-Blocks: NI: 2 UI: 1
Super-Descriptor S2 , Format: A , Options: None
Parent field(s): AO ( 1 - 6) A
AE ( 1 - 20) A
min max ave
-------------------------------------------------------------------------
Length 9 23 12.78
ISNs per value 1 5 1.05
Values: different: 1,052 total: 1,107
ASSO-Blocks: NI: 6 UI: 1
Super-Descriptor S3 , Format: A , Options: NU,PE
Parent field(s): AR ( 1 - 3) A
AS ( 1 - 9) P
min max ave
-------------------------------------------------------------------------
Length 12 12 12.00
ISNs per value 1 25 2.15
Values: different: 1,567 total: 3,383
ASSO-Blocks: NI: 10 UI: 1
Highest PE-occurrence: 5
Database 1, File 12 (VEHICLES ) 10-OCT-2006 14:30:39
Descriptor AA , Format: A , Options: UQ,NU
min max ave
-------------------------------------------------------------------------
Length 6 10 7.91
ISNs per value 1 1 1.00
Values: different: 772 total: 772
ASSO-Blocks: NI: 4 UI: 1
Descriptor AC , Format: A , Options: None
min max ave
-------------------------------------------------------------------------
Length 1 8 7.74
ISNs per value 1 24 1.16
Values: different: 662 total: 773
ASSO-Blocks: NI: 3 UI: 1
Descriptor AD , Format: A , Options: NU
min max ave
-------------------------------------------------------------------------
Length 2 14 6.63
ISNs per value 1 179 17.17
Values: different: 45 total: 773
ASSO-Blocks: NI: 1 UI: 1
Descriptor AF , Format: A , Options: NU
min max ave
-------------------------------------------------------------------------
Length 3 10 4.95
ISNs per value 1 135 11.36
Values: different: 68 total: 773
ASSO-Blocks: NI: 1 UI: 1
Descriptor AH , Format: A , Options: FI
min max ave
-------------------------------------------------------------------------
Length 1 1 1.00
ISNs per value 169 329 257.66
Values: different: 3 total: 773
ASSO-Blocks: NI: 1 UI: 1
Super-Descriptor AO , Format: A , Options: NU
Parent field(s): AG ( 1 - 2) U
AD ( 1 - 20) A
min max ave
-------------------------------------------------------------------------
Length 4 16 8.63
ISNs per value 1 45 4.29
Values: different: 180 total: 773
ASSO-Blocks: NI: 2 UI: 1
Total of 18 descriptors
指定されたファイルのすべてのディスクリプタについての情報が表示されます。
FDT
このパラメータは、FILE パラメータで選択されたファイルのフィールド定義テーブル（FDT）を表示するためのものです。この機能は、FILE パラメータとともに選択する必要があります。
adafin: file=9, fdt
Database 1, File 9 (EMPLOYEES ) 27-OCT-2006 08:11:42
Field Definition Table:
Level I Name I Length I Format I Options I Flags I Encoding
-------------------------------------------------------------------------------
1 I AA I 8 I A I DE,UQ I I
1 I AB I I I I I
2 I AC I 20 I W I NU I I
2 I AE I 20 I W I NU I SP I
2 I AD I 20 I W I NU I I
1 I AF I 1 I A I FI I I
1 I AG I 1 I A I FI I I
1 I AH I 8 I U I DE I I
1 I A1 I I I I I
2 I AI I 20 I W I NU,MU I I
2 I AJ I 20 I W I DE,NU I I
2 I AK I 10 I A I NU I I
2 I AL I 3 I A I NU I I
1 I A2 I I I I I
2 I AN I 6 I A I NU I I
2 I AM I 15 I A I NU I I
1 I AO I 6 I A I DE I SB,SP I
1 I AP I 25 I W I DE,NU I I
1 I AQ I I I PE I I
2 I AR I 3 I A I NU I SP I
2 I AS I 5 I P I NU I SP I
2 I AT I 5 I P I NU,MU I I
1 I A3 I I I I I
2 I AU I 2 I U I I SP I
2 I AV I 2 I U I NU I SP I
1 I AW I I I PE I I
2 I AX I 8 I U I NU I I
2 I AY I 8 I U I NU I I
1 I AZ I 3 I A I DE,NU,MU I I
-------------------------------------------------------------------------------
Type I Name I Length I Format I Options I Parent field(s) Fmt
-------------------------------------------------------------------------------
COLL I CN I1,144 I I NU,HE I AE de__PHONEBOOK
I I I I I PRIMARY
-------------------------------------------------------------------------------
SUPER I H1 I 4 I B I NU I AU ( 1 - 2 ) U
I I I I I AV ( 1 - 2 ) U
-------------------------------------------------------------------------------
SUB I S1 I 4 I A I I AO ( 1 - 4 ) A
-------------------------------------------------------------------------------
SUPER I S2 I 26 I A I NU I AO ( 1 - 6 ) A
I I I I I AE ( 1 - 20 ) W
-------------------------------------------------------------------------------
SUPER I S3 I 12 I A I NU,PE I AR ( 1 - 3 ) A
I I I I I AS ( 1 - 9 ) P
-------------------------------------------------------------------------------
FILE = { * | (number [-number] [,number [-number]]...) }
このパラメータは、1 つのデータベースから 1 つ以上のファイルを選択し、後続のパラメータに基づいてそれらのファイルの情報を表示させるものです。FILE = * を指定すると、すべてのファイルが選択されます。
[NO]HISTOGRAM
HISTOGRAM オプションを選択すると、DESCRIPTOR 機能によって続けて表示されるすべての情報に、ディスクリプタ値の長さの配分が全体的にどのようになっているかが図示されます。
HISTOGRAM を使用する場合には、DESCRIPTOR パラメータの前に指定する必要があります。
HISTOGRAM オプションを使用しても、データセットに対する I/O は発生しません。
デフォルトは NOHISTOGRAM です。
adafin: file=9, histogram, descriptor=ap
Database 1, File 9 (EMPLOYEES ) 27-OCT-2006 08:12:44
Descriptor AP , Format: W , Options: NU
min max ave
-------------------------------------------------------------------------
Length 2 26 12.71
ISNs per value 1 75 4.61
Values: different: 240 total: 1,107
ASSO-Blocks: NI: 3 UI: 1
Histogram of descriptor value length for descriptor AP
Length | 25% 50% 75% 100%| Frequency
-------+--------------+--------------+--------------+---------------+----------
2 |* | 1
3 |* | 22
5 |* | 7
6 |* | 26
7 |****** | 124
8 |**** | 83
9 |****** | 117
10 |****** | 119
11 |*** | 67
12 |**** | 83
13 |* | 23
14 |** | 47
15 |** | 46
16 |** | 46
17 |* | 29
18 |***** | 101
19 |* | 27
20 |* | 29
21 |* | 33
22 |* | 17
23 |* | 20
24 |* | 21
25 |* | 5
26 |* | 14
-------------------------------------------------------------------------------
adafin:
表示される情報は、次のように意味を持っています。
| キーワード | 説明 |
|---|---|
| Length | この列に表示されるそれぞれの値 n は、n バイトの長さのディスクリプタ値がファイルに存在することを示しています。 この列の値の範囲は、ヒストグラムの前の表に示されている最小値（"min" 列）と最大値（"max" 列）の間になります。 |
| Frequency | この列に表示される値は、それぞれの長さに該当するディスクリプタの値の数を示します。 この列の値の合計は、対象のディスクリプタの値の総数に等しくなります。 |
全ディスクリプタ値が同じ長さの値を持つ場合、例えば次の例のように、その概要レポートは通常と異なるものとなります。
adafin: file=9, histogram, descriptor=aa
Database 1, File 9 (EMPLOYEES ) 27-OCT-2006 08:15:16
Descriptor AA , Format: A , Options: UQ
min max ave
-------------------------------------------------------------------------
Length 8 8 8.00
ISNs per value 1 1 1.00
Values: different: 1,107 total: 1,107
ASSO-Blocks: NI: 5 UI: 1
Histogram of descriptor value length for descriptor AA
Length | 25% 50% 75% 100%| Frequency
-------+--------------+--------------+--------------+---------------+----------
8 |************************************************************| 1,107
-------------------------------------------------------------------------------
このヒストグラムは、8 バイトの長さを持つディスクリプタ値だけしか該当ファイル内に含まれていないことを示します。そのファイルには、該当ディスクリプタ AA に対して合計で 1107 個の値が含まれていることがわかります。
adafin: file=9, histogram, descriptor=ap
Database 1, File 9 (EMPLOYEES ) 27-OCT-2006 08:14:24
Descriptor AP , Format: W , Options: NU
min max ave
-------------------------------------------------------------------------
Length 2 26 12.71
ISNs per value 1 75 4.61
Values: different: 240 total: 1,107
ASSO-Blocks: NI: 3 UI: 1
USAGE = (keyword [,keyword [,keyword]])
指定されたキーワードに応じて、このパラメータはそのファイル内での使用ブロックのパーセンテージを表示します。
| キーワード | 説明 |
|---|---|
| DS | データストレージ内のブロック使用状況 |
| NI | ノーマルインデックス内のブロック使用状況 |
| UI | メイン／アッパーインデックス内のブロック使用状況 |
adafin: file=13, usage=ds
Database 76, File 13 (MISCELLANEOUS ) 27-OCT-2006 08:16:18
DS - Blocks allocated = 50 , used = 49 , unused = 1
Records: Number = 179
Length: max = 1,991 , min = 260 , avg = 997.47
0%: 0 blocks
5%: 0 blocks
10%: 0 blocks
15%: 0 blocks
20%: 0 blocks
25%: 0 blocks
30%: 0 blocks
35%: 0 blocks
40%: 0 blocks
45%: 0 blocks
50%: 0 blocks
55%: 0 blocks
60%: 0 blocks
65%: 0 blocks
70%:**** 2 blocks
75%: 0 blocks
80%:** 1 block
85%:************* 6 blocks
90%:***************************** 13 blocks
95%:************************************************************* 27 blocks
100%: 0 blocks
データベース 76 内のファイル 13 の使用データブロックについての情報が表示されます。データストレージでは、割り当てられた 50 ブロックのうち、49ブロックが使用済みであり、1 ブロックが未使用です。レコード数の合計は 179 であり、レコード長の範囲は 260～1991 です。平均のレコード長は、997.47です。後続の各行には、それぞれのパーセント範囲に応じた使用ブロック数が表示され、全体的な使用状況を把握できるようになっています。ブロック（27）の大多数は 90~95 ％まで使用されていることがわかります。
adafin: file = 8
adafin: adam_ds = full
adafin: usage = ds
Database 30, File 8 (ADAM_FILE ) 11-OCT-2006 12:08:57
ADAM key = FF ADAM parameter = 5 ADAM_DS = FULL
DS - Blocks used for ADAM = 94
Total overflow blocks = 1, used = 1
Records: Number = 3863
In ADAM area= 3860 , ovfl = 3
Length: max = 9 , min = 9 , avg = 9.00
0%: ******** 10 blocks
5%: *** 4 blocks
10%: 0 blocks
15%: 0 blocks
20%: 0 blocks
25%: 0 blocks
30%: * 1 block
35%: 0 blocks
40%: 0 blocks
45%: 0 blocks
50%: * 1 block
55%: 0 blocks
60%: 0 blocks
65%: ************************************************** 74 blocks
70%: 0 blocks
75%: 0 blocks
80%: 0 blocks
85%: 0 blocks
90%: 0 blocks
95%: *** 3 blocks
100%: * 2 blocks
ファイル 8 のデータブロックすべてについての情報、つまり ADAM ファイルが表示されます。ADAM パラメータは 5 に設定されています。94 ブロックが ADAM エリアに使用され、1 ブロックがオーバーフローのために確保されています。ADAM エリアのレコード数は 3860、オーバーフローエリアのレコード数は 3 です。