Override configuration resources

Override resources defined in the GAS configuration file at the command line when starting the dispatcher.

Understanding resources

The GAS includes several configuration resources listed in the <RESOURCE_LIST> section of the $FGLASDIR/etc/as.xcf file. These resources define how the GAS operates and allow you to customize its behavior. They include settings for the application environment, such as where to store or retrieve data, how long applications and services can run before timing out, and how to manage log levels.

Configuration resources often come with default values that are used by other resources and configuration elements. For instance, the resource res.appdata.path defines the location where application data is stored, and this path is established during the installation of the GAS.
<RESOURCE Id="res.appdata.path" Source="INTERNAL">$(res.path.as)/appdata</RESOURCE>
Additionally, some resources, like res.path.gbc.user and res.path.webcomponent.user, are not predefined by the GAS.
<RESOURCE Id="res.path.gbc.user" Source="INTERNAL"></RESOURCE>
<RESOURCE Id="res.path.webcomponent.user" Source="INTERNAL"></RESOURCE>
Instead, you can specify these values at runtime when starting the dispatcher, allowing for greater flexibility in configuration.

Dispatcher override option

An essential aspect of configuring the GAS is using the dispatcher override option (-E), which allows you to change a resource defined in the configuration file (as.xcf) directly from the command line when needed. For example: (Line breaks have been added to improve readability.)
fastcgidispatch -E res.path.gbc.user="C:\mygbc\dist\customization" 
                -E res.gip.log=DEBUG -E res.log.categories_filter="ALL"

The values set by these override options take precedence over the values specified in the configuration file, ensuring that you can adapt the dispatcher’s behavior to meet specific requirements at startup.