Error Handling

On successful completion, S3L_declare returns S3L_SUCCESS.

S3L_declare applies verious 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 to terminate and return the associated error value:

• S3L_ERR_ARG_RANK - The rank specified is invalid.

• 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.