RTVDIRINF および PRTDIRINF コマンドの出力の処理
ディレクトリー情報の検索 (RTVDIRINF) コマンドは、統合ファイル・システム中の オブジェクトの属性を収集するために使用されます。収集された情報はデータベース・ファイル (表) に保管されます。 ファイルには、INFFILEPFX パラメーターに指定された情報ファイル接頭部を使って名前が付けられます。 表は、 INFLIB パラメーターによって指定されたライブラリー内に作成されます。
RTVDIRINF コマンドの結果として、 3 つの表が作成されます。 1 つの表はオブジェクト属性を保管します。 もう 1 つはディレクトリー用で、最後の表は、 オブジェクト属性を保管するのにどのファイルが使用されたかを判別します。
V6R1 より、これらの 3 つの表は System i® ナビゲーター でも作成できます。詳しくは、IBM Navigator for i によるフォルダー属性の収集および分析を参照してください。
以下の表は、オブジェクト属性を保管する表に含まれるフィールドを 示しています。情報ファイル接頭部 (INFFILEPFX) パラメーターに *GEN を指定した場合は、この コマンドで生成される固有の接頭部を使用してデータベース・ファイルが作成されます。この接頭部は QAEZD で始まり、その後に 4 桁が続きます。収集された情報を保管するために作成されるファイルの名前には、 この接頭部が使用され、その後に文字 D (ディレクトリー情報を含むファイルの場合)、 または文字 O (ディレクトリー内のオブジェクトに関する情報を含むファイルの場合) のいずれかが付きます。 例えば、*GEN を 指定してこのコマンドを初めて実行した場合は、ファイル QAEZD0001D および QAEZD0001O が情報 ライブラリー (INFLIB) パラメーターで指定されたライブラリー内に作成されます。ユーザーは、 このデータベースの命名に使用するファイル接頭部を指定できます (最大で 9 文字の長さ)。
フィールド名 | フィールド・タイプ | フィールド記述 |
---|---|---|
QEZDIRIDX | INTEGER | ディレクトリーとオブジェクト・テーブル間のリレーショナル ID表を結合して完全なパス名情報を得るために使用します。オブジェクト・テーブル内の QEZDIRIDX フィールドの値は、オブジェクトの親ディレクトリーのディレクトリー・テーブルにおける QEZDIRIDX の値と一致します。 注: 「ルート」ディレクトリー (/) が RTVDIRINF への入力データとして指定される場合、「ルート」ディレクトリー (/) に親ディレクトリーがなくても QEZDIRIDX の値は 1 になります。
|
QEZOBJNAM 1 | VARGRAPHIC (1024) | オブジェクト名。 2 |
QEZOBJLEN | INTEGER | オブジェクト名 (フィールド QEZOBJNAM) に含まれるバイト数。 |
QEZNMCCSID | INTEGER | オブジェクト名 (フィールド QEZOBJNAM) を表現する CCSID。 |
QEZREGION | GRAPHIC (2) | オブジェクト名 (フィールド QEZOBJNAM) の国を表す 2 文字の ID。 この ID は照合シーケンスなど、操作の場所によって定義される操作に影響を及ぼします。 |
QEZLANGID | GRAPHIC (3) | オブジェクト名 (フィールド QEZOBJNAM) に使用されている言語を表す 3 文字の ID。 |
QEZMODE | INTEGER | ファイルのアクセス・モードとタイプ。 モードの詳細については、ファイルのオープン open() API を参照してください。 |
QEZOBJTYPE 1 | GRAPHIC (10) | オブジェクト・タイプ。 |
QEZCCSID | INTEGER | データの CCSID およびオブジェクトの拡張属性。 |
QEZALCSIZE 1 | BIGINT | このオブジェクトに割り振られたバイト数。 |
QEZDTASIZE | BIGINT | このオブジェクト内のデータのサイズ (バイト)。 このサイズには、オブジェクト・ヘッダーや、 オブジェクトに関連した拡張属性のサイズは含まれません。 |
QEZEAS | BIGINT | このオブジェクトに関連した拡張属性の数。 |
QEZCEAS | BIGINT | このオブジェクトに関連した重要な拡張属性の数。 |
QEZEXTATRS | BIGINT | すべての拡張属性データの合計バイト数。 |
QEZCRTTIM | TIMESTAMP | オブジェクトが作成された日時。 |
QEZACCTIM | TIMESTAMP | オブジェクトのデータが最後にアクセスされた日時。 |
QEZCHGTIMA 1 | TIMESTAMP | オブジェクトの属性が最後に変更された日時。 |
QEZCHGTIMD | TIMESTAMP | オブジェクトのデータが最後に変更された日時。 |
QEZSTGFREE 1 | SMALLINT | オブジェクトのデータがオフラインで移動され、
オンライン記憶域が解放されたかどうか。
有効な値は次のとおりです。
0 - オブジェクトのデータはオフラインでありません。 1 - オブジェクトのデータはオフラインです。 |
QEZCHKOUT 1 | SMALLINT | オブジェクトがチェックアウトされたかどうかを示す標識。
有効な値は次のとおりです。
0 - オブジェクトはチェックアウトされていません。 1 - オブジェクトはチェックアウトされています。 |
QEZCHKOWN | GRAPHIC (10) | オブジェクトをチェックアウトしたユーザー。 チェックアウトされていない場合、このフィールドはブランクになります。 |
QEZCHKTIM | TIMESTAMP | オブジェクトがチェックアウトされた日時。 オブジェクトがチェックアウトされていない場合、 このフィールドには NULL がその値として入れられます。 |
QEZLOCAL | SMALLINT | オブジェクトがローカルに保管されるか、
それともリモート・システム上に保管されるか。
オブジェクトをローカルに保管するかリモートに保管するかの決定は、
対応するファイル・システムの規則に応じて異なります。
ローカル標識とリモート標識のどちらも伝送しないファイル・システム内のオブジェクトは、
リモートとして扱われます。
有効な値は次のとおりです。
1 - オブジェクトのデータはローカルに保管されます。 2 - オブジェクトのデータはリモート・システム上に保管されます。 |
QEZOWN 1 | GRAPHIC (10) | オブジェクトの所有者であるユーザー・プロファイルの名前。
または、以下の特殊値。
*NOUSRPRF - この特殊値はネットワーク・ファイル・システムによって使用され、 リモート・オブジェクトのユーザー ID (UID) に一致する UID を持つユーザー・プロファイルが、 ローカル iSeries サーバー上に存在しないことを示します。 |
QEZUID | INTEGER | システムの各ユーザーごとに、 固有の数値であるユーザー識別番号 (UID) が必要です。 |
QEZOWNPGP | GRAPHIC (10) | オブジェクトの 1 次グループであるユーザー・プロファイルの名前。
または、以下の特殊値。
*NONE - このオブジェクトには 1 次グループがありません。 *NOUSRPRF - この特殊値はネットワーク・ファイル・システムによって使用され、 リモート・オブジェクトのグループ ID (GID) に一致する GID を持つユーザー・プロファイルがローカル・サーバー上に存在しないことを示します。 |
QEZGID | INTEGER | グループ・プロファイルは、 固有の数値であるグループ識別番号 (GID) によって識別されます。 |
QEZAUTLST | GRAPHIC (10) | 指定されたオブジェクトを保護するのに使用される権限リストの名前。 値 *NONE は、オブジェクトの権限を決定するために権限リストが使用されないことを示します。 |
QEZASP | SMALLINT | ストレージが保管される補助記憶域プール。 |
QEZJRNSTS 1 | SMALLINT | オブジェクトの現在のジャーナル状況。
このフィールドは、以下のいずれかの値になります。
0 (NOT_JOURNALED) - オブジェクトは現在、 ジャーナル処理されていません。 1 (JOURNALED) - オブジェクトは現在、 ジャーナル処理されています。 |
QEZJSUBTRE | SMALLINT | このフラグが戻されるとき、このオブジェクトは、
統合ファイル・システムのジャーナル処理サブツリー・セマンティクスを持つディレクトリーです。
0 - オブジェクトは、サブツリー・セマンティクスでジャーナル処理されません。 1 - オブジェクトは、サブツリー・セマンティクスでジャーナル処理されます。 このディレクトリーのサブツリー内に新しく作成されるオブジェクトは、 このディレクトリーからジャーナル処理属性とオプションを継承します。 |
QEZJOPTENT | SMALLINT | ジャーナル処理がアクティブのとき、
オプショナルと見なされる項目がジャーナル処理されます。
オプション・ジャーナル項目のリストは、
各オブジェクト・タイプに応じて異なります。
0 - オブジェクトの、オプション項目はジャーナル処理されません。 1 - オブジェクトの、オプション項目がジャーナル処理されます。 |
QEZJAFTERI | SMALLINT | ジャーナル処理がアクティブのとき、
変更後のオブジェクトのイメージがジャーナル処理されます。
0 - オブジェクトの、 変更後イメージはジャーナル処理されません。 1 - オブジェクトの、 変更後イメージがジャーナル処理されます。 |
QEZJBEFORI | SMALLINT | ジャーナル処理がアクティブのとき、
変更前のオブジェクトのイメージがジャーナル処理されます。
0 - オブジェクトの、 変更前イメージはジャーナル処理されません。 1 - オブジェクトの、 変更前イメージがジャーナル処理されます。 |
QEZJRNID | GRAPHIC (10) | このフィールドは、 ジャーナル処理対象のオブジェクトに ID を関連付けます。 さまざまなジャーナル処理関連コマンドおよび API でこの ID を使用できます。オブジェクトがジャーナル処理されなかった場合は、このフィールドはブランクになります。 |
QEZJRNNAM | GRAPHIC (10) | ジャーナル状況が JOURNALED の場合、 このフィールドには、現在使用されているジャーナルの名前が入ります。 ジャーナル状況が NOT_JOURNALED の場合、このフィールドには、このオブジェクトに関して最後に使用されていたジャーナルの名前が入ります。 このオブジェクトが一度もジャーナル処理されたことがない場合、このフィールドのすべてのバイトは 2 進ゼロに設定されます。オブジェクトがジャーナル処理されなかった場合は、このフィールドはブランクになります。 |
QEZJRNLIB | GRAPHIC (10) | ジャーナル状況が JOURNALED の場合、 このフィールドには、現在使用されているジャーナルを含むライブラリーの名前が入ります。 ジャーナル状況が NOT_JOURNALED の場合、このフィールドには、 最後に使用されたジャーナルを含むライブラリーの名前が入ります。 このオブジェクトが一度もジャーナル処理されたことがない場合、このフィールドのすべてのバイトは 2 進ゼロに設定されます。オブジェクトがジャーナル処理されなかった場合は、このフィールドはブランクになります。 |
QEZJRNSTR | TIMESTAMP | オブジェクトのジャーナル処理が最後に開始された日時に対応する Epoch 以降の秒数。 このオブジェクトが一度もジャーナル処理されたことがない場合、このフィールドは 2 進ゼロに設定されます。オブジェクトがジャーナル処理されなかった場合は、このフィールドにはその値として NULL が 入れられます。 |
QEZAUDT | GRAPHIC (10) | オブジェクトに関連した監査値。
有効な値は次のとおりです。
*NONE - オブジェクトにアクセスするユーザーにかかわりなく、このオブジェクトが読み取りまたは変更されるとき、 オブジェクトの監査は実行されません。 *USRPRF - 現在のユーザーが監査されている場合にのみ、 このオブジェクトを監査します。 このオブジェクトを監査するかどうか判別するために、 現在のユーザーが検査されます。 ユーザー・プロファイルを使用して、 このオブジェクトの変更アクセスだけを監査するか、 それとも変更アクセスと読み取りアクセスの両方を監査するかを指定できます。 *CHANGE - システムのすべてのユーザーによる、 このオブジェクトへの変更アクセスをすべて監査します。 *ALL - システムのすべてのユーザーによる、 このオブジェクトへのすべてのアクセスを監査します。 すべてのアクセスは、読み取り操作または変更操作として定義されます。 *NOTAVL - 操作を実行するユーザーは、現行オブジェクトの監査値を取得できません。 |
QEZBLKSIZ | INTEGER | オブジェクトのブロック・サイズ。 |
QEZNLNK | INTEGER | オブジェクトへのハード・リンクの数。 |
QEZFILEID 1 | GRAPHIC (16) | オブジェクトのファイル ID。 オブジェクトに関連付けられた識別子。 Qp0lGetPathFromFileID() と、ファイル ID を指定すれば、 オブジェクトのパス名を検索できます。 |
QEZFILEIDS | INTEGER | 4 バイトからなるファイル ID。 この数値は、ファイル・システム内のオブジェクトを一意的に識別します。 この数値は、システム全体の中のオブジェクトを識別することはできません。 |
QEZGENID | BIGINT | ファイル ID に関連した生成 ID。 |
QEZFSID | BIGINT | オブジェクトが属するファイル・システム ID。 この数値は、オブジェクトが属するファイル・システムを一意的に識別します。 |
QEZRDEV | BIGINT | オブジェクトがデバイス特殊ファイルを表す場合、 それによって表される実際のデバイス。 |
QEZDOM | GRAPHIC (10) | オブジェクトのドメイン。
有効な値は次のとおりです。
*SYSTEM - オブジェクトはシステム・ドメインに存在します。 *USER - オブジェクトはユーザー・ドメインに存在します。 |
QEZCRTAUD | GRAPHIC (10) | このディレクトリー内に作成されるオブジェクトに関連した監査値。
有効な値は次のとおりです。
*NONE - オブジェクトにアクセスするユーザーにかかわりなく、このオブジェクトが読み取りまたは変更されるとき、 オブジェクトの監査は実行されません。 *USRPRF - 現在のユーザーが監査されている場合にのみ、 このオブジェクトを監査します。 このオブジェクトを監査するかどうか判別するために、 現在のユーザーが検査されます。 ユーザー・プロファイルを使用して、 このオブジェクトの変更アクセスだけを監査するか、 それとも変更アクセスと読み取りアクセスの両方を監査するかを指定できます。 *CHANGE - システムのすべてのユーザーによる、 このオブジェクトへの変更アクセスをすべて監査します。 *ALL - システムのすべてのユーザーによる、 このオブジェクトへのすべてのアクセスを監査します。 すべてのアクセスは、読み取り操作または変更操作として定義されます。 *NOTAVL - 操作を実行するユーザーは、現行作成オブジェクトの監査値を取得できません。 *SYSVAL - ディレクトリーに作成されるオブジェクトのオブジェクト監査値は、システム監査値 (QCRTOBJAUD) によって決まります。 |
QEZSCN | GRAPHIC (1) | 統合ファイル・システムのいずれかのスキャン関連出口点に出口プログラムが登録されている場合、
オブジェクトがスキャンされるかどうかを指定します。
有効な値は次のとおりです。 x'00' (SCANNING_NO) - スキャン関連出口プログラムに記述された規則に従ってオブジェクトがスキャンされません。 注: この属性を持つオブジェクトが復元されるときにファイル・システム・スキャン制御 (QSCANFSCTL) の値 *NOPOSTRST が指定されていない場合、
オブジェクトは、復元後に少なくとも一度スキャンされます。
x'01' (SCANNING_YES) - オブジェクトが最後にスキャンされた以降に、 オブジェクトが変更された場合、またはにスキャン・ソフトウェアがアップデートされた場合には、 スキャン関連出口プログラムに記述された規則に従ってオブジェクトがスキャンされます。 x'02' (SCANNING_CHGONLY) - オブジェクトが最後にスキャンされた以降にオブジェクトが変更された場合に限り、 スキャン関連出口プログラムに記述された規則に従ってオブジェクトがスキャンされます。スキャン・ソフトウェアがアップデートされた場合には、 スキャンは実行されません。 この属性は、 ファイル・システム・スキャン制御 (QSCANFSCTL) システム値が *USEOCOATR に指定されている場合にのみ有効です。 そうでない場合は、 オブジェクトの属性が SCANNING_YES であるものとして扱われます。 注: この属性を持つオブジェクトが復元されるときにファイル・システム・スキャン制御 (QSCANFSCTL) の値 *NOPOSTRST が指定されていない場合、
オブジェクトは、復元後に少なくとも一度スキャンされます。
|
QEZINHSCN | GRAPHIC (1) | 統合ファイル・システムのいずれかのスキャン関連出口点に出口プログラムが登録されている場合、
ディレクトリー内に作成されるオブジェクトをスキャンするかどうかを指定します。
有効な値は次のとおりです。 x'00' - ディレクトリー内にオブジェクトが作成された後、
スキャン関連出口プログラムに記述された規則に従ってオブジェクトがスキャンされません。
注: この属性を持つオブジェクトが復元されるときにファイル・システム・スキャン制御 (QSCANFSCTL) の値 *NOPOSTRST が指定されていない場合、
オブジェクトは、復元後に少なくとも一度スキャンされます。
x'01' - ディレクトリー内にオブジェクトが作成された後、オブジェクトが最後にスキャンされた以降にオブジェクトが変更された場合、またはスキャン・ソフトウェアがアップデートされた場合に、スキャン関連出口プログラムに記述された規則に従ってオブジェクトがスキャンされます。 x'02'
- ディレクトリー内にオブジェクトが作成された後、
オブジェクトが最後にスキャンされた以降にオブジェクトが変更された場合に限り、
スキャン関連出口プログラムに記述された規則に従ってオブジェクトがスキャンされます。スキャン・ソフトウェアがアップデートされた場合には、
スキャンは実行されません。
この属性は、
ファイル・システム・スキャン制御 (QSCANFSCTL) システム値が *USEOCOATR に指定されている場合にのみ有効です。
そうでない場合は、
オブジェクトの属性が SCANNING_YES であるものとして扱われます。
注: この属性を持つオブジェクトが復元されるときにファイル・システム・スキャン制御 (QSCANFSCTL) の値 *NOPOSTRST が指定されていない場合、
オブジェクトは、復元後に少なくとも一度スキャンされます。
|
QEZSSTATUS | GRAPHIC (1) | このオブジェクトに関連したスキャン状況。
このフィールドは、以下のいずれかの値になります。
x'00' (SCAN_REQUIRED) - スキャン関連出口プログラムによってまだスキャンされていないため、 あるいは、最後のスキャン以降にオブジェクト・データか CCSID が変更されたため、 オブジェクトのスキャンが必要です。 オブジェクト・データまたは CCSID が変更される例には、 (直接の、またはメモリー・マッピングを介した) オブジェクトへの書き込み、 オブジェクトの切り捨て、オブジェクトのクリア、 オブジェクトの CCSID 属性の変更などがあります。 x'01' (SCAN_SUCCESS) - オブジェクトはスキャン関連出口プログラムによってすでにスキャン済みで、 その最後のスキャン要求の際、オブジェクトのスキャンが失敗しませんでした。 x'02' (SCAN_FAILURE) - オブジェクトはスキャン関連出口プログラムによってすでにスキャン済みです。 その最後のスキャン要求の際、オブジェクトのスキャンが失敗し、 操作が完了しませんでした。 いったんオブジェクトが失敗済みとマークされると、 オブジェクトが再びスキャンされるのは、 オブジェクトのスキャン・シグニチャーがグローバル・スキャン・キー・シグニチャーまたは独立 ASP グループ・スキャン・キー・シグニチャーと異なるようになった時点です。 このため、オブジェクトに対する処理を行う後続の要求は、 スキャン失敗標識とともに失敗します。 失敗する要求の例としては、オブジェクトのオープン、 オブジェクトの CCSID の変更、オブジェクトのコピーなどがあります。 x'05' (SCAN_PENDING_CVN) - オブジェクトが *TYPE2 ディレクトリー内に含まれないため、 ディレクトリーを変換するまではスキャンされません。 x'06' (SCAN_NOT_REQUIRED) - オブジェクトがスキャン対象外とマークされているため、 オブジェクトのスキャンは必要ありません。 |
QEZSSIGDF | GRAPHIC (1) | スキャン・シグニチャーは、
スキャン・ソフトウェアのサポート・レベルを示します。
オブジェクトが独立 ASP グループに含まれる場合、 オブジェクト・スキャン・シグニチャーは関連する独立 ASP グループ・スキャン・シグニチャーと比較されます。 オブジェクトが独立 ASP グループに含まれない場合、 オブジェクト・スキャン・シグニチャーはグローバル・スキャン・シグニチャーの値と比較されます。 このフィールドは、以下のいずれかの値になります。 x'00' - 比較されたシグニチャーは互いに異なりません。 x'01' - 比較されたシグニチャーが互いに異なります。 |
QEZSBINARY | GRAPHIC (1) | オブジェクトが以前にスキャンされたとき、
バイナリー・モードでスキャンされたかどうかを示す。
このフィールドは、以下のいずれかの値になります。
x'00' - オブジェクトはバイナリー・モードでスキャンされませんでした。 x'01' - オブジェクトはバイナリー・モードでスキャンされました。 オブジェクトのスキャン状況が SCAN_SUCCESS であれば、 オブジェクトはバイナリーで正常にスキャン済みです。 オブジェクトのスキャン状況が SCAN_FAILURE であれば、 オブジェクトのバイナリーでのスキャンが失敗しました。 |
QEZSCCSID1 | INTEGER | オブジェクトが以前にスキャンされたとき、 リストされた CCSID でスキャンされたかどうかを示す。 オブジェクトのスキャン状況が SCAN_SUCCESS であれば、 オブジェクトはこの CCSID で正常にスキャン済みです。 オブジェクトのスキャン状況が SCAN_FAILURE であれば、 この CCSID でのオブジェクト・スキャンが失敗しました。 値 0 は、このフィールドが適用されないことを意味します。 |
QEZSCCSID2 | INTEGER | オブジェクトが以前にスキャンされたとき、 リストされた CCSID でスキャンされたかどうかを示す。 オブジェクトのスキャン状況が SCAN_SUCCESS であれば、 オブジェクトはこの CCSID で正常にスキャン済みです。 オブジェクトのスキャン状況が SCAN_FAILURE であれば、 このフィールドは 0 になります。 値 0 は、このフィールドが適用されないことを意味します。 |
QEZUDATE | TIMESTAMP | オブジェクトが最後に使用された日付に対応する Epoch 以降の秒数。 オブジェクトの作成時には、このフィールドはゼロです。 IBM i タイプ用、 またはオブジェクトが属するファイル・システム用に使用状況データが保持されない場合、 このフィールドはゼロです。 |
QEZUDCOUNT | INTEGER | オブジェクトがこれまでに使用された日数。 ファイル・システムによって、 およびファイル・システムでサポートされる個々のオブジェクト・タイプによって、 「使用」の意味が異なります。 「使用」とは、ファイルのオープンまたはクローズを意味する場合もあれば、 リンクの追加、名前変更、復元、オブジェクトのチェックアウトを指す場合もあります。 このカウントは、オブジェクトが使用された一日ごとに増加し、Qp0lSetAttr() API を呼び出すことによってゼロにリセットされます。 |
QEZURESET | INTEGER | 使用日数カウントが最後にゼロ (0) にリセットされた日付に対応する Epoch 以降の秒数。 使用日数カウントをゼロにリセットするために Qp0lSetAttr() API を呼び出すと、 この日付は現在日付に設定されます。 |
QEZPRMLNK | SMALLINT | オブジェクトが複数の名前を持つ場合、 このフィールドには、最初に検出された名前だけが示される。 |
QEZALWCKPW | SMALLINT | 活動時保管チェックポイント処理中に、
読み取りプログラムおよび書き込みプログラムとの間でストリーム・ファイル (*STMF) を共用できるかどうか。
有効な値は次のとおりです。
0 - 読み取りプログラムとの間でのみ、オブジェクトを共用できます。 1 - 読み取りプログラムおよび書き込みプログラムとの間で、 オブジェクトを共用できます。 |
QEZSIG 1 | SMALLINT | オブジェクトが IBM i ディジタル署名を持っているかどうか。有効な値は次のとおりです。
0 - オブジェクトには IBM i ディジタル署名がありません。 1 - オブジェクトには IBM i ディジタル署名があります。 |
QEZSYSSIG | SMALLINT | システムが信頼するソースによってオブジェクトが署名されたかどうか。
有効な値は次のとおりです。
0 - システムが信頼するソースによる署名は 1 つも存在しません。 1 - システムが信頼するソースによってオブジェクトが署名されています。 オブジェクトに複数の署名が含まれる場合、 少なくとも 1 つは、システムが信頼するソースによる署名です。 |
QEZMLTSIG | SMALLINT | オブジェクトに複数の IBM i ディジタル署名が含まれるかどうか。有効な値は次のとおりです。
0 - オブジェクトにはただ 1 つのディジタル署名が含まれます。 1 - オブジェクトには複数のディジタル署名が含まれます。 QEZSYSSIG フィールドの値が 1 の場合、少なくとも 1 つの署名は、 システムによって信頼されたソースからのものです。 |
QEZDSTGOPT | SMALLINT | このオプションは、
指定したオブジェクト用の補助記憶域がシステムによってどのように割り振られるかを決定するために使用されます。
このオプションは、
「ルート」(/)、QOpenSys、およびユーザー定義ファイル・システム内のストリーム・ファイルに関してのみ指定できます。
*TYPE1 バイト・ストリーム・ファイルに関しては、このオプションが無視されます。
有効な値は次のとおりです。
0 - 補助記憶域は通常の方法で割り振られます。 つまり、追加の補助記憶域が必要とされる場合、 現在のスペース要件および予想される将来の要件を満たすために論理的サイズ範囲に分けて割り振られ、 ディスク入出力操作の回数が最小化されます。 1 - 補助記憶域は、 オブジェクトによるスペース使用量を最小化する方法で割り振られます。 つまり、追加の補助記憶域が必要とされる場合、 現在のスペース要件を満たすために小さなサイズの範囲に分けて割り振られます。 多数の小さな範囲からなるオブジェクトにアクセスすることにより、 そのオブジェクトに関するディスク入出力操作の回数が増加する可能性があります。 2 - システムは、 使用されるスペースとディスク入出力操作の回数を比較考慮して、 オブジェクト用の最適な補助記憶域割り振りを動的に決定します。 たとえば、頻繁に読み取りおよび書き込みされるファイルが多数の小さな範囲からなる場合、 ディスク入出力操作の回数を最小化するために、 今後はより大きな範囲で補助記憶域が割り振られます。 あるいは、頻繁に切り捨てられるファイルの場合、 スペース使用量を最小化するために、 今後はより小さな範囲で補助記憶域が割り振られます。 さらに、このシステム、およびシステムの活動のために、 ストリーム・ファイル・サイズ情報が保持されます。 また、このファイル・サイズ情報は、 他のオブジェクト・サイズと関連して、 このオブジェクトの最適な補助記憶域割り振りを決定するうえでも役立ちます。 |
QEZMSTGOPT | SMALLINT | このオプションは、
指定したオブジェクト用の主記憶域がシステムによってどのように割り振られ、
使用されるかを決定します。
このオプションは、
「ルート」(/)、QOpenSys、およびユーザー定義ファイル・システム内のストリーム・ファイルに関してのみ指定できます。
有効な値は次のとおりです。
0 - 主記憶域は通常の方法で割り振られます。 つまり、可能な限り大きな主記憶域が割り振られて使用されます。 この場合、情報が主記憶域にキャッシュされるので、 ディスク入出力操作の回数が最小限になります。 1 - 主記憶域は、 オブジェクトによるスペース使用量を最小化する方法で割り振られます。 つまり、可能な限り少ない主記憶域が割り振られて使用されます。 この場合、少ない情報が主記憶域にキャッシュされるので、 主記憶域の使用量が最小化されますが、ディスク入出力操作の回数は増えます。 2 - システムは、他のシステム活動や主記憶域の競合を考慮して、 オブジェクト用の最適な主記憶域割り振りを動的に決定します。 つまり、主記憶域の競合がほとんどない場合、 ディスク入出力操作の回数を最小化するために、 可能な限り大きな主記憶域が割り振られて使用されます。 また、主記憶域の競合が大きい場合には、 主記憶域の競合を最小化するために、 より少ない主記憶域が割り振られて使用されます。 このオプションは、 記憶域プールのページング・オプションが *CALC の場合にのみ有効です。 記憶域プールのページング・オプションが *FIXED である場合には、 STG_NORMAL と同じ動作になります。 ファイル・サーバーを通してオブジェクトがアクセスされるときには、 このオプションは影響を与えません。 その代わり、STG_NORMAL と同じ動作になります。 |
QEZDIRTYP2 | SMALLINT | 指定されたディレクトリー・オブジェクトのフォーマット。
有効な値は次のとおりです。
0 - ディレクトリー・フォーマットは *TYPE1 です。 1 - ディレクトリー・フォーマットは *TYPE2 です。 |
QEZFILTYP2 1 | SMALLINT | ストリーム・ファイル (*STMF) のフォーマット。
有効な値は次のとおりです。
0 - ストリーム・ファイル・フォーマットは *TYPE1 です。 1 - ストリーム・ファイル・フォーマットは *TYPE2 です。 |
QEZUDFTYP2 | SMALLINT | ユーザー定義ファイル・システム内に作成されるストリーム・ファイル (*STMF) のデフォルト・ファイル・フォーマット。
有効な値は次のとおりです。
0 - ストリーム・ファイル・フォーマットは *TYPE1 です。 1 - ストリーム・ファイル・フォーマットは *TYPE2 です。 |
QEZNONSAV | SMALLINT | オブジェクトを保管できるかどうか。
有効な値は次のとおりです。
0 - オブジェクトは保管されます。 1 - オブジェクトは保管されません。 さらに、このオブジェクトがディレクトリーである場合、 ディレクトリーのサブツリー内のオブジェクトは、 保管対象オブジェクトとして明示的に指定されていない限り、 いずれも保管されません。 サブツリーには、すべてのサブディレクトリー、 およびサブディレクトリー内のオブジェクトが含まれます。 |
QEZCLSTRSP | SMALLINT | このオブジェクトは、
xSeries サーバーが仮想ディスク・ドライブとして使用するために、
統合 xSeries サーバー用に割り振られた記憶域です。iSeries サーバーから見て、
仮想ドライブは統合ファイル・システム内のバイト・ストリーム・ファイルとして認識されます。
0 - オブジェクトは仮想ディスク装置ではありません。 1 - オブジェクトは仮想ディスク装置です。 |
QEZCASE | SMALLINT | このオブジェクトを格納するファイル・システムでの大文字小文字の区別を示す。
0 - ファイル・システムは大文字小文字を区別しません。 1 - ファイル・システムは大文字小文字を区別します。 |
QEZOFLOW | SMALLINT | オブジェクトが格納されている補助記憶域プールがオーバーフローしたかどうかを示す。
有効な値は次のとおりです。
0 - 補助記憶域プールはオーバーフローしていません。 1 - 補助記憶域プールがオーバーフローしています。 |
QEZPCREAD | SMALLINT | オブジェクトへの書き込み、オブジェクトの削除、
オブジェクトの拡張属性の変更または削除、
オブジェクト・サイズの変更が可能かどうか。
有効な値は次のとおりです。
0 - オブジェクトを変更できます。 1 - オブジェクトは変更できません。 |
QEZPCHID 1 | SMALLINT | 通常のディレクトリー・リストを使ってオブジェクトを表示できるかどうか。
0 - オブジェクトは隠されません。 1 - オブジェクトは隠されます。 |
QEZPCSYS | SMALLINT | オブジェクトがシステム・ファイルであるため、
通常のディレクトリー検索から除外されるかどうか。
0 - オブジェクトはシステム・ファイルではありません。 1 - オブジェクトはシステム・ファイルです。 |
QEZPCARC | SMALLINT | オブジェクトが最後に検査された後、オブジェクトが変更されたかどうか。
0 - オブジェクトは変更されていません。 1 - オブジェクトが変更されました。 |
QEZSYSARC | SMALLINT | オブジェクトが変更されたため、保管する必要があるかどうか。
オブジェクトの変更時刻が更新されたとき、これがオンに設定されます。
オブジェクトが保管されると、これがオフに設定されます。
0 - オブジェクトは変更されていないため、保管する必要はありません。 1 - オブジェクトが変更されたため、保管する必要があります。 |
QEZJRCVNAM | GRAPHIC(10) | ジャーナルの変更内容を正常に適用するために必要な最も古いジャーナル・レシーバー。 情報の適用フィールドが PARTIAL_TRANSACTION に設定されている場合、 ジャーナル・レシーバーには部分的なトランザクションの開始が含まれます。 それ以外の場合、ジャーナル・レシーバーには保管操作の開始が含まれます。オブジェクトがジャーナル処理されなかった場合は、このフィールドはブランクになります。 |
QEZJRCVLIB | GRAPHIC(10) | ジャーナルの変更内容を正常に適用するために必要なジャーナル・レシーバーを含んでいるライブラリーの名前。 オブジェクトがジャーナル処理されなかった場合は、このフィールドはブランクになります。 |
QEZJRCVASP | GRAPHIC(10) | ジャーナルの変更内容を正常に適用するために必要なジャーナル・レシーバーを含んでいる ASP の名前。
有効な値は次のとおりです。
*SYSBAS - ジャーナル・レシーバーはシステムまたはユーザーの ASP に格納されています。 ASP デバイス - ジャーナル・レシーバーを格納している ASP デバイスの名前。 |
QEZJTRNI | GRAPHIC(1) | このフィールドは、
コミットメント制御の境界に関連した、
オブジェクトの現在の状態についての情報を示します。
有効な値は次のとおりです。
x'00' (NONE) - 部分的なトランザクションは存在しません。 x'01' (PARTIAL_TRANSACTION) - 部分的なトランザクションを使用してオブジェクトが復元されました。 ジャーナル変更の適用 (APYJRNCHG) コマンドまたはジャーナル変更の削除 (RMVJRNCHG) コマンドを使って部分的なトランザクションを完了またはロールバックするまでは、 このオブジェクトを使用できません。 x'02' (ROLLBACK_ENDED) - 「コミットメント定義の処理 (Work with Commitment Definition)」(WRKCMTDFN) 画面の「ロールバック終了 (End Rollback)」オプションを使用して、 オブジェクトのロールバック操作が終了されました。 オブジェクトを使用できないため、復元することをお勧めします。 最後のオプションとして、ジャーナル・オブジェクトの変更 (CHGJRNOBJ) コマンドを使ってオブジェクトを使用可能にすることもできます。ただし、この場合、オブジェクトが不整合状態のままになる可能性があります。 |
QEZTMPOBJ | SMALLINT | オブジェクトが一時オブジェクトであるかどうか。
有効な値は次のとおりです。
|
QEZTMPUDFS | SMALLINT | ユーザー定義ファイル・システム (UDFS) 内のオブジェクトが一時オブジェクトであるかどうか。
有効な値は次のとおりです。
|
QEZUNIT | GRAPHIC(10) | UDFS 内のオブジェクトの優先ストレージ・メディア。
有効な値は次のとおりです。
|
QEZINALCPW | SMALLINT | あるディレクトリー内で作成またはリンクされた新規ストリーム・ファイル・オブジェクトが親ディレクトリーの活動時保管チェックポイント処理オプションを継承するかどうか。
有効な値は次のとおりです。
|
QEZSYSRSSV | SMALLINT | システムがオブジェクトの保管を防止するかどうか。
有効な値は次のとおりです。
|
注:
|
以下の表は、RTVDIRINF コマンドによって処理されるディレクトリーをリストした表の例です。
フィールド名 | フィールド・タイプ | フィールド記述 |
---|---|---|
QEZDIRIDX | INTEGER | ディレクトリーとオブジェクト・テーブル間のリレーショナル ID表を結合して完全なパス名情報を得るために使用します。オブジェクト・テーブル内の QEZDIRIDX フィールドの値は、オブジェクトの親ディレクトリーのディレクトリー・テーブルにおける QEZDIRIDX の値と一致します。 |
QEZDIRNAM1 1 | VARGRAPHIC (1024) | 親ディレクトリー・パス。 パス長が 1 KB (1024 バイト) 未満の場合にのみ使用される。 |
QEZDIRNAM2 1 | DBCLOB (16M) | 親ディレクトリー・パス。 パス長が 1 KB (1024 バイト) を超える場合にのみ使用される。 16 MB までの長さのパスを保管可能。 |
QEZDRCCSID | INTEGER | ディレクトリー CCSID。 |
QEZDREGION | GRAPHIC (2) | ディレクトリー・パスの国識別コード。 |
QEZLANGID | GRAPHIC (3) | ディレクトリー・パスの言語 ID。 |
QEZDIRLEN 1 | INTEGER | ディレクトリーのパス名の長さ。 |
QEZDIRFID | GRAPHIC (16) | ディレクトリーのファイル ID。 オブジェクトに関連付けられた識別子。 Qp0lGetPathFromFileID() と、ファイル ID を指定すれば、 オブジェクトのパス名を検索できます。 |
QEZDFID | INTEGER | ディレクトリーのファイル ID。 |
QEZDIRFSID | BIGINT | ディレクトリーのファイル・システム ID。 |
QEZDIRGID | BIGINT | 生成 ID。 |
QEZPARDIR | INTEGER | 親ディレクトリー索引 |
注記:
|
以下の表には、RTVDIRINF コマンドの実行時に作成されたファイルに関してこのコマンドが保管する情報が示されます。この情報が入っているファイルが存在 しないと、RTVDIRINF コマンドによってファイルが作成されます。それ以降にこのコマンドが 実行されると、その情報は既存のファイルに追加されます。PRTDIRINF コマンドはこの情報を 使用して、RTVDIRINF コマンドのさまざまなインスタンスによって検索された情報の保管に どのデータベース・ファイルが使用されたかを判別します。
フィールド名 | フィールド・タイプ | フィールド記述 |
---|---|---|
QEZDIRSRC | VARGRAPHIC (5000) | DIR パラメーターで指定されたパス (RTVDIRINF)。 |
QEZPRCCSID | INTEGER | パスの CCSID。 |
QEZPREGION | GRAPHIC (2) | パスの国識別コード。 |
QEZPLANGID | GRAPHIC (3) | パスの言語 ID。 |
QEZOBJFILE 1 | VARGRAPHIC (20) | オブジェクトの属性を保管するために生成されたファイルの名前。 |
QEZDIRFILE 1 | VARGRAPHIC (20) | ディレクトリーの索引を保管するために生成されたファイルの名前。 |
QEZLIB 1 | VARGRAPHIC (20) | 生成された両方のファイルが入っているライブラリー。 |
QEZSTRTIME | TIMESTAMP | RTVDIRINF が実行依頼された日時。 |
QEZENDTIME | TIMESTAMP | RTVDIRINF が完了した日時。 |
注記:
|