- IMMEDIATE
- Specifies that XRC immediately ends the active session. XRC
stops updates to the secondary volumes of active pairs once the current
consistency group has been applied. Secondary volumes are consistent
up to the UTC timestamp that is reported on the successful completion
of the command. IMMEDIATE is the default.
- ATTIME
- Specifies that XRC end the specified XRC session after applying
all updates, up to the time that is specified, to the secondary volumes.
XRC will not apply updates to the secondary volumes beyond the specified
universal time coordinated (UTC) timestamp.
When XRC encounters
a record update that has a timestamp later than the time specified,
XRC ends the session. All affected secondary volumes are consistent
up to the UTC timestamp that is reported on successful completion
of the command.
You can issue another XEND command to change
the ATTIME value to either earlier than or later than a previously
specified time. XRC issues a message that indicates when it has accepted
a new ATTIME value. The command fails if the specified ATTIME value
is earlier than the consistency group time that XRC is currently processing.
If you issue multiple XEND ATTIME commands, XRC always uses the last
valid ATTIME value that is specified.
If all volume pairs become
deleted or suspended (either due to an error, or by command) prior
to the specified ATTIME, XRC cancels the XEND command and clears the
ATTIME timestamp.
- DRAIN
- Specifies that XRC:
- Read the record updates from all storage control caches and obtain
the timestamp of the last update for each storage control session.
- Determine the most recent timestamp.
- Perform the XEND command when XRC has applied all records, up
to and including the most recent timestamp, to the secondary volumes.
The DRAIN parameter supports operations such as migration,
where applications are quiesced prior to issuing the DRAIN request.
This parameter allows you to quiesce application program updates to
the primary volumes and ensures that all updates have been applied
to the secondary volumes before the session is ended.
If non-timestamped
record updates exist in a storage control, the DRAIN function ensures
that all updates in the storage control at the time the command was
issued have been successfully applied to the secondary volume or volumes
before the command is performed.
If all volume pairs become
deleted or suspended (either due to an error, or by command) before
XRC can drain all updates from the primary storage control, XRC cancels
the XEND(DRAIN) command.
- CANCEL
- Specifies that XRC cancel the previous XEND command that was
issued with an ATTIME or DRAIN request specified. If a pending XEND
command was originally issued using the name of the master session,
you cannot issue the CANCEL option for that command using the name
for the local session.
- NOVERIFY
- Specifies that XRC not issue message ANTT0022A, which prompts
the user to confirm that XRC should continue to process the command.
If you select this option, XRC immediately processes the command without
waiting for verification.
- MSGROUTEID
- Specifies the user ID to which XRC messages associated with
the processing of this command are routed. If the specified user ID
is logged off, TSO saves messages in the TSO BRODCAST data set and
displays them after the next logon.
Note: Messages issued
by the initial command parser routine are sent to the user ID that
issues the TSO command.