INDICATE SPACES
Authorization
Privilege Class: E, G
Purpose
Use INDICATE SPACES to display information about a specific address space or all of the address spaces owned by a user. A class G user can display information about the user's own address spaces. A class E user can display information about any address spaces.
Operands
- USER *
- returns information about all address spaces owned by the command issuer. This is the default.
- USER userid
- returns information about all address spaces owned by userid.
- SPACE
- indicates that the next operand is a spaceid.
- spaceid
- is the name of the specific space for which data is requested. The spaceid is a 1- to 33-character string of the form: where owner is an optional 1- to 8-character user ID of the virtual machine that owns the address space, and spacename is the 1- to 24-character name assigned to the address space. If owner is not specified, the command issuer's virtual machine is assumed to be the owner of the address space.
The spacename 'BASE' is preassigned by CP to be the name of your virtual machine's host-primary address space.
An example of a valid spaceid is "OPERATOR:BASE".
Examples of spaceids that are not valid are ":BASE" and "BASE". These spaceids are not valid only when the command is issued with the AT command.
Usage Notes
- Any field containing cumulative data from the time the user logged on (reads, writes, and migrates) is preserved during a guest relocation. As a result, the counters might wrap over time.
Responses
Response 1:
Spaceid=sssssssssssssssssssssssssssssssss Owned size=nu {PRIVATE}
{SHARED }
Pages: Main=n...n Xstore=--- Dasd=nnnnnnnnnn Locked=---
Instan=n...n
Private paging:
Xstore: Reads=--- Writes=--- Migrates=---
Dasd: Reads=nnnnnnnnnn Writes=nnnnnnnnnn
Shared paging:
Xstore: Reads=--- Writes=--- Migrates=---
Dasd: Reads=nnnnnnnnnn Writes=nnnnnnnnnn
- Spaceid=sssssssssssssssssssssssssssssssss
- is the fully-qualified address space ID (1 to 33 characters), to which the following data applies.
- Owned size=nu
- is the size of the storage within the address space that is owned by the owner of the address
space, where n is a decimal number and u is the
unit of measure. This value can differ from the defined size of the address space only for a primary
address space. This value is displayed in units of measure appropriate to the storage size. Shared
portions of NSSs or DCSSs that are imbedded in the address space(s) are not considered to be owned
by the virtual machine and are not included in the storage size.
Table 1. Storage Units of Measure Units suffix Maximum allowed K - Kilobytes 2096128 M - Megabytes 17592186044416 G - Gigabytes 17179869184 T - Terabytes 16777216 P - Petabytes 16384 E - Exabytes 16 - PRIVATE
- SHARED
- indicates whether the address space is in the private state or in the shareable state.
- Pages
- includes information about pages for this space.
- Main=n...n
- is the number of pages that are resident in real storage for this address space.
- Xstore=---
- is included for compatibility only. It is always displayed as dashes.
- Dasd=nnnnnnnnnn
- is the number of pages allocated on DASD paging space for this address space.
- Locked=---
- is included for compatibility only. It is always displayed as dashes.
- Instan=n...n
- indicates the number of instantiated pages for this address space. A page is considered instantiated when it takes up resource in the paging hierarchy (that is, occupies a real frame or a slot on paging DASD). A copy of a page in multiple places in the paging hierarchy counts as one instantiation.
- Private paging
- includes information about private paging for this space. The values include counts only for
private pages owned by the address space owner. These counts are cumulative for the life of the
address space and do not change when the state (private or shared) of the address space changes.
- Xstore: Reads=--- Writes=--- Migrates=---
- is included for compatibility only. It is always displayed as dashes.
- Dasd
- includes information about paging between DASD paging space and real storage.
- Reads=nnnnnnnnnn
- is the number of pages read from DASD to real storage for this address space.
- Writes=nnnnnnnnnn
- is the number of pages written from main storage to DASD for this address space.
- Shared paging
- includes information about shared paging for this space. The values include counts only for
shared pages owned by the address space owner. These counts are cumulative for the life of the
address space and do not change when the state (private or shared) of the address space changes.
- Xstore: Reads=--- Writes=--- Migrates=---
- is included for compatibility only. It is always displayed as dashes.
- Dasd
- includes information about paging between DASD paging space and real storage.
- Reads=nnnnnnnnnn
- is the number of pages read from DASD to real storage for this address space.
- Writes=nnnnnnnnnn
- is the number of pages written from real storage to DASD for this address space.
Messages
- HCP007E Invalid userid - userid.
- HCP1041E Address space spaceid. does not exist
- HCP6578E Invalid address space identifier - option.