The S3L safety mechanism offers two types of services:
It performs error checking and reporting during execution of S3L routines.
It synchronizes S3L processes so that, when an error is detected, the section of code associated with the error can be more readily identified.
The S3L safety mechanism can be set to operate at ony one of four levels, which are described in Table 7-2.
Table 7-2 S3L Safety Levels
Safety Level |
Description |
---|---|
0 |
Turns the safety mechanism off. Explicit synchronization and errorchecking are not performed. This level is appropriate for productionruns of code that have already been thoroughly tested. |
2 |
Detects potential race conditions in multithreaded S3L operations on parallel arrays. To avoid race conditions, an S3L function locks all parallel array handles in its argument list before proceeding. This safety level causes warning messages to be generated if more than one S3L function attempts to use the same parallel array at the same time. |
5 |
In addition to checking for and reporting level 2 errors, performsexplicit synchronization before and after each call and locates eacherror with respect to the synchronization points. This safety level isappropriate during program development or during runs for which a small performance penalty can be tolerated. |
9 |
Checks for and reports all level 2 and level 5 errors, as well as errorsgenerated by any lower levels of code called from within S3L. Performs explicit synchronization in these lower levels of code and locates each error with respect to the synchronization points. This level is appropriate for detailed debugging following the occurrenceof a problem. |
The S3L safety mechanism can be controlled in either of two ways:
By setting the environment variable S3L_SAFETY.
By using the calls S3L_set_safety and S3L_get_safety in a program.
To set the S3L safety level using the S3L_SAFETY environment variable, issue the command:
setenv S3L_SAFETY { 0 | 2 | 5 | 9 }