A P P E N D I X  A

Sun S3L Array Checking Errors

Sun S3L interfaces do generic checking of the validity of the array handles that are passed as arguments to them. If such an array handle contains an invalid or corrupted value, the function terminates and one of the error codes listed in TABLE A-1 is returned.

TABLE A-1 Return Codes Associated With Array Handle Errors

Error Code

Definition

S3L_ERR_ARG_DTYPE

The data type specified for an array is not supported by Sun S3L.

S3L_ERR_ARG_ELEMSIZE

An array argument includes an invalid element size.

S3L_ERR_ARG_RANK

An invalid rank is specified for an array; it is either negative or larger than 32 (the largest supported array rank).

S3L_ERR_ARG_EXTENTS

An array argument includes a negative extent.

S3L_ERR_ARG_BLKSIZE

An array argument includes a negative blocksize.

S3L_ERR_ARG_BLKSTART

For a block-cyclic array distribution, an invalid starting process is specified; it is either negative or is larger than the extent of the corresponding process grid axis.

S3L_ERR_ARG_SFSIZE

An array argument includes an invalid subgrid size; it is either negative or is larger than the extent along the corresponding array axis.

S3L_ERR_ARG_MAJOR

An array argument includes an invalid majorness value.

S3L_ERR_ARG_PGRID_EXTENTS

An array argument includes an invalid process grid extent; it is either negative or larger than the total number of processes over which the array is defined.

S3L_ERR_ARG_PGRID_RANK

The rank of a process grid does not equal the rank of the corresponding array.

S3L_ERR_ARG_PGRID_MAJOR

An array argument specifies an invalid majorness value for a process grid.

S3L_ERR_ARG_PGRID_COOR

An array argument specifies a process grid coordinate that is either negative or larger than the process grid extent along that axis.