SYS_ACT_HOST

Use the SYS_ACT_HOST script function to return the name of the Agent on which a task runs. The script function lets you retrieve the Agent name for the following types of tasks:

• File and Console events
  Use SYS_ACT_HOST in the Process or Event Process pages.
• Jobs
  Use SYS_ACT_HOST in the Process page.

Note: The retrieved Agent is the actual agent on which the task runs. The Agent may differ from what has been defined in the task properties, because a user or a :PUT_ATT script statement may change the Agent for a particular execution.

More Information:

• Modifying Object Attributes
• Process Pages

Syntax

SYS_ACT_HOST ()

Example

The following example assigns a retrieved Agent name to a script variable. The script uses thes script variable as a first parameter of the script function GET_FILESYSTEM to count files in a temporary directory.

:SET &HOST# = SYS_ACT_HOST()
:SET &NUMBER# = GET_FILESYSTEM(&HOST#,"c:\temp\*.exe","PATH_FILE_COUNT")

See also: