XADVANCE—Updating secondary volumes

You can issue the XADVANCE command to both coupled and noncoupled sessions.

The XADVANCE command differs from the XRECOVER command in that it obtains a consistent set of secondary volumes without updating the secondary volume VOLSERs. This makes it easier for you to create a time-consistent backup of the secondary volumes before restarting XRC and resynchronizing volumes.

The XADVANCE command requires all volumes in the session to be suspended. It may be used with an active or an inactive session. You cannot use this command when the session is active on another system, or if the session has any nonsuspended volumes. The XADVANCE command does not apply any data to volumes that were suspended because of a command, or that were suspended because of errors that occurred before the last consistency group.

If an error occurs while writing to a secondary volume that results in all volumes being suspended, that volume is suspended at a different consistency time than the other volumes in the session. To resolve the time discrepancy, correct the error on the secondary volume, and issue the XADVANCE command to update that volume to the same consistency time as other volumes in the session.

Use the XADVANCE TSO command to update secondary volumes of a session to a time that is consistent with the volumes of other sessions that are coupled to the master session. The XADVANCE command applies secondary volume updates to the minimum master journal time or the pending master command time. This is the same time to which an XRECOVER command would recover the session.

If RACF® facility class protection is being used for XRC, the XADVANCE command should be added to the resource profile using the procedure documented for existing XRC commands. The XADVANCE command must also be defined as an authorized TSO command.

The XADVANCE command produces an XQUERY report that displays YES in the ADV column to indicate each volume in the session that was eligible to have updates applied. A NO in the column indicates that the volume was not eligible to have updates applied. The report also displays NO for volumes that have not reached duplex, that were suspended through a command, or that were suspended at a time before the consistency time that exists as of the beginning of the XADVANCE operation.

Issuing an XADVANCE command to a master session automatically generates an XQUERY MASTER report for the coupled sessions.

See Example: resuming operations after a sympathetic suspension for a scenario that uses XADVANCE to resume XRC operations after a sympathetic suspension caused by an error.