オブジェクト保管 (SAVOBJ)

実行可能場所: すべての環境 (*ALL)
スレッド・セーフ: いいえ

オブジェクト保管(SAVOBJ)コマンドは，1つのオブジェクトまたは同じライブラリーにある1グループのオブジェクトのコピーを保管します。オブジェクト (OBJ)パラメーターに*ALLを指定すると，ライブラリーのリストからオブジェクトを保管することができます。保管ファイルに保管する時には，ライブラリーは1つしか指定することができません。システムは，指定されたオブジェクトを，各オブジェクトのコピーをテープ，光ディスク媒体，または保管ファイルに書き込むことによって保管します。コマンドで記憶域の解放を指定しない限り，システム中のオブジェクトには影響がありません。しかし，各オブジェクトの記述は，ヒストリー更新 (UPDHST)パラメーターに*NOが指定されていない限り，それが最後に保管された日付，時刻，および場所で変更されます。

ジョブ待ち行列，ユーザー待ち行列，メッセージ待ち行列，および論理ファイルの場合には，オブジェクト記述だけが保管され，オブジェクトの内容は保管されません。しかし，論理ファイルのアクセス・パスは，アクセス・パス保管 (ACCPTH)パラメーターに*YESを指定することによって保管することができます。出力待ち行列上のスプール・ファイルの内容は，スプール・ファイル・データ (SPLFDTA)パラメーターに*ALLを指定することによって保管することができます。保管ファイルの内容は，保管ファイル・データ (SAVFDTA)パラメーターに*YESを指定するか，あるいは保管ファイル・データ保管(SAVSAVFDTA)コマンドを使用することによって保管することができます。データ待ち行列の内容は，待ち行列データ (QDTA)パラメーターに*DTAQを指定して保管することができます。

注: このコマンドは，出力ファイル以外のジョブに対して現在有効になっているすべてのファイル一時変更を無視します。

制約事項:

システム保管(*SAVSYS)特殊権限または以下のオブジェクト権限が必要です。
- 保管される各オブジェクトに対するオブジェクト存在(*OBJEXIST)権限（スプール・ファイル・データの場合，出力待ち行列に対する*OBJEXIST権限）
- 保管元の各ライブラリー・オブジェクトに対する実行(*EXECUTE)権限
*SAVSYS特殊権限がない場合には，ユーザーが権限を持っているオブジェクトのみが保管されます。
テープまたは光ディスク装置に保管する場合には，その装置記述および装置ファイルに対する使用(*USE)権限が必要です。保管ファイルに保管する場合には，その保管ファイルに対するオブジェクト操作(*OBJOPR)および追加(*ADD)権限と，保管ファイルが入っているライブラリーに対する*EXECUTE権限が必要です。
媒体定義を使用する場合には，その媒体定義に対する*USE権限および媒体定義ライブラリーに対する*EXECUTE権限が必要です。
このコマンドでは，ライブラリーのデータ・ディクショナリーまたは関連のデータベース・ファイルは保管されません。これらを保管するには，ライブラリー保管(SAVLIB)コマンドを使用する必要があります。
OUTFILEパラメーターを使用して既存のデータベース・ファイルに保管する場合には，その出力ファイル・ライブラリーに対する*EXECUTE権限が必要です。
テープを使用する場合には，標準ラベル付きボリュームを装置に入れなければなりません。
活動状態保管を使用しない限り，保管中のオブジェクトは，保管操作が行われた時に実行中であったジョブによって変更することはできません。
SAVFDTA(*YES)を指定して，保管ファイルの内容を同一保管ファイルに保管する場合には，保管ファイルの記述だけが保管されます。
SAVFDTA(*YES)を指定することによって保管ファイルの内容を保管した場合には，そこに入っているオブジェクトを復元する前に，保管ファイルを復元しなければなりません。
コマンド・ユーザー・スペース (CMDUSRSPC)パラメーターを使用する場合には，そのユーザー・スペースに対する*USE権限およびユーザー・スペース・ライブラリーに対する*EXECUTE権限が必要です。

上

パラメーター

キーワード	記述	選択項目	ノーツ
OBJ	オブジェクト	単一値: *ALL その他の値 (最大 300 回の繰り返し): 総称名, 名前	必須, 定位置 1
LIB	ライブラリー	単一値: SELECT, USRSPC その他の値 (最大 300 回の繰り返し): 総称名, 名前	必須, 定位置 2
DEV	装置	単一値: SAVF, MEDDFN その他の値 (最大 4 回の繰り返し): 名前	必須, 定位置 3
OBJTYPE	オブジェクト・タイプ	単一値: *ALL その他の値 (最大 300 回の繰り返し): 文字値	オプショナル, 定位置 4
VOL	ボリュームID	単一値: *MOUNTED その他の値 (最大 75 回の繰り返し): 文字値	オプショナル, 定位置 5
SEQNBR	順序番号	1-16777215, *END	オプショナル
LABEL	ラベル	文字値, *LIB	オプショナル
EXPDATE	ファイル満了日	日付, *PERM	オプショナル
ENDOPT	媒体の終わりオプション	REWIND, LEAVE, *UNLOAD	オプショナル
SAVF	保管ファイル	修飾オブジェクト名	オプショナル
	修飾子 1: 保管ファイル	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
MEDDFN	媒体定義	修飾オブジェクト名	オプショナル
	修飾子 1: 媒体定義	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
OPTFILE	光ディスク・ファイル	パス名, *	オプショナル
USEOPTBLK	最適ブロックの使用	YES, NO	オプショナル
TGTRLS	ターゲット・リリース	CURRENT, PRV, V7R1M0, V7R2M0, V7R3M0	オプショナル
UPDHST	ヒストリー更新	YES, NO	オプショナル
CLEAR	消去	NONE, ALL, AFTER, REPLACE	オプショナル
PRECHK	オブジェクト事前検査	NO, YES	オプショナル
SAVACT	活動状態保管	NO, LIB, SYNCLIB, SYSDFN	オプショナル
SAVACTWAIT	活動状態保管待ち時間	要素リスト	オプショナル
	要素 1: オブジェクト・ロック	0-99999, 120, *NOMAX
	要素 2: 保留中のレコード変更	0-99999, LOCKWAIT, NOCMTBDY, *NOMAX
	要素 3: 他の保留中の変更	0-99999, LOCKWAIT, NOMAX
SAVACTMSGQ	活動状態保管ﾒｯｾｰｼﾞ待ち行列	修飾オブジェクト名	オプショナル
	修飾子 1: 活動状態保管ﾒｯｾｰｼﾞ待ち行列	名前, NONE, WRKSTN
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
SYNCID	同期 ID	名前, *NONE	オプショナル
FILEMBR	ファイル・メンバー	値 (最大 50 回の繰り返し): 要素リスト	オプショナル
	要素 1: ファイル	名前, *ALL
	要素 2: メンバー	単一値: ALL, NONE その他の値 (最大 50 回の繰り返し): 総称名, 名前
ACCPTH	アクセス・パス保管	SYSVAL, NO, *YES	オプショナル
SAVFDTA	保管ファイル・データ	YES, NO	オプショナル
SPLFDTA	スプール・ファイル・データ	NONE, ALL	オプショナル
QDTA	待ち行列データ	NONE, DTAQ	オプショナル
PVTAUT	専用権限	NO, YES	オプショナル
STG	記憶域	KEEP, FREE	オプショナル
DTACPR	データ圧縮	DEV, NO, YES, LOW, MEDIUM, HIGH	オプショナル
COMPACT	データ短縮	DEV, NO	オプショナル
OMITLIB	除外するライブラリー	単一値: NONE, USRSPC その他の値 (最大 300 回の繰り返し): 総称名, 名前	オプショナル
OMITOBJ	除外するオブジェクト	単一値: *USRSPC その他の値 (最大 300 回の繰り返し): 要素リスト	オプショナル
	要素 1: オブジェクト	修飾オブジェクト名
	修飾子 1: オブジェクト	総称名, 名前, NONE, ALL
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	総称名, 名前, *ALL
	要素 2: オブジェクト・タイプ	文字値, *ALL
SELECT	SELECT	単一値: *USRSPC その他の値 (最大 300 回の繰り返し): 要素リスト	オプショナル
	要素 1: 組み込みまたは除外	INCLUDE, OMIT
	要素 2: オブジェクト	修飾オブジェクト名
	修飾子 1: オブジェクト	総称名, 名前, *ALL
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	総称名, 名前, *ALL
	要素 3: オブジェクト・タイプ	文字値, *ALL
	要素 4: オブジェクトの属性	文字値, ALL, BLANK
	要素 5: ファイル・メンバー	総称名, 名前, ALL, ALLMBR
ASPDEV	ASP装置	名前, , SYSBAS, *CURASPGRP	オプショナル
OUTPUT	出力	NONE, PRINT, *OUTFILE	オプショナル
OUTFILE	出力を受け取るファイル	修飾オブジェクト名	オプショナル
	修飾子 1: 出力を受け取るファイル	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
OUTMBR	出力メンバー・オプション	要素リスト	オプショナル
	要素 1: 出力を受け取るメンバー	名前, *FIRST
	要素 2: レコードの置き換えまたは追加	REPLACE, ADD
INFTYPE	出力情報のタイプ	OBJ, LIB, MBR, ERR	オプショナル
CMDUSRSPC	コマンド・ユーザー・スペース	修飾オブジェクト名	オプショナル
	修飾子 1: コマンド・ユーザー・スペース	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB

上

オブジェクト (OBJ)

保管する1つまたは複数のオブジェクトの名前または各オブジェクト・グループの総称名を指定します。すべてのオブジェクトがライブラリー (LIB)パラメーターに指定したライブラリーの中になければなりません。オブジェクト・タイプ (OBJTYPE)パラメーターに*ALLを指定するか，あるいは省略時の値とした場合には，そのパラメーターの記述にリストされているすべてのオブジェクト・タイプが指定されたライブラリーにあり，しかも指定された名前を持っていれば，それらがすべて保管されます。

これは必須パラメーターです。

単一値

*ALL: OBJTYPEパラメーターに指定された値に基づいて，指定されたライブラリーにあるすべてのオブジェクトが保管されます。

その他の値（最大300個指定可能）

総称名: 指定したライブラリー中の保管するオブジェクト・グループの1つまたは複数の総称名を指定してください。総称名は，1つ以上の文字とその後にアスタリスク(*)が付いた文字ストリングです。名前に*が指定されていない場合には，システムはその名前が完全なオブジェクト名であるとみなします。
名前: 保管する特定のオブジェクトの1つ以上の名前を指定します。総称名と特定名の両方を同じコマンドに指定することができます。

上

ライブラリー (LIB)

保管するオブジェクトが入っているライブラリーを指定します。オブジェクト (OBJ)パラメーターに*ALLを指定した場合には，最大300のライブラリー名を指定することができます。

これは必須パラメーターです。

単一値

*SELECT: SELECT (SELECT)パラメーターで識別されたライブラリーが保管されます。保管ファイルへの保管時，選択基準に指定できるライブラリーは1つだけです。特殊値*SPLFは選択基準には指定できません。

*USRSPC: コマンド・ユーザー・スペース (CMDUSRSPC)パラメーターに指定されたユーザー・スペース中で識別されるライブラリーが保管されます。保管ファイルに保管する時には，ユーザー・スペースにライブラリーは1つしか指定することはできません。特殊値*SPLFはユーザー・スペースには指定できません。

その他の値（最大300個指定可能）

総称名: 保管するオブジェクトが入っているライブラリーの総称名を指定します。総称名は1つまたは複数の文字とその後にアスタリスク(*)が付いた文字ストリング（例えば，ABC*)です。アスタリスク(*)は，有効な任意の文字と置き換えられます。総称名の指定は，名前がその総称接頭部で始まる，ユーザーが権限を持っているすべてのライブラリーです。総称（接頭部）名にアスタリスクが含まれていない場合には，システムはそれを完全なライブラリー名とみなします。
注: 保管ファイルに保管する時には，総称ライブラリー名を指定することはできません。
名前: 保管するオブジェクトが入っているライブラリーの名前を指定します。
注: 保管ファイルに保管する時には，ライブラリーは1つしか指定することはできません。

上

装置 (DEV)

保管操作に使用される装置の名前を指定します。この装置名は，装置記述によってシステム上で既に認識されていなければなりません。

これは必須パラメーターです。

単一値

*SAVF: 保管操作は，保管ファイル (SAVF)パラメーターに指定された保管ファイルを使用して実行されます。

*MEDDFN: 保管操作は，媒体定義 (MEDDFN)パラメーターに指定された媒体定義で識別された装置および媒体を使用して実行されます。

その他の値

光ディスク装置名: 保管操作に使用される光ディスク装置の名前を指定してください。

テープ媒体ライブラリー装置名: 保管操作に使用されるテープ媒体ライブラリー装置の名前を指定してください。

テープ装置名: 保管操作に使用される1つまたは複数のテープ装置の名前を指定してください。仮想テープ装置を使用する場合には，指定する唯一の装置でなければなりません。複数のテープ装置を使用する場合には，互換性のある媒体形式になっていなければならず，それらの名前は使用される順序で指定しなければなりません。複数のテープ装置を使用すると，テープ・ボリュームを巻き戻してアンロードしながら，別のテープ装置で次のテープ・ボリュームを処理できます。複数の装置を並列に使用するには，媒体定義が指定されていなければなりません。

上

オブジェクト・タイプ (OBJTYPE)

保管するシステム・オブジェクトのタイプを指定します。

単一値

*ALL: 指定した名前で，指定したライブラリーに入っているすべてのオブジェクト・タイプが保管されます。オブジェクト (OBJ)パラメーターにも*ALLが指定されている場合には，ライブラリーに入っているオブジェクトのうち，保管できるタイプのすべてのオブジェクトが保管されます。

その他の値（最大300個指定可能）

オブジェクト・タイプ: コマンド(*CMD),ファイル(*FILE),またはプログラム(*PGM)など，保管するオブジェクトの各タイプの値を指定します。
このコマンドについてプロンプトを出す時にオブジェクト・タイプの完全なリストを表示するには，このパラメーターのフィールドにカーソルを位置付け，F4（プロンプト）を押します。オブジェクト・タイプの記述については，IBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「プログラミング」ｶﾃｺﾞﾘｰの「制御言語(CL)」ﾄﾋﾟｯｸ･ｺﾚｸｼｮﾝの「オブジェクト・タイプ」を参照してください。

上

ボリュームID (VOL)

データを保管するボリュームのボリュームIDまたはテープ媒体ライブラリー装置内のテープのカートリッジIDを指定します。ボリュームは，このパラメーターに指定したのと同じ順序で装置に入れなければなりません。

単一値

*MOUNTED: データは，装置に入っているボリュームに保管されます。媒体ライブラリー装置の場合には，使用されるボリュームは，テープ・カテゴリー設定(SETTAPCGY)コマンドによって装てんされているカテゴリー中の次のカートリッジです。
注: 光ディスク媒体ライブラリー装置を使用している時には，この値を指定することはできません。

その他の値（最大75個指定可能）

文字値: 装置に入れてデータの保管に使用する順序で，1つまたは複数のボリュームのIDを指定してください。

上

順序番号 (SEQNBR)

テープが使用された時に，保管操作の開始点として使用する順序番号を指定します。

*END: 保管操作は，最初のテープ上の最後の順序番号の後で開始されます。最初のテープがいっぱいになっている場合には，エラー・メッセージが出されて操作は終了します。
1から16777215: 保管操作に使用されるファイルの順序番号を指定してください。

上

ラベル (LABEL)

保管操作に使用されるテープ・ボリューム上のデータ・ファイルを識別する名前を指定します。このパラメーターが保管コマンドで使用された場合には，復元コマンドでも同じラベルを指定しなければなりません。

注: このパラメーターで*SAVLIBを指定することはできません。この値は復元コマンドのラベル (LABEL)パラメーターの特殊値であり，これを指定すると保管したものを復元できなくなるからです。

*LIB: ファイル・ラベルは，ライブラリー (LIB)パラメーターに指定されたライブラリーの名前を使用して，システムが作成します。
文字値: 保管操作に使用されるデータ・ファイルのデータ・ファイルIDを指定してください。最大17文字を使用することができます。このオプションは，単一ライブラリーの保管操作の場合にのみ有効です。

上

ファイル満了日 (EXPDATE)

保管操作によって作成されるファイルの有効期限を指定します。日付が指定されている場合には，そのファイルは保護されて，指定された有効期限まで上書きできません。

注：

このパラメーターはテープおよび光ディスク・ファイルの場合に有効です。
このパラメーターを指定しても，CLEAR(*ALL)が指定されている保管操作からは保護されません。

*PERM: ファイルは永続的に保護されます。
日付: ファイルの保護が終了する日付を指定してください。

上

媒体の終わりオプション (ENDOPT)

保管操作の終了後にテープまたは光ディスク・ボリュームに対して自動的に実行される操作を指定します。複数のボリュームを使用する場合には，このパラメーターは最後に使用されるボリュームにだけ適用されます。その他のすべてのボリュームは，ボリュームの終わりに達するとアンロードされます。

注: このパラメーターが有効なのは，磁気テープ装置または光ディスク装置の名前がDEVパラメーターに指定されている場合だけです。光ディスク装置の場合は，サポートされる特殊値は*UNLOADだけであり，*REWINDおよび*LEAVEは無視されます。

*REWIND: 操作の終了後にテープは自動的に巻き戻されますが，アンロードされません。

*LEAVE: テープは，操作の終了後に巻き戻しまたはアンロードされません。テープ装置の現在の位置に留まります。

*UNLOAD: テープは操作が終了すると自動的に巻き戻されてアンロードされます。一部の光ディスク装置は操作が終了するとボリュームを排出します。

上

保管ファイル (SAVF)

保管されたデータを入れるのに使用される保管ファイルを指定します。消去 (CLEAR)パラメーターで*ALLが指定されないかぎり，保管ファイルは空になっていなければなりません。

注: 装置 (DEV)パラメーターに*SAVFが指定されている場合には，このパラメーターに値を指定しなければなりません。

修飾子1: 保管ファイル

名前: 使用する保管ファイルの名前を指定してください。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 最初に一致するものが見つかるまで，現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。

*CURLIB: 保管ファイルを見つけるためにスレッドの現行ライブラリーが使用されます。ライブラリー・リストに現行ライブラリー項目が存在しない場合には，QGPLライブラリーが使用されます。
名前: 保管ファイルが入っているライブラリーの名前を指定してください。

上

媒体定義 (MEDDFN)

保管データを入れるのに使用される装置および媒体を識別する媒体定義(*MEDDFN)オブジェクトを指定します。媒体定義の作成および使用の詳細については，ISERIESバックアップおよび回復(SD88-5008)，およびIBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「プログラミング」カテゴリーの「API」ﾄﾋﾟｯｸ･ｺﾚｸｼｮﾝの媒体定義作成APIを参照してください。

媒体定義を指定した場合には，VOL, SEQNBR, SAVF,およびOPTFILEパラメーターは指定することができません。ボリュームIDおよび順序番号は，媒体定義に指定します。

修飾子1: 媒体定義

名前: 使用する媒体定義の名前を指定してください。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 最初に一致するものが見つかるまで，現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。

*CURLIB: スレッドの現行ライブラリーが検索されます。スレッドの現行ライブラリーとして指定されているライブラリーがない場合，QGPLライブラリーが検索されます。

名前: 検索するライブラリーの名前を指定してください。

上

光ディスク・ファイル (OPTFILE)

保管操作に使用されるボリュームのルート・ディレクトリーで始まる光ディスク・ファイルのパス名を指定します。

パス名を指定するときの詳細については，IBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「プログラミング」ｶﾃｺﾞﾘｰの「制御言語(CL)」ﾄﾋﾟｯｸ･ｺﾚｸｼｮﾝの「オブジェクトの命名規則」を参照してください。

*: システムは，光ディスク・ボリュームのルート・ディレクトリー内に光ディスク・ファイル名を生成します。
'光ディスクのパス名/*': システムは，光ディスク・ボリュームの指定されたディレクトリー内に光ディスク・ファイル名を生成します。

'光ディスク・ファイル・パス名': 光ディスク・ファイルのパス名を指定してください。

上

最適ブロックの使用 (USEOPTBLK)

保管操作で最適ブロック・サイズを使用するかどうかを指定します。

注: USEOPTBLK(*YES)を指定すると，同一ブロック・サイズをサポートする装置にしか複写できないテープになります。

*YES

装置によってサポートされる最適ブロック・サイズが保管コマンドに使用されます。使用するブロック・サイズがすべての装置タイプによってサポートされるブロック・サイズより大きい場合には，次の通りです。

パフォーマンスが向上する場合があります。
作成されるテープ・ファイルは，使用したブロック・サイズをサポートする装置しか互換性がありません。ファイルを使用したのと同じブロック・サイズをサポートする装置に複製中でない限り，テープ複製(DUPTAP)などのコマンドはファイルを複製しません。
DTACPRパラメーターの値が無視されます。

*NO

装置によってサポートされる最適ブロック・サイズは使用されません。保管コマンドでは，すべての装置タイプによってサポートされる省略時のブロック・サイズが使用されます。テープ・ボリュームは，テープ複製(DUPTAP)コマンドを使用して任意の媒体形式に複製することができます。

上

ターゲット・リリース (TGTRLS)

オブジェクトを復元して使用しようとしているオペレーティング・システムのリリースを指定します。

ターゲット・リリースを指定するときは，形式VXRXMXでリリースを指定します。ここで，VXはバージョン，RXはリリース，MXはモディフィケーション・レベルです。例えば，V5R3M0は，バージョン5,リリース3,モディフィケーション0です。

有効な値は，オペレーティング・システムの現在のバージョン，リリース，およびモディフィケーション・レベルで異なり，リリースが新しくなるたびに変わります。このコマンド・パラメーターのプロンプト時にF4を押して，有効なターゲット・リリースの値のリストを表示することができます。

保管操作を行うシステムとは異なるリリース・レベルのシステムに配布するオブジェクトを保管するように指定するためには，プログラム・オブジェクトの場合とプログラム以外のオブジェクトの場合とでは手順が異なり，またプログラム・オブジェクトが作成されるリリース・レベルによっても手順は異なります。例えば，前のリリースで実行中のシステムに配布するオブジェクトを保管する場合には，次の選択を行うことができます。

プログラム・オブジェクトの場合:

ターゲットとなる，以前のリリースの後続のリリース・レベルでプログラム・オブジェクトが作成されている場合には，以下を行わなければなりません。
1. ターゲットとなる，以前のリリースを指定して，再度プログラム・オブジェクトを作成する
2. ターゲットとなる，以前のリリースを指定して，このプログラム・オブジェクトを保管する
3. ターゲット・システムでこのプログラム・オブジェクトを復元する
ターゲット・システムと同じリリース・レベルでプログラム・オブジェクトが作成されている場合には，以下を行うことができます。
1. ターゲットとなる，以前のリリースを指定して，このプログラム・オブジェクトを保管する
2. ターゲット・システムでこのプログラム・オブジェクトを復元する

プログラム以外のオブジェクトの場合:

次のことができます。

ターゲットとなる，以前のリリースを指定して，このオブジェクトを保管する
ターゲット・システムでこのオブジェクトを復元する

*CURRENT: オブジェクトは，現在ユーザーのシステムで実行中のオペレーティング・システムのリリースに復元され，使用されます。オブジェクトは，後続のリリースのオペレーティング・システムが導入されたシステムに復元することもできます。
*PRV: オブジェクトは，オペレーティング・システムの前のリリース（モディフィケーション・レベルは0)に復元されます。オブジェクトは，後続のリリースのオペレーティング・システムが導入されたシステムに復元することもできます。
文字値: リリースをVXRXMXの形式で指定してください。オブジェクトは，指定したリリースまたはそれ以降のオペレーティング・システムが導入されているシステムに復元することができます。

上

ヒストリー更新 (UPDHST)

各保管済みオブジェクトの保管ヒストリーを，この保管操作の日付，時刻，および位置で変更するかどうかを指定します。オブジェクトの保管ヒストリー情報は，オブジェクト記述表示(DSPOBJD)コマンドを使用して表示します。保管ヒストリー情報は，RCVRNG(*LASTSAVE)およびFROMENT(*LASTSAVE)またはFROMENTLRG(*LASTSAVE)がジャーナル処理項目適用(APYJRNCHG)コマンドで使用されると，処理するジャーナル項目はどれかを判別するために使用されます。

*YES: 保管された各オブジェクトで最終保管日，時刻，および位置が更新されます。
*NO: 保管された各オブジェクトの記述に入っている保管ヒストリー情報は更新されません。
注: UPDHST(*NO)は，回復を目的としない保管操作で使用する必要があります。例えば，保管データをレコードごとに別のシステムに送信して，保管ファイルを即時に削除すると，保管ヒストリー情報が更新されない場合があります。

上

消去 (CLEAR)

媒体上の活動データを自動的に消去するか置き換えるかを指定します。活動データとは，媒体上の有効期限が切れていないすべてのファイルのことです。テープへの保管の場合には，活動データを消去すると，保管操作で書き込まれた最後のファイルより後の，テープ・ボリューム上のファイルは以後アクセスできなくなります。光ディスクへの保管の場合には，保管操作で書き込まれたファイルを自動的に置き換えてそのボリューム上の他のファイルを活動状態のまま残すか，またはすべての活動ファイルを自動的に消去することができます。消去では，データは削除されず，ファイルが以後アクセスできなくなるだけです。

注：

テープの消去は，そのテープを初期設定しません。テープは，保管コマンドの発行前に，テープ初期設定(INZTAP)コマンドを使用してNEWVOLパラメーターに値を指定することによって標準ラベル形式に初期設定する必要があります。
光ディスク・ボリュームを消去すると，それは初期設定されます。
初期設定されていないボリュームが保管操作時に検出されると，照会メッセージが送信されて，操作員はそのボリュームを初期設定することができます。

*NONE: どの媒体も自動的には消去されません。保管操作でテープ・ボリューム，または保管ファイルに活動データが検出されると，照会メッセージが送信されて，操作員は保管操作を終了するか，あるいは媒体を消去することができます。保管操作で指定された光ディスク・ファイルが検出されると，照会メッセージが送信されて，操作員は保管操作を終了するか，あるいはそのファイルを置き換えることができます。

*ALL: すべての媒体が自動的に消去されます。

テープが使用され，SEQNBRパラメーターに順序番号が指定された場合には，その順序番号から最初のテープの消去が開始されます。その最初のテープに続くテープはすべて完全に消去されます。最初のテープ全体を消去するためには，SEQNBR(1)を指定する必要があります。

*AFTER: 最初のボリュームの後のすべての媒体が自動的に消去されます。保管操作の最初のテープ・ボリュームに活動データがある場合には，照会メッセージが送信されて，操作員は保管操作の終了または媒体の消去ができます。保管操作で最初のボリュームに指定された光ディスク・ファイルが検出されると，照会メッセージが送信されて，操作員は保管操作を終了するか，あるいはそのファイルを置き換えることができます。

注: *AFTER値は保管ファイルの場合には無効です。

*REPLACE: 媒体上の活動データは自動的に置き換えられます。光ディスク・ボリュームは初期設定されません。その他の媒体は，*ALL値の場合と同様に自動的に消去されます。

上

オブジェクト事前検査 (PRECHK)

次のいずれかが真の場合に，ライブラリーの保管操作を終了するかどうかを指定します。

オブジェクトが存在していない。
ライブラリーまたはオブジェクトに損傷があることが前に判明している。
ライブラリーまたはオブジェクトが他のジョブによってロックされている。
保管操作の要求元に，そのライブラリーの権限がないか，あるいはオブジェクトの保管権限がない。

*NO: ライブラリーに対する保管操作は続行し，保管できるオブジェクトのみを保管します。
*YES: 指定されたすべてのオブジェクトが検査された後で1つまたは複数のオブジェクトが保管できない場合には，ライブラリーに対する保管操作はデータが書き出される前に終了します。複数のライブラリーが指定された場合には，保管操作は次のライブラリーから続行します。ただし，PRECHK(*YES)およびSAVACT(*SYNCLIB)が指定され，保管するライブラリーの中に予備検査条件を満たしていないオブジェクトがある場合には，保管操作は終了し，オブジェクトはいずれも保管されません。

上

活動状態保管 (SAVACT)

オブジェクトを保管中にこれを更新できるかどうかを指定します。

注: ユーザーのシステムが制限状態であり，SAVACTパラメーターが指定された場合には，SAVACT(*NO)が指定されたかのように保管操作は実行されます。

*NO: 使用中のオブジェクトは保管されません。保管中のオブジェクトを更新することはできません。
*LIB: ライブラリー内のオブジェクトは，別のジョブで使用中であっても，保管することができます。ライブラリー中のすべてのオブジェクトが同時にチェックポイントに達し，オブジェクト相互の関係が一貫性のある状態で保管されます。
*SYNCLIB: ライブラリー内のオブジェクトは，別のジョブで使用中であっても，保管することができます。保管操作中のすべてのオブジェクトおよびすべてのライブラリーが同時にチェックポイントに達し，それらの相互の関係に一貫性のある状態で保管されます。
注: この値を指定して，多数のライブラリーを保管しようとすると，保管操作ですべてのオブジェクトおよびライブラリーのチェックポイントに達するために長時間を要する可能性があります。
*SYSDFN: ライブラリー内のオブジェクトは，別のジョブで使用中であっても，保管することができます。ライブラリー中のオブジェクトはそれぞれ異なる時点にチェックポイントに達することがあり，オブジェクト相互の関係が一貫性のある状態にならないことがあります。

上

活動状態保管待ち時間 (SAVACTWAIT)

保管操作を続行する前に，使用中のオブジェクトまたは変更が保留中になっているトランザクションがコミット境界に達するのを待つ時間の長さを指定します。

要素1: オブジェクト・ロック

使用中の各オブジェクトについては，そのオブジェクトが使用可能になるのを待つ時間の長さを指定します。オブジェクトが指定された時間内使用中のままになっている場合には，そのオブジェクトは保管されません。

120: システムは，保管操作を続行する前に，それぞれの個別オブジェクト・ロックを120秒まで待ちます。
*NOMAX: 最大待ち時間が存在していません。
0から99999: 保管操作を続行する前に，それぞれの個別オブジェクト・ロックを待つ秒数を指定します。

要素2: 保留中のレコード変更

一緒にチェックポイント処理されるオブジェクトの各グループごとに，レコードの変更が保留中になっているトランザクションがコミット境界に達するのを待つ時間の長さを指定します。一緒にチェックポイント処理されるオブジェクトは，活動状態保管 (SAVACT)パラメーターで決定されます。0が指定された場合には，保管中のすべてのオブジェクトがコミット境界になければなりません。その他の値が指定された場合には，保管中のオブジェクトと同じジャーナルにジャーナル処理されたすべてのオブジェクトがコミット境界に達していなければなりません。指定された時間以内にコミット境界に達しない場合には，*NOCMTBDYが指定されていない限り，保管操作は終了します。

*LOCKWAIT: システムは，レコードの変更が保留中になっているトランザクションがコミット境界に達するのを，「要素1」に指定された値まで待ちます。
*NOCMTBDY: システムは，レコードの変更が保留中になっているトランザクションがコミット境界に達することを必要とせずに，オブジェクトを保管します。したがって，オブジェクトは部分トランザクションとともに保管されることがあります。
部分トランザクションとともに保管されたオブジェクトを復元した場合には，ジャーナル変更を適用または除去(APYJRNCHGまたはRMVJRNCHGコマンド）して，コミット境界に達するまで，そのオブジェクトは使用できません。変更を適用または除去するには，部分トランザクションに関する情報を含むすべてのジャーナル・レシーバーが必要になります。変更を適用または除去するまでは，*NOCMTBDYを指定しない場合であっても，そのオブジェクトの今後の保管には部分トランザクションが組み込まれることになります。
*NOMAX: 最大待ち時間が存在していません。
0から99999: レコードの変更が保留中になっているトランザクションがコミット境界に達するのを待つ秒数を指定します。

要素3: 他の保留中の変更

各ライブラリーごとに，保留中になっているその他の変更があるトランザクションがコミット境界に達するのを待つ時間の長さを指定します。その他の保留中の変更には以下のものがあります。

そのライブラリーに対するデータ定義言語(DDL)オブジェクト・レベルの変更。
通常の保管処理を可能にするオプションを指定しないで追加されたすべてのAPIコミットメント資源。詳細については，IBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「プログラミング」カテゴリーの「API」ﾄﾋﾟｯｸ･ｺﾚｸｼｮﾝのコミットメント資源追加(QTNADDCR) APIを参照してください。

ライブラリーについて指定された時間以内にコミット境界に達しない場合には，ライブラリーは保管されません。

*LOCKWAIT: システムは，上記のトランザクションのタイプがコミット境界に達するのを，「要素1」に指定された値まで待ちます。
*NOMAX: 最大待ち時間が存在していません。
0から99999: 上記のトランザクションのタイプがコミット境界に達するのを待つ秒数を指定します。

0が指定され，1つの名前だけがオブジェクト (OBJ)パラメーターに指定され，*FILEがオブジェクト・タイプ (OBJTYPE)パラメーターに指定された唯一の値である場合には，システムは，上記のトランザクションのタイプがコミット境界に達することを必要とせずに，オブジェクトを保管します。

上

活動状態保管ﾒｯｾｰｼﾞ待ち行列 (SAVACTMSGQ)

ライブラリーのチェックポイント処理が完了していることをユーザーに通知するために保管操作で使用されるメッセージ待ち行列を指定します。活動状態保管 (SAVACT)パラメーターに*SYSDFNまたは*LIB値が指定されている時に，保管されるライブラリーごとに別々のメッセージが送られます。SAVACTパラメーターに*SYNCLIBが指定された場合には，保管操作ですべてのライブラリーに1つのメッセージが送られます。

このパラメーターは，既知の一貫性のある境界でオブジェクトを保管して，復元操作の後の追加回復手順を避けるために使用することができます。アプリケーションは，チェックポイント処理完了メッセージを受信するまで停止することができます。

単一値

*NONE: 通知メッセージは送信されません。
*WRKSTN: 通知メッセージがワークステーション・メッセージ待ち行列に送られます。この値はバッチ・モードでは無効です。

修飾子1: 活動状態保管ﾒｯｾｰｼﾞ待ち行列

名前: 使用するメッセージ待ち行列の名前を指定します。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 最初に一致するものが見つかるまで，現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。

*CURLIB: メッセージ待ち行列を見つけるために，ジョブの現行ライブラリーが使用されます。ジョブの現行ライブラリーとして指定されているライブラリーがない場合は，QGPLライブラリーが使用されます。
名前: メッセージ待ち行列が入っているライブラリーの名前を指定してください。

上

同期 ID (SYNCID)

この活動状態保管操作が関係する同期チェックポイントの名前を指定します。同期チェックポイントは，保管同期の開始 (STRSAVSYNC)コマンドによって既に開始しておく必要があります。

*NONE: この活動状態保管操作のチェックポイントは，他のどの活動状態保管操作とも同期されていません。

名前: 同期チェックポイントの名前を指定します。名前を指定する場合には，活動状態保管 (SAVACT)パラメーターに値*SYNCLIBを指定する必要もあります。
注: 名前を指定する場合には，活動状態保管待ち時間 (SAVACTWAIT)パラメーターの要素2: 保留中のレコード変更で使用される値が，関係しているすべての保管操作のなかで最大の値になります。ただし，関係しているいずれかの保管操作に*NOCMTBDYが指定されている場合には，関係しているすべての保管操作で*NOCMTBDYを指定する必要があります。

上

ファイル・メンバー (FILEMBR)

保管されるデータベース・ファイル・メンバーを指定します。このパラメーターは，ファイル名およびメンバー名の2つの部分からなります。

ここで指定した各データベース・ファイルは，完全な名前，総称名，または*ALLのいずれかによってオブジェクト(OBJ)パラメーターにも指定しなければなりません。オブジェクト・タイプ (OBJTYPE)パラメーター値は，*ALLであるか*FILEを含んでいるかのいずれかでなければなりません。

注: STG(*FREE)が指定されている時には，このパラメーターを指定することはできません。

要素1: ファイル

*ALL

この値に続くメンバー名の値のリストは，OBJパラメーターに指定されたすべてのファイルに適用されます。

名前

保管するためにリストしたメンバーが入っているデータベース・ファイルの名前を指定します。各ファイルのメンバー・リストを使用して，最大50のファイルを指定することができます。

注: 総称名は，データベース・ファイル名には無効ですが，メンバー名には使用することができます。

注: 重複ファイル名は使用することができません。

要素2: メンバー

単一値

*ALL: すべてのメンバーが，指定されたファイルから保管されます。
*NONE: メンバーは，指定されたファイルから保管されません。ファイル記述だけが保管されます。

その他の値（最大50個指定可能）

総称名: 指定したファイルから保管するメンバーの総称名を指定してください。総称名は，1つ以上の文字とその後にアスタリスク(*)が付いた文字ストリングです。名前に*が指定されていない場合には，システムはその名前が完全なメンバー名であるとみなします。
注: 総称メンバー名を指定した場合には，ファイルに保管するファイルの総称名と一致するメンバー名が含まれていなければなりません。例えば，総称メンバー名としてPAY*を指定し，システムがPAYで始まるメンバーを検出することができない場合には，ファイルは保管されません。指定した総称名をもつメンバーが検出できないために，FILEMBRパラメーターによって指定されたファイルが保管されない場合には，診断メッセージが送られ，保管操作を終了し，保管されなかったファイル数を指定したエスケープ・メッセージが送られます。FILEMBRパラメーターに応じて処理されるファイルのうちの少なくとも1つに，指定された総称名をもつメンバーが含まれている場合には，診断メッセージは送られず，保管されなかったファイル数は最終完了メッセージに入ります。
名前: 指定のファイルから保管されるメンバーの名前を指定してください。
注: 特定のメンバー名を指定した場合には，指定したメンバーが，保管または復元するファイルの任意の部分に応じてファイル中に存在していなければなりません。

上

アクセス・パス保管 (ACCPTH)

保管しようとしている物理ファイルに従属する論理ファイル・アクセス・パスも一緒に保管されるかどうかを指定します。アクセス・パスが保管されるのは，次の場合だけです。

アクセス・パスが作成されているすべてのメンバーがこの保管操作に組み込まれた場合。
保管時点でアクセス・パスが無効でないか，または損傷を受けていない場合。

システムでは，アクセス・パスの保全性を確認するための検査が行われます。システムによって相違が見つかった場合には，アクセス・パスが再作成される結果となります。

各物理ファイルと一緒に保管される論理ファイル・アクセス・パスの数を示す通知メッセージが送られます。アクセス・パスが作成される物理ファイルはすべて同じライブラリー内になければなりません。このパラメーターは，論理ファイル・オブジェクトを保管するものではなく，アクセス・パスの保管を制御するだけです。保管されたアクセス・パスの復元の詳細は，ISERIESバックアップおよび回復(SD88-5008)にあります。

重要：基礎になっている物理ファイルと論理ファイルが異なるライブラリーに入っている場合には，アクセス・パスが保管されます。しかし，論理ファイルおよび基礎になっている物理ファイルが異なるライブラリーに入っていて，論理ファイルまたは物理ファイルが復元時に存在していない（災害時回復や，ファイルが削除されていたなど）場合には，アクセス・パスは復元されません。これらは再作成されます。論理ファイルに対してできるだけ速い復元操作を実行するためには，論理ファイルおよび基礎になっている物理ファイルが同じライブラリーに入っていなければならず，同時に保管しなければなりません。

*SYSVAL: QSAVACCPTHシステム値は，保管しようとしている物理ファイルに従属する論理ファイル・アクセス・パスを保管するかどうかを決定します。
*NO: このコマンドで指定されたオブジェクトのみが保管されます。論理ファイルのアクセス・パスは保管されません。
*YES: 指定された物理ファイルとその上にあるすべての適切な論理ファイル・アクセス・パスが保管されます。
注: この値を指定しても，論理ファイルは保管されません。

上

保管ファイル・データ (SAVFDTA)

保管ファイル・オブジェクトの場合に，保管ファイルの記述を保管するか，あるいは保管ファイルの記述と内容の両方とも保管するかを指定します。

*YES: 保管ファイルの記述と内容を保管します。
*NO: 保管ファイルの記述だけを保管します。

上

スプール・ファイル・データ (SPLFDTA)

保管される出力待ち行列のスプール・ファイル・データおよび属性を保管するかどうかを指定します。

*NONE: スプール・ファイル・データは保管されません。
*ALL: 保管される出力待ち行列ごとに，出力待ち行列で使用可能なスプール・ファイル・データがすべて保管されます。

上

待ち行列データ (QDTA)

待ち行列オブジェクトの場合に，待ち行列の記述を保管するか，あるいは待ち行列の記述と内容の両方とも保管するかを指定します。

*NONE: 待ち行列の記述だけが保管されます。
*DTAQ: 標準データ待ち行列の記述と内容を保管します。分散データ管理機能(DDM)データ待ち行列の記述だけが保管されます。

上

専用権限 (PVTAUT)

保管されたオブジェクトで，専用権限を保管するかどうかを指定します。専用権限の保管によって，オブジェクトを保管する時間が増大しますが，オブジェクトまたはオブジェクト・グループのリカバリーを単純化できます。システム全体のリカバリーを単純化するわけではありません。

*NO: どの専用権限も保管されません。
*YES: 保管される各オブジェクトについて，専用権限が保管されます。
注: この値を指定するには，システム保管(*SAVSYS)またはすべてのオブジェクト(*ALLOBJ)特殊権限が必要です。

上

記憶域 (STG)

保管しようとしているライブラリー中の指定されたメンバー（保管ファイルを除く），モジュール，プログラム，サービス・プログラム，SQLパッケージ，およびジャーナル・レシーバーのデータ部分によって占められているシステム記憶域が保管操作の一部として解放されるかどうかを指定します。これらのオブジェクトのデータ部分のみが解放され，オブジェクトの記述は解放されません。

*KEEP: 保管しようとしているオブジェクトのデータ部分によって占められている記憶域は解放されません。
*FREE: 保管しようとしている指定されたオブジェクトのデータ部分によって占められている記憶域が保管操作の一部として解放されます。ライブラリー中のすべてのオブジェクトが占めている記憶域は，そのライブラリー中のすべてのオブジェクトが正常に保管された後でのみ解放されます。
注: 起こる可能性があるプログラムの異常終了を防止するためには，*FREEが指定された時に，保管しようとしているプログラムがシステムで実行中であってはなりません。

上

データ圧縮 (DTACPR)

データ圧縮を使用するかどうかを指定します。システム上で他のジョブが活動状態のときに，ソフトウェア圧縮を使用した保管が行われる場合，全体的なシステム・パフォーマンスが影響を受ける場合があります。

注: *DEVがこのパラメーターとデータ短縮 (COMPACT)パラメーターの両方に指定されていて，装置データの短縮が装置上でサポートされている場合には，装置データの短縮だけが実行されます。そうでない場合には，データ圧縮が実行されます。

このパラメーターに*YESが指定され，COMPACTパラメーターに*DEVが指定された場合には，装置上でサポートされていれば，装置データの短縮と装置データの圧縮の両方が実行されます。

*DEV: テープへの保管で，ターゲット装置が圧縮をサポートしている場合には，ハードウェアの圧縮が実行されます。そうでない場合には，データ圧縮は実行されません。

*NO: データ圧縮は実行されません。
*YES: テープへの保管で，ターゲット装置が圧縮をサポートしている場合には，ハードウェアの圧縮が実行されます。圧縮がサポートされていないか，あるいは保管データが光ディスク媒体または保管ファイルに書き出される場合には，ソフトウェア圧縮が実行されます。低ソフトウェア圧縮は，中間ソフトウェア圧縮を使用する光ディスクDVD以外のすべての装置に使用されます。
*LOW: 保管操作が保管ファイルまたは光ディスクに対する操作の場合には，ソフトウェア・データ圧縮はSNAアルゴリズムで実行されます。通常，低圧縮はより高速であり，圧縮されるデータは中間および高圧縮が使用された場合より大きくなります。
注: この値はテープの場合には無効です。
*MEDIUM: 保管操作が保管ファイルまたは光ディスクに対する操作の場合には，ソフトウェア・データ圧縮はTERSEアルゴリズムで実行されます。通常，中間圧縮は低圧縮より低速になりますが，高圧縮よりは高速となります。圧縮されるデータは通常，低圧縮が使用された場合よりは小さくなり，高圧縮が使用された場合よりは大きくなります。
注: この値はテープの場合には無効です。
*HIGH: 保管操作が保管ファイルまたは光ディスクに対する操作の場合には，ソフトウェア・データ圧縮はLZ1アルゴリズムで実行されます。通常，高圧縮はより低速であり，圧縮されるデータは低および中間圧縮が使用された場合より小さくなります。
注: この値はテープの場合には無効です。

上

データ短縮 (COMPACT)

装置データ短縮を実行するかどうかを指定します。

*DEV

データがテープに保管され，装置 (DEV)パラメーターに指定したすべてのテープ装置が短縮機能をサポートしている場合には，装置データ短縮が実行されます。

注: *DEVがデータ圧縮 (DTACPR)パラメーターとこのパラメーターの両方に指定されていて，装置データの短縮が装置上でサポートされている場合には，装置データの短縮だけが実行されます。そうでない場合には，装置上でサポートされていれば，データ圧縮が実行されます。

DTACPRパラメーターに*YESが指定され，このパラメーターに*DEVが指定された場合には，装置上でサポートされていれば，装置データの短縮と装置データの圧縮の両方が実行されます。

*NO

装置データの短縮は実行されません。

上

除外するライブラリー (OMITLIB)

保管操作から除外する，1つまたは複数のライブラリーの名前またはライブラリーの各グループの総称名を指定します。

単一値

*NONE: どのライブラリーも保管操作から除外されません。

*USRSPC: コマンド・ユーザー・スペース (CMDUSRSPC)パラメーターに指定されたユーザー・スペース中で識別されるライブラリーは，保管操作から除外されます。

その他の値（最大300個指定可能）

総称名: 除外するライブラリーの総称名を指定します。総称名は1つまたは複数の文字とその後にアスタリスク(*)が付いた文字ストリング（例えば，ABC*)です。アスタリスク(*)は，有効な任意の文字と置き換えられます。総称名の指定は，名前がその総称接頭部で始まる，ユーザーが権限を持っているすべてのライブラリーです。総称（接頭部）名にアスタリスクが含まれていない場合には，システムはそれを完全なライブラリー名とみなします。
名前: 保管操作から除外するライブラリーの名前を指定してください。

上

除外するオブジェクト (OMITOBJ)

操作から除外するオブジェクトを指定します。最大300までのオブジェクトまたは総称オブジェクトの値を指定することができます。

単一値

*USRSPC: コマンド・ユーザー・スペース (CMDUSRSPC)パラメーターに指定されたユーザー・スペース中で識別されるオブジェクトは，保管操作から除外されます。

その他の値（最大300個指定可能）

要素1: オブジェクト

修飾子1: オブジェクト

*NONE: 操作から除外されるオブジェクトはありません。
*ALL: 指定されたオブジェクト・タイプのすべてのオブジェクトが操作から除外されます。
総称名: 除外するオブジェクトの総称名を指定します。
注: 総称名は，1つまたは複数の文字の後にアスタリスク(*)が付いた文字ストリングとして指定されます。総称名を指定した場合には，その総称オブジェクト名と同じ接頭部を持つ名前のついたすべてのオブジェクトが選択されます。
名前: 操作から除外するオブジェクトの名前を指定します。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*ALL: 指定されたオブジェクトは，操作部位のすべてのライブラリーから除外されます。
総称名: 除外するオブジェクトが入っているライブラリーの総称名を指定します。
注: 総称名は，1つまたは複数の文字の後にアスタリスク(*)が付いた文字ストリングとして指定されます。総称名を指定した場合には，その総称オブジェクト名と同じ接頭部を持つ名前のついたすべてのオブジェクトが選択されます。
名前: 操作から除外するオブジェクトが入っているライブラリーの名前を指定します。

要素2: オブジェクト・タイプ

*ALL: オブジェクト名に指定された値に基づいて，すべてのオブジェクト・タイプが操作から除外されます。
文字値: 操作から除外するオブジェクトのオブジェクト・タイプを指定します。
このコマンドについてプロンプトを出す時にオブジェクト・タイプの完全なリストを表示するには，このパラメーターのフィールドにカーソルを位置付け，F4（プロンプト）を押します。オブジェクト・タイプの記述については，IBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「プログラミング」ｶﾃｺﾞﾘｰの「制御言語(CL)」ﾄﾋﾟｯｸ･ｺﾚｸｼｮﾝの「オブジェクト・タイプ」を参照してください。

上

SELECT (SELECT)

保管するオブジェクトの選択基準を指定します。オブジェクト (OBJ),ライブラリー (LIB),およびオブジェクト・タイプ (OBJTYPE)パラメーターに指定されたオブジェクトから選択できます。

単一値

*USRSPC: コマンド・ユーザー・スペース (CMDUSRSPC)パラメーターに指定されたユーザー・スペース中で識別される選択基準が使用されます。

その他の値（最大300個指定可能）

要素1: 組み込みまたは除外

選択したオブジェクトを保管操作に含めるか，またはこの操作から除外するかを指定します。

*INCLUDE: 選択したオブジェクトが保管されます(*OMITの指定によって一時変更された場合，および除外するライブラリー (OMITLIB)パラメーターまたは除外するオブジェクト(OMITOBJ)パラメーターによって除外された場合を除く）。
*OMIT: 選択したオブジェクトは保管操作に含まれません。

要素2: オブジェクト

修飾子1: オブジェクト

*ALL: オブジェクト (OBJ)パラメーターに指定されたすべてのオブジェクト名が選択されます。
総称名: 選択するオブジェクトの総称名を指定してください。
注: 総称名は，1つまたは複数の文字の後にアスタリスク(*)が付いた文字ストリングとして指定されます。総称名を指定した場合には，その総称オブジェクト名と同じ接頭部を持つ名前のついたすべてのオブジェクトが選択されます。
名前: 選択されるオブジェクトの名前を指定してください。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*ALL: ライブラリー (LIB)パラメーターに指定されたすべてのライブラリー名が選択されます。
総称名: 選択するライブラリーの総称名を指定してください。
名前: 選択するライブラリーの名前を指定してください。

要素3: オブジェクト・タイプ

*ALL: オブジェクト・タイプ (OBJTYPE)パラメーターに指定されたすべてのオブジェクト・タイプが選択されます。
文字値: 選択するオブジェクト・タイプを指定してください。
このコマンドについてプロンプトを出す時にオブジェクト・タイプの完全なリストを表示するには，このパラメーターのフィールドにカーソルを位置付け，F4（プロンプト）を押します。オブジェクト・タイプの記述については，IBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「プログラミング」ｶﾃｺﾞﾘｰの「制御言語(CL)」ﾄﾋﾟｯｸ･ｺﾚｸｼｮﾝの「オブジェクト・タイプ」を参照してください。

要素4: オブジェクトの属性

*ALL: すべてのオブジェクト属性が選択されます。
*BLANK: 属性値がないオブジェクトのみが選択されます。
属性値: 選択するオブジェクトの属性を指定してください。
総称属性値: 選択するオブジェクトの総称属性を指定してください。

要素5: ファイル・メンバー

選択するデータベース・ファイル・メンバーを指定します。

*ALLが指定された場合，前の要素によって選択されたオブジェクトが含まれるか，または除外されます。

*ALL以外の値を指定した場合には，ファイル・メンバー (FILEMBR)パラメーターを指定することはできません。前の要素によって選択されたオブジェクトが含まれます。そのオブジェクトがデータベース・ファイルでない場合でも同様です。選択されたオブジェクトがデータベース・ファイルの場合は，選択されたファイル・メンバーが含まれるか，あるいは除外されます。

*ALL: すべてのファイル・メンバーが選択されます。*OMIT指定の場合，選択されたファイルまたはオブジェクトも除外されます。
*ALLMBR: すべてのファイル・メンバーが選択されます。*OMIT指定の場合，選択されたファイルまたはオブジェクトが含まれ，すべてのファイル・メンバーが除外されます。
総称名: 選択するファイル・メンバーの総称名を指定してください。選択されたファイルまたはオブジェクトに指定のメンバーが含まれていない場合でも，そのファイルまたはオブジェクトが含まれます。
名前: 選択するファイル・メンバーの名前を指定してください。選択されたファイルまたはオブジェクトに指定のメンバーが含まれていない場合でも，そのファイルまたはオブジェクトが含まれます。

上

ASP装置 (ASPDEV)

保管操作に組み込まれる補助記憶域プール(ASP)装置を指定します。このパラメーターは，OBJパラメーターに基づいてSAVに適格のオブジェクトのリストをサブセット化するのに使用されます。

*: 操作には，システムASP (ASP番号1),すべての基本ユーザーASP (ASP番号2から32),さらに現行スレッドにASPグループがある場合には．そのASPグループ中のすべての独立ASPが組み込まれます。
*SYSBAS: システムASPおよびすべての基本ユーザーASPが保管操作に組み込まれます。
*CURASPGRP: 現行スレッドにASPグループがある場合には，そのASPグループ中のすべての独立ASPが保管操作に組み込まれます。
名前: 保管操作に組み込むASP装置の名前を指定します。

上

出力 (OUTPUT)

保管済みオブジェクトに関する情報が含まれているリストを作成するかどうかを指定します。この情報は，ジョブのスプール出力で印刷するか，あるいはデータベース・ファイルに出力することができます。

*NONE: 出力リストは作成されません。

*PRINT: 出力はジョブのスプール出力で印刷されます。

*OUTFILE: 出力は，出力を受け取るファイル (OUTFILE)パラメーターで指定されたデータベース・ファイルに送られます。

注: OUTPUT(*OUTFILE)が指定されている場合には，出力を受け取るファイル (OUTFILE)パラメーターにデータベース・ファイル名を指定しなければなりません。

上

出力を受け取るファイル (OUTFILE)

コマンドの出力が送られるデータベース・ファイルを指定します。ファイルが存在しない場合には，このコマンドによって，指定されたライブラリーにデータベース・ファイルが作成されます。ファイルが作成される場合には，ファイルの共通権限は，ファイルが作成されるライブラリーに指定された作成権限と同じものになります。ライブラリーの作成権限を表示するには，ライブラリー記述表示(DSPLIBD)コマンドを使用してください。

修飾子1: 出力を受け取るファイル

名前: コマンド出力が送られる先のデータベース・ファイルの名前を指定してください。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: ファイルを見つけるために，ライブラリー・リストが使用されます。ファイルが見つからない場合には，現行ライブラリーにファイルが作成されます。現行ライブラリーが存在していない場合には，ファイルはQGPLライブラリーに作成されます。
*CURLIB: ファイルを見つけるためにスレッドの現行ライブラリーが使用されます。スレッドの現行ライブラリーとして指定されているライブラリーがない場合，QGPLライブラリーが使用されます。

名前: 検索するライブラリーの名前を指定してください。

注: 新規ファイルが作成される場合，システムは，IBM提供の形式名QSRSAVのファイルQASAVOBJをモデルとして使用します。

上

出力メンバー・オプション (OUTMBR)

出力 (OUTPUT)パラメーターに*OUTFILEが指定された時に，出力を指示するデータベース・ファイル・メンバーの名前を指定します。

要素1: 出力を受け取るメンバー

*FIRST: ファイル中の最初のメンバーが出力を受け取ります。OUTMBR(*FIRST)が指定されていて，メンバーが存在していない場合には，システムが出力を受け取るファイル (OUTFILE)パラメーターに指定されたファイルの名前を使用してメンバーを作成します。
名前: 出力を受け取るファイル・メンバーの名前を指定してください。OUTMBR（メンバー名）が指定され，そのメンバーが存在しない場合，システムがメンバーを作成します。
メンバーが存在している場合には，レコードを既存メンバーの終わりに追加するか，既存メンバーを消去してレコードを追加することができます。

要素2: レコードの置き換えまたは追加

*REPLACE: 指定したデータベース・ファイル・メンバー中に既存のレコードは，新規レコードで置き換えられます。
*ADD: 新規レコードが指定されたデータベース・ファイル・メンバーの既存情報に追加されます。

上

情報のタイプ (INFTYPE)

印刷するか，データベース・ファイルに向ける情報のタイプを指定します。

*OBJ: リストには，保管するように要求された各オブジェクトの項目が入ります。
*ERR: リストには，コマンド，各ライブラリーの項目，および正常に保管されなかった各オブジェクトの項目に関する情報が入ります。
*LIB: リストには，保管するように要求された各ライブラリーのライブラリー項目が入ります。
*MBR: リストには，保管するように要求された各オブジェクトの項目，データベース・ファイル・メンバー，およびスプール・ファイルが入ります。

上

コマンド・ユーザー・スペース (CMDUSRSPC)

このコマンドに*USRSPCが指定されたパラメーターに対して値を入れたユーザー・スペースを指定します。このユーザー・スペースには，パラメーターごとに32767までのリスト値が許可されていますが，コマンド・パラメーターには300までしかリスト値が許可されていません。ユーザー・スペースは，オブジェクト・リスト保管(QSRSAVO) APIによって使用されるフォーマットでパラメーターを定義しなければなりません。

修飾子1:ユーザー・スペース

名前: このコマンドに*USRSPCが指定されたパラメーターに対して値を入れたユーザー・スペースの名前を指定します。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 最初に一致するものが見つかるまで，現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。

*CURLIB: ユーザー・スペースを見つけるために，ジョブの現行ライブラリーが使用されます。ジョブの現行ライブラリーとして指定されているライブラリーがない場合は，QGPLライブラリーが使用されます。
名前: ユーザー・スペースが入っているライブラリーの名前を指定します。

上

例

例1:同じ名前をもつプログラムおよびファイルの保管

SAVOBJ   OBJ(PETE)  LIB(LIBX)  DEV(TAP01)

このコマンドは，LIBXライブラリーにあるPETEという名前のオブジェクトを保管します。例えば，LIBXにPETEという名前のプログラムとファイルの両方が含まれていた場合には，両方のオブジェクトが保管されます。STGパラメーターは省略時の値(*KEEP)とみなされているで，そのオブジェクトが占めていた記憶域は解放されません。

例2:システム記憶域の解放

SAVOBJ   OBJ(MSTRPAY PAY*)  LIB(QGPL)  DEV(TAP01)  STG(*FREE)

汎用ライブラリー(QGPL)にあるMSTRPAYという名前のオブジェクト，および名前が文字PAYで始まるすべてのオブジェクトが保管されます。保管操作の一部として，保管されたメンバー，モジュール，プログラム，サービス・プログラム，SQLパッケージ，およびジャーナル・レシーバー・オブジェクトのデータ部分が占めていたシステム記憶域が解放されます。

例3:光ディスクでのファイルの保管

SAVOBJ   OBJ(FILEA)  OBJTYPE(*FILE)  LIB(LIBY)  DEV(OPT01)
         VOL(TOM)  CLEAR(*REPLACE)

LIBYライブラリーのFILEAという名前のファイルが，ボリュームID TOMによって識別される光ディスク・ボリューム上でライブラリー名LIBYをもつファイルに保管されます。LIBYファイルが既に光ディスク・ボリュームに存在していた場合には，FILEAが保管された後に自動的に置き換えられます。

例4:前のリリースでサポートされるオブジェクトの保管

SAVOBJ   OBJ(PAY*)  LIB(LIB1)  DEV(TAP01)  TGTRLS(*PRV)

このコマンドは，文字PAYで始まるオブジェクトを，前のオペレーティング・システムのリリースと互換性のある形式でLIB1ライブラリーから保管します。前のリリースでサポートされていたオブジェクトだけが保管されます。

例5:ファイルの記述およびデータの保管

SAVOBJ   OBJ(SAVEFILE)  LIB(MYLIB)  OBJTYPE(*FILE)  DEV(TAP01)
         SAVFDTA(*YES)

このコマンドは，MYLIBという名前のライブラリーにあるSAVEFILEという名前のファイルを保管します。この保管ファイルについては，記述とデータの両方が保管されます。

例6:オブジェクトのリストの保管

SAVOBJ   OBJ(APP1*)  LIB(*SELECT)  DEV(TAP01)
         SELECT((*INCLUDE PGMLIB/*ALL     *PGM        )
                (*OMIT    PGMLIB/APP1TEST             )
                (*INCLUDE DTALIB*/*ALL    *FILE    PF )
                (*INCLUDE DTALIB*/*ALL    *FILE    LF )
                (*OMIT    DTALIBTEST/*ALL             )
                (*INCLUDE JRNLIB*/*ALL    *JRN        )
                (*INCLUDE JRNLIB*/*ALL    *JRNRCV     ))

このコマンドは，ライブラリーPGMLIBにあるプログラム（プログラムAPP1TESTを除く），DTALIBで始まる名前のライブラリー（ライブラリーDTALIBTESTを除く）にある物理ファイルと論理ファイル，およびJRNLIBで始まる名前のライブラリーにあるジャーナルとジャーナル・レシーバーを含む，APP1で始まる名前のオブジェクトを保管します。

例7:データベース・ファイル記述の保管

SAVOBJ   OBJ(*ALL)  LIB(DATALIB)  DEV(TAP01)
         SELECT((*INCLUDE *ALL *FILE PF )
                (*INCLUDE *ALL *FILE LF )
                (*OMIT    *ALL *ALL  *ALL *ALLMBR ))

このコマンドは，ライブラリーDATALIB内のすべての物理ファイルおよび論理ファイルを保管しますが，ファイル・メンバーを保管しません。保管されるのは，ファイル記述のみです。

上

エラー・メッセージ

*ESCAPE メッセージ

CPF3701: &1個のオブジェクトが&3から保管されました。&2が保管されていません。
CPF3702: &1個のオブジェクトが&3から保管されました。&2が保管されていません。&9が組み込まれていません。
CPF3703: &3の&2 &1は保管されなかった。
CPF3708: &2の保管ファイル&1が小さすぎる。
CPF3709: テープ装置は同じ密度をサポートしていない。
CPF3727: 装置名リストで重複する装置&1が指定された。
CPF3728: 装置&1が他の装置と一緒に指定されている。
CPF3730: ライブラリー&3の&2 &1は認可されていない。
CPF3731: ライブラリー&3の&2 &1を使用することができない。
CPF3733: &3の&2 &1で前に損傷が起こっている。
CPF3735: ユーザー・プロファイル&1の記憶域が限界を超えた。
CPF3738: 保管または復元に使用した装置&1に損傷がある。
CPF3747: 複数のライブラリーでオブジェクト名を指定することはできない。
CPF3749: ライブラリー&2からオブジェクトが保管されませんでした。
CPF3767: 装置&1が見つからない。
CPF3768: 装置&1はコマンドに対して正しくない。
CPF377D: 内部システム資源の読み取りエラーのために保管が終了した。
CPF377E: 活動状態保管の要求に記憶域が不十分である。
CPF377F: 保管が終了しました。チェックポイントに到達できません。
CPF3770: ライブラリー&1について保管または復元されたオブジェクトはない。
CPF3771: &1個のオブジェクトが&3から保管されました。&2が保管されていません。
CPF3774: &1個のオブジェクトが&3から保管されました。&2が保管されていません。&8が組み込まれていません。
CPF3778: すべてのオブジェクトが保管されなかったライブラリーがある。
CPF378A: メッセージ待ち行列が使用できない。
CPF378C: SAVACTMSGQ(*WRKSTN)はバッチ・ジョブでは正しくない。
CPF378E: ライブラリー&1は保管されていない。
CPF3781: ライブラリー&1が見つかりません。
CPF3782: &2のファイル&1は保管ファイルでない。
CPF3789: 指定したパラメーターではライブラリーは１つしか使用できない。
CPF379E: ライブラリー&1の保管に使用可能な記憶域が不十分である。
CPF3793: マシンまたはASPの記憶域限界に達しました。
CPF3794: 保管または復元操作が正常に終了しなかった。
CPF3797: ライブラリー&3からオブジェクトが保管されませんでした。保管の限界を超えました。
CPF37AB: *NOCMTBDYはターゲット・リリースで使用できません。
CPF37AC: *NOCMTBDYの場合，ライブラリーは使用できません。
CPF37B1: SPLFDTAはターゲット・リリースでは使用できません。
CPF37B4: &2のユーザー・スペース&1が正しくありません。
CPF37B5: PVTAUTはターゲット・リリースでは使用できません。
CPF37B7: 専用権限の保管は認可されていない。
CPF37B9: 同期ID &1が使用中である。
CPF37BC: 同期ID &1は終了しました。待機時間を超えました。
CPF37BD: 同期ID &1は終了しました。チェックポイント前に保管が終了しました。
CPF37BE: 同期ID &1が開始されていない。
CPF37C7: 同期ID &1は終了しました。SAVACTWAITエラー。
CPF380B: この時点で保管を完了することができない。
CPF3812: &2の保管ファイル&1は使用中である。
CPF3815: &2の保管ファイル&1は保管操作には小さすぎる。
CPF384E: CD-ROMの事前マスター処理にはUSEOPTBLK(*YES)は無効である。
CPF3867: FILEMBRパラメーターの内容が正しくない。
CPF3868: FILEMBRを指定しているが，OBJTYPEは*ALLまたは*FILEでなければならない。
CPF3871: 保管または復元されたオブジェクトはない。&3個のオブジェクトが含まれなかった。
CPF388B: 光ディスク・ファイル・パス名が正しくない。
CPF3892: &3の&2 &1は保管されなかった。
CPF3894: メッセージ&1に対して取り消し応答を受け取った。
CPF38A2: ASP装置&1は正しくありません。
CPF38A3: &2のファイル&1はASPDEVでは無効です。
CPF38A4: ASP装置&1は正しくありません。
CPF38AA: オブジェクト選択リスト・キーが無効です。
CPF38AB: FILEMBRはSELECTでは無効です。
CPF38AC: LIB(*SELECT)は*ALLライブラリーでは無効です。
CPF5729: オブジェクト&1を割り振ることができない。
CPF9809: ライブラリー&1をアクセスすることができない。
CPF9812: ライブラリー&2にファイル&1が見つからない。
CPF9814: 装置&1が見つかりません。
CPF9820: ライブラリー&1の使用は認可されていない。
CPF9822: ライブラリー&2のファイル&1は認可されていない。
CPF9825: 装置&1は認可されていない。
CPF9833: *CURASPGRPまたは*ASPGRPPRIが指定されていて，スレッドにASPグループがない。
CPFB8ED: 装置記述&1はこの操作には正しくありません。
OPT1332: 光ディスク・ボリュームが装置&1に見つからない。

*STATUS メッセージ

CPF3770: ライブラリー&1について保管または復元されたオブジェクトはない。
CPF3771: &1個のオブジェクトが&3から保管されました。&2が保管されていません。
CPF3871: 保管または復元されたオブジェクトはない。&3個のオブジェクトが含まれなかった。

上