Save Object (SAV)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

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:

Top

 

Parameters

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

Top

 

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.

Top

 

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.

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.

Top

 

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.

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.

Top

 

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).

Top

 

Save active (SAVACT)

Specifies whether an object can be updated while it is being saved.

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.

Top

 

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.

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.

Top

 

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.

Top

 

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.

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.

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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:

  1. This parameter is valid for tape and optical files.

  2. 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.

Top

 

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.

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.

Top

 

Use optimum block (USEOPTBLK)

Specifies whether or not the optimum block size is used for the save operation.

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.

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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:

  1. If this value is specified, the value *ALL must be specified for all other elements of this parameter.

  2. 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.

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.

Specifying an explicit time is valid only if the ending date is an explicit date.

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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:

  1. 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.

  2. Clearing an optical volume does initialize it.

  3. 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.

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.

Top

 

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.

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.

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.

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.

This value is not valid for tape.

Top

 

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.

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.

Top

 

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.

Top

 

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:

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.

Top

 

Examples

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:

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.

Top

 

Error messages

*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.

Top