ライブラリー保管 (SAVLIB)

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

ライブラリー保管(SAVLIB)コマンドでは1つまたは複数のライブラリーのコピーを保管することができます。

保管ファイルに保管する時には，ライブラリーは1つしか指定することができません。

このコマンドでは，ライブラリー記述，オブジェクト記述，およびライブラリー中のオブジェクトの内容を含め，ライブラリー全体が保管されます。ジョブ待ち行列，メッセージ待ち行列，および論理ファイルの場合には，オブジェクトの定義だけが保管され，内容は保管されません。しかし，論理ファイルのアクセス・パスは，アクセス・パス保管 (ACCPTH)パラメーターに*YESを指定することによって保管することができます。出力待ち行列上のスプール・ファイルの内容は，スプール・ファイル・データ (SPLFDTA)パラメーターに*ALLを指定することによって保管することができます。保管ファイルの内容は，保管ファイル・データ (SAVFDTA)パラメーターに*YESを指定するか，あるいは保管ファイル・データ保管(SAVSAVFDTA)コマンドを使用することによって保管することができます。データ待ち行列の内容は，待ち行列データ (QDTA)パラメーターに*DTAQを指定して保管することができます。コマンドで記憶域の解放を指定しない限り，システム中のライブラリーとそのオブジェクトには影響がありません。しかし，ヒストリー更新 (UPDHST)パラメーターに*NOを指定しない限り，各ライブラリーおよび各オブジェクトの記述は，それが最後に保管された日付，場所，および時刻で更新されます。LIBパラメーターに*NONSYS, *ALLUSR,または*IBMを指定してライブラリーのグループが保管される場合には，QSYS中のデータ域（データ域QSAVLIBALL, QSAVALLUSR,またはQSAVIBM）のヒストリーで日付，時刻，および場所が更新されます。

このコマンドによって保管されるオブジェクトのタイプは，IBM i Information Center(http://www.ibm.com/systems/i/infocenter/)の「プログラミング」カテゴリーの「制御言語(CL)」トピック・コレクションの「共通して使用されるパラメーター：詳細説明」のOBJTYPEパラメーターの説明で，追加の*DTADCTと一緒にリストされています。ユーザー・ライブラリーに含まれていないある種のオペレーティング・システム・オブジェクト（ユーザー・プロファイルなど）は，このコマンドでは保管されません。これらはシステム保管(SAVSYS)コマンドまたは機密保護データ保管(SAVSECDTA)コマンドによって保管することができます。

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

制約事項:

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

上

パラメーター

キーワード	記述	選択項目	ノーツ
LIB	ライブラリー	単一値: NONSYS, ALLUSR, IBM, SELECT, *USRSPC その他の値 (最大 300 回の繰り返し): 総称名, 名前	必須, 定位置 1
DEV	装置	単一値: SAVF, MEDDFN その他の値 (最大 4 回の繰り返し): 名前	必須, 定位置 2
VOL	ボリュームID	単一値: *MOUNTED その他の値 (最大 75 回の繰り返し): 文字値	オプショナル, 定位置 3
SEQNBR	順序番号	1-16777215, *END	オプショナル
LABEL	ラベル	文字値, *LIB	オプショナル
EXPDATE	ファイル満了日	日付, *PERM	オプショナル
ENDOPT	媒体の終わりオプション	REWIND, LEAVE, *UNLOAD	オプショナル
STRLIB	開始ライブラリー	名前, *FIRST	オプショナル
SAVF	保管ファイル	修飾オブジェクト名	オプショナル
	修飾子 1: 保管ファイル	名前
	修飾子 2: ライブラリー	名前, LIBL, CURLIB
MEDDFN	媒体定義	修飾オブジェクト名	オプショナル
	修飾子 1: 媒体定義	名前
	修飾子 2: ライブラリー	名前, LIBL, CURLIB
OPTFILE	光ディスク・ファイル	パス名, *	オプショナル
USEOPTBLK	最適ブロックの使用	YES, NO	オプショナル
TGTRLS	ターゲット・リリース	CURRENT, PRV, V7R2M0, V7R3M0, V7R4M0	オプショナル
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	オプショナル
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
SORT	ソート方法	NAME, SIZE	オプショナル

上

ライブラリー (LIB)

保管するライブラリーを指定します。

注:

システム・ライブラリーQDOC, QDOCXXXX, QPTFOBJ1, QPTFOBJ2, QRCYXXXXX, QRECOVERY, QRPLOBJ, QRPLXXXXX, QSPL, QSPLXXXX, QSRV, QSYS, QSYSXXXXX,およびQTEMPをこのコマンドで保管することはできません。XXXXは基本ユーザーASP番号であり，XXXXXは独立ASP番号です。
このパラメーターに*ALLUSRまたは*IBMを指定した場合には，このコマンドは，指定したライブラリーが使用中でない時に実行しなければなりません。ライブラリーの保管中にライブラリー中のオブジェクトが使用中であった場合には，SAVACTを使用しなければオブジェクトは保管されません。すべてのライブラリーの保管を確実に完了するには，このコマンドを制限状態のシステムで実行してください。例えば，サブシステムQSNADSが活動状態である時にSAVLIB LIB(*ALLUSR)が実行された場合には，ライブラリーQUSRSYS中のQAO*ファイルは保管されません。QAO*ファイルを保管するには，SAVLIB LIB(*ALLUSR)の実行前にQSNADSサブシステムを終了してください。
SAVLIB LIB(*IBM)を実行してから，SAVLIB LIB(*ALLUSR)を実行すると，SAVLIB LIB(*NONSYS)の場合と同じライブラリーが保管されますが，2つの復元コマンドが必要です。
ライブラリーは，ソート方法 (SORT)パラメーターに指定された順序で保管されます。

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

単一値

*NONSYS

以下のシステム・ライブラリーを除くすべてのライブラリーが保管されます。XXXXおよびXXXXXはASP番号を表します。

QDOC        QRCYXXXXX   QSPL        QSYSXXXXX
QDOCXXXX    QRECOVERY   QSPLXXXX    QTEMP
QPTFOBJ1    QRPLOBJ     QSRV
QPTFOBJ2    QRPLXXXXX   QSYS

注: このオプションを指定する場合には，サブシステム終了(ENDSBS)またはシステム終了(ENDSYS)コマンドですべてのサブシステムを終了していなければなりません。

*ALLUSR

すべてのユーザー・ライブラリーが保管されます。次を除いて，英字Ｑで開始されない名前のすべてのライブラリーが保管されます。

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

次のQXXXライブラリーはIBMによって提供されますが，これらには一般的に，頻繁に変更されるユーザー・データが入れられます。したがって，こうしたライブラリーは「ユーザー・ライブラリー」とみなされ，これもまた保管されます。

QDSNX       QRCLXXXXX   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVXRXMX
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2XXXXX  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

*IBM

以下のものを除くIBM提供のすべてのライブラリーが保管されます。

QDOC        QRCL        QSYS2XXXXX  QUSRPOSGS
QDOCXXXX    QRCLXXXXX   QS36F       QUSRPOSSA
QDSNX       QRCYXXXXX   QTEMP       QUSRPYMSVR
QGPL        QRECOVERY   QUSER38     QUSRRDARS
QGPL38      QRPLOBJ     QUSRADSM    QUSRSYS
QMGTC       QRPLXXXXX   QUSRBRM     QUSRVI
QMGTC2      QSPL        QUSRDIRCF   QUSRVXRXMX
QMPGDATA    QSPLXXXX    QUSRDIRCL   QWQCENT
QMQMDATA    QSRV        QUSRDIRDB   QWQREPOS
QMQMPROC    QSRVAGT     QUSRIJS
QPFRDATA    QSYS        QUSRINFSKR
QPTFOBJ1    QSYSXXXXX   QUSRNOTES
QPTFOBJ2    QSYS2       QUSROND

注: 前のリリースのCLプログラム内でコンパイルされるユーザー・コマンドを入れるために，弊社がサポートする前の各リリース用にQUSRVXRXMXの形式の別のライブラリー名を作成することができます。QUSRVXRXMXユーザー・ライブラリーのVXRXMXは弊社が引き続きサポートしている前のリリースのバージョン，リリース，およびモディフィケーション・レベルです。

Ｑで始まらない名前をもつ次のライブラリーも保管されます。

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

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

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

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

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

上

装置 (DEV)

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

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

単一値

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

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

その他の値

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

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

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

上

ボリュームID (VOL)

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

単一値

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

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

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

上

順序番号 (SEQNBR)

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

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

LIBパラメーターに*NONSYS, *ALLUSR,または*IBMが指定された場合には，ライブラリーのセットの保管操作は，指定された順序番号で開始されます。このセットに最初に保管されたファイルはQFILEファイルです。QFILEファイルには保管されたライブラリーのリストが入っています。

上

ラベル (LABEL)

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

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

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

上

ファイル満了日 (EXPDATE)

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

注:

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

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

上

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

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

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

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

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

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

上

開始ライブラリー (STRLIB)

保管操作を開始するライブラリーを指定します。

保管操作中に回復不能媒体エラーが起こった場合には，このパラメーターを使用して，操作を再開することができます。

保管操作再開の基本ステップは次の通りです。

ジョブ・ログを調べて，前の保管操作が正常に行われなかったライブラリーを判別してください。最後に保管されたライブラリーを見つけてください。これは，正常完了メッセージによって示されます。
次のテープが初期設定されていることを確認して，そのテープを装てんしてください。
以下をオリジナルの保管操作に追加します。
```
  STRLIB(ライブラリー名)  OMITLIB(ライブラリー名)
```
ここで，STRLIBおよびOMITLIBパラメーターのライブラリー名は正常に保管された最後のライブラリーです。これにより，保管操作は正常に保管された最後のライブラリーの後のライブラリーから始まります。

ライブラリーを復元するには，実行されたそれぞれの保管操作ごとに別個の復元操作を実行する必要があります。

*FIRST: 保管操作は，ライブラリー (LIB)パラメーターに指定された最初のライブラリー値から始まります。最初の値が総称名または特殊値であった場合には，保管操作はこの値と一致する最初のライブラリーから始まります。
名前: 保管操作を開始するライブラリーの名前を指定してください。

上

保管ファイル (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の形式で指定してください。オブジェクトは，指定したリリースまたはそれ以降のオペレーティング・システムが導入されているシステムに復元することができます。

注:

LIB(*NONSYS), LIB(*ALLUSR),またはLIB(*IBM)が指定された場合には，ターゲット・リリースにできるのは現行リリースだけです。
すべてのオブジェクトで別のリリースをターゲットにすることができるわけではありません。どのオブジェクトがサポートされているかを判別するには，ISERIESバックアップおよび回復(SD88-5008)の図を参照してください。

上

ヒストリー更新 (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: 上記のトランザクションのタイプがコミット境界に達するのを待つ秒数を指定します。

上

活動状態保管メッセージ待ち行列 (SAVACTMSGQ)

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

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

単一値

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

修飾子1: 活動状態保管メッセージ待ち行列

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

修飾子2: ライブラリー

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

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

上

同期 ID (SYNCID)

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

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

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

上

アクセス・パス保管 (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)

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

単一値

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

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

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

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

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

要素2: オブジェクト

修飾子1: オブジェクト

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

修飾子2: ライブラリー

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

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

*ALL: すべてのオブジェクト・タイプが選択されます。
文字値: 選択するオブジェクト・タイプを指定してください。
このコマンドについてプロンプトを出す時にオブジェクト・タイプの完全なリストを表示するには，このパラメーターのフィールドにカーソルを位置付け，F4（プロンプト）を押します。オブジェクト・タイプの記述については，IBM i Information Center(http://www.ibm.com/systems/i/infocenter/)の「プログラミング」カテゴリーの「制御言語(CL)」トピック・コレクションの「オブジェクト・タイプ」を参照してください。

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

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

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

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

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

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

*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ライブラリーが使用されます。
名前: ユーザー・スペースが入っているライブラリーの名前を指定します。

上

ソート方法 (SORT)

ライブラリー (LIB)パラメーターに指定されたライブラリーが保管される順序を指定します。LIBパラメーターに*NONSYSまたは*ALLUSRが指定された場合，ライブラリーQSYS2, QGPL, QUSRSYS,およびQSYS2XXXXX（ここで，XXXXXは独立ASP番号です）が最初に保管されます（それらのライブラリーがＡＳＰＤＥＶパラメーターで指定されたＡＳＰ上にある場合）。

*NAME: ライブラリーは，LIBパラメーターに名前が指定された順序で保管されます。総称値または特殊値ごとに，独立ASP上のライブラリーは，システムおよび基本ユーザーASP上のライブラリーより前に保管されます。同じASP上のライブラリーは，ライブラリー名のアルファベット順に保管されます。
*SIZE: ライブラリーは，合計ライブラリー・サイズ順に最大から最小へと保管されます。これによって，保管操作のパフォーマンスを向上させることができます。

上

例

例1:テープ装置でのライブラリーの保管

SAVLIB   LIB(JOE)  DEV(TAP01)

このコマンドは，JOEという名前のライブラリーをTAP01という名前のテープ装置にあるテープに保管します。STGパラメーターは省略時の値(*KEEP)とみなされているので，システム内のJOEが占めていた記憶域は解放されません。

例2:複数のボリュームでの保管

SAVLIB   LIB(QGPL)  DEV(OPT01)  VOL(ABC DEF GHI)

汎用ライブラリー(QGPL)がOPT01という名前の装置の光ディスク・ボリュームで保管されます。使用される光ディスク・ボリュームはABC, DEF,およびGHIというボリューム名でなければなりません。ボリュームABCが満杯になった時に保管操作が終了していない場合には，装置にボリュームDEFを入れることを操作員に要求するメッセージが出されます。

例3:データの保管時の記憶域の解放

SAVLIB   LIB(CUSTDATA)  DEV(TAP01)
         VOL(CUSTNM CUSTAD)  STG(*FREE)

CUSTDATAという名前のライブラリーが，テープ装置TAP01に入れられたボリュームCUSTNMおよびCUSTADに保管されます。CUSTDATAライブラリー内の指定されたメンバー，モジュール，プログラム，サービス・プログラム，SQLパッケージ，およびジャーナル・レシーバーが占めていた記憶域は，それらが保管された後に解放されます。

例4:複数の装置での逐次保管

SAVLIB   LIB(USRLIB)  DEV(TAP01 TAP02 TAP03)
         VOL(USRA USRB USRC USRD)  ENDOPT(*UNLOAD)

USRLIBという名前のライブラリーが3つのテープ装置の4つのテープ・ボリュームに保管されます。USRAという名前のボリュームはTAP01という名前の装置に，USRBという名前のボリュームはTAP02という名前の装置に，USRCという名前のボリュームはTAP03という名前の装置に，およびUSRDという名前のボリュームはTAP01という名前の装置に入れられます。処理が完了した場合には，TAP01という名前の装置をUSRDという名前のボリュームに使用できるように，USRAという名前のボリュームを操作員が巻き戻し，アンロードする必要があります。

例5:複数の装置での並列保管

SAVLIB   LIB(USRLIB)  DEV(*MEDDFN)  MEDDFN(LIBA/MEDDFNA)

USRLIBという名前のライブラリーが，ライブラリーLIBAのMEDDFNAという名前の媒体定義に指定された装置で保管されます。媒体定義の作成および使用については，Information Centerの「バックアップ，回復，および可用性」トピックを参照してください。

例6:媒体ファイル・ラベルを使用したライブラリーの保管

SAVLIB   LIB(LIB1)  DEV(TAP01)  LABEL(MONDAYBACKUP)

このコマンドは，TAP01という名前のテープ装置を使用して，LIB1という名前のライブラリーをテープに保管します。ライブラリーは，MONDAYBACKUPの媒体ファイル・ラベルとともに保管されます。このライブラリーまたはそのいずれかのオブジェクトを復元する場合には，このラベルを指定する必要があります。

例7:保管操作を開始する場所の指定

SAVLIB   LIB(*NONSYS)  DEV(TAP01 TAP02)
         STRLIB(MIKESLIB)  ASPDEV(*SYSBAS)

このコマンドは，システムおよび基本ユーザーASPにあるすべてのライブラリーを，MIKESLIBという名前のライブラリーから順にTAP01およびTAP02という名前のテープ装置で保管します。システム・ライブラリーおよび通常は最初に保管されるライブラリー(QSYS2, QGPL,およびQUSRSYS)は保管されません。

例8:独立ASPグループへのユーザー・ライブラリーの保管

SAVLIB   LIB(*ALLUSR)  DEV(TAP01)  ASPDEV(*CURASPGRP)

このコマンドは，現行スレッド用のASPグループにある独立ASPにすべてのユーザー・ライブラリーを保管します。これは，システムASP (ASP番号1)または基本ユーザーASP(ASP番号2から32)にはライブラリーを保管しません。

例9:スプール・ファイルの保管

SAVLIB   LIB(MYLIB)  DEV(TAP01)  SPLFDTA(*ALL)

このコマンドは，MYLIBという名前のライブラリーを保管します。これにはライブラリー中の出力待ち行列のスプール・ファイル・データが含まれます。

上

エラー・メッセージ

*ESCAPE メッセージ

CPF3701: &1個のオブジェクトが&3から保管されました。&2が保管されていません。
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に損傷がある。
CPF3749: ライブラリー&2からオブジェクトが保管されませんでした。
CPF3751: 保管されなかったライブラリーがある。
CPF3767: 装置&1が見つからない。
CPF3768: 装置&1はコマンドに対して正しくない。
CPF377D: 内部システム資源の読み取りエラーのために保管が終了した。
CPF377E: 活動状態保管の要求に記憶域が不十分である。
CPF377F: 保管が終了しました。チェックポイントに到達できません。
CPF3770: ライブラリー&1について保管または復元されたオブジェクトはない。
CPF3771: &1個のオブジェクトが&3から保管されました。&2が保管されていません。
CPF3777: &1個のライブラリーは保管され，&6個のライブラリーは部分的に保管され，&2個のライブラリーは保管されませんでした。
CPF378A: メッセージ待ち行列が使用できない。
CPF378C: SAVACTMSGQ(*WRKSTN)はバッチ・ジョブでは正しくない。
CPF378E: ライブラリー&1は保管されていない。
CPF3781: ライブラリー&1が見つかりません。
CPF3782: &2のファイル&1は保管ファイルでない。
CPF3785: 終了していないサブシステムがある。
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は保管操作には小さすぎる。
CPF3818: 開始ライブラリー&1が見つからない。
CPF384E: CD-ROMの事前マスター処理にはUSEOPTBLK(*YES)は無効である。
CPF3871: 保管または復元されたオブジェクトはない。&3個のオブジェクトが含まれなかった。
CPF388B: 光ディスク・ファイル・パス名が正しくない。
CPF3892: &3の&2 &1は保管されなかった。
CPF3894: メッセージ&1に対して取り消し応答を受け取った。
CPF38A2: ASP装置&1は正しくありません。
CPF38A3: &2のファイル&1はASPDEVでは無効です。
CPF38A4: ASP装置&1は正しくありません。
CPF38AA: オブジェクト選択リスト・キーが無効です。
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個のオブジェクトが含まれなかった。

上