Index for Section 3

Alphabetical listing for I

Bottom of page

imc_rderrcnt(3)
NAME
  imc_rderrcnt - Reads the total error count across all logical rails

LIBRARY
  Memory Channel API library (libimc.a)

SYNOPSIS
  #include <sys/imc.h>
  int imc_rderrcnt ()

PARAMETERS
  The imc_rderrcnt() function does not take any parameters.

DESCRIPTION
				     Note

       Compaq recommends that you use the imc_rderrcnt_mr() function
       rather than the imc_rderrcnt() function.

  The imc_rderrcnt() function reads the total error count across all logical
  rails and returns the value to the calling program. The total error count
  is updated whenever a Memory Channel error occurs. The count is not
  guaranteed to be up to date with the most recent Memory Channel transfer.
  However, you can use it with the imc_ckerrcnt function to determine whether
  any errors occurred since the last time the count was updated.

  The Memory Channel hardware guarantees that no corrupt data will be written
  to host systems, and that all data will be delivered to the host systems in
  the sequence in which the data is written to the Memory Channel hardware.
  The atomic unit of transfer on Memory Channel is 32 bits.  Statistically,
  the error rate of the Memory Channel hardware is of the order of three
  errors per year.

  If an error count is being updated at the time the imc_rderrcnt() function
  is called, the function returns a negative value. Programs should check for
  this eventuality and call the function again to ensure that it reads the
  correct error count.

  You can use the imc_rderrcnt() function along with the imc_ckerrcnt
  function to construct application-specific error detection protocols.

RETURN VALUES
  On successful completion, the imc_rderrcnt() function returns a positive
  integer that contains the total error count.

  The imc_rderrcnt() function returns a negative value if the error count is
  being updated when the function is called.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

  Functions:  imc_api_init(3), imc_ckerrcnt(3), imc_ckerrcnt_mr(3),
  imc_perror(3), imc_rderrcnt_mr(3)

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page