PLBCMP Keywords

The following keywords may be added to the [environment] section of the program information file (PLBWIN.INI) to alter the behavior of the PLBCMP compiler.

The .ini file name processing occurs as follows:

The runtime qualifies and uses an INI file when the file contains any section header. A section header is an INI file record that starts with '[' and is terminated with a ']'.
The runtime looks for and uses an INI filename found in three possible directories. The runtime always processes the INI files in the same order giving the user the ability to override globally defined parameters. The file name searching is as follows:

First, the runtime looks for an INI filename in the current working directory. This allows someone doing very specific and local program execution using keyword controls that override default keyword controls specified in (B) or (C) below.
Second, the runtime looks for an INI filename in the current user Windows directory. If the INI filename is found, it becomes the local keyword controls for the runtime. This allows someone to define workstation INI file controls. The local INI file controls can override (C) below.
Third, the runtime looks for an INI filename in the directory where PLBWIN.EXE is found. If the INI filename is found, it becomes the global (default) keyword controls for the runtime.

If the runtime is started WITHOUT using the '-i' option, the runtime looks for the default INI file named 'PLBWIN.INI' in the three possible areas. Any PLBWIN.INI files found in the three directories are then used to locate requested INI file keywords in the order as described in (2) above.
If the runtime is started WITH the '-i' option being specified and the INI file name DOES NOT have a path specified, the runtime looks for the INI file name in the three possible directories defined in (2) above. The runtime only processes the user named INI file from the three directories defined in (B) above. This means the 'PLBWIN.INI' is NOT used in this case.
If the runtime is started WITH the '-i' option being specified and the INI file name DOES have a path specified, the runtime looks for and uses the single specified INI file if found. This case DISABLES the runtime from processing multiple INI files as described in (2) above.

It important to note that when modifying the INI files, unpredictable results can occur if the file is compressed by the process of editing it. If the user is using the Sunbelt Editor to change the file, the '-E' option should be specified to output a non-compressed file.

Keyword	Purpose
PLBCMP_EXT	Define the default source file extension.
PLBCMP_FPOSIT	FPOSIT instruction returns the position of the beginning of the record.
PLBCMP_INCEXT	Defines the optional inclusion file extensions.
PLBCMP_OPT	Defines the default compiler options.
PLBCMP_OUT	Defines the output file path or name.
PLBCMP_PLBM	Defines the default compiler metadata output path.
PLBCMP_PRT	Defines the default compiler print output path or file.
PLBCMP_SRCEXT	Defines the optional source file extensions.
PLBCMP_WRK	Defines the optional compiler work directory.