After recovery, a Failback performed by storage management
software or by a user command automatically unfences the secondary
volume.
- ,DEVN=devn
- A required input parameter field containing the device number
to which the FENCE command is issued.
If you also specify OPENDVCS=YES
then devn must identify a CKD device defined to the host system
making this request.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 2-byte field.
- ,ACTION=action
- A required input parameter field that specifies an action to take.
The values are FENCE or UNFENCE.
To code: Specify the RS-type
address, or address in register (2)-(12), of a 4-byte field.
- ,DVC=dvc
- An optional input parameter field that indicates the binary logical
unit number (LUN) for the device to be fenced or unfenced. This keyword
is required if you specify OPENDVCS=YES and SCOPE=DEV; it is ignored
otherwise.
To code: Specify the RS-type address, or address
in register (2)-(12), of a 1-byte field.
- ,ECB=ecb
- ,ECB=NO_ECB
- An optional input parameter field that SDM posts 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.
- ,LSS=lss
- An optional input parameter field that indicates the binary logical
subsystem number for the FB device to be fenced or unfenced. This
keyword is required if you specify OPENDVCS=YES; it is ignored otherwise.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 1-byte field.
- ,MASK=mask
- An optional input parameter field that specifies a 32-byte mask,
each bit of which represents a device on which to perform a soft fence
operation. Bit 0 of the first byte represents device 0. Bit 7 of the
last byte represents device 255. MASK is required when you specify
SCOPE=MASK. Otherwise, it is ignored.
To code: Specify the
RS-type address, or address in register (2)-(12), of a 32-byte field.
- ,OPENDVCS=opendvcs
- ,OPENDVCS=NO
- An optional input parameter field containing a keyword that indicates
if the request is for Open System (Fixed Block) devices. The value
is left-justified and padded on the right with blanks. If the field
contains binary zeros, the OPENDVCS keyword is treated as omitted.
- YES
- Specifies that the request applies to an Open System LSS or device.
- NO
- Specifies that the device specified with DEVN is a CKD device.
This is the default.
To code: Specify the RS-type address,
or address in register (2)-(12), of an optional 3-character field.
- ,RETINFO=retinfo
- An optional 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 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.
- ,SCOPE=scope
- ,SCOPE=DEV
- An optional input parameter field that specifies the scope of
the fence operation. The values and the scopes that they specify are:
- DEV
- The specified device only. This is the default.
- LSS
- All devices in the LSS of the device specified in the DEVN keyword
or the LSS keyword if OPENDVCS=YES.
- MASK
- All devices specified by with MASK. You must also specify the
MASK keyword with a non-zero mask.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 4-character field.
- ,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.
- ,WAITTIME=waittime | 0
- An optional input parameter 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 time expires before the request
completes, a value of 7039 (RQST_WAITTIME_EXPIRED) is returned. For
information about RQST_WAITTIME_EXPIRED, see ANTRQSTL. 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.