SQL/MX 3.2.1 Programming Manual for C and COBOL (H06.26+, J06.15+)

COBOL Program Compilation
HP NonStop SQL/MX Release 3.2.1 Programming Manual for C and COBOL—663854-005
16-52
Running the SQL/MX Program File
Security of the /usr/tandem/sqlmx/USERMODULES directory is very important. You
should restrict access so that users cannot alter the query plans in the modules or
remove modules. For information on securing modules, see the SQL/MX Release 3.2
Management Manual.
Running the SQL/MX Program File
An SQL/MX program can run in the OSS or in the Guardian environment. You can use
the GTACL command to start a Guardian program from OSS. You can use the osh
command to start an OSS program from a Guardian TACL session.

From the OSS environment, enter the program file name at the OSS shell prompt.
You can also use the OSS run command to run the program file by using specific
Guardian attributes (for example, a CPU or priority for the process).

From the Guardian environment, use the TACL osh command to run the program.
For more information, see Building SQL/MX COBOL Applications to Run in the
Guardian Environment on page 16-47.
For more information on the run or osh command, see the Open System Services
Shell and Utilities Reference Manual or the OSS reference pages.
Understanding and Avoiding Common Run-Time Errors
The details of how a COBOL executable is linked with its module or modules are
handled by the system and take place in the background. However, by understanding
this process and why certain run-time errors occur, you can avoid some common
SQL/MX application development issues.
Module File Errors
Error 8809 Unable to open module file
Error 8809 error occurs if module files are deleted from the base directory of the
application, the /usr/tandem/sqlmx/USERMODULES directory, user-specified
Guardian or OSS location(s) or both, or the application DLL location(s).
This error might also occur if the named module file exists but is not readable, or if the
required permission to access the volume, sub volume, or the OSS directory is not
granted. The owner of the module file must change the permission attributes to ensure
that an application can read the module file.
Error 8808 Module file name contains corrupted or invalid data
This error occurs when the timestamp encoded in the module file does not match the
timestamp passed from the application to the CLI. These timestamps are initially
generated by the preprocessor and are used to ensure that the version of the
application is synchronized with the version of the module file. This error can occur if
you run the preprocessor on your embedded SQL, compile the annotated COBOL