Input

• extents - An integer vector whose length is equal to the number of dimensions in the array. Each element in extents specifies the extent of the corresponding array axis. Note that axis indexing is zero-based for the C interface and one-based for the Fortran interface, as follows:

  • When called from a C or C++ application, the first element of extents corresponds to axis 0, the second element to axis 1, and so forth.

  • When called from an F77 or F90 application, the first element corresponds to axis 1, the second to axis 2, and so forth.

• type - Specifies the array's data type; this must be a type supported by Sun S3L. See Chapter 4, Sun S3L Data Types for a complete list of supported data types.

• axis_is_local - An integer vector whose length equals the array's rank. Each element of axis_is_local controls the distribution of the corresponding array axis as follows:

  • If axis_is_local[i]= 0, axis[i] of the array will be block-distributed along axis [i] of the process grid.

  • If axis_is_local[i]= 1, axis[i] will not be distributed.

    If axis_is_local is NULL (C/C++) or if its first integer value is negative (F77/F90), this argument will be ignored.

• atype - Use one of the following predefined values to specify how the array will be allocated:

  • S3L_USE_MALLOC - Uses malloc() to allocate the array subgrids.

  • S3L_USE_MEMALIGN64 - Uses memalign() to allocate the array subgrids and to align them on 64-bit boundaries.

  • S3L_USE_MMAP- Uses mmap() to allocate the array subgrids. Array subgrids on the same node will be in shared memory.

  • S3L_USE_SHMGET - Uses shmget() to allocate the array subgrids. Array subgrids on the same node will be in intimate shared memory.