SAVE_FILE_OBJECTS 表関数

オンライン編集

SAVE_FILE_OBJECTS 表関数は、保管ファイル内のオブジェクトに関する情報を戻します。統合ファイル・システム・オブジェクトに関する情報は返されない。

戻される情報は, 保管ファイル表示 (DSPSAVF) CL コマンドおよび保管ファイル・リスト (QSRLSAVF) で使用可能な詳細と類似しています。 API。

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

保管ファイルが入っているライブラリーに対する *USE 権限, および
保管ファイルに対する *USE 権限。

スキーマは QSYS2 です。

保管ファイル (save-file)

オブジェクトを含む保管ファイルの名前を識別する文字ストリング式またはグラフィック・ストリング式。

保管ファイル・ライブラリー

save-fileを含むライブラリーの名前を識別する文字ストリング式またはグラフィック・ストリング式。

ストリングには、以下の特殊値を含めることができます。

*CURLIB: 現行ライブラリーが使用されます。
*LIBL: ライブラリー・リストが使用されます。これはデフォルト値。

オブジェクト名フィルター (object-name-filter)

戻されるオブジェクト名を識別する文字ストリング式またはグラフィック・ストリング式。名前は総称にすることができます。

ストリングには、以下の特殊値を含めることができます。

*ALL: すべてのオブジェクトが返されます。

このパラメーターを指定しない場合、すべてのオブジェクトの情報が返されます。

オブジェクト・タイプ・フィルター

戻されるオブジェクトのシステム・オブジェクト・タイプを含む文字ストリング式またはグラフィック・ストリング式。

ストリングには、以下の特殊値を含めることができます。

*ALL: すべてのオブジェクト・タイプが返されます。

このパラメーターを指定しない場合は、すべてのオブジェクト・タイプの情報が返されます。

詳細情報

返す情報のタイプを識別する文字ストリング式またはグラフィック・ストリング式。

NONE: オブジェクトに関する情報のみが返されます。これはデフォルト値。
ファイル: *FILE オブジェクトの追加情報が戻されます。ファイルごとに、メンバーごとに 1 行が戻されます。
OUTQ: *OUTQ オブジェクトの追加情報が戻されます。出力待ち行列ごとに、スプール・ファイルごとに 1 行が戻されます。
ALL: *FILE および *OUTQ オブジェクトの追加情報が戻されます。; ファイルの場合、ファイル内のメンバーごとに 1 行が戻されます。; 出力待ち行列の場合には, 出力待ち行列中の各スプール・ファイルごとに 1 行が戻されます。

無視エラー

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

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

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

表 1. SAVE_FILE_OBJECTS 表関数
列名	データ・タイプ	説明
SAVE_FILE_LIBRARY	VARCHAR(10)	保管ファイルが入っているライブラリーの名前。
SAVE_FILE (保管ファイル)	VARCHAR(10)	保管ファイルの名前。
LIBRARY_NAME	VARCHAR(10)	オブジェクトの保管元のライブラリーの名前
OBJECT_NAME	VARCHAR(10)	保管されたオブジェクトの名前。 DLO オブジェクトのシステム名が入っています。
OBJECT_TYPE	VARCHAR(7)	オブジェクトのタイプ。
OBJECT_ATTRIBUTE	VARCHAR(10)	オブジェクト・タイプに関する拡張情報。オブジェクト属性がない場合は、NULL 値が入ります。
TEXT_DESCRIPTION	VARCHAR(50)	オブジェクトのテキスト記述。テキスト記述がない場合は、NULL 値が入ります。
SAVE_TIMESTAMP	TIMESTAMP(0)	オブジェクトが保管された日付と時刻。
オブジェクト・サイズ	BIGINT	オブジェクトのサイズ (バイト単位)。この値は、999,999,999 バイトより大きいオブジェクトの場合は丸められた値になります。
保存されたデータ	VARCHAR(3)	このオブジェクトのデータがオブジェクトと一緒に保管されたかどうか。 NO データは保存されませんでした。オブジェクトの記憶域は, この保管操作の前に前の保管コマンドによって解放されています。 YES データが保存されました。オブジェクトの記憶域は, この保管操作の前に前の保管コマンドによって解放されていません。
OBJECT_OWNER	VARCHAR(10)	オブジェクトの所有者
DLO_NAME	VARCHAR(20)	保管された文書, フォルダー, またはメール・オブジェクトの名前。文書ライブラリー・オブジェクトがない場合は、NULL 値が入ります。
FOLDER_PATH	VARCHAR(63)	保管されたフォルダーの名前。これが FLR または DOC オブジェクトでない場合、またはフォルダー・パスがない場合は、NULL 値が入ります。
IASP_NUMBER	INTEGER	オブジェクトが保管された時のライブラリーの補助記憶域プール (ASP)。 1はシステムASPを示します。
IASP_NAME	VARCHAR(10)	オブジェクトが保管された時のライブラリーの独立補助記憶域プール (ASP) 装置の名前。
メンバー情報
MEMBERS	INTEGER	ファイル用に保管されたメンバーの数。 DETAILED_INFO が NO または OUTQ の場合、または OBJECT_TYPE が *FILE でない場合は、NULL 値が入ります。
MEMBER_NAME	VARCHAR(10)	保管されたファイル・メンバーの名前。 DETAILED_INFO が NO または OUTQ の場合、または OBJECT_TYPE が *FILE でない場合は、NULL 値が入ります。
スプール・ファイル情報
SPOOLED_FILE_NAME	VARCHAR(10)	スプール・ファイルの名前 DETAILED_INFO が NO または FILE の場合、または OBJECT_NAME が出力キューでない場合は、NULL 値が入ります。
SPOOLED_FILE_ 番号	INTEGER	スプール・ファイルを所有するジョブ内での、スプール・ファイルの番号 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。
QUALIFIED_JOB_NAME	VARCHAR(28)	スプール・ファイルを所有する完全修飾ジョブ名。 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。
JOB_NAME	VARCHAR(10)	スプール・ファイルを所有するジョブの名前 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。
JOB_USER	VARCHAR(10)	スプール・ファイルを所有するユーザーの名前。 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。
JOB_NUMBER	VARCHAR(6)	スプール・ファイルを所有するジョブの番号 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。
SYSTEM_NAME	VARCHAR(8)	スプール・ファイルを所有するジョブが実行されたシステムの名前 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。
CREATE_TIMESTAMP	TIMESTAMP(0)	スプール・ファイルが作成された日付および時刻。 DETAILED_INFO が NO または FILE の場合、または OBJECT_TYPE が *OUTQ でない場合は、NULL 値が入ります。

例

MYLIB/SAVF1 保管ファイルに保管されているすべてのスプール・ファイルをリストします。

SELECT LIBRARY_NAME CONCAT '/' CONCAT OBJECT_NAME AS OUTPUT_QUEUE, SPOOLED_FILE_NAME, SPOOLED_FILE_NUMBER, CREATE_TIMESTAMP
FROM TABLE (QSYS2.SAVE_FILE_OBJECTS(SAVE_FILE => 'SAVF1', SAVE_FILE_LIBRARY => 'MYLIB', 
                                    OBJECT_TYPE_FILTER => '*OUTQ', DETAILED_INFO => 'ALL'));