PRO/5 Compiler Options

 

Expanding Building->BBxPRO/5 Settings in the Options dialog displays a list of the options and parameters for compiling with pro5cpl, as shown in the image below. With the exception of the BBx PRO/5 Compiler Location and the Strip Output File Extension options, these options represent command line parameters given directly to pro5cpl. For more information, see PRO/5 Compiler.

 

Click on an area of the image below to see a pop-up window containing the item's description.

 

shg_bbx5_compiler_options.png

Properties

BBx PRO/5 Compiler Location

Path and filename of the pro5cpl compiler. Note: If PRO/5 is not installed, then the pro5cpl utility will not be available, and the user cannot create PRO/5 tokenized files.

Convert Label References

This represents the –l option.

Error Log File

This option corresponds to the –e parameter. If an error log is specified, the compiler errors will be written to a disk file instead of being displayed in the Compiler Output Window in NetBeans. In order to display compiler errors in NetBeans as hyperlinks connected to the original source, leave this option blank.

Line Number Increment

Represents the –i parameter.

Line Start Number

Represents the –s parameter.

Output Directory

This option is the –d parameter and represents the path to the directory where the complier places the tokenized files. For best results, the output directory listed in this option should already have been created and mounted in the NetBeans Explorer. If the directory does not exist, the compiler (BBjCpl, bbx4cpl or pro5cpl) will create it and populate it with tokenized files, but the results will not be visible in the Explorer. In order to create tokenized files in the same directory as the source files, leave this option blank.

Output File Extension

The –x parameter represents the extension added to the end of tokenized files. The extension is not limited to a certain number of characters. If the extension used here has been registered as a BBj module extension, the compiled files will be assigned a special icon in the Explorer to distinguish them from all other file types. Leaving this option blank triggers the same file naming behavior discussed in Strip Output File Extension.

RAM Size Allocation

The –m parameter.

Remove Comments

Setting the –r parameter option to 'true' gives the respective switch to the compiler. When set to 'false', it is not included in the command used to start the compiler.

Reserve Verbs As Keywords

The –k parameter.

Strip Output File Extension

This option removes the last file extension from the name of the compiled file, but only when the developer specifies an output directory and gives no extension. If the output directory was left blank, this option becomes non-applicable. See Strip Output File Extension for a summary of the rules applying to file naming behavior.