このドキュメントでは ADAREP ユーティリティについて説明します。
次のトピックについて説明します。
ADAREP ユーティリティは、データベースステータスレポートを生成します。これには、データベースの現在の物理レイアウト、論理内容に関する情報が含まれます。特に断りのない限り、ニュークリアスがアクティブかどうかに関係なく、この機能を実行することができます。
このレポートに出力される情報は次のものです。
アソシエータとデータストレージの現在の割り当てスペース量と位置。
アソシエータとデータストレージの使用可能な未使用スペース量と位置。
データベースファイルのサマリ。
チェックポイント情報。
セキュリティ情報。
データベース内の各ファイルの情報（スペース割り当て、使用可能スペース、ロードされたレコード数、MAXISN 値、フィールド定義など）。
CHECKPOINTS 制御パラメータ（後述）のみ、ニュークリアスがアクティブであることが条件になります。
このユーティリティは多機能ユーティリティです。
| データセット | 環境 変数／ 論理名 |
記憶 媒体 |
追加情報 |
|---|---|---|---|
| アソシエータ | ASSOx | ディスク | |
| コントロールステートメント | stdin/ SYS$INPUT |
ユーティリティマニュアル | |
| ADAREP レポート | stdout/ SYS$OUTPUT |
メッセージおよびコード、 ユーティリティマニュアル |
このユーティリティはチェックポイントを書き込みません。
次のコントロールパラメータを使用できます。
CHECKPOINTS = { * | ( [absolute-date] [,[absolute-date] ] ) } CONSTRAINTS CONTENTS COUNT M DBID = number D [NO]FDT FILES = { * | (number [-number][,number[-number]]...) } D [NO]FULL FREE_SPACE LAYOUT SUMMARY
CHECKPOINTS = { * | ( [absolute-date] [,[absolute-date]] ) }
この機能は、チェックポイントリストからの選択情報を出力します。ニュークリアスがアクティブなときに使用可能です。
5 種類のシステムチェックポイント（SYNP、SYNC、SYNX、OPEN、CLSE）がチェックポイントファイルとプロテクションログに書き込まれますが、C1 コマンドが書き込むユーザーチェックポイントもここに書き込まれます。
SYNC は、ニュークリアスの初期化時、終了時、キャンセル時、ADAOPR 機能の FEOF = PLOG の最中、ADAOPR EXT_BACKUP=CONTINUE 機能の実行時、または ADABCK NEW_PLOG 機能の最中に作成されたチェックポイントを示します。
SYNP は、特権的な制御が必要な Adabas ユーティリティによってチェックポイントが作成されたことを示します。すなわち、モジュールがニュークリアスを使用しないで更新ができる場合です。SYNP は、例えば ADAMUP UPDATE 処理の終了時に書き込まれます。
SYNX は、1 つまたは複数ファイルの排他制御が必要なユーティリティによって作成されたことを示します。例えば、SYNX は ADAULD によって書き込まれます。
OPEN チェックポイントは、EXU/EXF ユーザーの OP コマンドによって書き込まれます。
CLSE チェックポイントは、EXU/EXF ユーザーの CL コマンドによって書き込まれます。
注意:
プロテクションログを使用して ADAREC REGENERATE 機能を実行する場合、DBA の操作が必要になるため、SYNP チェックポイントごとに、このユーティリティは停止します。
アスタリスク（*）を入力すると、すべてのチェックポイントが表示されます
日付文字列は、次の絶対日付フォーマットと時刻フォーマットに対応していなければなりません。
dd-mmm-yyyy[:hh[:mm[:ss]]]
日付と時刻の仕様の上位桁のゼロは、省略される可能性があります。指定されていない数字は、0 に設定されます（例：28-jul-2006 は 28-jul-2006:00:00:00 と同じです）。
次の表は、パラメータ CHECKPOINTS に使用できる値と、この値に対応して表示されるチェックポイントを示しています。
| パラメータ CHECKPOINTS に指定された値 | この指定で表示されるチェックポイント |
|---|---|
| * または（,） | すべてのチェックポイント |
| absolute-date | 指定された日時と書き込み時間が正確に一致するチェックポイントのみ |
| (absolute-date,) | 指定された日時以降に書き込まれたチェックポイント |
| (,absolute-date) | 指定された日付と時刻までに書き込まれたチェックポイント |
| (absolute-date,absolute-date) | 指定された最初の日付と時刻の値から、指定された 2 番目の日付と時刻の値までに書き込まれたチェックポイント |
adarep: checkpoints=* Name Date/Time Session User Id / Function ---- --------- ------- ------------------ SYNP 28-JUL-2006 12:50:34 8 ADADBM DELCP SYNX 28-JUL-2006 12:50:36 8 ADABCK DUMP=* STARTED SYNX 28-JUL-2006 12:50:37 8 ADABCK DUMP=* OPEN 28-JUL-2006 17:23:53 8 otto OPEN 28-JUL-2006 17:24:15 8 otto CLSE 28-JUL-2006 17:24:24 8 otto
全チェックポイントが表示されます。
［User ID / Function］列には、次のデータが含まれています。
EXU/EXF ユーザー用の OP/CL コマンドまたは C1 コマンドを使用して作成されたユーザーチェックポイントの場合：関連する OP コマンドのアディション 1 フィールドで指定されたユーザー。
ユーティリティチェックポイントの場合：実行されたユーティリティ機能
上記の例（checkpoints=*）の出力では、以下に示すように、選択条件を使用してチェックポイントを絞り込むことができます。
次を指定するとします。
checkpoints=28-jul-2006:12:50:36
出力結果は次のようになります。
Name Date/Time Session User Id / Function ---- --------- ------- ------------------ SYNX 28-JUL-2006 12:50:36 8 ADABCK DUMP=* STARTED
次を指定するとします。
checkpoints=(28-jul-2006:12:50:36,)
出力結果は次のようになります。
Name Date/Time Session User Id / Function ---- --------- ------- ------------------ SYNX 28-JUL-2006 12:50:36 8 ADABCK DUMP=* STARTED SYNX 28-JUL-2006 12:50:37 8 ADABCK DUMP=* OPEN 28-JUL-2006 17:23:53 8 otto OPEN 28-JUL-2006 17:24:15 8 otto CLSE 28-JUL-2006 17:24:24 8 otto
次を指定するとします。
checkpoints=(,28-jul-2006:12:50:36)
出力結果は次のようになります。
Name Date/Time Session User Id / Function ---- --------- ------- ------------------ SYNP 28-JUL-2006 12:50:34 8 ADADBM DELCP SYNX 28-JUL-2006 12:50:36 8 ADABCK DUMP=* STARTED
次を指定するとします。
checkpoints=(28-jul-2006:17, 28-jul-2006:17:24)
出力結果は次のようになります。
Name Date/Time Session User Id / Function ---- --------- ------- ------------------ OPEN 28-JUL-2006 17:23:53 8 otto
CONSTRAINTS
この機能は、DBID パラメータで指定したデータベース内の、すべての参照制約に関する情報を表示します。
adarep: constraints
Primary file Foreign file Name Action
---------------------------------------------------
9 (AA) <--- 12 (AC) HO DX UX
この参照制約 HO は、プライマリファイル 9 のプライマリキーフィールド AA を、外部ファイル 12 の外部キーフィールド AC にリンクします。関連付けられたアクションは、削除時にアクションなし（DX）および更新時にアクションなし（UX）です。
CONTENTS
この機能は、DBID パラメータに指定するデータベースのファイルに関する情報を表示します。
adarep: contents
Content of Database 163 30-MAY-2017 11:36:07
Index Extents Pad % flags
File Filename loaded on Top ISN level N U A D A D ALRCPM
-------------------------------------------------------------------------------
1 EMPLOYEES 30-MAY-2017 1,107 3 1 1 1 1 5 5 R M
2 VEHICLES 30-MAY-2017 773 3 1 1 1 1 5 5 R M
3 MISCELLANEOUS 30-MAY-2017 1,779 3 1 1 1 1 5 5 R M
60 EMPL-REF 30-MAY-2017 1,107 3 1 1 1 1 5 5 R M
251 SECURITY-FILE 30-MAY-2017 0 3 1 1 1 1 5 5 R M
254 USER-DATA-FILE 30-MAY-2017 0 3 1 1 1 1 5 5 R M
255 CHECKPOINT-FILE 30-MAY-2017 0 3 1 1 1 1 5 5 S M
Allocated blocks
File Filename NI UI AC DS
-------------------------------------------------------------------------------
1 EMPLOYEES 90 15 10 75
2 VEHICLES 40 20 2 40
3 MISCELLANEOUS 50 10 10 50
60 EMPL-REF 90 15 10 75
251 SECURITY-FILE 2 2 1 5
254 USER-DATA-FILE 24 2 6 57
255 CHECKPOINT-FILE 1 1 6 32
-------------------------------------------------------------------------------
Total 297 65 45 334
Unused blocks
File Filename NI UI DS
-------------------------------------------------------------------------------
1 EMPLOYEES 4 2 18
2 VEHICLES 16 12 26
3 MISCELLANEOUS 17 5 23
60 EMPL-REF 4 2 18
251 SECURITY-FILE 2 1 4
254 USER-DATA-FILE 24 1 56
255 CHECKPOINT-FILE 1 0 31
-------------------------------------------------------------------------------
Total 68 23 176
［Extents］列には、ノーマルインデックス（N）、メイン／アッパーインデックス（U）、アドレスコンバータ（A）、およびデータストレージ（D）に現在割り当てられている論理エクステントの数が表示されます。
［Pad］列にはアソシエータ（A）およびデータストレージ（D）用に定義されたブロックパディングファクタの割合が表示されます。詳細については、ADAFDU、ADAMUP、または ADAORD の ASSOPFAC および DATAPFAC パラメータを参照してください。
［Flags］列には次の情報が表示されます。
| サブカラム | フラグ | 説明 |
|---|---|---|
| A | A | Adam ファイルを示します。 |
| L | L | ファイルは LOB ファイルです。 |
| B | ファイルは対応する LOB ファイルを含む基本ファイルです。 | |
| R | R | ファイルの ISN とスペースの再利用が可能です。 |
| I | ファイルの ISN の再利用は可能ですが、スペースの再利用は不可能です。 | |
| S | ファイルのスペースの再利用は可能ですが、ISN の再利用は不可能です。 | |
| C | C | ファイルの暗号化が有効です。 |
| P | P | ファイルに対するプログラムリフレッシュが有効です。 |
| M | M | このファイルは最後にバックアップされてから変更されています。 |
ISN が再利用される場合、削除されたレコードの ISN は新規レコードに再度割り当てられます。スペース再利用の場合、レコードを削除してできたブロック内の解放スペースは新規レコードに再利用されます（詳細については ADADBM または ADAFDU の REUSE パラメータを参照）。
2 番目と 3 番目の表は、各ファイルについて、ノーマルインデックス（NI）、メイン／アッパーインデックス（UI）、アドレスコンバータ（AC）およびデータストレージ（DS）に割り当てられたブロック数を示しています。残りの列はメイン／アッパーインデックス（UI）およびデータストレージ（DS）の未使用ブロック数を表示します。
COUNT
このパラメータは、DBID パラメータで指定したデータベース内のファイルのレコード数を表示します。
adarep: count
Record Count of Database 2 20-APR-2017 16:08:52
File Filename Records loaded
-------------------------------------------------------------------------------
1 CHECKPOINT-FILE 0
2 SECURITY-FILE 0
3 USER-DATA-FILE 0
9 EMPLOYEES 1,272
11 EMPLOYEES-NAT 1,107
12 VEHICLES 773
13 MISCELLANEOUS 1,779
14 LOBFILE of 9 210
DBID = number
このパラメータは、使用対象となるデータベースを選択するためのものです。1 つのセッションで複数の DBID がサポートされます。
DBID パラメータは最初の ADAREP パラメータとして指定しなければなりません。
adarep: dbid = 1, contents
.
.
adarep: dbid = 2, contents
.
.
adarep: dbid = 3, contents
[NO]FDT
このオプションを FDT に設定すると、FILES 機能が続けて表示するステータス情報に、フィールド定義テーブル（FDT）も表示されます。
デフォルトは NOFDT です。
FILES = { * | (number [-number][,number [-number]]...) }
この機能は、選択したファイルステータス情報を表示します。
adarep: fdt
adarep: file=9
Database 216, File 9 (EMPLOYEES ) 30-MAY-2017 11:50:36
Highest Index Level: 3 Padding Factors: ASSO 5%, DATA 5%
Top ISN: 1,272 Maximum ISN expected: 8,191
SYFMAX : 9
Records loaded: 1,272 Corresponding LOB file: 14
Last FDT Modification: 4-SEP-2014 14:49:36.510905
Last ADABCK dump : 30-MAY-2017 11:49:32
ISN reusage: Enabled, inactive Space reusage: Enabled
Program refresh: Disabled Ciphering: Disabled
Modified since last backup
Container Block Extent Extents in Blocks Allocated Unused
File Size Type from to Blocks MB Blocks MB
-------------------------------------------------------------------------------
ASSO:
2 32KB AC 7,682 7,682 1 0 0 0
1 8KB NI 55 99 45 0 15 0
1 8KB UI 100 107 8 0 0 0
1 8KB UI 110 119 10 0 3 0
DATA:
1 32KB DS 14 45 32 1 21 0
-------------------------------------------------------------------------------
Field Definition Table:
Level I Name I Length I Format I Options I Flags I Encoding
-------------------------------------------------------------------------------
1 I A0 I I I I I
2 I AA I 8 I A I DE,UQ,NC,NN I RP I
2 I AB I I I I I
3 I AC I 4 I F I DE I I
3 I AD I 8 I B I NU,HF I I
3 I AE I 0 I A I NU,NV,NB,LA I I
1 I B0 I I I I I
2 I BA I 40 I W I NU I I
2 I BB I 40 I W I NU I I
2 I BC I 50 I W I DE,NU I SP I
1 I CA I 1 I A I FI I I
1 I DA I 1 I A I FI I I
1 I EA I 4 I P I DE,NC I I
1 I F0 I I I PE I I
2 I FA I 60 I W I NU,MU I I
2 I FB I 40 I W I DE,NU I I
2 I FC I 10 I A I NU I I
2 I FD I 3 I A I NU I I
2 I F1 I I I I I
3 I FE I 6 I A I NU I I
3 I FF I 15 I A I NU I I
3 I FG I 15 I A I NU I I
3 I FH I 15 I A I NU I I
3 I FI I 80 I A I DE,NU,MU I I
1 I I0 I I I PE I I
2 I IA I 40 I W I NU,MU I I
2 I IB I 40 I W I DE,NU I I
2 I IC I 10 I A I NU I I
2 I ID I 3 I A I NU I I
2 I IE I 5 I A I NU I I
2 I I1 I I I I I
3 I IF I 6 I A I NU I I
3 I IG I 15 I A I NU I I
3 I IH I 15 I A I NU I I
3 I II I 15 I A I NU I I
3 I IJ I 80 I A I DE,NU,MU I I
1 I JA I 6 I A I DE I SB,SP I
1 I KA I 66 I W I DE,NU I I
1 I L0 I I I PE I I
2 I LA I 3 I A I NU I SP I
2 I LB I 6 I P I NU I SP I
2 I LC I 6 I P I DE,NU,MU I I
1 I MA I 4 I G I NU I I
1 I N0 I I I I I
2 I NA I 2 I U I I SP I
2 I NB I 3 I U I NU I SP I
1 I O0 I I I PE I I
2 I OA I 8 I U I NU I I
I I I I DT(DATE) I I
2 I OB I 8 I U I NU I I
I I I I DT(DATE) I I
1 I PA I 3 I A I DE,NU,MU I I
1 I QA I 7 I P I I I
1 I RA I 0 I A I NU,NV,NB,LB I I
1 I S0 I I I PE I I
2 I SA I 80 I W I NU I I
2 I SB I 3 I A I NU I I
2 I SC I 0 I A I NU,MU,NV,NB,LB I I
1 I TC I 20 I U I DT(TIMESTAMP) I I
I I I I SY=TIME,CR I I
1 I TU I 20 I U I MU I I
I I I I DT(TIMESTAMP) I I
I I I I SY=TIME 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 BC de@collation=phonebook
I I I I I PRIMARY
-------------------------------------------------------------------------------
SUPER I H1 I 5 I B I NU I NA ( 1 - 2 ) U
I I I I I NB ( 1 - 3 ) U
-------------------------------------------------------------------------------
SUB I S1 I 2 I A I I JA ( 1 - 2 ) A
-------------------------------------------------------------------------------
SUPER I S2 I 46 I A I NU I JA ( 1 - 6 ) A
I I I I I BC ( 1 - 40 ) W
-------------------------------------------------------------------------------
SUPER I S3 I 9 I A I NU,PE I LA ( 1 - 3 ) A
I I I I I LB ( 1 - 6 ) P
-------------------------------------------------------------------------------
Referential Integrity
-------------------------------------------------------------------------------
Type I Name I Refer. I PrimaryI Foreign I Rules
I I file I field I field I
-------------------------------------------------------------------------------
PRIMARY I HO I 12 I AA I AC I DELETE_NOACTION UPDATE_NOACTION
-------------------------------------------------------------------------------
FILES パラメータは、ファイル番号とファイル名、最高インデックスレベル、ASSO と DATA のパディングファクタ、最高 ISN と最大 ISN、ロードされているレコード数、基本ファイルの番号や対応する LOB ファイルがある場合はその番号、および ISN 再利用、スペース再利用、プログラムリフレッシュ、暗号化のスイッチを表示します。最後の FDT 変更の日時も表示されます。
ファイルの ASSO および DATA エレメントのレイアウトが表示されます。表示される内容は、各種リスト要素が格納されるブロックサイズ、これらのエクステントの配置および対応する割り当て済みまたは未使用のブロック数／メガバイト数などです。
さらに、FDT 機能はファイルのフィールド定義テーブルを表示します。
フィールド定義テーブルに表示されるフラグは次のとおりです。
| フラグ | 説明 |
|---|---|
| HY | フィールドはハイパーディスクリプタの一部です。 |
| P | フィールドはフォネティック化されています。 |
| SB | このフィールドの一部はサブディスクリプタです。 |
| SP | スーパーディスクリプタの一部です。 |
FREE_SPACE
この機能は、ASSO または DATA 内の空きブロックの要約情報を出力します。これは、LAYOUT 機能の表示情報のサブセットです。
adarep: free_space
Free space of Database 76 28-NOV-2006 12:51:24
Container Extents in Blocks Number of Block
File from to Blocks Size
-------------------------------------------------------------------------------
ASSO:
1-2 611 1,546 936 2,048
DATA:
1 245 768 524 4,096
2 769 868 100 3,072
3-4 869 888 20 6,144
[NO]FULL
FDT と一緒に FULL を指定すると、FDT に関する以下の追加情報が表示されます。
ドロップされたフィールドは、ファイルのフィールドの表示に含まれます（フィールド名は含まれません）。
ICU バージョンは、照合ディスクリプタの表示に含まれます。
デフォルトは NOFULL です。
LAYOUT
この機能は、ASSO および DATA 内のブロックの要約情報を出力し、消失ブロックをレポートするものです。消失ブロックとは、フリースペーステーブル（FST）内にリスト化されなくなったにもかかわらず、ファイル、DSST、データベースのグローバルエリアのいずれにも割り当てることができないブロックを指します。また、この機能は、二重に割り当てられたブロックもレポートします。
adarep: layout
Layout of Database 76 28-NOV-2006 12:51:24
Container Extents in Blocks Number of Block Extent File
File from to Blocks Size Type Number
-------------------------------------------------------------------------------
ASSO:
1 1 30 30 4,096 CB
1 31 31 1 4,096 FCB 1
1 32 32 1 4,096 FDT 1
1 33 35 3 4,096 AC 1
1 36 36 1 4,096 UI 1
1 37 37 1 4,096 NI 1
1 38 38 1 4,096 FCB 2
1 39 39 1 4,096 FDT 2
1 40 40 1 4,096 AC 2
1 41 42 2 4,096 UI 2
1 43 43 1 4,096 NI 2
1 44 44 1 4,096 FCB 3
1 45 45 1 4,096 FDT 3
1 46 48 3 4,096 AC 3
1 49 50 2 4,096 UI 3
1 51 62 12 4,096 NI 3
1 63 152 90 4,096 NI 9
1 153 167 15 4,096 UI 9
1 168 168 1 4,096 FCB 9
1 169 169 1 4,096 FDT 9
1 170 170 1 4,096 NI 14
1 171 172 2 4,096 UI 14
1 173 173 1 4,096 FCB 14
1 174 174 1 4,096 FDT 14
1 175 264 90 4,096 NI 11
1 265 279 15 4,096 UI 11
1 280 280 1 4,096 FCB 11
1 281 281 1 4,096 FDT 11
1 282 321 40 4,096 NI 12
1 322 341 20 4,096 UI 12
1 342 342 1 4,096 FCB 12
1 343 343 1 4,096 FDT 12
1 344 393 50 4,096 NI 13
1 394 403 10 4,096 UI 13
1 404 404 1 4,096 FCB 13
1 405 406 2 4,096 FDT 13
1 407 2,560 2,154 4,096 FREE
2 2,561 2,561 1 32,768 DSST
2 2,562 2,562 1 32,768 AC 9
2 2,563 2,563 1 32,768 AC 14
2 2,564 2,572 9 32,768 AC 11
2 2,573 2,581 9 32,768 AC 12
2 2,582 2,582 1 32,768 AC 13
2 2,583 2,880 298 32,768 FREE
DATA:
1 1 4 4 32,768 DS 1
1 5 5 1 32,768 DS 2
1 6 13 8 32,768 DS 3
1 14 45 32 32,768 DS 9
1 46 170 125 32,768 DS 14
1 171 202 32 32,768 DS 11
1 203 212 10 32,768 DS 12
1 213 222 10 32,768 DS 13
1 223 640 418 32,768 FREE
LAYOUT を使用すると、ASSO および DATA の全ブロックの要約情報が出力されます。連続ブロックセクションの配置と長さ、ブロックサイズ、対応するファイルの使用タイプと番号が表示されます。このブロックはフリー（FREE）の場合も、グローバルブロック（CB）、ファイルコントロールブロック（FCB）、FCB 拡張（FCBE）、FCB ルートブロック（FCBR）、フィールド定義テーブル（FDT）、フリースペーステーブル（FST）、データスペースストレージテーブル（DSST）、ノーマルインデックス（NI）、アッパー／メインインデックス（UI）、アドレスコンバータ（AC）、データストレージ（DS）として使用されている場合もあります。
注意:
最初の FCBR ブロックと最初の FST ブロックはグローバルブロックの一部です。このため、データベースにこのようなブロックが複数含まれる場合、レイアウトでは FCBR ブロックと FST ブロックのみが表示されます。
SUMMARY
SUMMARY は、データベースおよび ASSO、DATA および WORK の物理レイアウトに関する情報を提供するものです。
adarep: summary
Summary of Database 76 28-JUL-2015 12:51:24
DATABASE NAME DOKU-DATABASE
DATABASE ID 76
MAXIMUM NUMBER OF FILES 30
SYSTEM FILES 1 (CHK), 2 (SEC), 3 (USR)
150 (RBAC)
ACTUAL FILES LOADED 6
AC SIZE 3
CURRENT PLOG NUMBER 8
CURRENT CLOG NUMBER 0
SECURITY ACTIVE
Container Device Extents in Blocks Number of Block Total Size
File Type from to Blocks Size (Megabytes)
-------------------------------------------------------------------------------
ASSO1 file 1 1,536 1,536 2,048 3.00
ASSO2 raw 1,537 1,546 10 2,048 0.02
DATA1 file 1 768 768 4,096 3.00
DATA2 raw 769 868 100 3,072 0.29
DATA3 file 869 878 10 6,144 0.06
DATA4 file 879 888 10 6,144 0.06
WORK1 file 1 1,365 1,365 3,072 4.00
-------------------------------------------------------------------------------
10.43
=====
デバイスタイプには、raw（RAW セクション）、file（ファイルシステム）、または worm（光学デバイスのように何回でも読み込みは可能だが書き込みは 1 回に制限されるデバイス）があります。
セキュリティ情報は、データベースセキュリティがアクティブ化されている場合にのみ表示されます。それ以外の場合、情報は表示されません。
RBAC システムファイルは、それが定義されている場合のみ表示されます。それ以外の場合、情報は表示されません。
注意:
データベースが READONLY モードで実行されている場合、WORK1 は表示されません。