Administration Guide > Configuration > Structure of the Configuration Files > Notes for Adjusting Configuration Files

Notes for Configuration-File Adjustments

Adjustments in INI files represent a significant intervention in the AE system and should therefore exclusively be made by the administrator. Trace flags (activating program analysis) should only be used in close cooperation with support and development staff.

All modifications made in INI files are only effective after program restart. Exception: No restart is required for modifications made in the section [HOST] of the agents' INI files.

At least the parameters shown below must be supplied with values:

System name
Definition of server processes and assignment of port numbers
Names and port numbers of agents
Names of log, trace and message files
Variables entries

The entries must correspond to your system environment and reflect the requirements of the AE system to be created. Some general notes are listed below. Additional notes in the documentation of the relevant INI file is to be considered.

System Name

The system name identifies a complete AE environment. Automation Engines and agents of an AE environment must use the same system name. It can consist of a maximum of 8 figures. Allowed are the upper-case letters A to Z, numbers and "_".

If a new system name is used, it must also be modified in all relevant INI files (Automation Engines and agents). End all running tasks (events, schedules, workflows etc.) before you start your modifications because otherwise, these tasks will not continue after a system name modification.

Note that there is a peculiarity in using the z/OS agent in combination with SMF technique. The z/OS Event Monitor converts the character "_" if used in the system name to "#".

Server Processes

AE automatically generates server process names. They consist of the following parts:

Name of the AE system (system name)
Wildcard character (#)
Type of server process (WP for work process, CP for communication process)
Three-digit process number which has been clearly defined for each process type

Example: UC4G#CP001

Server processes including their process numbers are defined in the INI file of the Automation Engine. At the same time, Server processes are assigned port numbers which must be clearly defined for the entire AE system.

Agent Names

The agent name is limited to 32 of the following characters: "A-Z", "0-9", "_", ".", "$", "@", "-" and "#". It can be defined in its INI file using the parameter name=. The host name is used instead if this parameter remains undefined.

Database Access

If an INI file contains information about the connection to the databaseA database is an organized collection of data including relevant data structures. (section [ODBC]), the appropriate passwordA secret combination of characters for a Automation Engine user. should be encoded. Find the description on how to install and use the particular program UCYBCRYP.EXE in the document "Encoding Passwords".