E ANALYZE/DISK_STRUCTURE -使用量ファイル

/USAGE修飾子を指定すると，ANALYZE/DISK_STRUCTUREは，ディスク使用量会計ファイルを作成します。 このファイルの最初のレコードである識別レコードには， ディスクとボリュームの特性の要約が格納されます。識別レコードの後には， 数多くのファイル要約レコードが続きます。ファイル要約レコードは， ディスク上の1つのファイルに対して1つのレコードが格納されます。 ファイル要約レコードの内容は，ファイルの所有者，サイズ， 名前です。

識別レコードは，USG$B_TYPEフィールドに格納されるタイプ・コードUSG$K_IDENT によって識別されます。表 E-1は識別レコードのフィールドの一覧です。

表 E-1 識別レコードの形式(Length USG$K_IDENT_ LEN)

フィールド	意味
USG$L_SERIALNUM	ボリュームの通し番号。8進ロングワード。
USG$T_STRUCNAM	ボリュームがボリューム・セットに属している場合，ボリューム・セット名。Files-11 構造レベル1ボリュームの場合はバイナリ・ゼロ，ボリューム・ セットに属していないFiles-11構造レベル2または5ボリュームの場合は空白文字である。 フィールド長は，USG$S_STRUCNAME。
USG$T_VOLNAME	相対ボリューム1のボリューム名。 フィールド長は，USG$S_VOLNAME。
USG$T_OWNERNAME	ボリューム所有者名。フィールド長は，USG$S_OWNERNAME 。
USG$T_ FORMAT	ボリューム形式タイプ。Files-11構造レベル1 ボリュームの場合は"DECFILE11A"，Files-11構造レベル2または5 ボリュームの場合は"DECFILE11B"である。フィールド長は，USG$S_ FORMAT。
USG$Q_TIME	使用量ファイルを作成したクォドワード・ システム時間。フィールド長は， USG$S_TIME。

ファイル要約レコードは，USG$B_TYPEフィールドに格納されるタイプ・ コードUSG$K_FILEによって識別されます。表 E-2 は，ファイル要約レコードのフィールドの一覧です。

表 E-2 ファイル・レコードの形式(Length USG$K_ FILE_LEN)

フィールド	意味
USG$L_FILEOWNER	ファイル所有者のUIC。ロングワード1 つまたはワード2つ(USG$W_UICMEMBERとUSG$W_UICGROUP)。
USG$W_UICMEMBER	ファイル所有者UIC のメンバ・フィールド。8進ワード。
USG$W_UICGROUP	ファイル所有者UICのグループ・ フィールド。8進ワード。
USG$L_ ALLOCATED	ファイル・ヘッダを含む，ファイルのブロック数。10 進ロングワード。
USG$L_ USED	エンド・オブ・ファイル・ブロックを含む，使用ブロック数。10 進ロングワード。
USG$W_ DIR_LEN	大括弧を含む，USG$T_FILESPECのディレクトリ文字列長。10 進ワード。
USG$W_SPEC_ LEN	USG$T_FILESPECのファイル指定全体の長さ。10進ワード。
USG$T_FILESPEC	次の形式によるファイル指定。 [ディレクトリ]ファイル名.タイプ;バージョン このフィールドは，可変長である。複数のディレクトリ・エントリが格納されているファイルは， 最初に検出されたファイル指定の下にリストされる。 紛失ファイルのディレクトリ文字列は空であり("[]")，ファイル名はファイル・ ヘッダから取り出される。この情報が存在しない場合もあるので， 使用量ファイルを処理するアプリケーション・プログラムを作成するときには， この点に留意する。フィールド長は，USG$S_ FILESPEC。

識別レコードとファイル要約レコードで参照するシンボリック名は，システム定義マクロ$USGDEF で定義します。識別レコードの長さはUSG$K_ IDENT_LEN，ファイル要約レコードの長さはUSG$K_FILE_LENです。