- ,CTLVOL=ctlvol
- ,CTLVOL=NO_CTLVOL
- Is the name (RS-type)
(or address in register (2)-(12) ASM only)
of an optional 6-character input field containing the 6-character
volume serial of a control volume. The volume serial is
left-justified and padded on the right with blanks. This parameter
is required if the CTLDVC parameter is omitted or set to binary
zero. This volume is used to determine the subsystem and
device status and characteristics that are compared to the devices
in the VOLLIST parameter list. This parameter must identify a
device that is online to the host system where this QFRVOLS request
is issued.
The default is NO_CTLVOL.
- ,CTLDVC=ctldvc
- ,CTLDVC=NO_CTLDVC
- Is the name (RS-type) (or address in register (2)-(12) ASM only)
of an optional halfword input field containing the 2 hexadecimal
byte device number of a control volume. This parameter
is required if the CTLVOL parameter is omitted or set to binary
zero. This volume is used to determine the subsystem and device
status and characteristics that are compared to the devices in the
VOLLIST parameter list. This parameter must identify a device
that is defined to the host system where this QFRVOLS request
is being issued.
The default is NO_CTLDVC.
- ,VOLLIST=vollist
- Is the name (RS-type) (or address in register (2)-(12) ASM
only) of a required variable character input field containing
the list of volumes that are examined for capability and
eligibility in Fast Replication operations. Fast Replication
operations include ESS FlashCopy® and
RVA Snapshot.
The size and format of this volume list
area is described in the ANTQFRVL macro. For a description
of the ANTQFRVL macro, see ANTQFRVL macro.
- ,VOLSRCTGT=volsrctgt
- Is the name (RS-type) (or address in register (2)-(12) ASM
only) of a required 6-character input field containing the 6-character
identifier of which type of Fast Replication capability or
eligibility is determined for each of the volumes in the VOLLIST.
The identifier can be either one of the following, but cannot
be omitted.
SOURCE indicates the volumes in the VOLLIST are
checked for Fast Replication source volume capability or eligibility.
TARGET
indicates the volumes in the VOLLIST are checked for Fast Replication
target volume capability or eligibility.
There is no default.
- ,TGTPPRIM=tgtpprim
- ,TGTPPRIM=NO
- Specifies
whether the target in the FlashCopy relationship
can be the primary in a PPRC
pair. The values are:
- NO
- The target in this FlashCopy relationship
cannot be the primary in a PPRC pair. The default is NO.
- YES
- The target in this FlashCopy relationship
can be the primary in a PPRC pair. This request proceeds normally
to the specified target but the hardware ignores the PPRC status of
the target.
To code: Specify the RS-type address,
or address in register (2)-(12), of an optional 3-character field.
- ,RETINFO=retinfo
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 100-character
output field 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. The area should be aligned 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 about how to coordinate the RETCODE, RSNCODE, and
RETINFO fields.
- ,ALET=alet | 0
- Is the name (RS-type)
(or address in register (2)-(12) ASM
only) of an optional fullword input field that specifies the
ALET value be used for the QRYINFO field, the SRCEXTENTS field,
the TGTEXTENTS field, the SRCBITMAP field, and the TGTBITMAP
field. If the ALET parameter is specified, all of the fields
are referenced using the ALET value. Otherwise, all of the output
fields are referenced in the caller address space.
The default is 0.
- SEFLC=seflc
- ,SEFLC=NO
- This parameter is the
name (RS-type) or address in register
(2)-(12) of a three-character field that specifies whether
the space-efficient volumes are included as eligible target
volumes for a FlashCopy request.
The specified character value is left-justified and padded on the
right with blanks.
- NO
- Indicates that space-efficient volumes
are not eligible
to be FlashCopy targets
if VOLSRCTGT(TARGET) is specified. This is the default.
- YES
- Indicates that space-efficient volumes are
eligible to
be FlashCopy targets if
VOLSRTGT(TARGET) is specified.
- ,ECB=ecb
- ,ECB=NO_ECB
- Is the name (RS-type)
(or address in register (2)-(12) ASM
only) of an optional fullword input field that SDM posts for an
asynchronous request. This field is ignored for synchronous requests.
The
default is NO_ECB.
- ,WAITTIME=waittime | 0
- Is the name (RS-type)
(or address in register (2)-(12)
ASM only) of an optional halfword input field containing how
long, in seconds, SDM waits for a request to complete. A value
of zero means do not time the request. If the time expires before
the request is complete, a value of 7039 (RQST_WAITTIME_EXPIRED
- see ANTRQSTL) 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.
The default is 0.
- ,PRESMIR=presmir
- ,PRESMIR=NO
- Is
an optional 4-character input field that contains a keyword
that specifies whether Preserve Mirror configuration checking is
to be done as part of verifying the eligibility of the target. The
input field is an RS-type name or an address in register (2)-(12).
The value is left-justified and padded on the right with blanks.
- NO
- Indicates that Preserve Mirror checking
is not needed.
- REQ
- Indicates that
Preserve Mirror checking must be done. If the
device is not Preserve Mirror-eligible, the device is not eligible.
- PREF
- Indicates that Preserve Mirror
checking must be done. Target
volumes are eligible even if a Preserve Mirror operation cannot be
done, as long as the device is FlashCopy-eligible.
The default is NO.