QUERY FLASHCOPY

Authorization

Privilege Class: B

Purpose

This command allows interrogation of persistent FlashCopy® relationships in the hardware and the Persistent FlashCopy Relationship Table. Each FlashCopy relationship is identified with a unique sequence number that is derived from the TOD clock when the relationship is established.

The Persistent FlashCopy Relationship Table is maintained by z/VM® to preserve additional information regarding FlashCopy relationships. Note that this table is NOT maintained over system IPLs and is intended to be used as supplemental information regarding FlashCopy relationships.

Operands

HARDWARE: specifies the real hardware devices that are to be interrogated. The resulting display will indicate all the persistent relationships that exist on the devices.
TABLEd: displays all additional information regarding persistent FlashCopy relationships that were established during the current system IPL session.
CREATEd *
CREATEd userid: displays additional information regarding persistent FlashCopy relationships that were established by the specified user during the current system IPL session.
OWNer *
OWNer userid: displays additional information regarding persistent FlashCopy relationships that were established on minidisks owned by the specified user during the current system IPL session.
SEQUENCE hhhhhhhh: displays additional information regarding persistent FlashCopy relationships that were established and assigned the specified sequence number during the current system IPL session.
VOLume volser: displays additional information regarding persistent FlashCopy relationships that were established on the specified real volume during the current system IPL session.
DEVice rdev: displays additional information regarding persistent FlashCopy relationships that were established on the specified real device during the current system IPL session.

Usage Notes

The contents of the Persistent FlashCopy Relationship Table are lost when the system is IPLed.
Entries might exist in the list for relationships that have been partially withdrawn by this or another LPAR.
Entries will not exist for relationships that have been completely withdrawn.
When the number of tracks remaining to be background copied is nonzero and you want to issue the FLASHCOPY WITHDRAW command, you must use the FORCE option.
If flag X'0002' is set to one, the number of remaining tracks to be copied is reported as '?'.
A VIRTUAL version of this command, QUERY VIRTUAL FLASHCOPY, also exists to facilitate a per-userid version of this data request. In some cases the VIRTUAL keyword is optional, so the output of this command may supersede QUERY VIRTUAL output. For more information, please see QUERY VIRTUAL FLASHCOPY.

Responses

Response 1: QUERY FLASHCOPY HARDWARE

q flashcopy hardware
HCP2466I Device 5100 - No FlashCopy relationships reported.
HCP2466I Device 5101 - No FlashCopy relationships reported.
HCP2466I Device 5C80 - No FlashCopy relationships reported.
HCP2466I Device 5C81 - No FlashCopy relationships reported.
HCP2466I Device FCE0 - No FlashCopy relationships reported.
HCP2466I Device FCE1 - No FlashCopy relationships reported.
HCP2466I Device FEE0 - No FlashCopy relationships reported.
HCP2466I Device FEE1 - No FlashCopy relationships reported.
Ready(02466); T=0.01/0.01 15:18:35

q flashcopy hardware 5100-5103
HCP2466I Device 5100 - No FlashCopy relationships reported.
HCP2466I Device 5101 - No FlashCopy relationships reported.
HCP040E Device 5102 does not exist
HCP040E Device 5103 does not exist
Ready(00040); T=0.01/0.01 15:19:24

flashcopy establish source 200 target 300
Command complete: FLASHCOPY 0200 0 99 TO 0300 0 99
FLASHCOPY RELATIONSHIP 4B145C34 ESTABLISHED
Ready; T=0.01/0.01 15:19:55

flashcopy establish source 210 target 310
Command complete: FLASHCOPY 0210 0 99 TO 0310 0 99
FLASHCOPY RELATIONSHIP 4B14700A ESTABLISHED
Ready; T=0.01/0.01 15:20:00

q flashcopy hardware
              --------SOURCE-------- --------TARGET--------
SEQUENCE FLGS RDEV VOLSER CC...CC/HH RDEV VOLSER CC...CC/HH REMAINING/TOTAL
4B145C34 0800 5100 PACK01     100/00 5101 PACK02     100/00 0/1500
4B14700A 0800 5100 PACK01     200/00 5101 PACK02     200/00 0/1500
4B145C34 8800 5100 PACK01     100/00 5101 PACK02     100/00 0/1500
4B14700A 8800 5100 PACK01     200/00 5101 PACK02     200/00 0/1500
HCP2466I Device 5C80 - No FlashCopy relationships reported.
HCP2466I Device 5C81 - No FlashCopy relationships reported.
HCP2466I Device FCE0 - No FlashCopy relationships reported.
HCP2466I Device FCE1 - No FlashCopy relationships reported.
HCP2466I Device FEE0 - No FlashCopy relationships reported.
HCP2466I Device FEE1 - No FlashCopy relationships reported.
Ready(02466); T=0.01/0.03 15:20:06

Note: If an RDEV in a FlashCopy relationship is not attached to this z/VM image, you will receive a display such as:

q flashcopy hardware
              --------SOURCE-------- --------TARGET--------
SEQUENCE FLGS RDEV VOLSER CC...CC/HH RDEV VOLSER CC...CC/HH REMAINING/TOTAL
62320413 E818 ssid *lsua*       0/00 FCE2 GESE01       0/00 50084/50085

When *lsua* is displayed for the VOLSER, the RDEV value that is displayed is the partner's subsystem ID and the *lsua* value is the partner's logical subsystem number and unit address, respectively.

Example:

q flashcopy hardware
              --------SOURCE-------- --------TARGET--------
SEQUENCE FLGS RDEV VOLSER CC...CC/HH RDEV VOLSER CC...CC/HH REMAINING/TOTAL
62320413 E818 0202 *0200*       0/00 FCE2 GESE01       0/00 50084/50085

The FLGS field of the QUERY FLASHCOPY HARDWARE response is in hexadecimal and has the following meaning:

Table 1. QUERY FLASHCOPY HARDWARE FLGS Field
Flag Bit	Definition
8000	0 = Source, 1 = Target
4000	1 = Full Volume Relationship
2000	1 = Background copy pending (NOCOPY)
1000	1 = Background copy in progress (BACKGNDCOPY)
0800	1 = Persistent Relationship (ESTABLISH)
0400	1 = Target extents are write protected (NOTGTWRITE)
0200	1 = Validation required
0100	1 = Change recording is active (CHGRECORD)
0080	1 = Reversible relationship (not set by z/VM)
0040	1 = Source write inhibited (not set by z/VM)
0020	1 = Virtual flash initialize relationship
0010	1 = Space efficient target volume or extent
0008	1 = Fail if no space (FAILNOSPACE)
0004	1 = Relationship is failed
0002	1 = Number of remaining tracks to copy is unknown
0001	1 = Source volume write inhibited due to full repository

For the --SOURCE-- and --TARGET-- areas, the CC...CC/HH fields are the decimal cylinder and head numbers for the beginning of the respective extent. (Note that the CC...CC cylinder field could contain as many as nine characters.) The REMAINING field contains the number of unmodified source tracks that have yet to be copied to the target, and the TOTAL field contains the total number of tracks in the extent.

Response 2: QUERY FLASHCOPY TABLED

q flashcopy tabled
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B145C34 2008-04-30 15:19:55  5100> PACK01 RWS      RWS      0200
4B145C34 2008-04-30 15:19:55 >5101  PACK02 RWS      RWS      0300
4B14700A 2008-04-30 15:20:00  5100> PACK01 RWS      RWS      0210
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:20:40

The RDEV> indicates a source relationship and the >RDEV indicates a target relationship.

The CREATOR is the VM user ID that issued the FLASHCOPY ESTABLISH command.

The OWNER and VDEV are the minidisk owner's information. For example, if you did this:

LINK MAINT 190 999 RR
FLASHCOPY ESTABLISH SOURCE 999 TARGET 200
QUERY FLASHCOPY CREATED RWS

you would get back

q flashcopy vol rws541
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
C1D5410F 2008-01-21 18:23:40  5C81> PACK03 RWS      MAINT    0190

rather than

q flashcopy vol rws541
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
C1D5410F 2008-01-21 18:23:40  5C81> PACK03 RWS      RWS      0999

Response 3: QUERY FLASHCOPY CREATED

q flashcopy created rws
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B145C34 2008-04-30 15:19:55  5100> PACK01 RWS      RWS      0200
4B145C34 2008-04-30 15:19:55 >5101  PACK02 RWS      RWS      0300
4B14700A 2008-04-30 15:20:00  5100> PACK01 RWS      RWS      0210
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:20:53

Response 4: QUERY FLASHCOPY OWNER

q flashcopy owner rws
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B145C34 2008-04-30 15:19:55  5100> PACK01 RWS      RWS      0200
4B145C34 2008-04-30 15:19:55 >5101  PACK02 RWS      RWS      0300
4B14700A 2008-04-30 15:20:00  5100> PACK01 RWS      RWS      0210
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:21:33

Response 5: QUERY FLASHCOPY VOLUME

q flashcopy volume pack02
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B145C34 2008-04-30 15:19:55 >5101  PACK02 RWS      RWS      0300
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:21:45

Response 6: QUERY FLASHCOPY SEQUENCE

q flashcopy sequence 4B14700A
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B14700A 2008-04-30 15:20:00  5100> PACK01 RWS      RWS      0210
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:22:13

Response 7: QUERY FLASHCOPY DEVICE

q flashcopy device 5101
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B145C34 2008-04-30 15:19:55 >5101  PACK02 RWS      RWS      0300
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:22:41

Response 8: If Information Is Not Available

In some cases, information might no longer be available, and you could see *UNKNOWN.

q flashcopy created rws
SEQUENCE ---DATE--- --TIME--  RDEV  VOLSER CREATOR  OWNER    VDEV
4B145C34 2008-04-30 15:19:55  5100> PACK01 RWS      *UNKNOWN 0200
4B145C34 2008-04-30 15:19:55 >5101  PACK02 RWS      RWS      0300
4B14700A 2008-04-30 15:20:00  5100> PACK01 *UNKNOWN RWS      0210
4B14700A 2008-04-30 15:20:00 >5101  PACK02 RWS      RWS      0310
Ready; T=0.01/0.01 15:20:53

Messages

HCP002E Invalid operand - operand
HCP026E Operand missing or invalid
HCP040E Device rdev does not exist
HCP2465I No matches found.
HCP2466I Device rdev - No FlashCopy relationships reported.