Save Object (SAV)
The Save (SAV) command saves a copy of one or more objects that can be used in the integrated file system.
For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Restrictions:
- For detailed restrictions on using this command to save objects by using name patterns in the root directory, to save objects in libraries, or to save document library objects, see the Backup and Recovery book, SC41-5304.
| Keyword |
Description |
Choices |
Notes |
| DEV |
Device |
Values (up to 4 repetitions): Path name |
Required, Positional 1 |
| OBJ |
Objects |
Values (up to 300 repetitions): Element list |
Optional, Positional 2 |
| Element 1: Name |
Path name, * |
| Element 2: Include or omit |
*INCLUDE, *OMIT |
| PATTERN |
Name pattern |
Values (up to 300 repetitions): Element list |
Optional |
| Element 1: Pattern |
Character value, * |
| Element 2: Include or omit |
*INCLUDE, *OMIT |
| SUBTREE |
Directory subtree |
*ALL, *DIR, *NONE, *OBJ, *STG |
Optional |
| SAVACT |
Save active |
*NO, *YES, *SYNC |
Optional |
| SAVACTOPT |
Save active option |
*NONE, *ALWCKPWRT |
Optional |
| OUTPUT |
Output |
Path name, *NONE, *PRINT |
Optional |
| VOL |
Volume identifier |
Single values: *MOUNTED
Other values (up to 75 repetitions): Character value |
Optional |
| LABEL |
Label |
Character value, *GEN |
Optional |
| OPTFILE |
Optical file |
Path name, * |
Optional |
| SEQNBR |
Sequence number |
1-16777215, *END |
Optional |
| EXPDATE |
File expiration date |
Date, *PERM |
Optional |
| ENDOPT |
End of media option |
*REWIND, *LEAVE, *UNLOAD |
Optional |
| USEOPTBLK |
Use optimum block |
*YES, *NO |
Optional |
| SAVACTMSGQ |
Save active message queue |
Path name, *NONE, *WRKSTN |
Optional |
| INFTYPE |
Type of output information |
*ALL, *ERR, *SUMMARY |
Optional |
| SYSTEM |
System |
*ALL, *LCL, *RMT |
Optional |
| CHGPERIOD |
Time period for last change |
Element list |
Optional |
| Element 1: Start date |
Date, *ALL, *LASTSAVE |
| Element 2: Start time |
Time, *ALL |
| Element 3: End date |
Date, *ALL |
| Element 4: End time |
Time, *ALL |
| PRECHK |
Object pre-check |
*NO, *YES |
Optional |
| TGTRLS |
Target release |
*CURRENT, *PRV, V5R2M0, V5R3M0, V5R4M0 |
Optional |
| UPDHST |
Update history |
Single values: *NO, *YES
Other values (up to 2 repetitions): *SYS, *PC |
Optional |
| CLEAR |
Clear |
*NONE, *ALL, *AFTER, *REPLACE |
Optional |
| DTACPR |
Data compression |
*YES, *NO, *DEV, *LOW, *MEDIUM, *HIGH |
Optional |
| COMPACT |
Data compaction |
*DEV, *NO |
Optional |
| ASPDEV |
ASP device |
Name, *DFT, *ALLAVL, *, *SYSBAS, *CURASPGRP |
Optional |
| SCAN |
Scan objects |
Element list |
Optional |
| Element 1: Scan during save |
*NO, *YES |
| Element 2: Save failed objects |
*NOSAVFAILED, *SAVFAILED |
Device (DEV)
Specifies the device to which the objects are to be saved.
For more information on specifying device path names, refer to "Specifying the device name" in the Backup and Recovery information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
This is a required parameter.
- 'save-file-path-name'
- Specify the path name of the save file used to save the objects.
- 'optical-device-path-name'
- Specify the path name of the optical device used to save the objects.
- 'tape-media-library-device-path-name'
- Specify the path name of the tape media library device used to save the objects.
- 'tape-device-path-name'
- Specify the path name of the tape device used to save the objects. A maximum of four tape devices can be specified. If a virtual tape device is used, it must be the only device specified.
- 'media-definition-path-name'
- Specify the path name of the media definition (*MEDDFN) object that identifies the devices and media used to contain the saved data.
For information about creating a media definition, see the Create Media Definition API in the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
For information about using a media definition, see the Backup and Recovery book, SC41-5304 and the Backup Your Server topic topic in the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Objects (OBJ)
Specifies the objects to be saved. You can specify an object name pattern for the path name to be used. When a path name is specified that could match many objects, you can specify a value for the Name pattern (PATTERN) parameter to subset the objects that are to be saved.
A maximum of 300 path names can be specified.
For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Additional information about object name patterns is in the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Element 1: Name
- '*'
- The objects in the current directory are saved.
- path-name
- Specify an object path name or a pattern that can match many names.
Element 2: Include or omit
Specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory.
Note: The SUBTREE parameter determines whether the subtrees are included or omitted.
- *INCLUDE
- The objects that match the object name pattern are to be saved, unless overridden by an *OMIT specification.
- *OMIT
- The objects that match the object name pattern are not saved. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
Name pattern (PATTERN)
Specifies one or more object name patterns to be used to subset the objects to be saved. The Objects (OBJ) parameter defines the set of candidate objects. A maximum of 300 values can be specified for this parameter.
Element 1: Pattern
- *
- All objects which qualify for the operation are included or omitted.
- character-value
- Specify an object name or a pattern that can match many names.
Element 2: Include or omit
Specifies whether names that match the pattern should be included or omitted from the operation.
Note: The SUBTREE parameter determines whether the subtrees are included or omitted.
- *INCLUDE
- Only objects which are included by the OBJ parameter and match the PATTERN parameter are included in the save, unless overridden by an *OMIT specification.
- *OMIT
- All objects which are included by the OBJ parameter are included in the save except those objects which match the PATTERN parameter. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
Directory subtree (SUBTREE)
Specifies whether directory subtrees are included in the save operation.
- *ALL
- The entire subtree of each directory that matches the object name pattern is included. The subtree includes all subdirectories and the objects within those subdirectories.
- *DIR
- The objects in the first level of each directory that matches the object name pattern are included. The subdirectories of each matching directory are included, but the objects in the subdirectories are not included.
- *NONE
- No subtrees are included in the save operation. If a directory matches the object name pattern specified, the objects in the directory are included. If the directory has subdirectories, neither the subdirectories nor the objects in the subdirectories are included.
- *OBJ
- Only the objects that exactly match the object name pattern will be processed. If the object name pattern specifies a directory, objects in the directory are not included.
- *STG
- The objects that match the object name pattern are processed along with the storage for related objects. Objects that are saved using this value can only be restored using SUBTREE(*STG).
Save active (SAVACT)
Specifies whether an object can be updated while it is being saved.
Note: If your system is in a restricted state, this parameter is ignored and the save operation is performed as if SAVACT(*NO) was specified.
- *NO
- Objects that are in use are not saved. Objects cannot be updated while being saved.
- *YES
- Objects can be saved and used at the same time. The object checkpoints can occur at different times.
- *SYNC
- Objects can be saved and used at the same time. All of the object checkpoints occur at the same time.
Save active option (SAVACTOPT)
Specifies options to be used with the save while active parameter.
- *NONE
- No special save while active options will be used.
- *ALWCKPWRT
- Enables objects to be saved while they are being updated if the corresponding system attribute for the object is set.
Note: This option should only be used by applications to save objects that are associated with the application and that have additional backup and recovery considerations. For more information, refer to the Backup and Recovery information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Output (OUTPUT)
Specifies whether a list of information about the saved objects is created. The information can be directed to a spooled file, a stream file, or a user space.
A stream file or user space is specified as a path name.
For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
- *NONE
- No output is created.
- *PRINT
- The output is printed with the job's spooled output.
- 'stream-file-path-name'
- Specify the path name of the existing stream file to which the output of the command is directed.
- 'user-space-path-name'
- Specify the path name of the existing user space to which the output of the command is directed.
Volume identifier (VOL)
Specifies the volume identifiers of the volumes, or the cartridge identifiers of tapes in a tape media library device, on which the data is saved. The volumes must be placed in the device in the same order as specified for this parameter.
A maximum of 75 volume identifiers can be specified. After all specified volumes are filled, the save operation continues on whatever volumes are placed in the device.
Single values
- *MOUNTED
- The data is saved on the volumes placed in the device. For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command.
Note: This value cannot be specified when using an optical media library device.
Other values (up to 75 repetitions)
- character-value
- Specify the identifiers of one or more volumes in the order in which they are placed in a device and used to save the data.
Label (LABEL)
Specifies the file identifier of the media to be used for the save operation.
- *GEN
- The file label is created by the system.
- For objects in libraries, this is the equivalent of LABEL(*LIB) on the Save Object (SAVOBJ) and Save Library (SAVLIB) commands.
- For document library objects, this is the equivalent of LABEL(*GEN) on the Save Document Library Object (SAVDLO) command.
- For objects in other file systems, the label is SAVyyyymmdd.
- character-value
- Specify the identifier (up to 17 characters) of the tape file used for the save operation.
Optical file (OPTFILE)
Specifies the path name of the optical file that is used for the save operation, beginning with the root directory of the volume.
For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
- *
- The system generates an optical file name in the root directory of the optical volume.
- 'optical-directory-path-name/*'
- The system generates an optical file name in the specified directory of the optical volume.
- 'optical-file-path-name'
- Specify the path name of the optical file.
Sequence number (SEQNBR)
Specifies, when tape is used, the sequence number to use as the starting point for the save operation.
- *END
- The save operation begins after the last sequence number on the first tape. If the first tape is full, an error message is issued and the operation ends.
- 1-16777215
- Specify the sequence number of the file to be used for the save operation.
File expiration date (EXPDATE)
Specifies the expiration date of the file created by the save operation. If a date is specified, the file is protected and cannot be overwritten until the specified expiration date.
Notes:
- This parameter is valid for tape and optical files.
- Specifying this parameter does not protect against a later save operation specifying CLEAR(*ALL).
- *PERM
- The file is protected permanently.
- date
- Specify the date when protection for the file ends.
End of media option (ENDOPT)
Specifies the operation that is automatically done on the tape or optical volume after the save operation ends. If more than one volume is used, this parameter applies only to the last volume used; all other volumes are unloaded when the end of the volume is reached.
Note: This parameter is valid only if a tape or optical device name is specified for the DEV parameter. For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.
- *REWIND
- The tape is automatically rewound, but not unloaded, after the operation has ended.
- *LEAVE
- The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
- *UNLOAD
- The tape is automatically rewound and unloaded after the operation ends. Some optical devices will eject the volume after the operation ends.
Use optimum block (USEOPTBLK)
Specifies whether or not the optimum block size is used for the save operation.
Note: Specifying USEOPTBLK(*YES) may result in a tape that can be duplicated only to a device that supports the same block size.
- *YES
- The optimum block size supported by the device is used for Save commands. If the block size that is used is larger than a block size that is supported by all device types, then:
- Performance may improve.
- The tape file that is created is only compatible with a device that supports the block size used. Commands such as Duplicate Tape (DUPTAP) do not duplicate files unless the files are being duplicated to a device which supports the same block size that was used.
- The value for the DTACPR parameter is ignored.
- *NO
- The optimum block size supported by the device is not used. Save commands use the default block size supported by all device types. The tape volume can be duplicated to any media format using the Duplicate Tape (DUPTAP) command.
Save active message queue (SAVACTMSGQ)
Specifies the message queue that the save operation uses to notify the user that the checkpoint processing is complete.
For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
- *NONE
- No notification message is sent.
- *WRKSTN
- The notification message is sent to the work station message queue.
- path-name
- Specify the path name of the message queue to be used.
Type of output information (INFTYPE)
Specifies the type of information that is directed to the spooled file, stream file, or user space.
- *ALL
- The file will contain information about the command, an entry for each directory, an entry for each object that was successfully saved, and an entry for each object that was not successfully saved.
- *ERR
- The file will contain information about the command, an entry for each directory, and an entry for each object that was not successfully saved.
- *SUMMARY
- The file will contain information about the command, and an entry for each directory.
System (SYSTEM)
Specifies whether to process objects that exist on the local system or remote systems.
- *LCL
- Only local objects are processed.
- *RMT
- Only remote objects are processed.
- *ALL
- Both local and remote objects are processed.
Time period for last change (CHGPERIOD)
Specifies a date/time range. Objects that were last changed within that range will be saved.
Element 1: Start date
- *ALL
- No starting date is specified. All objects last changed prior to the ending date will be saved.
- *LASTSAVE
- The objects that have changed since the last time they were saved with UPDHST(*YES) specified are saved. Notes:
- If this value is specified, the value *ALL must be specified for all other elements of this parameter.
- For local file systems, the system archive attribute is used. For remote file systems, the PC archive attribute is used.
- date
- Specify the date after which objects that have changed are to be saved. The date must be specified in job date format.
Element 2: Start time
- *ALL
- All times of day are included in the range.
- time
- Specify the time on the start date after which objects that have changed are to be saved.
- The time is specified in 24-hour format with or without a time separator as follows:
- With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
- Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.
Note: Specifying an explicit time is valid only if the starting date is an explicit date.
Element 3: End date
- *ALL
- No ending date is specified. All objects changed since the starting date will be saved.
- date
- Specify the date before which objects that have changed are to be saved. The date must be specified in the job date format.
Element 4: End time
- *ALL
- All times of day are included in the range.
- time
- Specify a time on the end date before which objects that have changed are to be saved.
- The time is specified in 24-hour format with or without a time separator as follows:
- With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
- Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.
Note: Specifying an explicit time is valid only if the ending date is an explicit date.
Object pre-check (PRECHK)
Specifies whether the save operation ends if any of the selected objects cannot be saved.
- *NO
- The save operation does not end. Objects that can be saved are saved.
- *YES
- The save operation ends. Nothing is saved unless all of the selected objects can be saved.
Target release (TGTRLS)
Specifies the release level of the operating system on which you intend to use the object being saved.
When specifying the target-release value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R3M0 is version 5, release 3, modification 0.
Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.
- *CURRENT
- The object is to be restored to, and used on, the release of the operating system currently running on your system. The object can also be restored to a system with any subsequent release of the operating system installed.
- *PRV
- The object is to be restored to the previous release with modification level 0 of the operating system. The object can also be restored to a system with any subsequent release of the operating system installed.
- character-value
- Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.
Update history (UPDHST)
Specifies whether to update the save history on the objects saved with this save operation. The save history information is used when CHGPERIOD(*LASTSAVE) is specified on a later save operation.
Single values
- *NO
- This save operation will not be updated in the save history of the selected objects.
- *YES
- The save history is updated. For local file systems, the system save history is updated. For remote file systems, the PC save history is updated.
Other values (up to 2 repetitions)
- *SYS
- The system save history is updated.
- *PC
- The PC save history is updated.
Clear (CLEAR)
Specifies whether active data on the media is automatically cleared or replaced. Active data is any file on the media that has not expired. For saves to tape, clearing active data will make any files on the tape volume beyond the last file written by the save operation no longer accessible. For saves to optical, the files written by the save operation can be automatically replaced while other files on the volume remain active, or all active files can be automatically cleared. Clearing does not erase the data, it just makes the files no longer accessible.
Notes:
- Clearing a tape does not initialize it. You should initialize tapes to a standard label format before the save command is issued by using the Initialize Tape (INZTAP) command and specifying a value for the NEWVOL parameter.
- Clearing an optical volume does initialize it.
- If a volume that is not initialized is encountered during the save operation, an inquiry message is sent and an operator can initialize the volume.
- *NONE
- None of the media is automatically cleared. If the save operation encounters active data on a tape volume or in a save file, an inquiry message is sent, allowing the operator to either end the save operation or clear the media. If the save operation encounters the specified optical file, an inquiry message is sent, allowing the operator to either end the save operation or replace the file.
- *ALL
- All of the media is automatically cleared.
If tapes are used and a sequence number is specified for the SEQNBR parameter, the first tape is cleared beginning at that sequence number. All tapes following that first tape are completely cleared. To clear the entire first tape, SEQNBR(1) must be specified.
- *AFTER
- All media after the first volume is automatically cleared. If the save operation encounters active data on the first tape volume, an inquiry message is sent, allowing the operator to either end the save operation or clear the media. If the save operation encounters the specified optical file on the first volume, an inquiry message is sent, allowing the operator to either end the save operation or replace the file.
-
Note: The *AFTER value is not valid for save files.
- *REPLACE
- Active data on the media is automatically replaced. Optical volumes are not initialized. Other media is automatically cleared in the same way as the *ALL value.
Data compression (DTACPR)
Specifies whether data compression is used. If the save is running while other jobs on the system are active and software compression is used, the overall system performance may be affected.
Note: If *DEV is specified for both this parameter and the Data compaction (COMPACT) parameter, only device data compaction is performed if device data compaction is supported on the device. Otherwise, data compression is performed.
If *YES is specified for this parameter and *DEV is specified for the COMPACT parameter, both device data compaction and device data compression are performed if supported on the device.
- *DEV
- If the save is to tape and the target device supports compression, hardware compression is performed. Otherwise, no data compression is performed.
- *NO
- No data compression is performed.
- *YES
- If the save is to tape and the target device supports compression, hardware compression is performed. If compression is not supported, or if the save data is written to optical media or to a save file, software compression is performed. Low software compression is used for all devices except optical DVD, which uses medium software compression.
- *LOW
- If the save operation is to a save file or optical, software data compression is performed with the SNA algorithm. Low compression is usually faster and the compressed data is usually larger than if medium or high compression is used.
Note: This value is not valid for tape.
- *MEDIUM
- If the save operation is to a save file or optical, software data compression is performed with the TERSE algorithm. Medium compression is usually slower than low compression but faster than high compression. The compressed data is usually smaller than if low compression is used and larger than if high compression is used.
Note: This value is not valid for tape.
- *HIGH
- If the save operation is to a save file or optical, software data compression is performed with the LZ1 algorithm. High compression is usually slower and the compressed data is usually smaller than if low or medium compression is used.
Note: This value is not valid for tape.
Data compaction (COMPACT)
Specifies whether device data compaction is performed.
- *DEV
- Device data compaction is performed if the data is saved to tape and all tape devices specified for the Device (DEV) parameter support the compaction feature.
Note: If *DEV is specified for both the Data compression (DTACPR) parameter and this parameter, only device data compaction is performed if device data compaction is supported on the device. Otherwise, data compression is performed if supported on the device.
If *YES is specified for the DTACPR parameter and *DEV is specified for this parameter, both device data compaction and device data compression are performed if supported on the device.
- *NO
- Device data compaction is not performed.
ASP device (ASPDEV)
Specifies the auxiliary storage pool (ASP) device to be included in the save operation.
- *DFT
- The operation uses the ASPDEV value appropriate for the file system from which objects are being saved. For Integrated File System objects, *ALLAVL is used. For objects from the QSYS file system, the corresponding save command ASPDEV default is used.
- *ALLAVL
- The operation includes the system ASP (ASP number 1), all basic user ASPs (ASP numbers 2-32), and all available independent ASPs.
- *
- The operation includes the system ASP, all basic user ASPs, and, if the current thread has an ASP group, all independent ASPs in the ASP group.
- *SYSBAS
- The system ASP and all basic user ASPs are included in the save operation.
- *CURASPGRP
- If the current thread has an ASP group, all independent ASPs in the ASP group are included in the save operation.
- name
- Specify the name of the ASP device to be included in the save operation.
Scan objects (SCAN)
Specifies whether objects will be scanned while being saved when exit programs are registered with any of the integrated file system scan-related exit points and whether objects that previously failed a scan should be saved.
The integrated file system scan-related exit points are:
- QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
- QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program
For details on these exit points, see the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Element 1: Scan during save
- *NO
- Objects will not be scanned by the scan-related exit programs.
- *YES
- Objects will be scanned according to the rules described in the scan-related exit programs.
Element 2: Save failed objects
- *NOSAVFAILED
- Objects that have either previously failed a scan or that fail a scan by a QIBM_QP0L_SCAN_OPEN exit program during this save will not be saved.
- *SAVFAILED
- Objects that have either previously failed a scan or that fail a scan during this save will be saved.
Example 1: Saving All Data Not in Libraries and Not Document Library Objects
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
This command saves all objects that are not in libraries and are not document library objects.
Example 2: Saving Changes Since the Last Time the Objects Were Saved
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
CHGPERIOD(*LASTSAVE)
This command saves all objects that are not in libraries, that are not document library objects, and that have changed since the last time they were saved with UPDHST(*YES) specified.
Example 3: Saving Data That Has Not Changed Since 1999
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
CHGPERIOD((*ALL *ALL '12/31/99'))
This command saves all objects that are not in libraries, that are not document library objects, and that have not changed since December 31, 1999.
Example 4: Saving All Objects in the Current Directory
SAV DEV('/QSYS.LIB/TAP01.DEVD')
This command uses the default value '*' on the OBJ parameter to save all objects in the current directory and its subdirectories. This example is not valid if the current directory is the root directory or if the current directory is in the QDLS file system.
SAV DEV('/QSYS.LIB/TAP01.DEVD') OBJ('*') SUBTREE(*NONE)
This command saves all objects in the current directory but not in the subdirectories.
Example 5: Omitting Objects During a Save Operation
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ(('*') ('**.BACKUP' *OMIT) ('**.TEMP' *OMIT))
This command saves all objects in the current directory except those with extensions of .BACKUP and .TEMP (the entire subtrees of directories with these extensions are omitted).
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ(('/A') ('/A/B/C' *OMIT))
This command saves all objects in directory /A and its subdirectories, except those in directory /A/B/C.
Example 6: Saving a Library
SAV DEV('/QSYS.LIB/TAP01.DEVD') OBJ('/QSYS.LIB/A.LIB')
This command saves library A on the tape device named TAP01.
Example 7: Saving Two Libraries
SAV DEV('/QSYS.LIB/TAP01.DEVD') OBJ('/QSYS.LIB/A.LIB')
SAV DEV('/QSYS.LIB/TAP01.DEVD') OBJ('/QSYS.LIB/B.LIB')
These two commands save two libraries. The first command saves library A and the second command saves library B.
Example 8: Saving All Files in a Library
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ('/QSYS.LIB/MYLIB.LIB/*.FILE')
This command saves all files in the library MYLIB on the tape device named TAP01.
Example 9: Saving Two Objects in a Library
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ('/QSYS.LIB/MYLIB.LIB/MYPGM.PGM')
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ('/QSYS.LIB/MYLIB.LIB/MYFILE.FILE')
These two commands save two objects in the same library. This first command saves the program MYPGM from library MYLIB. The second command saves the file MYFILE from library MYLIB.
Example 10: Saving a Stream File, a Database File, and a Document
SAV DEV('/QSYS.LIB/TAP01.DEVD') OBJ('/MyDir/MyFile')
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ('/QSYS.LIB/MYLIB.LIB/MYFILE.FILE')
SAV DEV('/QSYS.LIB/TAP01.DEVD')
OBJ('/QDLS/MYFLR/MYDOC') SUBTREE(*OBJ) UPDHST(*YES)
Three commands are used in this example to save three objects. The first command saves the stream file MyFile in the directory MyDir on the tape device named TAP01. The second command saves the database file MYFILE in the library named MYLIB on the tape device named TAP01. The third command saves the document MYDOC in a folder named MYFLR on the tape device named TAP01.
Example 11: Saving to a Save File
SAV DEV('/QSYS.LIB/MYLIB.LIB/MYSAVF.FILE') OBJ(MYDIR)
This command saves the directory MYDIR to a save file named MYSAVF.
Example 12: Using Symbolic Links for the Save Operation
SAV DEV('DevLink')
OBJ(('DirLink') ('FileLink') ('DirLink/*'))
SAVACT(*YES) SAVACTMSGQ('MsgqLink')
This command assumes that the current directory contains the following symbolic links:
- DevLink = /QSYS.LIB/TAP01.DEVD
- DirLink = /SomeDirectory
- FileLink = /SomeDirectory/SomeFile
- MsgqLink = /QSYS.LIB/LIB1.LIB/MSGQ1.MSGQ
This command saves the names associated with DirLink and FileLink, and the objects in SomeDirectory, to device TAP01. A message is sent when the save-while-active checkpoint is complete.
Symbolic links can be used to specify a device, a save-while-active message queue, and an output file. When symbolic links are specified to be saved, only the names of the associated objects are saved, not the content of the associated objects. A symbolic link to a directory can be used to save objects in the directory. Additional information about symbolic links is in the Integrated file system topic in the File systems and management category of the Information Center.
*ESCAPE Messages
- CPFA0DB
- Object not a QSYS.LIB object. Object is &1.
- CPFA0DC
- Object not a QDLS object. Object is &1.
- CPF3708
- Save file &1 in &2 too small.
- CPF3727
- Duplicate device &1 specified on device name list.
- CPF3735
- Storage limit exceeded for user profile &1.
- CPF3738
- Device &1 used for save or restore is damaged.
- CPF3768
- Device &1 not valid for command.
- CPF377D
- Save ended because of read error on internal system resource.
- CPF377E
- Not enough storage for save-while-active request.
- CPF378A
- Message queue not available.
- CPF378C
- SAVACTMSGQ(*WRKSTN) not valid for batch job.
- CPF3782
- File &1 in &2 not a save file.
- CPF3794
- Save or restore operation ended unsuccessfully.
- CPF380D
- Save or restore of entire system completed unsuccessfully.
- CPF3808
- Save file &2 in &3 not complete.
- CPF381D
- Values on CHGPERIOD parameter not valid.
- CPF3812
- Save file &1 in &2 in use.
- CPF382B
- Parameters not valid with multiple file systems.
- CPF382C
- OBJ parameter value not valid for QSYS file system.
- CPF382E
- Specified parameter not valid for QDLS file system.
- CPF382F
- OBJ parameter value not valid for QDLS file system.
- CPF3823
- No objects saved or restored.
- CPF3826
- *INCLUDE object required on OBJ parameter.
- CPF3828
- Error occurred while attempting to use &1.
- CPF3829
- Specified parameter not valid for QSYS file system.
- CPF383A
- Save or restore ended unsuccessfully.
- CPF383B
- End of file &1.
- CPF383D
- Cannot use &1.
- CPF3833
- Specified value on DEV parameter not valid.
- CPF3834
- Too many values specified on the DEV parameter.
- CPF3835
- Tape devices do not support same densities.
- CPF3837
- &1 objects saved. &2 not saved.
- CPF3838
- &1 objects saved. &2 objects not saved.
- CPF384A
- Volume identifier &1 not valid.
- CPF384B
- Optical file specified not valid.
- CPF384C
- Error occurred during CCSID conversion.
- CPF384E
- USEOPTBLK(*YES) not valid for CD-ROM premastering.
- CPF386B
- Not able to save &1.
- CPF386C
- Not able to save &1.
- CPF3894
- Cancel reply received for message &1.
- CPF38A5
- Error on the PATTERN parameter.
- CPF5729
- Not able to allocate object &1.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9825
- Not authorized to device &1.