Explanation
When the XRC function encounters an I/O error,
the message text provides the following information:
- device_number – The device to which the
I/O is directed. If the device is associated with a primary XRC volume,
then the error can be a storage control error.
- abbreviated_error_description – A short
error code describing the type of error based on the sense information.
The valid codes are:
- Code
- Description
- BOC
- Bus out parity check
- CMD
- Command reject
- COR
- Correctable data check
- DCK
- Data check
- ENV
- Environmental data present
- EOC
- End of cylinder
- EQC
- Equipment check
- FPR
- File protect
- IMP
- Imprecise ending
- ITF
- Invalid track format
- LOG
- First error log
- M23
- MR23 record
- MTO
- Message to operator
- NRF
- No record found
- OVR
- Overrun
- PRM
- Permanent error
- RIW
- Request inhibit write
- VIO
- Intent violation
- WRI
- Write inhibited
- WRO
- Write operation
- ***
- Unknown
- failing_CCW_command_code – The CCW command
code that encounters the I/O error. If the error has occurred at the
first CCW in the chain (a Define Extent), the path to the storage
control or device can be dropped. This potential operations error
is due to the removal of the storage path.
- failing_CCW_position – The position in
the channel program chain on which the error occurs. If the error
occurs at the first CCW in the chain (a Define Extent), the path to
the storage control or device can have been dropped. This can indicate
an operations error because of the storage path being removed.
- IOS_completion_code – The return code
from IOS.
- subchannel_status – The channel status
word status field received from the subchannel.
- sense_data – The sense information returned
from the operation. See the storage control reference information for
interpretation of the sense data.
- serial_number – The volume serial number
of the device on which the I/O operation fails.
- full_error_description – A brief description
of the cause of the I/O error based on the sense data. See the ANTX5000E
message for an explanation of these descriptions.
System action
The XRC action taken is based upon the type of
error and the ERRORLEVEL specified on the XSTART command as follows:
- If ERRORLEVEL(SESSION) is selected, XRC will suspend all active
volumes in the session on any I/O error. Correct the error and restart
the XRC session. The session is suspended only if the volume is in
a duplex state at the time of the error. Errors before a volume reaching
duplex state do not affect the session. If the session is a coupled,
interlocked session, the error also causes volumes to be suspended
in all other sessions coupled to the same master session.
- If ERRORLEVEL(VOLUME) is selected, the scope of the error determines
the action taken. If the error occurs for a single primary or secondary
volume, only the affected volume pair will be removed from the session.
If the error impacts a storage control, all volume pairs using that
storage control will be removed from the session. Certain errors have
the potential to end the XRC session.
- If ERRORLEVEL(group_name) is specified, XRC
suspends all volumes that belong to the specified group. Correct the
error and add the volume pairs back into the session.
System programmer response
If the problem is an environmental
or hardware error, correct the error and restart the failing XRC function.
If the problem persists, search problem reporting databases for a
solution. If no solution exists, contact the IBM® Support Center. Provide the system log and
SVC dumps of the ANTAS000 and any ANTASnnn address spaces
that are active. To determine which address spaces are active,
enter the console command DISPLAY A,ANTAS*. In addition, provide
any SYS1.LOGREC information indicating the I/O error encountered.
In
any case, XRC processing for the impacted volume or volumes has ended.
Correct the error and restart the session or volumes.
Source
Extended remote copy (XRC).