NOTE:The SNAPSET keyword may only be followed by DETAIL, COPY_ONCE, STATUS, SYMM(gk), or
start_dev[-end_dev].
NOTE:VDG is an alias for VERSIONED_DATA_GROUP. You can also use optional parenthesis as follows: VDG(vdg_name).
Command-specific parameters
DEVice[,COPY_ONCE]
Generates a report of the devices that are included in the VDG definition.
COPY_ONCE
Filters the display to include only copy-once devices. For each copy-once device, displays the last snapset containing the copy-once device.
The COPY_ONCE parameter can be specified only once per command. If both DEVice and SNAPSET keywords are specified on the same command, the COPY_ONCE parameter applies to both DEVice and SNAPSET queries.
SNAPSET[,DETAIL][,COPY_ONCE]
Displays the snapsets created for the VDG.
NOTE:The SNAPSET keyword may only be followed by DETAIL, COPY_ONCE, STATUS, SYMM(gk), or
start_dev[-end_dev].
COPY_ONCE
Displays only snapsets that contain copy-once devices.
The COPY_ONCE parameter can be specified only once per command. If both DEVice and SNAPSET keywords are specified on the same command, the COPY_ONCE parameter applies to both DEVice and SNAPSET queries.
DETAIL
Displays each device in the snapset.
start_dev[-end_dev]
Narrows the query to the specified range of devices.
STATUS
Displays VDG status, cycle, and properties.
SYMM(gk)
Narrows the query to the storage system specified with the gatekeeper CCUU.
Example 1: QUERY VDG STATUS
The following example shows QUERY VDG,STATUS output:
The QUERY VDG,STATUS command lists properties set for the VDG. For an explanation of each property, see the description of the corresponding zDP parameter.
Example 2: QUERY VDG DEVICE
The following example shows QUERY VDG,DEVICE output for local devices.
Normally only one SRP is configured per storage system. If multiple SRPs are configured, only SRPs associated with devices in the VDG or TGT are displayed.
Reserved Capacity
Indicates the maximum percentage of the SRP that is allocated for host writes.
Total Capacity
Lists the total track capacity of the SRP.
Total Allocated
Lists the CKD and FBA tracks allocated to the SRP.
Snap Allocated
Lists the SnapVX-specific CKD and FBA tracks allocated to the SRP.
CCUU
The z/OS device number or "----" if not addressed.
DEVICE
Lists the PowerMax or VMAX device number of the device. “/O” indicates a copy-once device.
TYPE
Lists the device type (CKD or FBA).
SIZE
Lists the device size (in tracks).
SRP ID
Lists the ID of the SRP to which the device belongs.
RDF INFO/MODE
Lists the SRDF device type (R1, R2, R11, R21 or R22), SRDF groups, and SRDF mode for the device (S for synchronous, A for asynchronous (SRDF/A), and ADC for Adaptive Copy). For an active R2, the R2 group, R1 group status is shown.
NOTE:For R1s, mode and SRDF group information is not displayed.
COPY_ONCE SSET
Indicates the last saved snapset containing the copy-once device.
Example 3: QUERY VDG SNAPSET
The following example shows QUERY VDG,SNAPSET output:
Normally only one SRP is configured per storage system. If multiple SRPs are configured, only SRPs associated with devices in the VDG or TGT are displayed.
Reserved Capacity
Indicates the maximum percentage of the SRP that is allocated for host writes.
Total Capacity
Lists the total track capacity of the SRP.
Total Allocated
Lists the CKD and FBA tracks allocated to the SRP.
Snap Allocated
Lists the SnapVX-specific CKD and FBA tracks allocated to the SRP.
SNAPSET_NAME
Specifies the
snapset name, with the VDG name followed by the snapset ID.
STATE
Indicates the snapset state:
CRE—Created
ACT—Activated
LNK—Linked
RST—Restored
A STATE suffix value indicates the following:
–F—Failed snapset
–I—Secure snapset
–S—Saved snapset
–P—Persistent snapset
CREATE DATE
Indicates the snapset creation date.
CREATE TIME
Indicates the snapset creation time.
SOURCE_TRACKS CHANGED
Lists the number of changed tracks for the source volume.
SOURCE_TRACKS UNIQUE
Lists the number of tracks (for the source volume) that have only one snapshot pointing to them.
EXPIRATION DATE
Indicates the date when the snapset expires.
NOTE:The expiration date is generated when a saved snapset is created.
EXPIRATION TIME
Indicates the time when the snapset expires.
Example 4: QUERY VDG SNAPSET DETAIL
The following example shows the detailed part of the report that is produced with QUERY VDG,SNAPSET,DETAIL: