Optional Argument. `DIM`

Description. Returns the total number of processors available to the
program or the number of processors available to the program along a
specified dimension of the processor array.

Class. System inquiry function.

Arguments.

DIM (optional) must be scalar and of type integer with a value
in the range where is the rank of the
processor array.

Result Type, Type Parameter, and Shape. Default integer scalar.

Result Value. The result has a value equal to the extent of
dimension `DIM` of the implementation-dependent hardware processor array
or, if `DIM` is absent, the total number of elements of the
implementation-dependent hardware processor array. The result is always
greater than zero.

Examples. For a computer with 8192 processors arranged in a 128 by
64 rectangular grid, the value of `NUMBER_OF_PROCESSORS()` is
8192; the value of `NUMBER_OF_PROCESSORS(DIM=1)` is 128; and the
value of `NUMBER_OF_PROCESSORS(DIM=2)` is 64. For a
single-processor workstation, the value of `NUMBER_OF_PROCESSORS()`
is 1; since the rank of a scalar processor array is zero, no `DIM`
argument may be used.

Thu Dec 8 16:17:11 CST 1994