Optional parameters

QRYSSID

When REMOTE(YES) is specified without OPENDVCS(YES), ssid is the 4-digit hexadecimal address of the storage subsystem where the FlashCopy® request is to occur. This must be the same value as that specified for SSID of the secondary device on the PPRC establish pair command.

QRYDVC

When OPENDVCS(YES) or REMOTE(YES) is specified, the value for dev is:

volume's storage control serial number: This can include up to 10 digits, depending on the type of storage control.
logical storage subsystem: This is a two-digit hexadecimal value for the logical subsystem (LSS) for the device (ESS only).
Note: The LSS number is required if the storage control supports logical subsystems (like the ESS) and not allowed if the storage control does not support logical subsystems.
channel connection address or logical unit number: The channel connection address is a two-digit hexadecimal value. The logical unit number is the two-digit hexadecimal value for the open device.

OPENDVCS

Specifies whether Open System (fixed block) devices or CKD devices are addressed by this command. The values are:

NO: The DEVN parameter identifies a CKD device. The default is NO.
YES: Specifies that the DEVN and QRYDVC parameters identify fixed block devices using a CKD access device.

REMOTE

Specifies whether the request is for a subsystem that is not directly attached to the issuing processor. The values are:

NO

The request is directed to a device on a subsystem locally attached to the issuing processor. The default is NO.

YES

The request is directed to a remote subsystem using Inband subsystem functions.

When specifying an Inband request for a CKD secondary device, DEVN must identify a PPRC primary device in a subsystem accessible by the host processor issuing the request, and the device specified as the FlashCopy source must also be the PPRC secondary for the DEVN device.

When specifying an Inband request for an open (fixed block) secondary device, DEVN must identify an online CKD System z® device located in the same subsystem cluster as the fixed block device of the PPRC pair with the secondary designated as FlashCopy target. The device specified as the FlashCopy Source device must be the PPRC secondary of a FB PPRC pair.

SHOWRELS

Indicates whether or not the device’s relationship table information is to be formatted and displayed. The values for SHOWRELS are:

NO: indicates that the relationship table information for the device is not to be displayed. This is the default.
ALL: indicates that the relationship table information for all of the relationships for the device is to be formatted and displayed.
number-of-relationships: indicates that the relationship table information for the device is to be formatted and displayed up to number-of-relationships. Valid values are 1 through 9999.

This requires FlashCopy Version 2. If the device does not support FlashCopy Version 2, the FlashCopy Version 1 relationship table query results are displayed.

The relationship table information does not appear in the SYSLOG.

STARTADDR

Indicates the starting track for a query on which the device’s relationship table information is to be displayed. The results start with relationships intersecting with track-address. track-address indicates the starting track by cylinder and head number.

UNFORMAT

Specifies that the information that is returned from the FCQUERY is to be formatted as a string of values separated by commas, similar to the information string returned to the ANTRQST API caller of FCQUERY. The default is formatted data.

Note: The UNFORMAT report is replaced by the FORMAT=FQMAP on the ANTRQST FCQUERY request. Thus, the UNFORMAT report is not updated.

SUBCHSET

Specifies the subchannel set in which the command is to be issued. The subchannel set where the I/O will be issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The valid values are determined by what is supported by the host system's processor and configured for the device.

If you omit the parameter, the command is issued to the device that is logically in subchannel set 0. If a swap has occurred, this could be the device that was defined in an alternate subchannel set in the I/O configuration (IODF), with HCD.