Appendix A 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 following error codes 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.

Previous: Chapter 8 Sun S3L Core Library Functions