System Setup
This section allows the administrator to view and configure the AMT environment. The four available tabs and their respective settings are described below.
Before continuing, to learn how to configure the Base Setup, Basepaths, Logging Configurations, and Runtime Behaviour Configurations, please visit the page Control Center Set-Up.
Base Setup
Base Setup controls the entire system's setup.
The following Base Setup settings are available:
Environment
The name of this AMT environment. The name can be chosen freely.
Local time zone
The local time zone of the server on which the Control Center is hosted. This time is also displayed in the header.
Basepaths
Basepaths define the directory structure that an AMT application can use. Multiple basepath configurations may be created and used as needed.
The following environment variables can be used for default paths:
Variable | Description | Example |
%SYSROOT% | The root directory of the AMT Java environment. |
%SYSROOT%\Logging |
%APPNAME% | The name of the application. | %SYSROOT%\Scripts\%APPNAME% |
%APPROOT% | The application base path as defined in the Application settings. | |
%USER% | The username of the current user. | %SYSROOT%\Files\Uploads\%APPNAME%\%USER% |
Opening an existing Basepath lists the Configurations and Applications making use of this basepath configuration, and all available Basepath settings. The following settings can be configured when adding a new or editing a Basepath:
Name
The name of this basepath.
Script path
The path to the directory where the scripts are located.
Extract path
The path to the directory where the extracts will be stored by default.
Print path
The path to the directory where the listboxes of the application will be stored by default.
Call path (optional)
The path to the directory where the external libraries are located.
Help path (optional)
The path to the directory where the help pages of the forms and popup forms will be stored by default.
Log path (optional)
The path to the directory where the log files of the application will be stored by default.
Logging Configurations
Logging Configurations allow for rules to be set for storing logging information into a file to keep track of things that happen while an application is running. While creating a new configuration, clicking the button 'Default values' automatically sets each setting to its default value. with tThe following Logging Configuration settings are available:
Description
The description (name) of this Logging Configuration (optional).
Configurations
A list of configurations using this Logging Configuration.
Applications
A list of applications using this Logging Configuration.
General Logging settings
Clean time
The Batch Controller starts its daily cleaning process of report and log files at the set time. Default: 00:00.
Days To Keep Logging Settings
Days to keep job history
Sets the number of days to keep information about job execution. Default: 30.
Days to keep failed job history
Sets the number of days to keep information about failed job execution. Default: 30.
Days to keep logfiles history
Sets the number of days to keep log files. Default: 30.
Days to keep prints history
Sets the number of days to keep prints. Default: 20.
Days to keep messages
Sets the number of days to keep messages in the database. Default: 20.
Transaction Logging Settings
A Transaction Logging database is necessary to log transactions. Before it is possible to configure the settings below, create a Transaction Logging database and define the database in the cc-config.yaml file.
Enable transaction logging
If enabled, database transactions are logged in a separate database. warning The transaction database in
which these logs are stored first needs to be made.
Default: Disabled.
Days to keep transaction logging
The number of days transaction logs are kept in the transaction logging database. Default: 20.
Runtime Behaviour Configurations
Runtime Behaviour Configurations contain settings that tell an application how to run when it is started. While creating a new configuration, clicking the button 'Default values' automatically sets each setting to its default value. The following settings are available:
Description
The description of this Runtime Behaviour (optional).
Configurations
A list of configurations using this Runtime Behaviour.
Applications
A list of applications using this Runtime Behaviour.
General
Charset
Set the character encoding used for the creation of print files. The character set UTF-8 is used by
default. Default: UTF-8.
Call timeout
The maximum number of seconds for the call process to wait before the call gets executed. Default: 0.
Call shared program timeout
The maximum number of seconds shared between programs for the call process to wait before the call gets
executed. Default: 0.
Receive timeout
The maximum number of seconds for the call process to wait before timing out. Default: 0.
Exception on array out of bounds
If enabled, an exception will be raised during runtime if an array is accessed that is out of bounds. If disabled, a
dummy element will be returned. Default: Enabled.
Printing
Always write printer Macros
If enabled, all printers will write printer macros. Individual printers can be configured to overrule this setting.
Default: Disabled.
Always write from depth
If enabled, always writes the maximum number of lines to a printfile. Default: Disabled.
Overwrite printfile
If enabled, existing print files are overwritten by new print files with the same name. Default: Disabled.
Hex value printing filter
Filters out one of the following hexadecimal characters: Hex00, Hex01, or HexFF. Default: HexFF.
Save copy of printfile in print folder
If enabled, saves an extra copy of print files in the Print directory. Default: Disabled.
Do not register empty print files
If enabled, reports producing no output are not visible in the Prints menu option of the Control Center. Default:
Disabled.
Forms
Xmit Timeout (seconds)
The maximum number of seconds for a call to wait for a response from the application server. Default: 3600.
Show application description in caption
If enabled, the description of the application is added to the title bar at the top of the AMT Screens window.
Default: Disabled.