- ,DEVN=devn
- A required input parameter field containing the binary
device number to use for I/O. If OPENDVCS=YES is specified, then devn identifies
a System z® device to act
as a CKD access volume. This device must
be located in the same subsystem cluster as the primary device.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 2-byte field.
- ,QRYSIZE=qrysize
- A required input parameter field that tells how big the area is
that QRYINFO refers to.
To code: Specify the RS-type address,
or address in register (2)-(12), of a halfword field.
- QRYSERIAL=qryserial
- When OPENDVCS=YES, this specifies the storage control
serial number that can include up to 12 digits, depending on the type
of storage control.
To code: Specify the RS-type address,
or address in register (2)-(12), of a required 12-character field.
- QRYLSS=qrylss
- When OPENDVCS=YES, this specifies the 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.
To code: Specify the RS-type
address, or address in register (2)-(12), of a required 1-character
field.
- QRYDVC =qrydvc
- When OPENDVCS=YES, this specifies the two-digit hexadecimal
value for the logical unit number (lun) for open devices, or the channel
connection address cca.
To code: Specify the RS-type
address, or address in register (2)-(12), of a required 1-character
field.
- ,QRYINFO=qryinfo
- A required output parameter field to be used to return the result
of the query. If the field is not big enough to contain the
complete result a return code of RQST_PQUERY_QRYSIZE_TOO_SMALL (see
ANTRQSTL) is placed in the return code part of RETINFO, and the total
amount of space required is placed in the reason code part of RETINFO.
If the field is big enough to contain the complete result a
return code of RQST_PQUERY_QRYSIZE_BIG ENOUGH (see ANTRQSTL) is placed
in the return code part of RETINFO, and the total amount of space
actually used is placed in the reason code part of RETINFO.
For PATHS(NO) message ANTP0091I is indicated on the
first line of the report. The output of this message is the unformatted
query report. For PATHS(YES) message ANTP0096I is indicated on the
last line of the report. The output for this message is the unformatted
query report.
The optional ALET parameter may be used to specify
the location of the QRYINFO field.
To code: Specify
the RS-type address, or address in register (2)-(12), of a character
field.
- ,RETINFO=retinfo
- A required output parameter field that is used to return detailed
information about the results of executing the request. Information
about the results of scheduling the request are returned in
the RETCODE and RSNCODE fields. Align the area on a word boundary.
The first 4-bytes contain the return code and the second 4-bytes
contain the reason code. The remainder of the information is dependent
on the return and reason codes. See the coding example SDM API usability guide about how to coordinate the RETCODE,
RSNCODE, and RETINFO fields.
To code: Specify the RS-type
address, or address in register (2)-(12), of a 100-character field.
- ,FORMAT=format
- ,FORMAT=LONG|PQMAP
- An optional input parameter field containing a keyword that specifies
the content of the PQUERY output. The value is left-justified and
padded on the right with blanks. If the field is set to binary zero,
the program uses the default.
LONG indicates
that all fields in the PQUERY output are filled with relevant information
as available. See Managing Peer-to-Peer Remote Copy operations for further
information. You can interpret the volume report by using Querying PPRC volumes and the paths report by using Querying PPRC paths.
PQMAP provides
the capability to return the result of a ANTRQST REQUEST=PQUERY in
a format mapped by Dsect ANTPQMAP. It is returned in an area of storage
that can be mapped using the ANTPQMAP MACRO. PQMAP indicates that
the data is not to be formatted. It will be returned in an area of
storage that can be mapped using the ANTPQMAP macro.
LONG is the default format.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a six-character field.
- ,ALET=alet
- ,ALET=0
- An optional input parameter field that specifies the ALET value
to use if the QRYINFO field has an ALET value different from the one
associated with the caller. The default is 0.
To code: Specify
the RS-type address, or address in register (2)-(12), of a fullword
field.
- ,BITMAP=bitmap
- ,BITMAP=YES
- An optional input parameter field containing a keyword that specifies
whether to access the bitmap for a primary device when determining
the percentage of synchronization for a pending or suspended volume
pair. This field is used only if DEVN specifies a primary volume.
The value is left-justified and padded on the right with blanks. If
the field contains binary zeros, the program uses the default.
NO directs
PPRC to not read the bitmap for the primary volume specified by DEVN.
YES directs
PPRC to read the primary volume's bitmap.
The default is YES.
Hint: If a P command has been issued to this
device, the I/O to read the bitmap will not complete until a PRUN
command is issued to this device. Use the WAITTIME parameter to return
to the program that executed ANTRQST.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 3-character field.
- ,PATHS=paths
- ,PATHS=NO
- ,PATHS=YES
- ,PATHS=LNK
- An optional input parameter field containing a keyword that specifies
whether to specify volume information or path information. The value
is left-justified and padded on the right with blanks. If the field
contains binary zeros, the program uses the default.
NO directs
PPRC to display the status of the volume specified by DEVN.
YES directs
PPRC to display all of the paths associated with the application site
storage control, and the status of each path.
LNK directs
PPRC to display all of the potential connectivity of the Fibre Channel
ports in the storage control specified by the DEVN parameter to each
system adapter port in the storage control specified by the SWWNN
or SDEVN parameter. If a device specified by SDEVN is the secondary
of an established PPRC pair, the query will fail. The exception to
this rule is if the secondary device is also the primary device of
another PPRC pair (cascading). Either SWWNN or SDEVN is required.
The
default is NO.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 3-character field.
- ,ECB=ecb
- ,ECB=NO_ECB
- An optional input parameter field that SDM will post for an asynchronous
request. This field is ignored for synchronous requests. The default
is NO_ECB.
To code: Specify the RS-type address, or address
in register (2)-(12), of a fullword field.
- ,SDEVN=devn
- An optional input field containing 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.
To code: Specify the RS-type address, or address
in register (2)-(12), of a 4-byte field.
- ,SWWNN=wwnn
- An optional input field containing 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 ESS to which
the I/O operation is directed.
To code: Specify the RS-type
address, or address in register (2)-(12), of an 8-byte field.
- ,WAITTIME=waittime
- ,WAITTIME=0
- An optional input field containing how long in seconds
SDM waits for a request to complete. A value of zero indicates that
the system does not time the request. If the time expires before
the request is complete, a value of 7240 (RQST_PQUERY_ERROR, with
a message ANTP0217E indicating I/O timeout) is returned. If the request
is a synchronous request, the value is placed in the return code part
of RETINFO. If the request is an asynchronous request, the value
is used as the ECB post code. If waittime is
less than five seconds, then SDM changes waittime to
five seconds. If waittime is greater than
255 seconds, SDM changes waittime to 255
seconds.
- ,SUBCHSET=subchset
- ,SUBCHSET=0
- 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 currently supported by the host system's
processor and configured for the device.
If you specify a value
of X'00' or omit this keyword, the command is issued to the
device that is currently 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.
To
code: Specify the RS-type name, or address in
register (2)-(12), of an optional 1-byte (character) field.
- ,SSUBCHSET=ssubchset
- ,SSUBCHSET=0
- ssubchset is the name (RS-type) or address in register
(2)-(12) of a 1-character field that specifies the subchannel set
for the device specified with the SDEVN parameter. This is the subchannel
set as defined in the Hardware Configuration Dialog (HCD). Valid values
are determined by what is supported by the host system's processor
and configured for the device.
If you omit this 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. If SSUBCHSET is specified without keyword SDEVN, it is ignored.