Creating a Server Configuration File

The server configuration file is named acurcl.cfg, and a sample file of this name is located in the %PROGRAMDATA%\Micro Focus\extend\10.5.1 (Windows) or /etc (UNIX/Linux) directory by default. For AcuConnect, this file specifies tells the location of the AcuAccess file, defines the default user, and supplies other information. If you have installed ACUCOBOL-GT using all default settings, this server configuration file is completely optional.
Notes: To increase compatibility with Microsoft Windows, this release of extend delivers or creates configuration files in the following directories, and searches in this order by default:
  • %PROGRAMDATA%\Micro Focus\extend\x.x.x
  • %PROGRAMDATA%\Micro Focus\extend
  • \etc

Where x.x.x is the installed version number of extend.

If the required file is not found in one of the first two listed directories, it searches \etc for backward compatibility.

If you choose to use a server configuration file, you can use the sample file as is (complete with its default values), or you can modify the file to your specification. If you give the file another name or place it in an alternative directory, you must specify the full location and name of the file with the -c option when you start AcuConnect. See the description of the -start command in acurcl -start for more information.

The server configuration file may contain any or all of the following variables:

Name Default Value
ACCESS_FILE %PROGRAMDATA%\Micro Focus\extend\10.5.1 (Windows) or /etc/AcuAccess (UNIX)
ACURCL_PORT 5632
AGS_BAD_SOCKET undefined
ALIAS_FILE_IS_XML TRUE
CHILD_WAIT 50
DEFAULT_USER undefined
FILE_TRACE 0
FILE_TRACE_FLUSH FALSE
FILE_TRACE_TIMESTAMP FALSE
FORCE_KILL_TIME 150 seconds
PASSWORD_ATTEMPTS 3
PROVIDE_PASSWORD_MESSAGES FALSE
SECURITY_METHOD   NONE
SERVER_ALIAS_FILE /etc/acurcl.ini (thin client only)
SERVER_IP undefined
SERVER_NAME undefined
SERVER_RUNTIME wrun32.exe or runcbl in the acurcl directory
TEXT_015 "A password is required to connect to host %s."
TEXT_016 "Please enter a password: "
TEXT_017 "Invalid password."
USE_SYSTEM_RESTRICTIONS FALSE
USE_UNIX_SHELL FALSE
WINNT_LOGON_DOMAIN undefined
WINNT_EVENTLOG_DOMAIN NULL

Values assigned to variables contained in the server configuration file are applied solely to operations performed by AcuConnect. See Starting AcuConnect for information on using these variables.