
{ CML$RHFAM_FAILURE_DATA
{
{ PURPOSE:  This statistic provides the information that is available
{    when the NAD PP driver encounters an abnormality, while
{    functioning the NAD.
{
{ FREQUENCY:  Each time the PP encounters an error a message is emitted.
{    If the error is retryable, then an intermediate failure condition
{    is logged.  Otherwise an unrecorvered failure is logged.
{
{ CONTENT:
{    Descriptive Data:
{
{    '<mf>.<iou>.<pp>.<channel>.<element>*<severity>*<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 and 'ssss' is the serial number of
{        that processor.
{
{      where <iou> specifies the string 'IOUn' where n identifies
{        the resident IOU of the channel (either 0 or 1).
{
{      where <pp> specifies the string 'PPn' where n is the decimal
{        representation of the logical PP used to access the channel.
{
{      where <channel> specifies the string 'CHn' where n is the decimal
{        representation of the physical channel used to access the NAD.
{
{      where <element> is the element name, specified in the PCU,
{        used to logically identify the NAD.
{
{      where <severity> specifies a string of two characters which
{        defines the severity of the error.
{
{        IF      Intermediate failure.
{        UF      Unrecovered failure.
{
{      where <symptom> specifies a string that briefly describes the
{        failure encountered by the PP.
{
{        0)  FUNCTION TIMEOUT
{        1)  CHANNEL ACTIVATE FAILED
{        2)  CHANNEL HUNG EMPTY
{        3)  PRIME FLAG TIMEOUT
{        4)  FLAG FUNCTION TIMEOUT
{        5)  ABNORMAL NAD RESPONSE
{        6)  NAD HARDWARE ABNORMAL
{        7)  INPUT TERMINATED EARLY
{        8)  OUTPUT TERMINATED EARLY
{        9)  CHANNEL PARITY ERROR
{       10)  UNIVERSAL COMMAND TIMEOUT
{       11)  NAD MEMORY ERROR
{       12)  CONCURRENT_CHANNEL_ERROR
{
{    Counters:
{
{      1 - Logical PP number.
{          Bit 57 = 1 implies that the PP is an I4 concurrent PP.
{          Bits 46 thru 51 contain the IOU number of the PP.
{
{      2 - Channel number of the channel that is physically connected
{            to the NAD.  Since only one NAD exists per channel
{            the channel number uniquely defines the NAD.
{          Bit 57 = 1 implies that the channel is an I4 concurrent
{          channel.
{          Bits 46 thru 51 contain the IOU number of the channel.
{
{      3 - Equipment number. (not used)
{
{      4 - Unit number. (not used)
{
{      5 - Unit type value.
{          1  = $380-170.
{
{      6 - Logical Operation Code.
{
{          0  = load the local NAD micro-code.
{          1  = dump the local NAD memory image.
{          2  = obtain the status of the connections
{               established through the local NAD.
{          3  = obtain statistics from the local NAD.
{          4  = send data across the network.
{          5  = receive data from the network.
{          6  = request the establishment of a connection
{               through the local NAD.
{          7  = accept an incoming connect request.
{          8  = reject an incoming connect request.
{          9  = obtain an incoming connect request.
{         10  = dump the remote NAD memory image.
{         11  = load the remote NAD micro-code.
{         12  = obtain statistics from the remote NAD.
{         13  = obtain the status of the corresponding
{               connection.
{         14  = terminate the connection in the local NAD.
{         15  = send a control message.
{         16  = receive a control message.
{
{      7 - Failure severity. (2 specifies a intermediate
{          failure and 1 specifies an unrecovered
{          failure.
{
{      8 - Symptom code.  A number which corresponds
{          to a symptom code defined in the descriptive
{          data section (e.g. a "0" is a FUNCTION
{          TIMEOUT).
{
{      9 - Retry count.  This parameter specifies the
{          current retry iteration being logged.  This
{          is used to correlate a sequence of messages.
{
{     10 - Connection number.  (A value of zero is used
{          for non-path related functions).
{
{     11 - The last controlware function issued.
{          If the function flag is clear then
{          this field contains the last
{          universal command subfunction issued.
{
{     12 - The last hardware function issued.
{
{     13 - Controlware status at time of failure.
{          A value of 0FFFF(16) means the status was not
{          available.
{
{     14 - Hardware status at time of failure.
{          A value of 0FFFF(16) means the status was not
{          available.
{
{          See the 380-170 NAD Hardware reference manual for
{          further documentation of the NAD functions and status
{          values.
{
{     15 - Transfer count.  This counter contains the number of
{          bytes that were transferred across the channel before
{          the error was encountered.  This counter is typically
{          only meaningful for abnormal I/O conditions.  However,
{          it can also provide trace information.

  CONST
      cml$rhfam_failure_data = cmc$min_ecc + 7200;

*copyc cmc$condition_limits

