PROBE(2,L)                  AIX Technical Reference                  PROBE(2,L)



-------------------------------------------------------------------------------
probe



PURPOSE

Validates the status of a TCF cluster site.

SYNTAX

#include <sys/types.h>

int probe(sitenum)
siteno_t sitenum;

DESCRIPTION

The probe system call tells the system to check a site to determine its status.
To do this, the system sends an "are you there" message to the site.  If the
site does not respond, system status information is updated to indicate that
the site is no longer in the TCF cluster.  If the site responds, but was
previously thought to be down, the distributed topology change algorithm is run
to bring the site into the TCF cluster.

sitenum is the number of the site being probed.

RETURN VALUE

Upon successful completion, a value of 0 is returned to the calling process.
Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERROR CONDITIONS

The probe system call fails if one of the following is true:

EBADST    sitenum is an invalid site number.

ESITEDN1  The requested site is down.

RELATED INFORMATION

In this book:  "getsites."












Processed November 7, 1990        PROBE(2,L)                                  1