Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

blacs_get

Gets values that BLACS use for internal defaults.

Syntax

call blacs_get
(
icontxt
,
what
,
val
)
Input Parameters
icontxt
INTEGER
. On values of
what
 that are tied to a particular context, this parameter is the integer handle indicating the context. Otherwise, ignored.
what
INTEGER
. Indicates what BLACS internal(s) should be returned in
val
. Present options are:
  • what
     = 0 : Handle indicating default system context.
  • what
     = 1 : The BLACS message ID range.
  • what
     = 2 : The BLACS debug level the library was compiled with.
  • what
     = 10 : Handle indicating the system context used to define the BLACS context whose handle is
    icontxt
    .
  • what
     = 11 : Number of rings multiring broadcast topology is presently using.
  • what
     = 12 : Number of branches general tree broadcast topology is presently using.
  • what
     = 13 : Number of rings multiring combine topology is presently using.
  • what
     = 14 : Number of branches general tree combine topology is presently using.
  • what
     = 15 : Whether topologies are forced to be repeatable or not. A non-zero return value indicates that topologies are being forced to be repeatable. See Repeatability and Coherence for more information about repeatability.
  • what
     = 16 : Whether topologies are forced to be heterogenous coherent or not. A non-zero return value indicates that topologies are being forced to be heterogenous coherent. See Repeatability and Coherence for more information about coherence.
Output Parameters
val
INTEGER
. The value of the BLACS internal.
Description
This routine gets the values that the BLACS are using for internal defaults. Some values are tied to a BLACS context, and some are more general. The most common use is in retrieving a default system context for input into
blacs_gridinit
 or
blacs_gridmap
.
Some systems, such as MPI*, supply their own version of context. For those users who mix system code with BLACS code, a BLACS context should be formed in reference to a system context. Thus, the grid creation routines take a system context as input. If you wish to have strictly portable code, you may use
blacs_get
 to retrieve a default system context that will include all available processes. This value is not tied to a BLACS context, so the parameter
icontxt
 is unused.
blacs_get
 returns information on three quantities that are tied to an individual BLACS context, which is passed in as
icontxt
. The information that may be retrieved is:
  • The handle of the system context upon which this BLACS context was defined
  • The number of rings for
    TOP = 'M'
     (multiring broadcast/combine)
  • The number of branches for
    TOP = 'T'
     (general tree broadcast/general tree gather).
  • Whether topologies are being forced to be repeatable or heterogenous coherent.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804