Mainframe Enablers TimeFinder SnapVX and zDP 8.5 Product Guide

The QUERY VDG command displays VDG information.

Syntax

QUERY VDG {vdg_name|*}

[,DEVice[,COPY_ONCE]]

[,SNAPSET[,DETAIL][,COPY_ONCE]]

[,start_dev[-end_dev]]

[,STATUS]

[,SYMM(gk)]

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:

EMCP001I QUERY VDG VDG_TEST,STATUS

EIP0020I  VDG EMC_SECURE is Inactive, Cycle 0                                                    
EIP0021I     Cycle_Time(10,0,SECURE,1),Cycle_Overflow(IMMED),Consistent(YES),Timeout(15,CONT) 
EIP0021I     Terminate_Policy(OLDEST),Dynamic_Change(NO)
EIP0021I     SRP_Warn%(80),SRP_Snap%(50),SRP_Term%(100),RDP_Cache_Util%(60,95)              
EIP0021I     Max_Snapsets(256),Saved_Snapsets(0,1),Persistent_Copy_Limit(32)                  
EIP0021I     Log_Opt(SCF)                                                                     
EIP0021I     SMF(NO)                                                                          
EIP0021I     MAXRC(4) 

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.

EMCP001I QUERY VDG EMCVDG1,DEVICE                                               

EIP0022I   Device Query for VDG EMCVDG1                                          

EIP0023I     SYMM 0001234-05678, Microcode level 5977_0772, Type VMAX200K       
EIP0024I      Gatekeeper  3008, Device Count:     32                            
EIP0025I      SRP ID/Name: 0001/SRP_1, Reserved Capacity:  10%                  
EIP0026I          Total Capacity:     506M, Total Allocated:    4789K, Snap Allocated:  0
                                                                                
EIP0027I      CCUU    DEVICE    TYPE     SIZE     SRP ID   RDF INFO/MODE        
EIP0027I      ____    ______    ____   ________   ______   ______________       
                                                                                
EIP0028I      3150    000170/O   CKD      32760    0001    ---                  
EIP0028I      3151    000171     CKD      32760    0001    ---                  
EIP0028I      3152    000172     CKD      32760    0001    ---                  
EIP0028I      3153    000173     CKD      32760    0001    ---                  
EIP0028I      3154    000174     CKD      32760    0001    ---                  
EIP0028I      3155    000175     CKD      32760    0001    ---                  
EIP0028I      3156    000176     CKD      32760    0001    ---                  
EIP0028I      3157    000177     CKD      32760    0001    ---                  
EIP0028I      3158    000178     CKD      32760    0001    ---                  
EIP0028I      3159    000179     CKD      32760    0001    ---                  
EIP0028I      315A    00017A     CKD      32760    0001    ---                  
EIP0028I      315B    00017B     CKD      32760    0001    ---                  
EIP0028I      315C    00017C     CKD      32760    0001    ---                  
EIP0028I      315D    00017D     CKD      32760    0001    ---                  
EIP0028I      315E    00017E     CKD      32760    0001    ---                  
EIP0028I      315F    00017F     CKD      32760    0001    ---

The following example shows QUERY VDG,DEVICE output for remote devices.

EMCP001I QUERY VDG EMCVDGCC1,DEVICE 

EIP0022I   Device Query for VDG EMCVDGCC1 
                                                                                
EIP0023I     SYMM 0001234-05678, Microcode level 5977_0772, Type VMAX200K       
EIP0024I      Gatekeeper  3008, Device Count:      4, Remote(71)                
EIP0025I      SRP ID/Name: 0001/SRP_1, Reserved Capacity:  10%                  
EIP0026I          Total Capacity:     506M, Total Allocated:    3557K, Snap Allocated:    22347
                                                                                
EIP0027I      CCUU    DEVICE    TYPE     SIZE     SRP ID   RDF INFO/MODE        
EIP0027I      ____    ______    ____   ________   ______   ______________       
                                                                                
EIP0028I      ----    000270     CKD      10017    0001    R2:  70,71 /S        
EIP0028I      ----    000271     CKD      10017    0001    R2:  70,71 /S        
EIP0028I      ----    000272     CKD      10017    0001    R2:  70,71 /S        
EIP0028I      ----    000273     CKD      10017    0001    R2:  70,71 /S 
                                                                                
EIP0023I     SYMM 0001234-08765, Microcode level 5977_0772, Type VMAX200K       
EIP0024I      Gatekeeper  3008, Device Count:      4, Remote(EA)                
EIP0025I      SRP ID/Name: 0001/SRP_1, Reserved Capacity:  10%                  
EIP0026I          Total Capacity:     506M, Total Allocated:    3698K, Snap Allocated:    22347
                                                                                
EIP0027I      CCUU    DEVICE    TYPE     SIZE     SRP ID   RDF INFO/MODE        
EIP0027I      ____    ______    ____   ________   ______   ______________       
                                                                                
EIP0028I      ----    000270     CKD      10017    0001    R2:  EB,EA /S        
EIP0028I      ----    000271     CKD      10017    0001    R2:  EB,EA /S        
EIP0028I      ----    000272     CKD      10017    0001    R2:  EB,EA /S        
EIP0028I      ----    000273     CKD      10017    0001    R2:  EB,EA /S

The following example illustrates the QUERY VDG,DEVICE output with the COPY_ONCE option specified:

EIP0027I      CCUU    DEVICE    TYPE     SIZE     SRP ID   RDF INFO/MODE    COPY_ONCE SSET
EIP0027I      ____    ______    ____   ________   ______   ______________   ______________
                                                                          
EIP0028I      3150    000170/O   CKD      32760    0001    ---              171360952S00001

SRP ID/Name

Lists the storage resource pool ID and name.

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:

EMCP001I QUERY VDG EMCVDGC1,SNAPSET                                               
                                                                                
EIP0035I   Snapset Query for VDG EMCVDGC1                           
                                                                                
EIP0023I     SYMM 0001900-01234, Microcode level 5977_0811, Type VMAX200K        
EIP0024I      Gatekeeper  D008, Device Count:     48, Snapset Count:   12       
EIP0025I      SRP ID/Name: 0001/SRP_1, Reserved Capacity:  10%                  
EIP0026I          Total Capacity:     506M, Total Allocated:      20M, Snap Allocated:      10M 
                                                                                
EIP0036I                                             CREATE               SOURCE_TRACKS   EXPIRATION
EIP0036I      SNAPSET_NAME                    STATE  DATE       TIME      CHANGED UNIQUE DATE       TIME
EIP0036I      ______________________________  _____  ___________________  _____________  ___________________
                                                                                
EIP0039I      MYVDGC1........161231257S00012  ACT-S  05/02/2016 12:57:25    4598  44296  05/07/2016 12:57:25
EIP0039I      MYVDGC1........161231307C00013  ACT    05/02/2016 13:07:25    4518  44186
EIP0039I      MYVDGC1........161231317C00014  ACT    05/02/2016 13:17:25    4598  44296
EIP0039I      MYVDGC1........161231327C00015  ACT-P  05/02/2016 13:27:25    4390  43042
EIP0039I      MYVDGC1........161231337C00016  ACT    05/02/2016 13:37:24    4837  45184
EIP0039I      MYVDGC1........161231347C00017  ACT    05/02/2016 13:47:25     598   9441
EIP0039I      MYVDGC1........161231400C00018  ACT    05/02/2016 14:00:32    4245  42245
EIP0039I      MYVDGC1........161231410C00019  ACT    05/02/2016 14:10:31    4159  40305
EIP0039I      MYVDGC1........161231420C00020  ACT    05/02/2016 14:20:32    3092  31296
EIP0039I      MYVDGC1........161231430C00021  ACT    05/02/2016 14:30:31    3145  30164
EIP0039I      MYVDGC1........161231440C00022  ACT    05/02/2016 14:40:31    2097  20429
EIP0039I      MYVDGC1........161231450C00023  ACT    05/02/2016 14:50:31    4592  45296
EIP0039I      MYVDGC1........161231400C00018  LNK    05/02/2016 14:00:32    4245  42245
EIP0039I      MYVDGC1........161231420C00020  RST    05/02/2016 14:20:32    3092  31296
EIP0034I QUERY command completed

SRP ID/Name

Lists the storage resource pool ID and name.

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:

EIP0036I                                             CREATE               SOURCE_TRACKS                            
EIP0036I      SNAPSET_NAME                    STATE  DATE       TIME      CHANGED UNIQUE  SRCDEV/CCUU  TGTDEV/CCUU 
EIP0036I      ______________________________  _____  ___________________  ______________  ___________  ___________ 
                                                                                                                   
EIP0038I      VDG_UYF1.......161371429S00006  ACT-S  05/16/2016 14:29:19        0      0  000140/---- 
EIP0038I                                      ACT-S  05/16/2016 14:29:19        0      0  000141/----              
EIP0038I                                      ACT-S  05/16/2016 14:29:19        0      0  000142/----              
EIP0038I                                      ACT-S  05/16/2016 14:29:19        0      0  000143/----              
EIP0038I      VDG_UYF1.......161381523S00001  ACT-S  05/17/2016 15:23:10        0      0  000140/----              
EIP0038I                                      ACT-S  05/17/2016 15:23:10        0      0  000141/----              
EIP0038I                                      ACT-S  05/17/2016 15:23:10        0      0  000142/----              
EIP0038I                                      ACT-S  05/17/2016 15:23:10        0      0  000143/----              
EIP0038I      VDG_UYF1.......161381544C00008  ACT    05/17/2016 15:44:10        0      0  000140/----              
EIP0038I                                      ACT    05/17/2016 15:44:10        0      0  000141/----              
EIP0038I                                      ACT    05/17/2016 15:44:10        0      0  000142/----              
EIP0038I                                      ACT    05/17/2016 15:44:10        0      0  000143/----              
EIP0038I      VDG_UYF1.......161381547C00009  ACT    05/17/2016 15:47:11        0      0  000140/----              
EIP0038I                                      ACT    05/17/2016 15:47:11        0      0  000141/----              
EIP0038I                                      ACT    05/17/2016 15:47:11        0      0  000142/----              
EIP0038I                                      ACT    05/17/2016 15:47:11        0      0  000143/----              
EIP0038I      VDG_UYF1.......161381550C00010  ACT    05/17/2016 15:50:11        0      0  000140/----              
EIP0038I                                      ACT    05/17/2016 15:50:11        0      0  000141/----              
EIP0038I                                      ACT    05/17/2016 15:50:11        0      0  000142/----              
EIP0038I                                      ACT    05/17/2016 15:50:11        0      0  000143/---- 

The fields in this example have the same meaning as in the QUERY VDG,SNAPSET report. The two additional fields are as follows:

SRCDEV/CCUU

The PowerMax or VMAX device number and CCUU of the source device.

TGTDEV/CCUU

The PowerMax or VMAX device number and CCUU of the target device.

NOTE:Target devices can be displayed for linked sources only. If a source device is not linked, the TGTDEV/CCUU column is blank.