- ,DEVN=devn
- A required input parameter field containing the binary
device number to use for I/O. DEVN must be a 4-digit hexadecimal address
of a configured device with a UCB on the System z® system issuing the command.
When
querying a local CKD device, this specifies the four-digit hexadecimal
device number of the volume.
When querying a local fixed block
device (OPENDVCS(YES) is specified), DEVN must specify a CKD access
volume located in the same subsystem cluster as the FB device identified
by QRYDVC in this command.
When querying a remote
fixed block device (both OPENDVCS(YES) and REMOTE(YES) are specified),
DEVN must specify a CKD access volume located in the same subsystem
cluster as the PPRC primary device that is paired with the PPRC secondary
acting as the FlashCopy source.
When
querying a remote CKD device (REMOTE(YES) is specified), DEVN must
specify the PPRC primary device that is paired with the PPRC secondary
acting as the FlashCopy source.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 2-byte field.
- QRYDVC =qrydvc
- When OPENDVCS=YES or REMOTE=YES is specified, this specifies
the two-digit hexadecimal value for the device being queried (either
connection address or logical unit number).
To code: Specify
the RS-type address, or address in register (2)-(12), of a required
1-character field.
- ,QRYSIZE=qrysize
- specifies the length of the QRYINFO area.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a required halfword input field.
- ,QRYSERIAL=qryserial
- When OPENDVCS=YES or REMOTE=YES is specified, this
identifies the storage control serial number that can include up to 10
digits, depending on the type of storage control.
To code: Specify
the RS-type address, or address in register (2)-(12), of a required
10-character field.
- ,QRYLSS=qrylss
- When OPENDVCS=YES or REMOTE=YES is specified, this
identifies 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.
- ,QRYSSID=qryssid
- When REMOTE=YES is specified without OPENDVCS=YES,
this is the two-byte binary unsigned SSID of the subsystem where the FlashCopy request is to occur.
This must be the same value as that specified for SSID on the
PPRC secondary in the PPRC establish command.
To code: Specify
the RS-type address, or address in register (2)-(12), of an optional
half-word field.
- ,OPENDVCS=opendvcs
- ,OPENDVCS=NO
- Specifies whether Open System (fixed block) devices
or CKD devices are addressed by this command. The values are:
- NO
- Specifies that the required parameters identify a CKD device.
The default is NO.
- YES
- Specifies that the required parameters identify a fixed block
device.
To code: Specify the RS-type address,
or address in register (2)-(12), of an optional 3-character field.
- ,REMOTE=remote
- ,REMOTE=NO
- 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 REMOTE=YES is specified, the request must be for a
full volume.
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 FlashCopy source device must be the PPRC
secondary of that DEVN.
When specifying an Inband request for
an Open System (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.
To code: Specify the RS-type address,
or address in register (2)-(12), of an optional 3-character field.
- ,FORMAT=FQMAP | NO
- specifies whether the data is to be formatted using
the ANTFQMAP macro. Specify the value FQMAP left-justified and padded
on the right with blanks for formatting. A value of binary zeros
defaults to NO.
To code: Specify the RS-type name, or address
in register (2)-(12), of an optional 6-character input field.
- ,QRYINFO=qryinfo
- specifies the name of a variable-character output
field that returns the result of the query.
If the field is not
big enough to contain the complete result, the program places a return
code of 7622 (RQST_FCQUERY_QRYINFO_TOO_SMALL) in the return code
part of RETINFO. The program places the total space required in the
reason code part of RETINFO.
If the field is big enough to
contain the complete result, the program places a return code of 7623
(RQST_FCQUERY_QRYINFO_LARGE_ENOUGH) in the return code part of RETINFO.
The program places the total amount of space that the result uses
in the reason code part of RETINFO.
You can use the optional
ALET parameter to specify the location of the QRYINFO field.
To
code: Specify the RS-type name, or address in register (2)-(12),
of a required variable-character output field.
- ,RETINFO=retinfo
- Is a required 100-character output field that the
program uses to return detailed information about the results of executing the
request. The name of the output field is a name (RS-type) or address
in register (2)-(12). The program returns information about the
results of scheduling the request in the RETCODE and RSNCODE
fields. Align the area on a word boundary. The first 4 bytes contain
the return code. The second 4 bytes contain the reason code. The remainder
of the information depends on the return and reason codes. See the
coding example about how to coordinate the RETCODE, RSNCODE, and
RETINFO fields.
- ,ALET=alet | 0
- Is an optional fullword input field that specifies the ALET value
that the program uses for the QRYINFO field, the SRCEXTENTS field,
and the TGTEXTENTS field. The name of the input field is a name (RS-type)
or address in register (2)-(12). If you specify the ALET parameter,
the program uses the ALET value to reference the QRYINFO field, the SRCEXTENTS field,
and the TGTEXTENTS field. Otherwise, the program does not use
the ALET value to reference any of the output fields.
The default is 0.
- ,ECB=ecb
- ,ECB=NO_ECB
- Is an optional fullword input field that SDM posts for an asynchronous
request. The name of the input field is a name (RS-type) or address
in register (2)-(12). The program ignores this field for synchronous
requests.
The default is NO_ECB.
- ,WAITTIME=waittime | 0
- Is an optional halfword input field that contains how long in
seconds SDM waits for a request to complete. The name of the input
field is a name (RS-type) or address in register (2)-(12). A value
of zero specifies that the requests should not be timed. If the time
expires before the request completes, the program returns a value
of 7039 (RQST_WAITTIME_EXPIRED). For information about RQST_WAITTIME_EXPIRED,
see ANTRQSTL. If the request is a synchronous request, the program
places the value in the return code part of RETINFO. If the request
is an asynchronous request, the program uses the value as the ECB
post code.
The default is 0.
- ,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.