Skip to content
Thoroughbred Software InternationalThoroughbred Software InternationalThoroughbred DocumentationDocs

How to Use a Compile List

A compile list is a list of scripts that need to be compiled before they can be executed. To maintain applications, you can use the Generate Compile List and Compile from Generated List Utilities from the Dictionary-IV Development Menu.

The Generate Compile List Utility searches through a range or library of scripts. It compares the change date of the script, the change date of any copy script used by the script, and the change date of any definition such as a format or screen used by the script, to the compile date. If any of these change dates are more recent than the compile date, the utility puts the script in a compile list. After the library or range is checked, you can specify another range or library to search for script names to add to the list.

The name of the compile list is 4GLCLtt, where tt is the terminal ID. Any compile list is unique to the terminal where it is created. Each time you select the Generate Compile List Utility the compile list is erased before a new list is created.

The Compile from Generated List Utility compiles the scripts in the compile list.

How to Build a Compile List

Section titled “How to Build a Compile List”

To create a compile list, go to the Dictionary-IV Development Menu. Type 6 and press the Enter key. The GENERATE COMPILE LIST screen will be displayed:

Screenshot from How to Build a Compile List

You must answer the following questions:

Library:

Enter the name of the library that contains scripts you plan to include in the compile list.

Select everything (Y/N)?

Select one of the following:

Y means every script in the library will be checked.

N means you plan to specify a range of scripts to check.

from name:
to name:

To define a range of scripts, you can use the following specifications:

  • To specify all the scripts in the library, press the Enter key in the from name field and press the Enter key in the to name field.
  • To specify a range of scripts, type the name of the first script you plan to compile in the from name field and the name of the last script you plan to compile in the to name field.
  • To specify a single script, type the name of the script you plan to compile in the from name field and press the Enter key in the to name field.

In most cases, you only need to type enough of a script name to identify it as a unique name, then press the Enter key and let the system fill in the rest of the name.

using name mask:

A name mask enables you to select a set of scripts from a range of scripts. You do not have to compile all the scripts in the range and you do not have to select individual scripts to compile one at a time. If you do not plan to use a mask, press the Enter key.

Use the following information to define a mask:

  • A mask is a string of characters used to test the string of characters in the script name. A script name that matches the mask is selected for compilation.

  • A mask can contain match and passing characters. A character in a script name must be the same character as the match character and occur in the same position. The ? is the pass character, which means that no match in this position is needed.

    Mask action definition names A? selects AB Ac A1

    bypasses aB cA 11

After you have answered all of these questions, the following message will be displayed:

Is the displayed information correct (Y/N)?

Enter one of the following:

Y begins checking change dates using the displayed information.

N enables you to respecify the displayed information.

Press the Y key to check change dates. If no script needs to be compiled, the compile list will be empty. After the utility finishes processing, you will be returned to the GENERATE COMPILE LIST screen.

How to Compile from a Compile List

Section titled “How to Compile from a Compile List”

To compile all of the scripts on the compile list, go to the Dictionary-IV Development Menu. Type 7 and press the Enter key. The following message will be displayed:

Do you want to compile from 4GLCLtt generated date - time  (Y/N)?

Enter one of the following:

Y compiles the scripts on the compile list.

N halts the process and returns you to the Dictionary-IV Development Menu.

Press the Y key to compile the scripts on the compile list. If the compile list exists, and if it is not empty, the name of each script and its description will be displayed as it compiles. The script code will be listed below this information. To stop the compilation process at any time, press the Escape key.

Errors pause compilation. To continue compiling after an error is encountered, press the Enter key. For more information on the errors you may encounter, see the sections on How to Manage Compilation Errors and Error Messages.

After the compiler finishes processing, you will be returned to the Dictionary-IV Development menu.

If the compile list does not exist or is empty, the utility will display a message. Press the Enter key to return to the Dictionary-IV Development Menu.

From the Script-IV Developer Guide, version 8.9.1. Open this page in the PDF