pbdBASE (version 0.5-3)

blacsexit: BLACS Exit

Description

Shuts down all BLACS communicators.

Usage

base.blacsexit(CONT = TRUE)
blacsexit(CONT = TRUE)

Arguments

CONT

logical; determines whether or not to shut down all MPI communicators

Value

Has an invisible return of 0 when successful.

Details

If the user wishes to shut down BLACS communicators but still have access to MPI, then call this function with CONT=TRUE. Calling blacsexit(CONT=FALSE) will shut down all MPI communicators, equivalent to calling

> blacsexit(CONT=TRUE) > finalize(mpi.finalize=TRUE)

This function is automatically invoked if BLACS communicators are running and finalize() is called.

Examples

# NOT RUN {
spmd.code <- "
  suppressMessages(library(pbdMPI))
  suppressMessages(library(pbdBASE))
  init.grid()

  ### Do something with BLACS here.

  ### Don't use this unless you know what to do after this.
  # blacsexit()

  ### Then, do others without BLACS here.

  finalize()  # This should be off since blacexit().
"
pbdMPI::execmpi(spmd.code = spmd.code, nranks = 2L)

# }