NAME
     NUMBER_OF_PROCESSORS

SYNOPSIS
     USE HPF_LIBRARY

     NUMBER_OF_PROCESSORS(DIM)

DESCRIPTION
     NUMBER_OF_PROCESSORS returns the total number of  processors
     available  to the program or the number of processors avail-
     able to the program along a specified dimension of the  pro-
     cessor array.

ARGUMENTS
     DIM  this is an optional argument.  If present, it  must  be
          scalar  and of type integer with a value in the range 1
          <= DIM <= n, where n is the rank of MASK.

RESULT TYPE
     Default integer scalar.

SEE ALSO
     PROCESSORS_SHAPE.