Start Save Synchronization (STRSAVSYNC)

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

The Start Save Synchronization (STRSAVSYNC) command starts a synchronized checkpoint for more than one save while active operation. This allows you to save objects in one or more libraries and objects in one or more directories and have all the objects reach a checkpoint together.

Restrictions:

Top

Parameters

Keyword Description Choices Notes
SYNCID Synchronization ID Name Required, Positional 1
NUMSYNC Number of operations 2-32, 2 Optional
STRSAVWAIT Start save wait time 1-99999, 600, *NOMAX Optional
Top

Synchronization ID (SYNCID)

Specifies the name of the synchronized checkpoint. This name must also be specified for the Synchronization ID (SYNCID) parameter for each of the participating save operations.

name
Specify the name of the synchronized checkpoint.
Top

Number of operations (NUMSYNC)

Specifies the number of save while active operations that will participate in the synchronized checkpoint. All of the participating save operations must start within the amount of time specified for the Start save wait time (STRSAVWAIT) parameter.

2
Two save while active operations will participate in the synchronized checkpoint.
2-32
Specify the number of save while active operations that will participate in the synchronized checkpoint.
Top

Start save wait time (STRSAVWAIT)

Specifies the amount of time to wait for all of the participating save operations to be started. If the number of participating save operations specified for the Number of operations (NUMSYNC) parameter do not start within the specified time, any operations that do start within that time will be ended.

600
The system waits up to 600 seconds for all of the participating save operations to begin.
*NOMAX
There is no maximum wait time.
1-99999
Specify the number of seconds to wait for all of the participating save operations to begin.
Top

Examples

STRSAVSYNC   SYNCID(SYNCMYDATA)  NUMSYNC(2)
SBMJOB   CMD(SAVLIB   LIB(MYLIB)  DEV(TAP01)
             SAVACT(*SYNCLIB)  SYNCID(SYNCMYDATA))
SBMJOB   CMD(SAV   DEV('/QSYS.LIB/TAP02.DEVD')  OBJ(('/MYDIR'))
             SAVACT(*SYNC)  SYNCID(SYNCMYDATA))

This example shows a way to synchronize the checkpointed data when saving a library and a directory. The STRSAVSYNC command starts a synchronized checkpoint named SYNCMYDATA in which two save while active operations will participate. Then the two participating save operations are submitted for batch processing. The first submitted operation saves library MYLIB to device TAP01. The second submitted operation saves directory MYDIR to device TAP02. Each participating save operation specifies the appropriate SAVACT value for full synchronization of all the data that it saves, and also specifies the synchronization ID SYNCMYDATA.

Top

Error messages

*ESCAPE Messages

CPF37BB
Synchronization ID &1 already started.
CPF37C4
Service &1 with protocol &2 not found.
CPF37C6
A communication error occurred.
Top