z/VM: CP Commands and Utilities Reference - z/VM - IBM

XLINK RESET
►►
XLINK
Authorization
Purpose
Operands
RESET
Usage Notes
sysname
ALL
volid
Privilege Class: A , B
NOPROMPT
Use XLINK RESET only when you want to free links held by a failed system.
Attention: Issuing XLINK RESET when the specified system is not really down or
is in the process of coming up destroys minidisk data—not directly, but by disrupting
cross-system link operation.
If XLINK RESET sysname is issued and users have write access to one of the
minidisks on a volume just reset, all link indicators are cleared. This condition can
allow another user to get write access to the same minidisk, possibly causing a loss
of minidisk data.
sysname
identifies the name of the system whose map records are to be RESET. This
system must not be in operation.
ALL
specifies that all volumes in the CSELVOL INCLUDE macro for the system
sysname are to be cleared.
volid
identifies the volume to be cleared.
XLINK RESET
NOPROMPT
specifies that the RESET should be performed WITHOUT a system prompt to
the user requesting that the user verify if the RESET should really be done.
1. The system specified as sysname should not be considered down unless it is
powered off or unless its storage has been cleared to binary zeros.
2. To avoid losing user data, enter the SYSTEM RESET and SYSTEM CLEAR
commands for the system that is down. Do this before issuing the XLINK
RESET command from another system.
3. This command clears the record of existing links held by the failed system,
allowing users on the remaining systems in the CSE complex to establish links
to those minidisks.
4. The XLINK RESET command is not necessary for shutdown because the link
indicators are automatically cleared.
5. To avoid problems, confirm that the suspect system is not operating before you
enter this command.
►◄
Chapter 2. CP Commands 1749