Mainframe Enablers TimeFinder SnapVX and zDP 8.5 Product Guide

Displays snapshots for the specified source device and their relationship to target devices.

To specify a range of devices, use the DEVICE option with the LOCAL or REMOTE parameter.

Multiline query

When MULTI_LINE_query(YES) is specified, the query output includes detailed information about devices for each snapshot, such as:

• Track counts
• Snapshot ID
• Time since creation and time to live
• Whether the snapshot is secure
• Snapshot copy mode

Compact query

When COMPACT_query(YES) is specified, the query output shows status fields at the end of each line to provide a single-line summary of important snapshot information, including:

• Snapshot status and whether the snapshot has been activated
• Link type (softlink, hardlink)
• Snapshot copy mode (COPY or NOCOPY) and status (if every track on the source has been copied to the target at least one time)
• Whether the snapshot is secure and (or) zDP-managed

Syntax

QUERY SNAPSHOT({VOLume(volser)|UNIT(cuu)|GROUP(grpname[,grpname,...])|SCFGroup(gnsgrp)}

[optional_parameters])

Where optional_parameters are:

[CcUU({cuu|low-high|low:high|ccuu(count)})]

[COMPACT_query({Yes|No})] The default value is No.

[DEVice({symdv#|lowsymdv#-highsymdv#|lowsymdv#:highsymdv#|symdv#(count)|ALL})]

[DISPLAY_CUU({Yes|No})] The default value is No.

[EMUL_TYPE({ALL|HARDLINK|SNAPVX})] The default value is ALL.

[LOCAL({

UNIT(cuu) [CONTROLLER({[xxxxxxx-]xxxxx|name})]|

VOLUME(volser) [CONTROLLER({[xxxxxxx-]xxxxx|name})]|

DDNAME(ddname) [CONTROLLER({[xxxxxxx-]xxxxx|name})]|

CONTROLLER({[xxxxxxx-]xxxxx|name})

})]

[MULTI_LINE_query({Yes|No})] The default value is No.

[NAME(snapshot_name)]

[REMOTE (RAGROUP(nn.nn.nn.nn)

{UNIT(cuu) [CONTROLLER({[xxxxxxx-]xxxxx|name})]|

VOLUME (volser) [CONTROLLER({[xxxxxxx-]xxxxx|name})]| DDNAME(ddname) [CONTROLLER({[xxxxxxx-]xxxxx|name})]})]

[SECURE_Query({Yes|No})] The default value is No.

[SHOW_Tracks_to_be_defined({Yes|No})] The default value is No.

[SNAPSHOT_LIST(filter1[,filter2,...,filterN])]

[SORT({Yes|No})] The default value is No.

Command-specific parameters

NAME(snapshot_name)

See NAME. When NAME(snapshot_name) is specified, QUERY SNAPSHOT shows only the snapshot with the specified snapshot_name.

SORT({Yes|No})

When set to YES, sorts snapshots by date. NO disables sorting by date.

The default value is No.

NOTE:Sorting can dramatically increase the query time.

Example 1: DISPLAY_CUU(NO)

QUERY SNAPSHOT (                      - 
                UNIT(8D00)            - 
                DEV(436A-436B) 	      - 
                DISPLAY_CUU(NO)       - 
               ) 

The output is similar to the following:

ESNP1AAI   TOTAL NUMBER OF QUERY RESULTS: 00000002 
 ESNP1AAI                                                                                                                 
 ESNP1AAI                                                                                 TIME STAMP                      
ESNP1AAI     SRC     CUU    VOLSER TGT     CUU    VOLSER NAME                             YYDDD/HH:MM:SS STATUS      ACT  
 ESNP1AAI     -----------------------------------------------------------------------------------------------------------  
 ESNP1AAI     0000436A(N/A ) DA430B FFFFFFFF(N/A )        SSHOT_WJ01                       16200/18:38:24 CREATE SOFT Y    
 ESNP1AAI     0000436B(N/A ) DA430B 00000054(N/A ) MV8041 SSHOT_WJ01                       16200/18:38:25 LINKED      Y    
ESNP1AAI     -----------------------------------------------------------------------------------------------------------  
 ESNP1AAI                                                                                                                 
 ESNP461I PROCESSING FOR STATEMENT #4 COMPLETED, HIGHEST RETURN CODE ENCOUNTERED IS 0                                     
 ESNP440I PROCESSING COMPLETED, HIGHEST RETURN CODE ENCOUNTERED IS 0 

Output fields

TOTAL NUMBER OF QUERY RESULTS

The total count of results returned in the query.

SRC

The PowerMax or VMAX device number of the source device.

CUU

The CUU of the source device.

NOTE:With DISPLAY_CUU(NO), the value is displayed as N/A.

VOLSER

The volser of the source device.

TGT

The PowerMax or VMAX device number of the target device.

CUU

The CUU of the target device.

NOTE:With DISPLAY_CUU(NO), the value is displayed as N/A.

VOLSER

The volser of the target device.

NAME

The snapshot name on the source device.

TIME STAMP

The approximate time when the snapshot was created.

STATUS

The status of the snapshot:

• CREATE HARD (hardlinked snapshot)
• CREATE SOFT (softlinked snapshot)
• EMUL RESNAP
• F-LINK (failed LINK)
• F-SNAPSHOT (failed snapshot)
• LINKED
• NONE
• RELINKED
• TERMINATED
• UNLINKED

ACT

Indicates whether the snapshot has been activated. Possible values: Y or N.

Example 2: Multiline query

QUERY SNAPSHOT                               -    
       (                                     -    
        UNIT(cuu)                            -    
        DEVICE(symdv#)                       -    
        MULTI_LINE_QUERY(YES)                -    
        SHOW_TRACKS_TO_BE_DEFINED(YES)       -    
       ) 

The output is similar to the following:

TOTAL NUMBER OF QUERY RESULTS:             4390 
                                                                                                                  
                                                                                TIME STAMP                        
    SRC     CUU    VOLSER TGT     CUU    VOLSER NAME                             YYDDD/HH:MM:SS STATUS     ACT    
    -----------------------------------------------------------------------------------------------------------    
    0000010E(N/A )        FFFFFFFF(N/A )        SAMPLE_SNAPSHOT_NAME             17110/13:13:40 CREATE SOFT Y      
         UNIQUE TRACKS:                          0000000000                                                       
         SRC MODIFIED TRACKS (UNIQUE+SHARED):    0000000000                                                       
         TGT MODIFIED TRACKS (UNIQUE+SHARED):    0000000000                                                       
         TRACKS TO BE COPIED:                    0000000000                                                       
         TIME TO LIVE DDDD/HH:MM:SS:             0000/00:00:00                                                    
         TIME SINCE CREATION DDDD/HH:MM:SS:      0004/20:09:34                                                    
         SNAPSHOT ID:                            ADAD0001                                                         
         SECURE SNAPSHOT:                        NO                                                               
         COPY MODE:                              N/A 
         TRACKS TO BE DEFINED:                   0000000000             
                                                                                                     
    0000010E(N/A )        0000015E(N/A )        SAMPLE_SNAPSHOT_NAME             17111/15:43:52 LINKED     Y      
         UNIQUE TRACKS:                          0000000000                                                       
         SRC MODIFIED TRACKS (UNIQUE+SHARED):    0000000000                                                       
         TGT MODIFIED TRACKS (UNIQUE+SHARED):    0000000000                                                       
         TRACKS TO BE COPIED:                    0000000000                                                       
         TIME TO LIVE DDDD/HH:MM:SS:             0000/00:00:00                                                    
         TIME SINCE CREATION DDDD/HH:MM:SS:      0003/17:39:22                                                    
         SNAPSHOT ID:                            ADAD0001 
         SECURE SNAPSHOT:                        NO                                                               
         COPY MODE:                              COPY 
         TRACKS TO BE DEFINED:                   0000000000 

...

    ---------------------------------------------------------------------------------------------------------- 

     TOTAL UNIQUE TRACKS IN REQUEST:                           0000000000005087
     TOTAL TRACKS TO BE COPIED IN REQUEST:                     0000000000000000
     TOTAL SRC MODIFIED TRACKS (UNIQUE+SHARED) IN REQUEST:     0000000013394781
     TOTAL TGT MODIFIED TRACKS (UNIQUE+SHARED) IN REQUEST:     0000000000263646
     TOTAL TRACKS TO BE DEFINED IN REQUEST:                    0000000000000000

Output fields

The multiline query displays the following information for each snapshot:

UNIQUE TRACKS

The number of tracks that are only associated with the displayed snapshot. These tracks are freed when the snapshot is terminated. A preceding tilde (~) indicates an approximate value.

NOTE:The unique track count is not updated immediately after a snapshot is terminated. A background task in the storage system updates it periodically.

SRC MODIFIED TRACKS (UNIQUE+SHARED)

The number of tracks that have changed on the snapshot source device since the ACTIVATE was issued. A preceding tilde (~) indicates an approximate value.

TGT MODIFIED TRACKS (UNIQUE+SHARED)

The number of tracks that have changed on a snapshot linked target device since the LINK action.

TRACKS TO BE COPIED

The number of tracks that remain to be copied to the linked target device. A preceding tilde (~) indicates an approximate value.

TIME TO LIVE

The time until a snapshot is automatically terminated. For expired snapshots, EXPIRED is displayed.

TIME SINCE CREATION

The time that has elapsed since snapshot creation.

SNAPSHOT ID

The ID given to a snapshot at creation time. This ID is only unique for each source device. The IDs are reused after snapshots are terminated.

This field is not displayed for snapsets that are created by zDP with PowerMaxOS 5978.0300 or later.

SECURE SNAPSHOT

Indicates whether the snapshot is secure or not.

COPY MODE

Indicates the current copy mode (COPY or NOCOPY). For unlinked snapshots, N/A is displayed.

With PowerMaxOS 5978 and HYPERMAX OS 5977, NOCOPY and NOCOPYRD are not distinguished.

TRACKS TO BE DEFINED

The number of tracks that are still to be defined on the target device.

This field is shown when the SHOW_TRACKS_TO_BE_DEFINED parameter or the SHOWDEF site option is set to YES.

For hardlinked or unlinked snapshots, the field shows N/A.

SNAPSHOT SIZE (IN CYLINDERS)

The size of the source device at the moment of snapshot creation.

This field is displayed if the GLOBAL CHECK_SNAPSHOT_SIZE option is set to Yes. The size of the source device is not displayed for linked parts of the snapshot.

TOTAL UNIQUE TRACKS IN REQUEST

The number of tracks that are associated with all snapshots in the current query. A preceding tilde (~) indicates an approximate value.

TOTAL TRACKS TO BE COPIED IN REQUEST

The number of tracks that remain to be copied to the linked target devices for all snapshots in the current query. A preceding tilde (~) indicates an approximate value.

TOTAL SRC MODIFIED TRACKS (UNIQUE+SHARED) IN REQUEST

The number of tracks that have been modified on all snapshot source devices in the current query since the ACTIVATE was issued. A preceding tilde (~) indicates an approximate value.

TOTAL TGT MODIFIED TRACKS (UNIQUE+SHARED) IN REQUEST

The number of tracks that have been modified on all snapshot linked target devices since the LINK actions.

TOTAL TRACKS TO BE DEFINED IN REQUEST

The number of tracks to be defined on all snapshot linked target devices. This field is displayed when SHOW_TRACKS_TO_BE_DEFINED(YES) and MULTI_LINE_QUERY(YES) are set.

Example 3: Compact query

QUERY SNAPSHOT                        -    
       (                              -    
        UNIT(cuu)                     -    
        DEVICE(symdv#)                -    
        COMPACT_query(YES)            -    
       ) 

The output is similar to the following:

QUERY SNAPSHOT(UNIT(DC00) DEV(F8-FF) COMPACT(Y))

ESNP1AAI   TOTAL NUMBER OF QUERY RESULTS:           15
ESNP1AAI   ************************************** STATUS FIELDS LEGEND *****************************************
ESNP1AAI   * STA=SNAPSHOT STATUS | S/H=SOFT/HARD LINK | LTH=LINK TARGET HOLD | CPY=COPYMODE  | ZDP=ZDP MANAGED *
ESNP1AAI   * DEF=TARGET DEFINED  | ACT=ACTIVATED      | 1PS=1 PASS COMPLETE  | SEC=SECURE    |                 *
ESNP1AAI   *****************************************************************************************************
ESNP1AAI
ESNP1AAI                                                                                               S S L C Z D A 1 S
ESNP1AAI                                                                                TIME STAMP     T / T P D E C P E
ESNP1AAI   SRC     CUU    VOLSER TGT     CUU    VOLSER NAME                             YYDDD/HH:MM:SS A H H Y P F T S C
ESNP1AAI   -------------------------------------------------------------------------------------------------------------
ESNP1AAI   000000F8(N/A )        FFFFFFFF(N/A )        SNVX_S1                          21313/23:11:58 S S - - N - Y - N
ESNP1AAI   000000F8(N/A )        00000100(N/A )        SNVX_S1                          21313/23:11:58 L S - C N Y Y - N
ESNP1AAI   000000F9(N/A )        FFFFFFFF(N/A )        SNVX_S1                          21313/23:11:58 S S - - N - Y - N
ESNP1AAI   000000F9(N/A )        00000101(N/A )        SNVX_S1                          21313/23:11:58 L S - C N Y Y - N
ESNP1AAI   000000FA(N/A )        FFFFFFFF(N/A )        SNVX_S1                          21313/23:11:58 S S - - N - Y - N
ESNP1AAI   000000FA(N/A )        00000102(N/A )        SNVX_S1                          21313/23:11:58 L S - C N N Y - N
ESNP1AAI   000000FB(N/A )        FFFFFFFF(N/A )        SNVX_S2                          21313/23:13:35 S S - - N - Y - N
ESNP1AAI   000000FB(N/A )        00000103(N/A )        SNVX_S2                          21313/23:13:35 L S - N N N Y - N
ESNP1AAI   000000FC(N/A )        FFFFFFFF(N/A )        SNVX_S2                          21313/23:13:35 S S - - N - Y - N
ESNP1AAI   000000FC(N/A )        00000104(N/A )        SNVX_S2                          21313/23:13:35 L S - N N N Y - N
ESNP1AAI   000000FD(N/A )        FFFFFFFF(N/A )        SNVX_S2                          21313/23:13:35 S S - - N - Y - N
ESNP1AAI   000000FD(N/A )        00000105(N/A )        SNVX_S2                          21313/23:13:35 L S - N N N Y - N
ESNP1AAI   000000FE(N/A )        FFFFFFFF(N/A )        EMCVDG1........213132317C00001   21313/23:17:47 S S - - Y - Y - N
ESNP1AAI   000000FE(N/A )        000001C7(N/A )        EMCVDG1........213132317C00001   21313/23:18:50 L S N C Y Y Y - N
ESNP1AAI   000000FF(N/A )        000001D4(N/A )        CLONE_HL                         21313/23:21:21 H H - C N N Y - N
ESNP1AAI   -----------------------------------------------------------------------------------------------------------
ESNP1AAI

Output fields

The compact query adds status fields on the right of the display. Status column headings are stacked vertically so that each corresponds to a one-character value for each query result. STATUS FIELDS LEGEND above the table explains the status values.

Status fields have the following meaning:

STA

Indicates the snapshot status:

• E—Emulation resnap
• F—Failed snapshot
• H—Hardlink
• L—Linked to a target device
• S—Created softlinked snapshot
• U—Unlinked from a target device

S/H

Indicates whether the snapshot is softlinked (S) or hardlinked (H).

CPY

Indicates the copy mode that the source and target devices are in. Possible values are:

• C—COPY
• N—NOCOPY

ZDP

Indicates whether the snapshot was created by zDP.

DEF

Indicates if the target device is fully defined or not. If not linked, this field shows a dash (‘-’).

ACT

Indicates if the snapshot has been activated.

1PS

Indicates if every track on the source has been copied to the target at least one time. For active snapshots, a dash (‘-’) is shown.

SEC

Indicates whether the snapshot is secure or not.