{
{ CML$7155_1X_FAILURE_DATA
{
{
{ PURPOSE:
{    The purpose of this statistic is to record the failure data
{ captured by the system when accessing a 7155_1x disk subsystem.
{
{ FREQUENCY: At occurrence of failure.
{
{ CONTENT:
{    The  descriptive-data portion of this statistic contains:
{
{   '<mf>.<iou>.<pp>.<channel>.<controller>.<unit>*<vsn>*<class>*..
{      <symptom>'
{
{      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 either the string 'PPn' or 'CPPn' and where 'n'
{        is the decimal representation of the logical PP number used
{        to process the failing request.  Note that 'CPP' is the
{        designation given to the concurrent PPs in an I4 IOU.
{
{      where <channel> is either the string 'CHn' or 'CCHnp',
{        where 'n' is the decimal representation of the channel and
{        where 'p' is the channel port (A or B) through which the
{        disk device was accessed.  Note that 'CCH' is the
{        designation given to the concurrent channels in an I4 IOU.
{
{      where <controller> is the element name of the disk controller
{        used in the failing request.
{
{      where  <unit> is the element name of the failing disk storage
{        device used in the failing request.
{
{      where <vsn> is the recorded-vsn of the disk volume which  was
{        the object of the failing request.
{
{      where  <class>  is  the string 'UF' for unrecovered, 'RF' for
{        recovered, 'IF' for intermediate failure log-entry, and 'IM'
{        for informative message.
{
{        The PP reports failure data and diagnostic results  as  an
{        intermediate  failure  log-entry  prior  to retrying an i/o
{        request.  This is due to  PP-memory-size  limitations.   An
{        intermediate    failure    log-entry   will   provide   the
{        first-failure data captured by the PP  during  the  initial
{        attempt  at  the  request  or  during  a subsequent request
{        retry.  This  log-entry  provides  the  initial  and  final
{        failure data for an intermediate, unsuccessful i/o request
{        retry.  At least  one  additional  request  retry  will  be
{        performed after this log-entry is made.
{
{        For  unrecovered  disk failures the counter values contain
{        the failure data corresponding  to  the  last  unsuccessful
{        retry of the i/o request.  This log-entry provides
{        the   initial   and  final  failure  data  for  the  final,
{        unsuccessful i/o request retry.
{
{        For  failures  corrected  during  sector-oriented  (media)
{        recovery, the counter values contain the first-failure data
{        captured by  the  PP.   This  log-entry  is  only  made  to
{        document successful sector-oriented recovery.
{
{      where <symptom> is the symptom/action statement  provided  by
{        the system.
{
{    The  descriptive-data portion of this statistic contains:
{
{    1.  Logical PP number (bits 58 - 63).
{        Bit 57 = 1 implies that the PP is an I4 concurrent PP.
{        Bits 46 - 51 contain the IOU number.
{
{    2.  Channel Number of Controller (bits 58 - 63).
{        Bit 57 = 1 implies that the channel is an I4 concurrent
{        channel.
{        Bits 46 - 51 contain the IOU number.
{
{    3.  Equipment Number of Controller
{    4.  Physical Unit Number
{    5.  Unit-type (identifies the kind of unit, i.e.  product id)
{        1 - 844-4x
{        2 - 885-1x
{    6.  Logical Operation Code
{        1 - read
{        2 - write
{        4 - read_flaw_map
{        5 - disk_driver_initialization
{    7.  Log-entry Class
{        0 - Recovered Failure Report
{        1 - Unrecovered Failure Report
{        2 - Intermediate Failure Report
{        3 - Informative Message
{    8.  Failure Symptom Code
{        1 - INDETERMINATE (channel or controller or unit)
{        2 - INPUT CHANNEL PARITY - On an input from controller to
{            PP the channel-error-flag was set.
{        3 - OUTPUT CHANNEL PARITY - On an output from the PP to the
{            controller, the controller reported a parity error in
{            detailed status but the channel-error-flag was not set.
{        4 - CONTROLLER FAILURE - (reported by controller)
{        5 - UNIT FAILURE
{        6 - FUNCTION TIMEOUT - (controller not responding)
{        7 - UNIT RESERVED - (unit reserved to opposite access)
{            During i/o request processing the PP driver attempts
{            to connect to the target unit.  If it cannot connect
{            to the unit, this statistic is generated.  The driver
{            will terminate the i/o request as a result of the
{            failure.
{        8 - CONTROLLER RESERVED - (to another channel)
{            During i/o request processing the PP driver attempts
{            to obtain the coupler reservation.  If not successful for
{            10 seconds, this statistic is generated.  The driver will
{            continue to try to obtain the coupler reservation until
{            successful.
{        9 - SEEK FAILURE
{        10 - ERROR IN CHECKWORD
{        11 - CONTROLLER RAM PARITY
{        12 - INCOMPLETE SECTOR TRANSFER
{        15 - UNIT NOT READY - START switch off, unit not spun up or
{            dropped ready
{        16 - UNIT OFF LINE OR NOT CABLED - 844 unit has switch on back
{            of unit in offline position or unit not cabled
{            to controller.
{        17 - UNIT READ ONLY SWITCH ON - 885 unit has write-inhibit
{            switch set
{        18 - CHAN ENABLE SWITCH OFF OR UNIT NOT CABLED - 885 unit has
{            CHAN ENABLE switch off or unit is not cabled to the
{            controller.
{        19 - FLAWED TRACK - a sector with a track flaw bit set
{            has been read/written.  This may indicate that the
{            Utility Map is wrong or there is a NOS/VE software
{            problem.
{        20 - FLAWED SECTOR - a flawed sector on an 844 unit has been
{            read/written.  This may indicate that the Utility MAP is
{            wrong or there is a NOS/VE software problem.
{        21 - SECTOR ADDRESS MISCOMPARE
{        22 - CYLINDER ADDRESS MISCOMPARE
{        23 - LOST CONTROL WORD
{        24 - IOU OUTPUT PARITY - On an output from PP to controller
{            both the channel-error-flag and the controller's detailed
{            status indicated a parity error occurred.
{        25 - INDETERMINATE OUTPUT PARITY - On an output from PP to
{            controller the channel-error-flag was set but there was
{            no error reported by the controller.  This may mean there is
{            a problem in the IOU and/or the channel and/or the
{            controller.
{        26 - SOFTWARE FAILURE - The driver has detected an error
{            in the CP/PP interface.
{        27 - ADDRESS ERROR - Word 1, bit 3, is set in the detailed
{            status.
{        28 - TRACK ADDRESS MISCOMPARE - Word 1, bit 1, is set in the
{            detailed status.
{        29 - DRIVE NOT SELECTED - Word 9, bit 8, = 0, in the detailed
{            status.
{        30 - CONTROLLER - DRIVE INTERFACE ERROR -
{            - Word 18, bit 4, is set in the detailed status; or
{            - If the command was a seek, and word 13, bits 8 - 0
{              are nonzero. (885)
{        31 - PP - CONTROLLER DATA INTEGRITY - Data was transferred
{             between the PP and the controller, no error was detected,
{             but the data miscompared.
{        32 - PP - DRIVE DATA INTEGRITY - Data was written to disk, then
{             read from disk.  No error was detected, but the data
{             miscompared.
{        33 - WRITE BUFFER TO DISK ERROR
{        34 - PROCESSOR INSTRUCTION TIMEOUT - an internal controller
{             channel used to function the disk has timed out.
{        35 - BM REGISTER PARITY ERROR - The controller buffer memory
{             output register detected a parity error during a write
{             to disk.
{        36 - WRITE VERIFY ERROR
{        37 - MEDIA FAILURE - The confidence test passed and retries of
{             the request failed.  The sector is also software flawed
{             when this is the message.
{        38 - CONFIDENCE CYLINDER IS FLAWED - Sector or track flaw bits
{             are set in every address of every sector on the cylinder,
{             so the confidence test can not be run.
{        39 - LOADING CONTROLWARE - This is an informative message that
{             controlware is being loaded.
{    9.  Request Retry Count
{        The number of times the PP driver retried the i/o request
{        from the beginning.
{    10. Sector Retry Count
{        The number of retries that the PP driver performed on the
{        failing sector on the last attempt to retry the i/o request.
{    11. Cylinder number of initial seek
{    12. Track number of initial seek
{    13. Sector number of initial seek
{    14. Cylinder number of failure - This is normally the cylinder
{        number in the disk request.  However, if the failure occurred
{        while running the confidence test, the cylinder number will be
{        821 for an 844 drive and 842 for an 885 drive.
{    15. Track number of failure
{    16. Sector number of failure
{    17. Residual byte count on incomplete channel transfer
{    18. Failing Function
{        The function that caused the initial recovery attempt.
{        The value is extracted from the initial detailed status if
{        the controller provides status after the failure.  On a
{        function timeout, the function reported is the one which
{        was outstanding when the controller hung.
{
{   First-failure Data:
{     19.       Poll Status
{                     (right justified)
{     20 .. 39. Words 1..20 of Detailed Status
{                     (right justified)
{
{   The following failure data is only provided in the
{   cases where the Log-entry Class is unrecovered or
{   intermediate.  The data represents the subsystem
{   status at the end of the intermediate or final
{   request retry.
{
{   Last-failure Data:
{     40.       Poll Status
{                     (right justified)
{     41 .. 60. Words 1..20 of Detailed Status
{                     (right justified)
{

  CONST
    cml$7155_1x_failure_data = cmc$min_ecc + 4101;

*copyc cmc$condition_limits



