Index for Section 3

Alphabetical listing for I

Bottom of page

imc_ckerrcnt_mr(3)
NAME
  imc_ckerrcnt_mr - Checks for the existence of outstanding errors on a
  specified logical rail 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_mr (
	 int  *errcnt,
	 int  logical_rail );

PARAMETERS
  errcnt    Specifies the current process error count on the specified
	    logical rail, and returns the updated error count.

  logical_rail
	    Specifies the Memory Channel logical rail that is to be checked
	    for errors.	 The first logical rail is numbered 0, the second
	    logical rail is numbered 1, and so on, up to a maximum defined by
	    a constant, IMC_MAXRAILS.

DESCRIPTION
  The imc_ckerrcnt_mr() function checks for the existence of outstanding
  errors on the specified Memory Channel logical rail. It returns the
  IMC_MC_ERROR value if any of the following conditions apply:

    ·  The function detects an outstanding error on the specified logical
       rail.

    ·  The function detects that error handling is in progress.

    ·  The error count is greater than the value supplied in the errcnt
       parameter.

  If the error count is being updated at the time the imc_ckerrcnt_mr()
  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_mr() function along with the imc_rderrcnt_mr()
  function to construct application-specific error-detection protocols.

RETURN VALUES
  The imc_ckerrcnt_mr() 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 on the specified logical
	    rail; or, error handling is in progress; or, the error count is
	    greater than the value supplied in the errcnt parameter.

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

  IMC_BADRAIL
	    The logical rail number specified in the call to the
	    imc_ckerrcnt_mr function is invalid; or, the logical rail is
	    inactive.

  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 complete the operation.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

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

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page