Automation Engine Script Guide > Ordered by Function > Activation Data > SYS_ACT_HOST

SYS_ACT_HOST

Script Function: Returns the name of the host.

Syntax

SYS_ACT_HOST()

Return code

Name of the host of the object in which this script function is called.

Comments

This script function can be used in events of type "File System" and "Console" (Process and !Process tab) and in the Process tabs of jobs.

 

Note that the name of the host on which the event or job is actually executed is returned. This host can differ from a previously defined host if the user changes it for one particular job execution in the Attribute Dialog or sets :PUT_ATT in the Pre-Process tab.

Example

The following example describes how a returned host name can be assigned to a script variable. This script variable is then used as the first parameter of the script function GET_FILESYSTEM in order to have files of a temporary directory counted.

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

 

See also:

Script element Description

SYS_HOST_ALIVE

Checks if a particular host is active.

Script Elements - Activation Data

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function