Next: PROCESSORS_SHAPE() Up: Specifications of Intrinsic Previous: MINLOC(ARRAYDIM, MASK)

NUMBER_OF_PROCESSORS(DIM)

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 processor-dependent hardware processor array or, if DIM is absent, the total number of elements of the processor-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.