shmem_pe_accessible(3)

NAME
     shmem_pe_accessible - Determines whether a processing element (PE) is
     accessible via SHMEM data transfer operations

SYNOPSIS
     C:

        #include <mpp/shmem.h>

        int shmem_pe_accessible(int pe);

     Fortran:

        #include <mpp/shmem.fh>

        LOGICAL LOG, SHMEM_PE_ACCESSIBLE

        INTEGER pe

        LOG = SHMEM_PE_ACCESSIBLE(pe)

DESCRIPTION
     shmem_pe_accessible is a query function that indicates whether a
     specified PE is accessible via SHMEM from the local PE.

     On IRIX systems, this function is needed when a message-passing
     application using both MPI and SHMEM is distributed over a cluster.
     In these cases, SHMEM communication is available only for PEs residing
     on the same host as the local PE.

     On SGI Altix 3000 series systems, SHMEM is supported across multiple
     partitioned hosts.  In this case, SHMEM communication is available for
     PEs residing on the same or different partitions from the local PE.

     When running multiple executable MPI applications using SHMEM on
     Altix, full SHMEM support is available between processes running from
     the same executable file.  However, SHMEM support between processes of
     different executable files is supported only for data objects on the
     symmetric heap, since static data objects are not symmetric between
     different executable files. The shmem_pe_accessible function on Altix
     returns TRUE only if the remote PE is a process running from the same
     executable file as the local PE, indicating that full SHMEM support
     (static memory and symmetric heap) is available.

RETURN VALUES
     C:        The return value is 1 if the specified PE is a valid remote
               PE for SHMEM functions; otherwise,it is 0.

     Fortran:  The return value is .TRUE. if the specified PE is a valid
               remote PE for SHMEM functions; otherwise, it is .FALSE..

SEE ALSO
     intro_shmem(3), shmem_addr_accessible(3)