Compiling global procedures

This utility is used to compile specified global procedures in an application dictionary. If your application uses global procedures, you may need to use this utility under the following circumstances:

• If you transferred global procedures using the Transfer Resources utility, but didn’t have the Compile Scripts option marked, use the Compile Global Procedures utility to compile those global procedures.
• If you transferred global procedures into a dictionary using the Transfer Resources utility, but some global procedures couldn’t be compiled because resources were missing from the destination dictionary, use the Compile Global Procedures utility to compile the uncompiled global procedures after the missing resources have been included.
• Before you send out your application, it’s a good idea to compile all global procedures using the Compile Global Procedures utility. This ensures that all resources referenced by the global procedures are included in the dictionary, that the latest version of scripts are being used, and that the global procedures don’t contain any syntax errors.

To begin compiling global procedures, select an editable dictionary, then choose Compile Global Procedures from the Scripts menu to display the Compile Global Procedures window.

1. Select a series.

Select the series that includes the global procedures being compiled. The global procedures in that series will appear in the Scripts list.

2. Select compiling options.

The following options control how the scripts will be compiled.

Compiler Errors Only   Mark this option to include only compiler error messages in the status report that is printed after the global procedures are compiled. Otherwise, all status messages will be saved to the report.

Compile Debug   Mark this option to include debugging information in scripts, and to compile the debug and assert statements in your code. If you don’t mark this option, you won’t be able to use the Script Debugger, and the debug and assert statements won’t be executed. We recommend unmarking this option in the final version of your application to ensure optimal script performance.

3. Select scripts to compile.

Select the global procedures to compile by selecting each one and clicking Insert to add it to the list of selected scripts. Double-clicking a script performs the same function. You can select and compile procedures from several series at one time. To compile all global procedures in the selected series, click Insert All. Use the Remove and Remove All buttons to remove scripts from the Selected Scripts list.

4. Compile scripts.

Click the Compile button to compile the selected global procedures. The Report File Name dialog box will appear. Enter the name and location for the Compile Global Procedures Status Report file, then click OK to continue the compiling process, or click Cancel to return to the Compile Global Procedures window.

5. Use the status report to verify that scripts compiled.

Once compiling is complete, the status report will be printed to a text file. This report lists each global procedure along with a message that indicates whether it was compiled successfully. If the global procedure wasn’t compiled successfully, the message indicates the compiler error that occurred. If you mark Compiler Errors Only, only information about scripts that couldn’t be compiled will appear in the report.

Documentation Feedback

---