Use request type STATESAVE to request a standard or none-disruptive
state save, for the storage facility image (SFI) in which a specified
device resides, for certain error conditions. This invokes ANTRQST
ILK=ESSRVCS REQUEST=STATESAVE.
One statesave is allowed every 5 minutes. However,
only 10 non-disruptive statesaves are allowed in a 24-hour period.
- DEVN(devno)
- Specifies the 2-byte (4 hexadecimal digits) number of the device
to which the STATESAVE command is to be sent.
Because a state save is applicable to
an entire SFI, the device to which the command is issued does not
have to be the device on which an error occurred. IBM recommends
that an alternate device in the same SFI be used as the target for
the state save, as the device in error may not be available.
- NDSS(statesave)
- Specifies whether a non-disruptive state save should be taken.
- YES
- Requests a non-disruptive state save. This does not cause a warm
start of the SFI. This is the default.
- NO
- Requests a standard state save, with a resulting warm start in
the SFI.
- 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 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.
Use the following optional parameters to describe the state save.
The values are not checked or validated.
- CALLER(caller)
- Specifies the name of the caller requesting the state save. The default
is INTERNAL (the internal caller).
- CCA(cca)
- Specifies the CCA associated with the device where the initial error
occurred.
- DIAGREAS(diagreason)
- Specifies a diagnostic reason code to be associated with the state
save. This can be used to identify the problem that prompted the state
save.
- DIAGRETC(diagretc)
- Specifies diagnostic return code to be associated with the state
save. This can be used to identify the problem that prompted the
state save.
- FUNC(function)
- Specifies the function being performed at the time the state save
was requested. This is a free-form field that is not checked or validated.
You can specify anything that may help explain the conditions at the
time that the state save was requested.
- LSS(lss)
- Specifies the the
LSS associated with the device where the initial error occurred.
- SEQNO(seqno)
- Specifies the the
XRC read record set sequence number associated with the initial error.
- SESSION(session)
- Specifies the XRC session associated with the state save.
- TIME(timestamp)
- Specifies the time, in STCK format, associated with the state save.
The default is the time at which the state save I/O request is issued.
- TITLE(title)
- Specifies a title for the state save. This is a free-form text field
that is not checked or validated. You can specify anything that helps
explain the conditions at the time that the state save was requested.
The default is no title text.
- TYPE(functiontype)
- Specifies the type of function that was in control at the time the state
save was requested. The
values for functiontype are:
- CC
- Concurrent Copy
- FC
- FlashCopy
- FREEZE
- Freeze
- GC
- Global Copy
- GM
- Global Mirror
- MM
- Metro Mirror
- PATHS
- Establish or delete paths
- RUN
- Run
- SS
- SnapShot
- XRC
- Extended Remote Copy
- XRCER
- XRC Enhanced Reader