Configuration (INI) Files

Only the administrator should change parameter values in configuration files (INI files) since this is a major interference with the AE system. Use trace flags that activate program analysis only in close cooperation with support and development staff.

Notes:

Note that you must restart your computer after changing INI file parameters. Exception: No restart is required after changing values in the [HOST] section of an agent's INI file.
It is recommended to use host names instead of IP addresses in order to make configuring and managing your network easier. Basically, the Automation Engine can handle both, IP addresses (IPv4 and IPv6) and host names.
IPv6 link-local addresses are not supported. Link-local addresses for IPv4 are defined in the address block 169.254.0.0/16 in CIDR notation. In IPv6, they are assigned the address block fe80::/64." The AE cannot route these addresses because it does not save the interface (examle IPv6 address: fe80::153a:9938:b170:63f0%23, the interface for this IP address is %23). For more information, see Link-local address.

The following parameters must always be specified when you newly install the Automation Engine:

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

All entries must correspond to your system environment and reflect the requirements of the AE system that you are setting up. Some general notes are listed below.

System Name

The system name identifies a complete AE environment. The Automation Engine and agents of an AE environment must use the same system name. This name is limited to 8 characters. Allowed are the upper-case letters A to Z, numbers and "_".

If you want to use a new system name, you must also adjust it in all relevant INI files (Automation Engine and agents). To do so, end all running tasks (events, schedules, workflows etc.) before you start because they would not continue after you have changed the system name.

Important! z/OS agent in combination with SMF technology: The z/OS Event Monitor converts the character "_" to "#" when it is used in the system name.

Server Processes

The Automation Engine automatically generates server process names. They are composed of of the following parts:

Name of the AE system (system name)
Number sign (#)
Type of server process (WP for work process, CP for communication process)
Three-digit process number that is unique for each process type

For example: UC4G#CP001

The Automation Engine's INI file includes the definitions of server processes including their process numbers. It also includes the port numbers that are assigned to the server processes. They must be unique throughout the entire AE system.

Agent Names

Agent names are limited to 32 of the following characters: A-Z, 0-9, _, ., $, @, - and #. You define them in the corresponding agent's INI file parameter name=. The host name is used by default if you do not define this parameter.

Database Access

If an INI file contains information about the connection to the database (section [ODBC]), you should encrypt the corresponding password. For a detailed description on how to install and use the particular program UCYBCRYP.EXE for this purpose, see Encoding Passwords.

Education

Broadcom's Enterprise Software Academy provides a comprehensive curriculum of free courses and tutorials. If you have not already done so, register at Enterprise Software Academy. Once registered, you can start profiting from our education offer immediately by enrolling in any course of your interest.

Tip: The Education team is constantly working on new content. Check the Enterprise Software Academy regularly for new free courses!

The following course(s) are associated with this topic:

Automic Automation Administration Standard