IFS_OBJECT_STATISTICS 表関数

IFS_OBJECT_STATISTICS 表関数は、開始パス名に含まれるオブジェクト、または開始パス名からアクセス可能なオブジェクトの表を戻します。

この情報は、ディレクトリー情報検索 (RTVDIRINF) コマンドまたは Qp0lGetAttr() -- 属性取得 API によって返される情報と似ています。

リモート・ファイル・システム・オブジェクトの行は戻されません。これは、QNTC ファイル・システムの場合、/QNTC の行のみが戻されることを意味します。ネットワーク・ファイル・システム (NFS) および QFileSvr.400 ファイル・システムの場合、行は戻されません。

QDLS を含む一部のファイル・システムはスレッド・セーフではありません。これらのファイル・システムから情報にアクセスしても、一部の行が返されない場合があります。これが発生した場合は、IGNORE_ERRORS パラメーターの設定に基づいてエラーまたは警告が返されます。スレッド・セーフ・ファイル・システムのリストについては、このページの「使用上の注意」( access () -- ファイル・アクセシビリティーの判別) を参照してください。

許可: 呼び出し側は以下を備えている必要があります。

QDLS および QSYS 以外のファイル・システムの場合:

検索を開始するために使用されるパス名に含まれる各ディレクトリーの場合は、*X
再帰的に処理されるディレクトリーの場合は、*RX および *OBJMGT
戻される各オブジェクトの場合、*OBJMGT

QDLS ファイル・システムの場合:

検索を開始するために使用されるパス名 (QDLS を除く) に含まれる各ディレクトリーの場合は、*X
再帰的に戻される、または処理されるすべてのオブジェクトの場合は、*RWX および *OBJEXIST *OBJMGT *OBJALTER *OBJREF

QSYS ファイル・システムの場合:

検索を開始するために使用されるパス名に含まれているライブラリーまたはオブジェクトの場合は、*USE
サービスによって再帰的に処理されるライブラリーまたはオブジェクトの場合は、*USE および *OBJMGT
戻される各オブジェクトの場合、*OBJMGT

OBJECT_AUDIT および OBJECT_AUDIT_CREATE の値を戻すには、呼び出し側に *ALLOBJ または *AUDIT 特殊権限が必要です。

開始パス名

検索を開始するためのパス名を返す式。相対パス名は、現行ディレクトリーに対する相対パス名です。絶対パス名が指定されていない場合、オブジェクトに解決するために、現行作業ディレクトリーが相対パス名と組み合わせて使用されます。

サブツリー・ディレクトリー

すべてのサブディレクトリーを再帰的に処理するかどうかを示す式。

NO: 開始パス名によって識別されるディレクトリー内のオブジェクトのみが処理されます。
YES: 開始パス名で識別されるディレクトリーのすべてのサブディレクトリーが処理されます。これはデフォルト値。

オブジェクト・タイプ・リスト

返される必要がある 1 つ以上のオブジェクト・タイプのリスト。複数の値は 1 つ以上のブランクで区切られます。デフォルトは空ストリングで、すべてのオブジェクトが返されることを示します。値には、すべての標準システム・オブジェクト・タイプ (例えば、*PGM または *STMF) と、以下の特殊値が含まれます。

*ALLDIR: すべてのディレクトリー・オブジェクト・タイプを選択します。これには、*LIB、*DIR、*FLR、*FILE、および *DDIR オブジェクト・タイプが含まれます。
*ALLSTMF: すべてのストリーム・ファイル・オブジェクト・タイプを選択してください。これには、*MBR、*DOC、*STMF、*DSTMF、および *USRSPC オブジェクト・タイプが含まれます。
*MBR: すべてのデータベース・ファイル・メンバー・タイプを選択してください。
*NOQDLS: すべての QDLS ファイル・システム・オブジェクト・タイプを除外します。
*NOQOPT: すべての QOPT および QNTC ファイル・システム・オブジェクト・タイプを除外します。
*NOQSYS: すべての QSYS.LIB オブジェクト・タイプを除外します。これには、QSYS.LIB ファイル・システム内のすべてのオブジェクトと、機能の呼び出し時に使用可能なすべての独立 ASP QSYS.LIB ファイル・システムが含まれます。

除外リスト

処理から除外する 1 つ以上のパス名を含む文字ストリング。このパスからアクセスされるすべてのオブジェクトおよびサブディレクトリーも除外されます。デフォルトは空ストリングで、パス名が処理から除外されないことを示します。

ルート・パス (「/」) をリストに含めることはできません。複数のパスを指定すると、値は 1 つ以上のブランクで区切られます。パス名にブランクがある場合には、パス名をアポストロフィ (') または引用符 (") で囲まなければなりません。パス名を区切るときに、パス名にアポストロフィまたは引用符 (囲み文字と一致する) がある場合は、組み込み文字を二重にする必要があります。例えば、以下は有効なパス・ストリングです。

1 つのパス名。区切り文字は必要ありません:
/dir1/dir2/content
2 つのパス名。区切り文字は必要ありません:
/dir1/content /dir1/dir3
パス名のブランク、アポストロフィで区切られたパス:
'/dir1/content 文字列'
2 つのパス名。最初のパスにブランクとアポストロフィがあります。最初のパス名はアポストロフィで区切られ、名前のアポストロフィは二重になります。 2 番目のパスは、次のように区切る必要はありません。
'/dir1/dir2/my file''s content' /dir4/test'123
2 つのパス名。最初のパスにブランクとアポストロフィがあります。最初のパス名は引用符で区切られます。 2 番目のパスは必須ではありませんが、区切り文字で区切られます
"/dir1/dir2/my file's content" "/dir4/test'123"

ignore-errors

エラーの発生時に実行する内容を識別する文字ストリング式またはグラフィック・ストリング式。

NO: エラーが戻されます。
YES: 警告が戻されます。; エラーが検出されても、行は戻されません。これはデフォルト値。

この関数の結果は、以下の表に示された形式の行を含むテーブルです。列はすべて NULL 可能です。

表 1. IFS_OBJECT_STATISTICS 表関数
列名	データ・タイプ	説明
PATH_NAME	DBCLOB(16M) CCSID 1200	Integrated File System オブジェクトのパス名。
OBJECT_TYPE	VARCHAR(10)	オブジェクト・タイプ。
SYMBOLIC_LINK	DBCLOB(16M) CCSID 1200	このオブジェクトのシンボリック・リンク。 OBJECT_TYPE が *SYMLNK でない場合は、NULL 値が入ります。
ASP_NUMBER	INTEGER	オブジェクトが保管される補助記憶域プール (ASP)。オブジェクトがこの IBM® i上にない場合は、NULL 値が入ります。
TEXT_DESCRIPTION	VARGRAPHIC(50) CCSID 1200	オブジェクトに関連付けられたテキスト・ストリング。テキスト・ストリングがない場合は、NULL 値が入ります。
FILE_IDENTIFIER_NUMBER	BIGINT	オブジェクトのファイル ID 番号です。この番号は、ファイル・システムでオブジェクトを一意的に識別します。一緒に使用されるファイル ID 番号、世代 ID、およびファイル・システム ID は、システム上のオブジェクトを固有に識別します。
GENERATION_IDENTIFIER	BIGINT	オブジェクトに関連付けられた世代 ID。一緒に使用されるファイル ID 番号、世代 ID、およびファイル・システム ID は、システム上のオブジェクトを固有に識別します。
FILE_SYSTEM_IDENTIFIER	BIGINT	オブジェクトが属するファイル・システム ID。この数値は、オブジェクトが属するファイル・システムを一意的に識別します。一緒に使用されるファイル ID 番号、世代 ID、およびファイル・システム ID は、システム上のオブジェクトを固有に識別します。
FILE_IDENTIFIER	BINARY(16)	参照されたオブジェクトに関連付けられた ID。
FILE_ACCESS	BINARY(4)	ファイル・タイプおよびファイル・モードを含む情報を含むビット・ストリング
CREATE_TIMESTAMP	TIMESTAMP(0)	オブジェクトが作成された時刻。
ACCESS_TIMESTAMP	TIMESTAMP(0)	オブジェクトのデータが最後にアクセスされた時刻。オブジェクトがアクセスされたことがない場合は、NULL 値が入ります。
DATA_CHANGE_TIMESTAMP	TIMESTAMP(0)	オブジェクトのデータが最後に変更された時刻。オブジェクトのデータが一度も変更されていない場合は、NULL 値が入ります。
OBJECT_CHANGE_TIMESTAMP	TIMESTAMP(0)	オブジェクトのデータまたは属性が最後に変更された時刻。オブジェクトのデータまたは属性が一度も変更されていない場合は、NULL 値が入ります。
LAST_USED_TIMESTAMP	TIMESTAMP(0)	オブジェクトが最後に使用された日付。オブジェクトが一度も使用されていない場合、またはオブジェクトが属する IBM i タイプまたはファイル・システムの使用状況データが維持されていない場合は、NULL 値が入ります。
DAYS_USED_COUNT	INTEGER	オブジェクトがこれまでに使用された日数。ファイル・システムによって、およびファイル・システムでサポートされる個々のオブジェクト・タイプによって、「使用」の意味が異なります。「使用」とは、ファイルのオープンまたはクローズを意味する場合もあれば、リンクの追加、名前変更、復元、オブジェクトのチェックアウトを指す場合もあります。このカウントは 1 日に 1 回増分され、オブジェクトが使用され、リセットできます。
LAST_RESET_TIMESTAMP	TIMESTAMP(0)	使用日数カウントが最後にゼロにリセットされたときのタイム・スタンプ。使用日数カウントがリセットされていない場合は、NULL 値が入ります。
ALLOCATED_SIZE	BIGINT	このオブジェクトに割り振られたバイト数。
DATA_SIZE	BIGINT	このオブジェクト内のデータのサイズ (バイト単位)。このサイズには、オブジェクト・ヘッダーや、オブジェクトに関連した拡張属性のサイズは含まれません。
CCSID	INTEGER	オブジェクトのデータおよび拡張属性のCCSID。 CCSID がない場合は、NULL 値が入ります。
CODE_PAGE	INTEGER	ファイル内のデータまたはディレクトリーの拡張属性に使用されるコード化文字セット ID (CCSID) から派生したコード・ページ。複数のコード・ページがある場合、または CCSID がサポートされている CCSID ではない場合は、NULL 値が入ります。
EXTENDED_ATTRIBUTE_COUNT	BIGINT	このオブジェクトに関連した拡張属性の数。
CRITICAL_EXTENDED_ATTRIBUTE_COUNT	BIGINT	このオブジェクトに関連した重要な拡張属性の数。
EXTENDED_ATTRIBUTE_SIZE	BIGINT	拡張属性バイトの合計数。
HARD_LINK_COUNT	INTEGER	オブジェクトへのハード・リンク数
OBJECT_READ_ONLY	VARCHAR(3)	オブジェクトが書き込みまたは削除できるか，拡張属性が変更または削除されたか，あるいはそのサイズが変更されたかどうか。 NO オブジェクトは変更できます。 YES オブジェクトは読み取りのみが可能です。
OBJECT_HIDDEN	VARCHAR(3)	通常のディレクトリー・リストを使ってオブジェクトを表示できるかどうか。 NO オブジェクトは非表示ではありません。 YES オブジェクトは非表示です。
TEMPORARY_OBJECT	VARCHAR(3)	オブジェクトが一時オブジェクトであるかどうか。 NO オブジェクトは永続オブジェクトです。 YES オブジェクトは一時オブジェクトです。
SYSTEM_FILE	VARCHAR(3)	オブジェクトがシステム・ファイルであるため、通常のディレクトリー検索から除外されるかどうか。 NO オブジェクトはシステム・ファイルではありません。 YES オブジェクトはシステム・ファイルです。
SYSTEM_USAGE	VARCHAR(6)	ファイルにシステムによる特殊使用があるかどうか。 NONE ファイルは汎用ストリーム・ファイルです。 NWSSTG ファイルはネットワーク・サーバー記憶域スペースです。 VRTVOL ファイルは仮想ボリュームです。この例としては，テープおよび光ディスクの仮想ボリュームが含まれます。 OBJECT_TYPE が *STMF でない場合は、NULL 値が入ります。
DEVICE_SPECIAL_FILE	BIGINT	オブジェクトが装置特殊ファイルであり、それが表す実装置です。これが装置特殊ファイルでない場合は、NULL 値が入ります。
OBJECT_OWNER	VARCHAR(10)	オブジェクトの所有者のユーザー・プロファイル名。次の特殊値を含めることができます。 *NOUSRPRF この特殊値は、リモート・オブジェクトの UID と一致するユーザー ID (UID) を持つユーザー・プロファイルが IBM i 上のローカル・サーバー上に存在しないことを示すために、ネットワーク・ファイル・システムによって使用されます。所有者がない場合は、NULL 値が入ります。
USER_ID_NUMBER	BIGINT	オブジェクトの所有者のユーザー ID (UID) 番号。所有者がない場合は、NULL 値が入ります。
PRIMARY_GROUP	VARCHAR(10)	オブジェクトの 1 次グループとなるユーザー・プロファイルの名前。次の特殊値を含めることができます。 *NOUSRPRF この特殊値は、リモート・オブジェクトの GID と一致するグループ ID (GID) を持つユーザー・プロファイルが IBM i 上のローカル・サーバー上に存在しないことを示すために、ネットワーク・ファイル・システムによって使用されます。オブジェクトに 1 次グループがない場合は、NULL 値が入ります。
GROUP_ID_NUMBER	BIGINT	オブジェクトの 1 次グループとなるユーザー・プロファイルのグループ ID (GID) 番号。オブジェクトに 1 次グループがない場合は、NULL 値が入ります。
AUTHORIZATION_LIST	VARCHAR(10)	指定のオブジェクトを保護するために使用される権限リストの名前。オブジェクトに対する権限の決定に権限リストが使用されない場合は、NULL 値が入ります。
SET_EFFECTIVE_USER_ID	VARCHAR(3)	実行時に有効ユーザーID (UID)を設定します。 NO 実行時にユーザーID (UID)は設定されません。 YES オブジェクト所有者は実行時の有効ユーザーID (UID)となります。 OBJECT_TYPE が *DIR の場合は、NULL 値が入ります。
SET_EFFECTIVE_GROUP_ID	VARCHAR(3)	実行時に有効グループID (GID)を設定します。 NO オブジェクトがファイルの場合は，グループID (GID)は実行時に設定されません。オブジェクトが "ルート" (/)、QOpenSys、またはユーザー定義ファイル・システムのディレクトリーである場合には、ディレクトリーに作成されたオブジェクトのグループ ID (GID) は、オブジェクトを作成するスレッドの有効 GID に設定されます。この値は他のファイル・システムでは設定できません。 YES オブジェクトがファイルの場合は，グループID (GID)は実行時に設定されます。オブジェクトがディレクトリーである場合には，ディレクトリー中に作成されたオブジェクトのグループID (GID)は親ディレクトリーのGIDに設定されます。
AUTHORITY_COLLECTION_VALUE	VARCHAR(10)	オブジェクトの権限収集が活動状態の時にオブジェクトに使用される権限収集値を指定します。 NONE 値オブジェクトの権限収集が活動状態の時には、このオブジェクトの権限情報は収集されません。オブジェクト・タイプが権限収集によってサポートされていない場合は，NONEの値が戻されます。 *OBJINF オブジェクトの権限収集が活動状態の時に、このオブジェクトの権限情報が収集されます。権限検査と関連するオブジェクト・レベル情報の各固有インスタンスについて権限検査情報が収集されます。
OBJECT_AUDIT	VARCHAR(7)	オブジェクトと対応した監査値 ALL システム上のすべてのユーザーによるこのオブジェクトへのすべてのアクセスを監査します。アクセスはすべて，読み取りまたは変更の操作として定義されます。変更システム上のすべてのユーザーによるこのオブジェクトへのすべての変更アクセスを監査します。 NONE 値どのユーザーがオブジェクトにアクセスしているかには関係なく、このオブジェクトの読み取りまたは変更時に、オブジェクトの監査は行われません。 USRPRF 現行のユーザーが監査されている場合にのみ、このオブジェクトを監査します。このオブジェクトの監査を実行するかどうか判別するために、現行のユーザーが検査されます。ユーザー・プロファイルを使用して、このオブジェクトの変更アクセスだけを監査するか、それとも変更アクセスと読み取りアクセスの両方を監査するかを指定できます。ユーザーが現在の監査値の取得を許可されていない場合は、NULL 値が入ります。
OBJECT_AUDIT_CREATE	VARCHAR(7)	ディレクトリーと関連したオブジェクト作成監査値。これは、ディレクトリーに作成されたすべてのオブジェクトに与えられる監査値です。 ALL システム上のすべてのユーザーによるこのオブジェクトへのすべてのアクセスを監査します。アクセスはすべて，読み取りまたは変更の操作として定義されます。変更システム上のすべてのユーザーによるこのオブジェクトへのすべての変更アクセスを監査します。 NONE 値どのユーザーがオブジェクトにアクセスしているかには関係なく、このオブジェクトの読み取りまたは変更時に、オブジェクトの監査は行われません。 SYSVAL ディレクトリーに作成されたオブジェクトのオブジェクト監査値は、システム監査値 (QCRTOBJAUD) によって決定されます。 *USRPRF 現行のユーザーが監査されている場合にのみ、このオブジェクトを監査します。このオブジェクトの監査を実行するかどうか判別するために、現行のユーザーが検査されます。ユーザー・プロファイルを使用して、このオブジェクトの変更アクセスだけを監査するか、それとも変更アクセスと読み取りアクセスの両方を監査するかを指定できます。ユーザー監査変更 (CHGUSRAUD) コマンドの OBJAUD パラメーターは、特定のユーザーの監査を変更するために使用されます。ユーザーが現在のオブジェクト作成監査値を取得することを許可されていない場合は、NULL 値が入ります。
JOURNALED	VARCHAR(3)	オブジェクトの現在のジャーナル状況。 NO オブジェクトは現在ジャーナル処理されていません。 YES オブジェクトは現在ジャーナル処理されています。
JOURNAL_LIBRARY	VARCHAR(10)	現在使用中のジャーナルが入っているライブラリーの名前。オブジェクトがジャーナル処理されていない場合は、NULL 値が入ります。
JOURNAL_NAME	VARCHAR(10)	現在使用されているジャーナルの名前。オブジェクトがジャーナル処理されていない場合は、NULL 値が入ります。
JOURNAL_BEFORE_IMAGE	VARCHAR(3)	ジャーナル処理が活動状態の時に、変更前のオブジェクトのイメージがジャーナル処理されるかどうかを示します。 NO 変更前のオブジェクトのイメージはジャーナル処理されません。 YES 変更前のオブジェクトのイメージはジャーナル処理されます。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
JOURNAL_AFTER_IMAGE	VARCHAR(3)	ジャーナル処理が活動状態の時に、変更後のオブジェクトのイメージがジャーナル処理されるかどうかを示します。 NO 変更後のオブジェクトのイメージはジャーナル処理されません。 YES 変更後のオブジェクトのイメージはジャーナル処理されます。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
JOURNAL_IDENTIFIER	VARCHAR(10)	このオブジェクトのジャーナル ID (JID)。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
JOURNAL_START_TIMESTAMP	TIMESTAMP(0)	オブジェクトのジャーナル処理が最後に開始されたときのタイム・スタンプ。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
JOURNAL_OPTIONAL_ENTRIES	VARCHAR(3)	ジャーナル処理がアクティブのとき、オプショナルと見なされる項目がジャーナル処理されます。オプション・ジャーナル項目のリストは、各オブジェクト・タイプに応じて異なります。各種オブジェクトのこれらのオプション項目については、Integrated File System を参照してください。 NO このオブジェクトのオプション項目はジャーナル処理されません。 YES このオブジェクトのオプション項目はジャーナル処理されます。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
JOURNAL_SUBTREE	VARCHAR(3)	このオブジェクトが継承ジャーナル・セマンティクスを持つディレクトリーまたはライブラリーであるかどうかを示します。 NO このオブジェクトは継承ジャーナル・セマンティクスを使用しません。 YES このオブジェクトがディレクトリーの場合は，このディレクトリー内部で作成またはリンクされた新規オブジェクトは，このディレクトリーのジャーナル・オプションと状態を継承します。このオブジェクトがライブラリーの場合は，このライブラリー内部で作成またはリンクされた新規オブジェクトは，このライブラリーのジャーナル継承ルールに従って，このライブラリーからジャーナル・オプションと状態を継承します。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
PARTIAL_TRANSACTION	CHAR(1)	オブジェクトに部分トランザクションが含まれているかどうかを示します。 N オブジェクトに部分トランザクションが含まれていません。 R ロールバックが、完了前に異常終了しました。オブジェクトは使用できないので、復元することをお勧めします。最後の手段として，ジャーナル処理オブジェクト変更(CHGJRNOBJ)コマンドを使用して，オブジェクトを使用できるようにすることができます。ただし，そのようにすると，オブジェクトは不整合状態のままになることがあります。 Y 部分トランザクションで活動状態の時にオブジェクトが保管されました。後続のオブジェクトの復元には、部分トランザクションが含まれます。トランザクションを完了させるために、ユーザーがジャーナルから変更を適用する必要があります。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
APPLY_STARTING_RECEIVER_LIBRARY	VARCHAR(10)	ジャーナル・レシーバーが入っているライブラリーの名前。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
APPLY_STARTING_RECEIVER	VARCHAR(10)	一番古いジャーナル・レシーバーには，ジャーナル処理変更の適用(APYJRNCHG)を正常に実行する必要があります。 PARTIAL_TRANSACTION の値が Y の場合、ジャーナル・レシーバーには部分トランザクションの開始を表すジャーナル項目が含まれます。そうでない場合には、ジャーナル・レシーバーに保管操作の開始を表すジャーナル項目が入っています。 PARTIAL_TRANSACTION の値が R の場合は、NULL 値が入ります。オブジェクトが一度もジャーナル処理されていない場合は、NULL 値も入ります。
APPLY_STARTING_RECEIVER_ASP	VARCHAR(10)	開始ジャーナル・レシーバーが入っているライブラリーの ASP の名前です。特殊値 *SYSBAS を入れることができます。オブジェクトがジャーナル処理されたことがない場合は、NULL 値が入ります。
OBJECT_SIGNED	VARCHAR(3)	オブジェクトにデジタル署名があるかどうか。 NO オブジェクトはデジタル・シグニチャーをもちません。 YES オブジェクトにデジタル署名があります。 OBJECT_TYPE が *STMF でない場合は、NULL 値が入ります。
SYSTEM_TRUSTED_SOURCE	VARCHAR(3)	オブジェクトが，システムによって信頼されるソースによって署名されているかどうか。 NO どのシグニチャーも，システムによってトラストされたソースからきていません。 YES オブジェクトはシステムによって信頼されるソースによって署名されています。オブジェクトが複数のシグニチャーを持っている場合には，それらのシグニチャーのうち少なくとも1つはシステムの信頼するソースからきたものです。 OBJECT_TYPE が *STMF でない場合、または OBJECT_SIGNED が NO の場合は、NULL 値が入ります。
MULTIPLE_SIGNATURES	VARCHAR(3)	オブジェクトに複数のデジタル署名があるかどうか。 NO オブジェクトには1つのデジタル・シグニチャーしかありません。 YES オブジェクトに複数のデジタル・シグニチャーがあります。 SYSTEM_TRUSTED_SOURCE が YES の場合、少なくとも 1 つの署名がシステムによって信頼されたソースからのものです。 OBJECT_TYPE が *STMF でない場合、または OBJECT_SIGNED が NO の場合は、NULL 値が入ります。
OBJECT_DOMAIN	VARCHAR(7)	オブジェクトの定義域。 * システムオブジェクトはシステム・ドメインに存在します。 * ユーザーオブジェクトはユーザー・ドメインに存在します。
BLOCK_SIZE	INTEGER	オブジェクトのブロック・サイズ。
AUX_STORAGE_ALLOCATION	VARCHAR(8)	指定されたオブジェクトに対してシステムが補助記憶域を割り振る方法を決定します。 DYNAMIC システムは，使用されるスペースとディスク入出力操作回数とのバランスをとりながら，オブジェクトに対して最適な補助記憶域の割り振りを動的に決定します。 MINIMIZE 補助記憶域は，オブジェクトによって使用されるスペースを最小化するために割り振られます。すなわち，追加の補助記憶域が必要になると，それは現行のスペース所要量を入れるための小さいサイズのエクステントに割り振られます。多くの小さなエクステントから成るオブジェクトにアクセスすると，そのオブジェクトのディスク入出力操作の回数が多くなる場合があります。 NORMAL 補助記憶域が通常通り割り振られます。すなわち，追加の補助記憶域が必要になると，ディスク入出力操作の回数を最小化すると同時に，現行のスペース所要量を収容するために論理的にサイズ決定されたエクステント，および予期される将来の所要量が割り振られます。 OBJECT_TYPE が *STMF でない場合は、NULL 値が入ります。
AUX_STORAGE_OVERFLOW	VARCHAR(3)	オブジェクトが常駐する補助記憶域プールをオーバーフローしたかどうか。 NO 補助記憶域プールはオーバーフローしていません。 YES 補助記憶域プールがオーバーフローしています。
MAIN_STORAGE_ALLOCATION	VARCHAR(8)	指定されたオブジェクトに対してシステムが主記憶域をどのように割り振るかを決定します。 DYNAMIC システムは，他のシステム活動および主記憶域の競合に応じて，オブジェクトに対する最適な主記憶域の割り振りを動的に決定します。すなわち，主記憶域の競合がほとんどない時は，ディスク入出力操作の回数を最小化するために，できるだけ多くの記憶域が割り振られて使用されます。著しい主記憶域の競合がある時は，主記憶域の競合を最小化するために，より少ない主記憶域が割り振られて使用されます。 MINIMIZE 主記憶域は，オブジェクトによって使用されるスペースを最小化するように割り振られます。すなわち，できるだけ少ない主記憶域が割り振られ，使用されます。少ない情報が主記憶域にキャッシュされるので，これは主記憶域使用量を最小化し，一方でディスク入出力操作の回数を増やします。 NORMAL 主記憶域が通常通り割り振られます。すなわち，できるだけ多くの主記憶域が割り振られ，使用されます。情報は主記憶域にキャッシュされるので，これはディスク入出力操作の回数を最小化します。 OBJECT_TYPE が *STMF でない場合は、NULL 値が入ります。
STORAGE_FREED	VARCHAR(3)	オブジェクトのデータがオフラインに移行（オンライン記憶域を解放）したかどうか。 NO オブジェクトのデータがオフラインではありません。 YES オブジェクトのデータはオフラインです。
STORED_LOCAL	VARCHAR(3)	オブジェクトがローカルに保管されるか、リモート・システムに保管されるかを示します。ファイルがローカルかリモートかの決定は、それぞれのファイル・システム規則によって異なります。ローカル標識とリモート標識のどちらも伝送しないファイル・システム内のオブジェクトは、リモートとして扱われます。 NO オブジェクトのデータはリモート・システム上にあります。 YES オブジェクトのデータがオフラインではありません。
VIRTUAL_DISK_STORAGE	VARCHAR(3)	オブジェクトが、統合 xSeries サーバーが xSeries サーバーの仮想ディスク・ドライブとして使用するために割り振られたストレージであるかどうか。 NO オブジェクトが仮想ディスク・ストレージではありません。 YES オブジェクトは仮想ディスク・ストレージです。 OBJECT_TYPE が *STMF でない場合は、NULL 値が入ります。
DIRECTORY_FORMAT	CHAR(6)	指定されたディレクトリー・オブジェクトのフォーマット。 TYPE1 ディレクトリーは、元のディレクトリー形式です。ディレクトリー変換(CVTDIR)コマンドを使用して，TYPE1形式からTYPE2形式に変換することができます。 TYPE2 このディレクトリーは、TYPE1 形式のディレクトリーと比較して、パフォーマンス、サイズ、および信頼性が最適化されています。 OBJECT_TYPE が DIR でない場合は、NULL 値が入ります。
STREAM_FILE_FORMAT	CHAR(6)	ストリーム・ファイルのフォーマット。 TYPE1 オブジェクトの形式は、V4R4 より前のリリースで作成された STMF オブジェクトと同じです。最小のオブジェクト・サイズは4096バイトで，最大オブジェクト・サイズは約128ギガバイトです。 TYPE2 この形式は、V4R4 で導入されました。「ルート」(/)、QOpenSys、およびユーザー定義ファイル・システムでは、最小オブジェクト・サイズは 4096 バイトで、最大オブジェクト・サイズは約 1 テラバイトです。設定されていなければ，最大は約256ギガバイトです。 OBJECT_TYPE が STMF でない場合は、NULL 値が入ります。
UDFS_FILE_FORMAT	CHAR(6)	ユーザー定義ファイル・システム内に作成されるストリーム・ファイル (STMF) のデフォルト・ファイル・フォーマット。 TYPE1 ストリーム・ファイル (STMF) の形式は、V4R4 より前のリリースで作成された STMF と同じです。最小のオブジェクト・サイズは4096バイトで，最大オブジェクト・サイズは約128ギガバイトです。 TYPE2 この形式は、V4R4 で導入されました。「ルート」(/)、QOpenSys、およびユーザー定義ファイル・システムでは、最小オブジェクト・サイズは 4096 バイトで、最大オブジェクト・サイズは約 1 テラバイトです。設定されていなければ，最大は約256ギガバイトです。 OBJECT_TYPE が STMF でない場合は、NULL 値が入ります。
UDFS_PREFERRED_STORAGE	CHAR(3)	UDFS 内のオブジェクトの優先ストレージ・メディア。 ANY どの記憶媒体も優先しません。記憶域は任意の使用可能な記憶媒体から割り振られます。 SSD ソリッド・ステート・ドライブ記憶媒体を優先します。記憶域は，ソリッド・ステート・ドライブ記憶媒体が使用可能な場合は，その媒体から割り振られる必要があります。優先ストレージ・メディアが不明の場合は、NULL 値が入ります。
UDFS_TEMPORARY_OBJECT	VARCHAR(3)	UDFS 内のオブジェクトが一時オブジェクトであるかどうか。 NO UDFS 内のオブジェクトは永続オブジェクトです。 YES UDFS 内のオブジェクトは一時オブジェクトです。
CASE_SENSITIVE_FILE_SYSTEM	VARCHAR(3)	このオブジェクトを含むファイル・システムの大/小文字の区別。 NO ファイル・システムは大/小文字を区別しません。 YES ファイル・システムでは大/小文字が区別されます。
RESTRICT_RENAME_AND_UNLINK	VARCHAR(3)	ディレクトリー内のオブジェクトの名前変更およびリンク解除が制限されます。オブジェクトはこの属性がオンに設定されているディレクトリーにリンクできますが，操作を実行するユーザーに対して次の1つ以上が真でない場合には，名前変更またはリンク解除することはできません。ユーザーがオブジェクトの所有者である。ユーザーがディレクトリーの所有者である。ユーザーが*ALLOBJ特殊権限を持っている。 NO 名前変更およびリンク解除操作の追加の制約事項なし。 YES 名前変更およびリンク解除操作の追加の制約事項あり。
PC_ARCHIVE	VARCHAR(3)	オブジェクトが最後に PC に保管されてから変更されたかどうか。 NO オブジェクトは変更されていません。 YES オブジェクトは変更されました。
SYSTEM_ARCHIVE	VARCHAR(3)	オブジェクトが変更され、IBM i に保存する必要があるかどうか。オブジェクトの変更時刻が更新されると値は YES になり、オブジェクトが保管されると値は NO に設定されます。 NO オブジェクトが変更されておらず，保管する必要がありません。 YES オブジェクトが変更されたため、保存する必要があります。
ALLOW_SAVE	VARCHAR(3)	オブジェクトを保管できるかどうか。 NO このオブジェクトは，オブジェクト保管(SAV)コマンドまたはQSRSAVE() APIの使用時に保管されません。さらに，このオブジェクトがディレクトリーの場合には，ディレクトリーのサブツリーのオブジェクトは，保管するオブジェクトとして明示的に指定されていない限り，いずれも保管されません。 YES このオブジェクトは，オブジェクト保管(SAV)コマンドまたはQSRSAVE() APIの使用時に保管されます。
SYSTEM_RESTRICT_SAVE	VARCHAR(3)	システムがオブジェクトの保管を防止するかどうか。 NO システムはオブジェクトを保存できないようにしません。 YES システムは、システムの制約のためにオブジェクトを保管できないと判断しました。
INHERIT_ALLOW_CHECKPOINT_WRITER	VARCHAR(3)	ディレクトリー内で作成された新規オブジェクトが、その親の活動時保管チェックポイント処理オプションを継承するかどうか。 NO このディレクトリー内に作成された新規ディレクトリー・オブジェクトの QP0L_ATTR_INHERIT_ALWCKPWRT 属性は NO に設定されます。このディレクトリー内に作成された新規オブジェクトの QP0L_ATTR_ALWCKPWRT 属性は、QP0L_NOT_ALWCKPWRT に設定されます。 YES このディレクトリー内に作成される新規ディレクトリー・オブジェクトは、QP0L_ATTR_INHERIT_ALWCKPWRT 属性が YES に設定されます。このディレクトリー内に作成された新規オブジェクトの QP0L_ATTR_ALWCKPWRT 属性は、QP0L_ALWCKPWRT に設定されます。
ALLOW_WRITE_DURING_SAVE	VARCHAR(3)	オブジェクトがストリーム・ファイルである場合は，活動状態保管チェックポイント処理時に，このストリーム・ファイルを読み取りプログラムおよび書き出しプログラムと共用できるかどうかを示します。オブジェクトがディレクトリーである場合は，活動状態保管操作時に，このディレクトリー内でリンクの追加，除去，および名前変更を行えるかどうかを示します。 NO オブジェクトがストリーム・ファイルである場合は，活動状態保管チェックポイント処理時に，このストリーム・ファイルを読み取りプログラムとのみ共用できます。オブジェクトがディレクトリーである場合は，活動状態保管操作時に，このディレクトリー内でリンクの追加，除去，および名前変更を行うことはできません。 YES オブジェクトがストリーム・ファイルである場合は，活動状態保管チェックポイント処理時に，このストリーム・ファイルを読み取りプログラムおよび書き出しプログラムと共用できます。オブジェクトがディレクトリーである場合は，活動状態保管操作時に，このディレクトリー内でリンクの追加，除去，および名前変更を行うことができます。 OBJECT_TYPE が STMF または DIR でない場合は、NULL 値が入ります。
EXIT_PROGRAM_OPEN_CLOSE	VARCHAR(3)	オブジェクトがオープンまたはクローズされるときに、統合ファイル・システムのオープン関連出口プログラムのいずれかに登録された出口プログラムが呼び出されるかどうか。これは、オブジェクトの実行出口プログラム値です。 NO オブジェクトがオープンまたはクローズされる時には, 出口プログラムは呼び出されません。 YES 出口プログラムは, オブジェクトがオープンされる前, およびオブジェクトがクローズされた後に呼び出されます。 OBJECT_TYPE が *STMF でない場合は、NULL 値が入ります。
EXIT_PROGRAM_OPEN_CLOSE_DIRECTORY	VARCHAR(3)	オブジェクトがこのディレクトリーに作成されるときに使用される実行出口プログラムの値。これは、ディレクトリーの実行出口プログラムの作成値でもあります。 NO このディレクトリーに作成されたオブジェクトの実行出口プログラム値は NO になります。さらに, このディレクトリーに作成されたディレクトリー・オブジェクトの実行出口プログラムの作成値は NO になります。 YES このディレクトリーに作成されたオブジェクトの実行出口プログラム値は YES になります。さらに, このディレクトリーに作成されたディレクトリー・オブジェクトの実行出口プログラムの作成値は YES になります。 OBJECT_TYPE が *DIR でない場合は、NULL 値が入ります。
EXIT_PROGRAM_SCAN	VARCHAR(11)	出口プログラムが統合ファイル・システムのスキャン関連出口点で登録されるときに，オブジェクトがスキャンされるかどうか。 CHANGE ONLY オブジェクトが最後にスキャンされてから後で変更されている場合に限り，オブジェクトはスキャン関連出口プログラムに記述されている規則に従ってスキャンされます。スキャン・ソフトウェアが更新されても，オブジェクトはスキャンされません。この属性が有効となるのは，スキャン・ファイル・システム制御(QSCANFSCTL)システム値に USEOCOATRが指定されている場合だけです。それ以外の場合は、YES と同じように扱われます。 NO オブジェクトは、スキャン関連出口プログラムに記述されている規則に従ってスキャンされません。 YES オブジェクトが変更されているか，あるいは最後にオブジェクトがスキャンされてから後でスキャン・ソフトウェアが更新されている場合には，オブジェクトはスキャン関連出口プログラムに記述されている規則に従ってスキャンされます。 OBJECT_TYPE が STMF でない場合は、NULL 値が入ります。
EXIT_PROGRAM_SCAN_DIRECTORY	VARCHAR(11)	出口プログラムが統合ファイル・システムのスキャン関連出口点で登録されるときに，ディレクトリー内に作成されたオブジェクトがスキャンされるかどうか。 CHANGE ONLY ディレクトリーにオブジェクトが作成された後で，最後のオブジェクトのスキャン以降にオブジェクトが変更されている場合に限り，オブジェクトは，スキャン関連の出口プログラムに記述された規則に従ってスキャンされます。スキャン・ソフトウェアが更新されても，オブジェクトはスキャンされません。この属性が有効となるのは，スキャン・ファイル・システム制御(QSCANFSCTL)システム値に USEOCOATRが指定されている場合だけです。それ以外の場合は、YES と同じように扱われます。 NO ディレクトリーにオブジェクトが作成された後は、スキャン関連出口プログラムに記述されている規則に従ってオブジェクトがスキャンされることはありません。 YES ディレクトリーにオブジェクトが作成された後で，オブジェクトが変更されているかあるいは最後にオブジェクトがスキャンされた後でスキャン・ソフトウェアが更新されている場合には，そのオブジェクトはスキャン関連出口プログラムで記述されている規則に従ってスキャンされます。 OBJECT_TYPE が DIR でない場合は、NULL 値が入ります。
SCAN_STATUS	VARCHAR(12)	このオブジェクトに関連したスキャンの状況。 FAILURE オブジェクトはスキャン関連出口プログラムによってスキャンされ，その最後のスキャン要求時点でオブジェクトはスキャンに失敗して操作は完了していません。一度オブジェクトが失敗としてマークづけされると，そのオブジェクトのスキャン・シグニチャーがグローバル・スキャン・キー・シグニチャーまたは適切な独立ASPグループのスキャン・シグニチャーと異なる場合を除き，再びスキャンされることはありません。したがって，そのアクセスがオブジェクトのスキャン時の基準を満たす場合には，このオブジェクトの以後の処理要求は失敗し，スキャン失敗指示が出されます。 NOT REQUIRED オブジェクトがスキャンしないようにマークづけされているので，オブジェクトにはスキャンは要求されません。 PENDING オブジェクトは*TYPE2ディレクトリー形式に完全に変換されていないファイル・システム中にあるので，そのファイル・システムが完全に変換されるまではスキャンされません。 REQUIRED オブジェクトのスキャンが必要な理由は、オブジェクトがまだスキャン関連出口プログラムによってスキャンされていないか、あるいはオブジェクト・データまたは CCSID が最後にスキャンされてから変更されているかのいずれかです。 SUCCESS オブジェクトはスキャン関連出口プログラムによってスキャンされ，その最後のスキャン要求時点でオブジェクトはスキャンに失敗していません。
CCSID_SCAN	INTEGER	オブジェクトが以前に CCSID でスキャンされた場合、そのオブジェクトがスキャンされた CCSID 値。 SCAN_STATUS が SUCCESS の場合、オブジェクトはこの CCSID で正常にスキャンされます。 SCAN_STATUS が FAILURE の場合、オブジェクトはこの CCSID でのスキャンに失敗します。 CCSID が適用されない場合は、NULL 値が入ります。
CCSID_SCAN_SUCCESS	INTEGER	SCAN_STATUS が SUCCESS の場合、オブジェクトはこの CCSID で正常にスキャンされます。 SCAN_STATUS が FAILURE の場合、または CCSID_SCAN が NULL 値の場合は、NULL 値が入ります。
SCAN_SIGNATURES_DIFFERENT	VARCHAR(3)	オブジェクトが独立ASPグループ内にある場合には，オブジェクトのスキャン・シグニチャーは関連する独立ASPグループのスキャン・シグニチャーと比較されます。オブジェクトが独立 ASP グループに含まれない場合、オブジェクト・スキャン・シグニチャーはグローバル・スキャン・シグニチャーの値と比較されます。 NO 比較されたシグニチャーは異なっていません。 YES 比較されたシグニチャーは異なっています。
BINARY_SCAN	VARCHAR(3)	オブジェクトは、前にスキャンされた時にバイナリー・モードでスキャンされました。 NO オブジェクトはバイナリー・モードでスキャンされていません。 YES オブジェクトはバイナリー・モードでスキャンされています。
CHECKED_OUT	VARCHAR(3)	オブジェクトがチェックアウトされているかどうか。 NO オブジェクトはチェックアウトされません。 YES オブジェクトはチェックアウトされています。
CHECKED_OUT_TIMESTAMP	TIMESTAMP(0)	オブジェクトがチェックアウトされた時刻。オブジェクトがチェックアウトされていない場合は、NULL 値が入ります。
CHECKED_OUT_USER	VARCHAR(10)	オブジェクトをチェックアウトしたユーザー。オブジェクトがチェックアウトされていない場合は、NULL 値が入ります。

例

ディレクトリー /usr 内のすべてのオブジェクトの基本情報をリストします。

SELECT PATH_NAME, OBJECT_TYPE, DATA_SIZE, OBJECT_OWNER
    FROM TABLE (QSYS2.IFS_OBJECT_STATISTICS(START_PATH_NAME => '/usr', 
                                            SUBTREE_DIRECTORIES => 'NO'));

/usr 内のすべてのオブジェクトの基本情報をリストし、すべてのサブディレクトリーも処理します。

SELECT PATH_NAME, OBJECT_TYPE, DATA_SIZE, OBJECT_OWNER 
    FROM TABLE (QSYS2.IFS_OBJECT_STATISTICS(START_PATH_NAME => '/usr',
                                            SUBTREE_DIRECTORIES => 'YES'));