{
{ DECK: CMH$LSP_FAILURE_DATA_DOC
{ PURPOSE:
{    The purpose of this statistic is to record the failure data captured
{    by the system when accessing a STORNET/ESM memory device.
{    The File Server's PP reports initial failure data after the request
{    retry count has been exhausted. This log-entry provides the initial
{    and final failure data for the I/O failure.
{
{ FREQUENCY: At each failure occurrence.
{
{ CONTENT:
{    The  descriptive-data portion of this statistic contains:
{
{    '<mf>.<iou>.<pp>.<ch>.<element>.<class>.<message>'
{
{      where <mf> is the identification of the mainframe in the form
{        $SYSTEM_mmmm_ssss.  Where 'mmmm' is the model number of
{        Central Processor zero (CP0), e.g. 0990, and 'ssss' is the
{        serial number of that processor, e.g. 0104.
{
{      where  <iou>  is  the  string  'IOUn' where n is 0 or 1.
{        This identifies the IOU associated with the channel over
{        which the failure was reported.
{
{      where  <pp>  is the string 'PPn' where n is the PP number (in
{        decimal) of the PP which performed the i/o operation  which
{        is being reported.
{
{      where <ch> is the string 'CHn' where n is the channel number
{        number (in decimal) over which the i/o request was processed.
{
{      where  <element> is the element_name assigned to the STORNET
{        device via the PCU command DEFINE_ELEMENT.
{
{      where <class> is the string 'UF' when error is unrecovered and
{        'RF' when error is recovered.
{
{      where  <message>  is a statement describing the type of error
{        encountered. The failure message corresponds to the integer
{        in counter 8 of the statistics counter field.
{
{
{    The  counter-value portion of this statistic contains:
{
{    1.  Logical PP number (bits 58 - 63).
{        Bits 46 - 51 contain the IOU number.
{
{    2.  Channel Number (bits 58 - 63).
{        Bits 46 - 51 contain the IOU number.
{
{    3.  Always zero.
{    4.  Always zero.
{    5.  Unit-type
{           0 = ESM II
{           1 = STORNET
{    6.  Logical Operation Code (always 1)
{        1 - read
{        2 - write
{    7.  Log-entry Class
{        0 - Recovered Failure Report
{        1 - Unrecovered Failure Report
{    8.  Failure Analysis Code
{        Indicates the extent to which the subsystem and the PP were
{        able to isolate  the  failure when it was detected. The code
{        corresponds to the number preceding the failure messages.
{    9.  Request Retry Count
{        The number of times the PP retried the operation.
{   10.  First Word Address of the ESM/Stornet Buffer.
{   11.  Number of bytes to be transferred between ESM/Stornet and CM
{   12.  unused
{   13.  Last function issued on channel (bits 48 - 63).
{   14.  Residual byte count after executing block I/O instruction.
{   15.  ESM/Stornet Low Speed Port status after failure.
{
{        STATUS BIT   HEXIDECIMAL
{       (right most)  POSITION                ASSIGNMENT
{       ------------  -----------    ----------------------------
{           63          xxx1          Abort.
{           62          xxx2          Accept.
{           61          xxx4          Double bit error.
{           60          xxx8          Write operation in progress.
{           59          xx1x          Channel parity error.
{           58          xx2x          Memory address parity error (STORNET only)
{           57          xx4x          not used.
{           56          xx8x          not used.
{           55          x1xx          not used.
{           54          x2xx          Upper half of buffer memory enabled.
{           53          x4xx          High speed data transfer enabled.
{           52          x8xx          not used.
{
{ These counter values are set to -1 if not CY170 DMA Adapter channel or if
{ the failure did not occur during DMA mode I/O via the CY170 DMA Adapter.
{ (Refer to Engineering Specification No.22132530 for details.)
{   16.  CY170 DMA Adapter initial T register contents (if set prior to error).
{   17.  CY170 DMA Adapter Control Register contents.
{   18.  CY170 DMA Adapter Operational Status register contents.
{   19.  CY170 DMA Adapter Error Status register contents.
{
{        STATUS BIT   HEXIDECIMAL
{       (right most)  POSITION                ASSIGNMENT
{       ------------  -----------    ----------------------------
{           63          xxx1          KX board error.
{           62          xxx2          JY board error.
{           61          xxx4          KZ board error.
{           60          xxx8          BAS parity error.
{           59          xx1x          JY data error.
{           58          xx2x          12/16 conversion error.
{           57          xx4x          Input error.
{           56          xx8x          Overflow error.
{           55          x1xx          Clock fault.
{           54          x2xx          CMI read data parity error.
{           53          x4xx          Response code parity error.
{           52          x8xx          Invalid CM response.
{           51          1xxx          CM reject.
{           50          2xxx          Uncorrected CM error.
{           49          4xxx          not used.
{           48          8xxx          not used.
{
{   20.  CY170 DMA Adapter PP word count (Always 2).
{   21.  CY170 DMA Adapter T register contents at time of failure (if loaded).
{
{  The following failure messages correspond to the condition codes
{  defined in deck dfc$esm_driver_error_codes.
{  The <message> recorded in the engineering log entry is that shown below
{  preceded by the character string "ERR=VP730ncccc, " where 'n' is 2 if
{  device is Stornet, 3 if ESM II; and where 'cccc' is the symptom code.
{
{    1 - CHANNEL FUNCTION TIMEOUT               The channel did not go inactive
{                                               after function issued.
{    2 - IOU CHANNEL PARITY ERROR               A channel parity error was
{                                               detected by the IOU.
{    3 - ESM CHANNEL PARITY ERROR               A channel parity error was
{                                               detected by ESM/Stornet.
{    4 - ESM DOUBLE BIT PARITY ERROR            A double bit parity error was
{                                               detected by ESM/Stornet.
{    5 - ESM ADDRESS PARITY ERROR               ESM/Stornet detected parity
{                                               error on received address.
{    6 - ESM FLAG OPERATION ABORT               An unexpected abort on a four
{                                               bit flag operation occurred.
{    7 - ADAPTER UNCORRECTED CM ERROR           CY170 DMA Adapter status bit 50.
{
{    8 - ADAPTER CM REJECT                      CY170 DMA Adapter status bit 51.
{
{    9 - ADAPTER INVALID CM RESPONSE            CY170 DMA Adapter status bit 52.
{
{   10 - ADAPTER CM RESPONSE PARITY ERROR       CY170 DMA ADAPTER status bit 53.
{
{   11 - ADAPTER CMI READ PARITY ERROR          CY170 DMA ADAPTER status bit 54.
{
{   12 - ADAPTER CLOCK FAULT                    CY170 DMA ADAPTER status bit 55.
{
{   13 - ADAPTER INPUT BUFFER OVERFLOW          CY170 DMA ADAPTER status bit 56.
{
{   14 - ADAPTER INPUT DATA PARITY ERROR        CY170 DMA ADAPTER status bit 57.
{
{   15 - ADAPTER 12/16 CONVERTION ERROR         CY170 DMA ADAPTER status bit 58.
{
{   16 - ADAPTER JY DATA PARITY ERROR           CY170 DMA ADAPTER status bit 59.
{
{   17 - ADAPTER BAS (KX PP DATA) PARITY ERROR  CY170 DMA ADAPTER status bit 60.
{
{   18 - ADAPTER KZ BOARD DETECTED ERROR        CY170 DMA ADAPTER status bit 61.
{
{   19 - ADAPTER JY BOARD DETECTED ERROR        CY170 DMA ADAPTER status bit 62.
{
{   20 - ADAPTER KX BOARD DETECTED ERROR        CY170 DMA ADAPTER status bit 63.
{
{   21 - ESM ADDRESS OVERFLOW                   ESM LSP error status bits 62 & 63.
{
{   22 - CHANNEL INACTIVE ERROR                 Channel found to be inactive
{                                               when expected to be active.
{   23 - ADAPTER TRANSFER HALTED EARLY          The transfer halted early, more
{                                               detail unknown.
{   24 - LOW SPEED PORT DEADMAN TIMEOUT         The STORNET/ESM failed to fill or
{                                               empty the channel within time limit.

