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

DETACH XSTORE
DETACH XSTORE
Authorization
►►
►►
DETach
DETach
Purpose
Operands
XSTore
XSTore
Usage Notes
Responses
Privilege Class: B
FRom
userid
*
Privilege Class: G
256 z/VM: CP Commands and Utilities Reference
Use DETACH XSTORE to remove real Expanded Storage from your virtual machine
configuration.
userid
identifies the virtual machine to which Expanded Storage is currently attached.
The specified user must be logged on, not in the process of logging on.
SYSTEM is not a valid userid.
* If an asterisk (*) is specified, XSTORE is detached from the issuing user.
1. SET IMSG OFF will not suppress informational messages for this command.
2. The detached virtual machine partition becomes immediately available for CP
use.
3. Expanded Storage can be detached from a user even if it is still in use.
However, unexpected results can occur.
4. Whenever the Expanded Storage is detached, the system operator receives a
message indicating that the storage is available.
5. If a class B user issues DETACH XSTORE with no operands, or specifies userid
as an asterisk (*), the command is in the class G format. Therefore, the
command detaches any Expanded Storage from the user issuing the command.
6. If a RETAIN XSTORE command was issued but left pending, the Expanded
Storage detached is used in an attempt to satisfy the amount remaining from
the RETAIN request.
7. For more information, see “Usage Notes” on page 232.
Receiving messages indicating that the DETACH XSTORE was successful are:
v The user who currently owns the Expanded Storage partition
v The user who issued the DETACH XSTORE command (if different from the
owner of the Expanded Storage partition)
►◄
►◄