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

SYS_ACT_HOST

Script Function: Returns the name of the hostComputer, target system..

Syntax

SYS_ACT_HOST()

Return code

Name of the host of the objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task in which this scriptA particular Automation Engine object type. functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… 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 eventAction that is triggered if particular conditions apply. It can be an Automation Engine object type or an entry in a Policy Orchestrator EventBase. or jobAn Automation Engine object type for a process that runs on a target system. is actually executed is returned. This host can differ from a previously defined host if the userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management. 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 variableA placeholder for a value within a script.. 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

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH