Index for Section 3

Alphabetical listing for I

Bottom of page

imc_ckerrcnt(3)
NAME
  imc_ckerrcnt - Checks for the existence of outstanding errors on Memory
  Channel hosts in a Memory Channel Application Programming Interface (API)
  cluster

LIBRARY
  Memory Channel API library (libimc.a)

SYNOPSIS
  #include <sys/imc.h>
  int imc_ckerrcnt (
	 int *errcnt );

PARAMETER
  errcnt    Specifies the current process error count across all logical
	    rails, and returns the updated error count.

DESCRIPTION
				     Note

       Compaq recommends using the imc_ckerrcnt_mr() function rather
       than the imc_ckerrcnt() function.

  The imc_ckerrcnt function checks for the existence of outstanding errors
  across all logical rails on the other Memory Channel hosts in a cluster. It
  returns the IMC_MC_ERROR value if any of the following conditions apply:

    ·  The function detects an outstanding error on another host in the
       cluster.

    ·  The function detects that error handling is in progress.

    ·  The total error count on all logical rails is greater than the value
       supplied in the errcnt parameter.

  If an error count is being updated at the time the imc_ckerrcnt() function
  is called, the function returns a negative value in the errcnt parameter.
  Programs should check for this eventuality and call the function again to
  ensure that the error has been handled.

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

RETURN VALUES
  The imc_ckerrcnt() function returns one of the following values:

  IMC_SUCCESS
	    Normal successful completion: no Memory Channel errors detected.

  IMC_MC_ERROR
	    A Memory Channel error was detected.

  IMC_BADPARM
	    An invalid parameter was specified in the call to the
	    imc_ckerrcnt() function.

  IMC_INITERR
	    A fatal error occurred while initializing the error-checking
	    mechanism.

  IMC_NOTINIT
	    This host has not been initialized to use the Memory Channel API
	    library.

  IMC_NORESOURCES
	    There are insufficient Memory Channel data structures available
	    to perform the operation.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

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

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page