Windows Agent

The name of the agent.

The agent name is limited to 32 of the following characters: A-Z, 0-9, _, ., $, @, - and #.

The host name is used instead if this parameter remains undefined. Lowercase letters are converted to uppercase letters.

Allowed values: "0", "1" (default value)

See: Description of the settings ANONYMOUS_FT and ANONYMOUS_JOB in the variable UC_HOSTCHAR_DEFAULT.

The language that should be used for the logging. You can specify a primary and a secondary language.

Allowed values: "E", "D", "F"
Default: "E,D" (primary English, secondary German)

If there is no message in the primary language, the system searches for a message in the secondary language.

The xx characters in the file name are placeholders. They stand for the two-character abbreviation of the respective Windows version. See:Terminology

The number signs serve as placeholders for a series in numerical order. When you start the agent, the log files are renamed so that the most current log file is always the one with the number "00".

Allowed values: ALL (default value), NONE, CONTROLS

"ALL" = The complete message file is held in the RAM.
"NONE" = Always read from the hard drive.
"CONTROLS" = All language-dependent strings that are required in order to display the dialog program are held in the RAM (not relevant for the agent).

The path and the name of the interpreter that processes the script.

Default value: powershell.exe -NonInteractive -ExecutionPolicy bypass -NoLogo -file

With the default setting, Windows jobs, starting with "Interpreter" selection are able execute PowerShell commands. The parameter " -ExecutionPolicy bypass " guarantees that the generated script (Windows job) will run regardless of security settings setup by the administrator. When this parameter is not set, the Windows administrator must explicit allow starting Powershell scripts on host. Otherwise Powershell jobs won't be able to start.

File ends should be specified without dot.

Default value: ps1

Allowed values: INCL, EXCL

"INCL" = Access must be allowed for every single user that is specified in [USERID]
"EXCL" = Access is denied to users that are specified in [USERID]. All other users can start jobs.

INCL only evaluates entries with "START" in the [USERID] section.
EXCL only evaluates entries with "NO_START" in the [USERID] section.

useJobObject=

The setting jobs starts in a Windows Job object. The value that are defined here serves as the default value for all AE jobs under Windows. A setting that should apply for a particular job can be specified in the Job tab.

Allowed values: "0" and "1"

"0" - The Windows JobVerarbeitung auf einem Zielsystem. Auch ein eigener Objekttyp in der Automation Engine. object is not used.
"1" - The Windows Job object is used. More information about the job and its sub-jobs is available. The improved restart options are an advantage. Note that the AE job will only end when all sub-jobs have ended.

HomeDirCache=

You can use this parameter to determine whether the home directory of the login user is stored.

Specify a period of time (in minutes) after which the agent should store the name of the home directory. This will increase performance. If you use "0", this information is not stored.

Default value: 10 minutes

Note that any changes that are made in the home directory only become effective after the specified period of time.

ft_temp_file=

This parameter creates temporary files in  FileTransfers.

Allowed values: "yes" (default value) and "no"

"yes" - The file obtains a temporary name which is composed of the letter "T" and an alphabetic string originating from the RunID"Kurzform für ""laufende Nummer"". Hierbei handelt es sich genauer um eine Zahl, welche die Durchführung einer Aufgabe eindeutig kennzeichnet. Die RunID kann zwischen 7 und 10 Stellen aufweisen. Sie wird von der Komponente Automation Engine vergeben.". The new file transfer additionally appends a file ID to obtain a unique file name because basically, only a RunID is provided. The file is renamed after it has successfully been transferred.
"no" - The agent assigns the final file name when the file transfer starts.

This parameter checks the available hard disk space before a file transfer is processed.

Allowed values:
"y" - The system checks whether there is sufficient hard disk space for the files that should be transferred. The files will only be transferred when there is enough space. Otherwise, the file transfer will abort with an error message.
"n" (default) - No check is made.

Checking the available space of network drives may occasionally lead to an incorrect result.

When this parameter is set, the Windows Agent skips NetGetDCName() and NetUserGetInfo() to determine the user home.

Allowed values:
"yes"
"no" (default)

[STATUS_CHECK]

time=

The internal timing cycle in which the system checks whether the job has already ended (provided that it runs in a Windows Job object).

Default value: 1 second

The agent's internal job table is checked in this interval. It depends on a job's runtime whether a status check is made. The job is checked during its execution at ever increasing time interval (doubling the value "time"). These intervals never exceed the value specified for the agent with JOB_CHECKINTERVAL in the host characteristics.

For example: time=1, JOB_CHECKINTERVAL=60
The job table is checked each second
StatusZustand einer Aufgabe (z.B. aktiv, blockiert, in Generierung, usw.). check after: 1s, 2s, 4s,..., 60s, 60s....

[USERID]

The specification of authorized Windows users in the format:
User name/Domain=START

Specification of unauthorized Windows users in the format:
User name/Domain=NO_START

[VARIABLES]

This section contains the agent variables that include agent settings and information.

[TRACE]

The path and the file name of the trace file.

The xx characters in the file name are placeholders. They stand for the two-digit abbreviation of the particular Windows version. See: Terminology

The number signs serve as placeholders for a series in numerical order. When you start a trace, the trace files will be renamed so that the most current trace file is always the one with the number "00"

Allowed values: "0" (default value) to "9"

Trace flags must only be used in close cooperation with Automic Support.

bindaddr=

The IP address or the host name for communication to the agent.

Use this parameter when the connection should be established via a particular IP address (for example, the computer has more than one network interface card).

Alternately, you can also specify the IP address or host name in port=

(Format: port=IP address:port or DNS name:port). Specifications made in bindaddr= are then ignored.

bindlocal=

Consideration of the local host (127.0.0.1).

Use this parameter together with bindaddr=

Allowed values: "0" (default value), "1"

"0" - No listen socket is created.
"1" - An additional listen socket is created on the local host.

connect=

The time interval in seconds in which the agent tries to establish connection to the Automation Engines. This affects the connection setup for a restart or after a lost connection.

Default value: 60 seconds

This parameter is only effective until the first successful logon to the AE system. Afterwards, you can use the parameter RECONNECT_TIME in the host characteristics.

report=

The time interval in seconds in which the agent sends the logging to the Automation Engine.

Default value: 60 seconds

cp=

Address of the communication process in the AE system to which the agent should connect.

Allowed formats:
DNS Name:Port number
TCP/IP Address:Port number

SendBufferSize=

The size of the TCP/IP input buffer for messages that should be sent (Byte).

Default value: 1048576 Byte

RecvBufferSize=

The size of the TCP/IP input buffer for messages that should be received (Byte).

Default value: 1048576 Byte

Used to set TcpKeepAlive on socket level of the operating system.

Default value: yes

[HOSTS]

[CP_LIST]

The list of communication processes.

This list is created when the agent starts and is extended when new communication processes are activated. You will find more detailed information about establishing a connectionin the chapter Multi-Server Operation.

The communication process that is defined in the parameter cp= (section [TCP/IP]) is not included in the cp list.

Format:
Port number=DNS name
or
Port number=TCP/IP address

Definition of whether the execution of the Windows commands of backend-type VariableSpeichert oder ermittelt Werte dynamisch zur Laufzeit. Auch ein eigener Objekttyp in der Automation Engine. objects should be shown on the desktop.

Allowed values:
"0" (default) or "1"

"0" - Commands of backend-type variables run in the background.
"1" - Commands are shown on the desktop.

This function is only available when the Windows agent has not been started via a ServiceManager (the option "Show job on desktop" of Windows jobs reacts in the same way). The commands are shown on the agent desktop.

Activating this parameter is only useful when the agent has not been started with the system user.