Error Handling

On successful completion, S3L_declare_detailed returns S3L_SUCCESS.

S3L_declare_detailed applies various checks to the arrays it accepts as arguments. If an array argument fails any of these checks, the function returns an error code indicating the kind of error that was detected and terminates. See Appendix A, S3L Array Checking Errors of this manual for a list of these error codes.

In addition, the following conditions will cause S3L_declare_detailed to terminate and return the associated error value:

• S3L_ERR_ARG_RANK - The rank specified is invalid in one of the following ways:

  • If called from a C/C++ program, it is negative or greater than 31

  • If called from an F77/F90 program, it is zero or greater than 32.

• S3L_ERR_ARG_EXTENTS - One or more of the array extents is less than 1.

• S3L_ERR_ARG_BLKSIZE - One or more blocksizes is less than 1.

• S3L_ERR_ARG_DISTTYPE - axis_is_local has one or more invalid values. See the description of axis_is_local in the Input section for details.