Using TSO FCQUERY to view FlashCopy relationship details

Use the FCQUERY parameters to view details of FlashCopy^® relationships.

Table. FCQUERY command parameters
Parameter	Value	Description
DEVN	Device number	Specify the number (device address) of the FlashCopy^® volume whose details you want to display.
REMOTE	YES	The target volume of this request is on a storage system that is remote to the host issuing the command. When REMOTE(YES) is used, the DEVN parameter must specify a PPRC primary device in a storage system that is attached to the host issuing the request, and the FlashCopy^® S-VOL must be the PPRC S-VOL for the specified DEVN.
REMOTE	NO	The target volume of this request is on a storage system that is attached (local) to the host issuing the command. NO is the default setting.
QRYSSID	SSID	Specifies the SSID of the CU on which the FlashCopy^® relationship was established. Use this parameter when REMOTE is YES.
QRYDVC	Serial number of the remote DKC CU number LDEV number	Specifies the serial number of the remote DKC, the CU number, and the LDEV number of the volume that is the target of the status query command. Use this parameter when REMOTE is YES.
SHOWRELS	ALL	Displays detailed relationship information.
	NO	Does not display detailed information about relationships. NO is the default setting.
	Integer between 1 and 9999	Displays the same information as for ALL. However, detailed information is shown only for the specified number of relationships.
STARTADDR	CCHH number	Specifies the CCHH number of the starting address. Use this parameter when the relationship number is specified in the SHOWRELS parameter.

You can use the FCQUERY command to display information such as the attributes for devices specified by DEVN and the number of FlashCopy^® relationships established with the specified devices.

An example of the FCQUERY command follows. This command requests that information about device 1900 be displayed.

FCQUERY DEVN(1900)

The following example shows the output of this FCQUERY command.

 ANTF0420I FCQUERY Formatted -3
 DEVN SSID LSS CCA  CU     SERIAL       ACT   MAX XC PC CC RV SE   SEQNUM
 1900 12C0 00   00 2107 000000064552      1 65534  N  N  N  N NN  00000000

The following table shows the information displayed by the FCQUERY command.

Table. FCQUERY command output
Item	Value		Description
DEVN	Device number		Device number (device address) recognized by the host.
SSID	Storage system ID		Storage subsystem ID.
LSS	CU number		CU number.
CCA	LDEV number in CU		LDEV number in the CU.
CU	DKC emulation type		DKC emulation type.
SERIAL	Serial number		Serial number.
ACT	Number of active relationships		Number of active FlashCopy^® V2 and FlashCopy^® SE relationships. For details, see the figure and description about the number of the relationships that follow this table.
MAX	Maximum number of pairs and relationships		Maximum number of pairs and relationships that can be created with the device specified by DEVN.
XC	S		Volume status specified by DEVN is one of the following: SIz S-VOL using the ATTIME Suspend function (online)¹. P-VOL of the TCz pair (Host I/O time stamp transfer is enabled, and the pair status is Duplex or Pending). P-VOL of the URz pair (Timer Type is System or None, and the pair status is Duplex or Pending).
XC	N		Volume specified by DEVN is not in the status described above, or the volume is not used.
PC	P		Volume specified by DEVN is currently used as the P-VOL of an SIz or TCz pair.
	S		Volume specified by DEVN is currently used as an SIz or TCz S-VOL. When the volume is used as an SIz or TCz S-VOL, N is displayed if one of the following conditions is satisfied: For TCz, the pair is suspended and system option mode 20 is ON. For details about system option mode 20, see the TrueCopy^® for Mainframe User Guide. For TCz, the pair is suspended and secondary volume Read/Write is enabled. For TCz, the pair is being swapped (Swapping). For SIz, the pair is in Split or V-Split status. If YES is specified for the REMOTE parameter, S is always displayed regardless of the above conditions.
	N		Volume specified by DEVN is currently not used by SIz or TCz. In some cases N might be displayed when the volume specified by DEVN is used as an SIz or TCz S-VOL. See the description for the PC S value.
CC	S		Volume specified by DEVN is currently used as the source volume of a Concurrent Copy pair.
CC	N		Volume specified by DEVN is currently used as the T-VOL of the Concurrent Copy pair, or not used for Concurrent Copy.
RV	N		Displays whether the volume specified by DEVN is Revertible or not. However, since Compatible FlashCopy^® V2 does not support this function, N will always be displayed for this item. For details about Revertible, see the IBM^® PPRC document.
SE²	S	Y	The volumes specified by DEVN are TSE-VOLs.
	S	N	The volumes specified by DEVN are not TSE-VOLs.
	E	N	The volumes specified by DEVN are not source volumes of relationships containing TSE-VOLs.
		Y	The volumes specified by DEVN are source volumes of relationships containing TSE-VOLs.
		F	The volumes specified by DEVN are source volumes of relationships containing TSE-VOLs, and at least one is in Failed State.
		I	The volumes specified by DEVN are source volumes of relationships containing TSE-VOLs, and at least one is in write inhibit.
		B	The volumes specified by DEVN are source volumes of relationships containing TSE-VOLs, and relationships in failed state and write inhibit are mixed.
SEQNUM	00000000		Displays the Sequence Number. However, since FlashCopy^® does not support this function, "00000000" will always be displayed for this item. For details about Sequence Number, see the IBM^® PPRC manual.
Notes: In case the volume is set online in more than one LPAR defined by the mainframe system host. The SE item might not display correctly when the following conditions occur at the same time: FCQUERY is executed with the SHOWRELS parameter omitted. The specified volume is the source volume of a volume relationship having 13 or more target volumes. You can avoid this situation by specifying the SHOWRELS parameter when running FCQUERY. To omit detailed information about the relationships, specify SHOWRELS(NO), which is equivalent to the omission of the SHOWRELS parameter.

ACT shows the total number of the active FlashCopy^® relationships in each data set. In the first case of the following figure, VOL#0 has one active relationship within. Since the number of relationships is counted for each data set, "2" displays as the value of ACT for the volume even though there is only one relationship. In the second case, VOL#0 and the VOL#1 have two active relationships. Each volume has two data sets for the relationships, and thus "2" displays as the value of ACT for each volume.

Figure. The number of relationships displayed in ACT

The following is an example of the FCQUERY command using the SHOWRELS parameter.

Table. FCQUERY command output
Item	Value	Description
RELATIONSHIP DETAIL STARTING TRACK	Starting address	CCHH number of the starting address. The CCHH number specified here is displayed if the STARTADDR parameter is specified. "00000000" is displayed if the STARTADDR parameter is not specified.
DEVICE LONG BUSY FOR CG	Y	The consistency of the extent is maintained.
DEVICE LONG BUSY FOR CG	N	The consistency of the extent is not maintained.
WRITE INHIBITED	Y	Writing is not allowed.
WRITE INHIBITED	N	Writing is allowed.
DEVICE IN SAFEGUARDED COPY RELATIONSHIP	N	This is a device in a SAFEGUARDED COPY relationship. NO, is always displayed because Compatible FlashCopy^® V2 does not support this function. For details, see the IBM^® documentation.
LSS	CU number	CU number
CCA	LDEV number	LDEV number in the CU
SSID	Storage subsystem ID	Storage subsystem ID
SOURCE START	Starting source extent CCHH number	The starting CCHH number of the copy source extent
TARGET START	Starting target extent CCHH number	The starting CCHH number of the copy target extent
SO	Y	This is a source volume of a relationship.
SO	N	This is a target volume of a relationship.
FV	Y	The relationship is established for the full volume.
FV	N	The relationship is not established for the full volume.
CO	Y	The relationship is created with COPY mode.
CO	N	The relationship is created with NOCOPY mode.
CA	Y	Background copy is active.
CA	N	Background copy is not active.
PR	Y	It is a persistent relationship.
PR	N	It is not a persistent relationship.
CR	Y	Changes are recorded as differential data if the S-VOL and T-VOL are updated. This is an Incremental Type1 relationship.
	2	Changes are recorded as differential data if the S-VOL and T-VOL are updated. This is an Incremental Type2 relationship.
	N	Changes are not recorded as differential data, even if the S-VOL and T-VOL are updated. This is not an incremental relationship.
TW	Y	Writing to the T-VOL is allowed.
TW	N	Writing to the T-VOL is not allowed.
SE	N	The T-VOL is not a TSE-VOL.
	F	The T-VOL is a TSE-VOL. (When the pool is full, the relationship is in failed state.)
	I	The T-VOL is a TSE-VOL. (When the pool is full, writing to the S-VOL is not allowed.)
FS	Y	The relationship is in failed state.
FS	N	The relationship is not in failed state.
PM	N	The relationship is established without using the Preserve Mirror FlashCopy^® function.
	P	The relationship is established by specifying PREFERRED in the Preserve Mirror FlashCopy^® function.
	R	The relationship is established by specifying REQUIRED in the Preserve Mirror FlashCopy^® function.
	S	The relationship is established between the two TCz S-VOLs with the Preserve Mirror FlashCopy^® function.
	U	The relationship is in the status where the type of the Preserve Mirror FlashCopy^® function (PREFERRED or REQUIRED) cannot be identified because the P-VOL and S-VOL of TCz are mixed.
RA	N	This is a CONSISTENCY GROUP RESERVATION ACTIVE relationship of SAFEGUARDED COPY. NO, is always displayed because Compatible FlashCopy^® V2 does not support this function. For details, see the IBM^® documentation.
SG	N	This is a relationship of SAFEGUARDED COPY. NO, is always displayed because Compatible FlashCopy^® V2 does not support this function. For details, see the IBM^® documentation.
RR	N	This is a RECOVERY relationship of SAFEGUARDED COPY. NO, is always displayed because Compatible FlashCopy^® V2 does not support this function. For details, see the IBM^® documentation.
WP	N	The relationship is in WITHDRAW PENDING status. NO, is always displayed because Compatible FlashCopy^® V2 does not support this function. For details, see the IBM^® documentation.
NO. OF TRACKS	Number of tracks	The number of tracks in the relationship.
TRACKS TO COPY	Number of tracks	Displays the number of tracks that have not been copied.