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 analyses only in close cooperation with support and development staff.
Note that you must restart your computer after changing INI-file parameters. Exception: No restart is required after changing values in the section [HOST] of an agent's INI file.
Automic recommends using 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). See also: 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.
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. See Encoding Passwords for a detailed description on how to install and use the particular program UCYBCRYP.EXE for this purpose.