IBM Support

Save-while-active Backup Does Not Wait the Time Specified in the Parameter 'Save active wait time'

Troubleshooting


Problem

This document explains why the checkpoint process may not honor the 'Save active wait time' parameter when there are multiple save operations occurring on the system for the same objects.

Resolving The Problem

This document explains why the checkpoint process may not honor the 'Save active wait time' parameter when there are multiple save operations occurring on the system for the same objects.

The Save-While-Active (SWA) backup starts to save objects immediately after the backup starts even though the process encounters locked objects and has not waited the indicated amount of time specified on the 'Save active wait time' parameter (SAVACTWAIT).

One of the following messages are posted in the joblog immediately after the start of the backup:

CPI3724 - The save-while-active operation has now locked the objects in 0 libraries.
CPF3761 - Cannot use &2 &1 in &3.
CPI3710 - Save-while-active checkpoint processing for library &1 complete.

This scenario will occur if there is another job that is performing a backup on the same objects.

This is working as designed. The object locks obtained by save operations do not conflict with each other, so multiple save operations can each obtain object locks. The additional check for concurrent save operations is immediate so the immediate time-out on the objects is what would be expected if those objects were being saved or restored in another job.

Here are some suggested alternatives to obtain a successful backup:
1. If mirroring software is being used and is the other job performing the save of these objects, quiesce the mirroring software activity during the backup.
2. Allocate the objects before the backup with an *EXCLRD lock that will conflict with other save operations. Specify the desired wait time on the ALCOBJ command. You should remember to deallocate the objects after backup. If BRMS is being used for the backup, this recommendation can be performed by adding an EXIT in the control group before and after the backup item to be saved. A program can also be created to perform this step and execute the backup.
Note: The parameter 'Save active wait time' specifies the amount of time to wait for an object that is in use or to wait for transactions with pending changes to reach a commit boundary before continuing the save operation.

This issue can be encountered when running save-while-active backups with BRMS or with native commands.

 

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000C4BAAU","label":"IBM i"},{"code":"a8m0z000000cwp6AAA","label":"Save Restore"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Historical Number

620635554

Document Information

More support for:
IBM i

Component:
IBM i, Save Restore

Software version:
All Versions

Operating system(s):
IBM i

Document number:
684875

Modified date:
29 March 2025

UID

nas8N1011237

Manage My Notification Subscriptions