If problems occur when a script is compiled, PocketBuilder displays messages in a Message window below the script.
Figure 6-4: Example of a script compilation error message
There are three kinds of messages:
Errors
Warnings
Information messages
Errors indicate serious problems that you must fix before a script will compile and before you can close the Script view or open another script in the same view. Errors are shown in the Message window as:
line number: Error error number:message
Warnings indicate problems that you should be aware of but that do not prevent a script from compiling.
There are three types of warnings:
Compiler warnings Compiler warnings inform you of syntactic problems, such as undeclared variables. PocketBuilder lets you compile a script that contains compiler warnings, but you must fix the problem in the script before you can save the object that the script is for, such as the window or menu. Compiler warnings are shown in the Message window as:
line number: Warning warning number:message
Obsolete warnings Obsolete warnings inform you when you use any obsolete functions or syntax in your script. Obsolete functions, although they still compile and run, have been replaced by more efficient functions. You should replace all references to obsolete functions as soon as possible. Obsolete warnings are shown in the Message window as:
line number: Warning warning number:message
Database warnings Database warnings come from the database manager you are connected to. PocketBuilder connects to the database manager when you compile a script containing embedded SQL. Typically, these warnings arise because you are referencing a database you are not connected to. Database warnings are shown in the Message window as:
line number: Database warning number:message
PocketBuilder lets you compile scripts with database warnings and also lets you save the associated object. It does this because the execution environment might be different from the compile-time environment, and the problem might not apply during execution.
You should study database warnings carefully to make sure the problems will not occur during execution.
Information messages are issued when there is a potential problem. For example, an information message is issued when you have used a global variable name as a local variable, because that might result in a conflict later.
Information messages are shown in the Message window as:
line number: Information number:message
To specify which messages display when you compile, select Design>Options to open the Options dialog box, select the Script tab page, and check or clear the Display Compiler Warnings, Display Obsolete Messages, Display Information Messages, and Display Database Warnings check boxes. The default is to display compiler and database warning messages. Error messages always display.
To fix a problem, click the message. The Script view scrolls to display the statement that caused the message. After you fix all the problems, compile the script again.
