Specifies that XRC delete the specified volume pairs after applying
all updates, up to the specified time, to the secondary volumes.
XRC
will not apply any updates beyond the specified Universal Time Coordinated
(UTC) timestamp to the secondary volumes. All affected secondary volumes
are consistent up to the UTC timestamp that is reported on successful
completion of the command.
You can issue another XDELPAIR command
to change the ATTIME value to either earlier than or later than a
previously specified time. The command fails if the specified ATTIME
value is earlier than the consistency group time that XRC is currently
processing. If you issue multiple commands to a single volume pair,
XRC always uses the last valid ATTIME value that you specified with
this command.
Note: You cannot issue an XDELPAIR command
with the ATTIME parameter to delete a volume that is in the suspended
state. You can only delete suspended volumes with an XDELPAIR IMMEDIATE
command or an XEND command.
If all volume pairs
are deleted or suspended (because of an error or by command) before
the time specified on the ATTIME expires, XRC cancels the XDELPAIR
command and clears the ATTIME timestamp.
The system data mover
(SDM) does not process record updates for the deleted volume that
are received in the storage control after the specified time. Record
updates in the journal data set that are associated with the deleted
volume are discarded and are not available for a subsequent recovery.
The storage control continues to record updates to other primary volumes.
The SDM then processes these updates.
Specifying the ATTIME
parameter with VOLUME(
primary_volser) results
in the following:
- If the specified volser is a fixed utility device, the command
is rejected, with return code 4082.
- If the specified volser is not a fixed utility device, it is deleted
based on the time specified on the ATTIME parameter.
If more than one volser is specified, and one of the volsers
is for a fixed utility device, the command is rejected. If the list
of volsers does not include a fixed utility device, XRC will delete
each volume in the list based on the time specified on the ATTIME
parameter. (The list of volsers can be across multiple storage controls
sessions.)
- Reads the record updates from the cache on all storage controls
and obtains the timestamp of the last update for each storage control
session.
- Determines the most recent timestamp.
- Processes the XDELPAIR command when all records, up to and including
the most recent timestamp, have been applied to the secondary volumes
that are being deleted from the session.
Note: You cannot issue an XDELPAIR command with the
DRAIN parameter to delete a volume that is in the suspended state.
You can only delete suspended volumes with an XDELPAIR IMMEDIATE command
or an XEND command.
If all volume pairs are deleted
or suspended (because of an error or by command) before XRC can drain
all updates from the primary storage control, XRC cancels the XDELPAIR(DRAIN)
command.
Specifying the DRAIN parameter with VOLUME(
primary_volser) results in the following:
- If the specified volser is a fixed utility device, the command
is rejected, with return code 4082.
- If the specified volser is not a fixed utility device, it is deleted
after all updates from the storage control cache have been applied
to the secondary volumes.
If more than one volser is specified, and one of the volsers
is for a fixed utility device, the command is rejected. If the list
of volsers does not include a fixed utility device, XRC will delete
each volume in the list after all updates from the storage control
cache have been applied to the secondary volumes. (The list of volsers
can be across multiple storage controls sessions.)