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

QUERY XSTORAGE/XSTORE
►►
Query
Authorization
Purpose
Operands
Usage Notes
Examples
XSTorage
XSTore
MAP
USER
userid
Privilege Class: B
Use QUERY XSTORAGE or QUERY XSTORE to display the assignment of real
Expanded Storage.
USER userid
indicates that the Expanded Storage partition for this specific user ID is to be
displayed. If userid is left off, all guest partitions are displayed.
MAP
indicates that a map of Expanded Storage is to be displayed. This map shows
how Expanded Storage is currently allocated.
1. The responses to QUERY XSTORAGE may display different partition sizes than
you requested when you issued the ATTACH XSTORE nnnnnnnnM, RETAIN
XSTORE, or SET MDCACHE XSTORE commands. If you try to attach a
partition that is too large, CP assigns the maximum size partition available to
the virtual machine. If you retain a portion of Expanded Storage for CP paging,
CP has access to the retained size and can also use any portion of Expanded
Storage that is not attached to the virtual machine.
If you divide Expanded Storage between CP and a virtual machine (MVS) as
follows:
Configured and Installed Expanded Storage = 256M
RETAIN XSTORE 64M
ATTACH XSTORE MVS 128m
a possible response to QUERY XSTORE is:
XSTORE= 256M online= 256M
XSTORE= 128M userid= SYSTEM usage= 72% retained= 64M pending= 0M
XSTORE MDC min=0M, max=128M, usage=48%
XSTORE= 128M userid= MVS
XSTORE= 64M userid= (none) max. attach= 64M
QUERY XSTORAGE/XSTORE
Note: CP has access to the remaining 64 MB not assigned to MVS and not
specified by the RETAIN XSTORE command.
►◄
Chapter 2. CP Commands 1153