Optional parameters

ODEVN
Specifies address information for the open device to be queried. (If CKD device address information is specified with this parameter, CKD data will be returned.) The values are:
serno
Specifies the storage subsystem serial number, which can include up to 12 digits depending on the type of logical subsystem.
lun
Specifies the 2-digit logical unit number. lun must be specified in X'' notation.
lss
Specifies a 2-digit hexadecimal value that identifies the logical subsystem for the device.
VOLUME
Directs PPRC to display the status of the volume that is specified with the DEVN parameter. The default value is VOLUME.
BITMAP
Specifies that PPRC report the percentage of tracks that it has copied for a pending or suspended PPRC primary volume. This option is valid when you query a PPRC primary volume and you either specify the VOLUME keyword, or you do not specify any optional parameters. BITMAP is ignored if you specify the PATHS keyword. If you specify the VOLUME keyword, the default value is BITMAP.
NOBITMAP
Specifies that PPRC not report the percentage of tracks that it has copied for a pending or suspended PPRC primary volume. This option is valid when you query a PPRC primary volume and you either specify the VOLUME keyword, or you do not specify any optional parameters.

You can use the NOBITMAP option to collect some data from a storage control even when the device is unable to respond to the CQUERY command.

Example: PPRC may not be able to collect bitmap information because the device is disabled.

PATHS
Directs PPRC to display all of the paths that are associated with the primary site storage control, and the status of each path. If you direct this command to the secondary device, PPRC cannot make path or storage control information available. To obtain this information, issue the command to a volume on that storage control that is either in simplex state or is a primary of a duplex pair.
FORMAT
Specifies that PPRC present the CQUERY command output in a block format. For examples refer to Examples of CQUERY output. The default value is FORMAT.

PPRC issues message ANTP0090I as part of a block report when you specify the CQUERY VOLUME with FORMAT option. PPRC issues message ANTP0095I as part of a block report when you specify the CQUERY PATH with FORMAT option.

UNFORMAT
Specifies that PPRC present the CQUERY command output as in the examples in CQUERY unformatted output for a primary volume for a volume query and CQUERY unformatted output with the PATHS option for a paths query.

PPRC issues message ANTP0091I as part of a block report when you specify the CQUERY VOLUME with UNFORMAT option.

PPRC issues message ANTP0096I as part of a block report when you specify the CQUERY PATHS with UNFORMAT option.

LINKINFO
Requests that PPRC display all of the potential connectivity of the Fibre Channel ports in the storage facility image (SFI) specified by the DEVN parameter to each system adapter port in the SFI specified by the SWWNN or SDEVN parameter.
SDEVN
Specifies the device number of the secondary volume that PPRC is to query. The device number is the 4-digit hexadecimal address of the device to which the I/O operation is directed.
SWWNN
Specifies the world wide node name of the secondary volume that PPRC is to query. The world wide node name is the 8-byte hexadecimal identifier of the SFI to which the I/O operation is directed.
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.

SSUBCHSET
Specifies the subchannel set for the secondary device specified with the SDEVN parameter. The subchannel set is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The 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.