1MSTAT(3PVM)                     PVM Version 3.4                    MSTAT(3PVM)
2
3
4

NAME

6       pvm_mstat - Returns the status of a host in the virtual machine.
7
8

SYNOPSIS

10       C    int mstat = pvm_mstat( char *host )
11
12       Fortran   call pvmfmstat( host, mstat )
13
14

PARAMETERS

16       host    Character string containing the host name.
17
18       mstat   Integer returning machine status:
19                    value               MEANING
20                    PvmOk               host is OK
21                    PvmNoHost           host is not in virtual machine
22                    PvmHostFail         host is unreachable (and thus possibly failed)
23
24

DESCRIPTION

26       The  routine  pvm_mstat  returns the status mstat of the computer named
27       host with respect to running PVM processes. This routine can be used to
28       determine  if  a  particular host has failed and if the virtual machine
29       needs to be reconfigured. The function pvm_notify() can also be used to
30       notify the caller that a host has failed.
31
32

EXAMPLES

34       C:
35            mstat = pvm_mstat( "msr.ornl.gov" );
36
37       Fortran:
38            CALL PVMFMSTAT( 'msr.ornl.gov', MSTAT )
39
40

ERRORS

42       These error conditions can be returned by pvm_mstat
43
44       PvmSysErr
45              pvmd not responding.
46
47       PvmNoHost
48              giving a host name not in the virtual machine.
49
50       PvmHostFail
51              host is unreachable (and thus possibly failed).
52

SEE ALSO

54       pvm_notify(3PVM), pvm_config(3PVM)
55
56
57
58                                30 August, 1993                    MSTAT(3PVM)
Impressum