Automation Engine Script Guide > Ordered by Function > Script Structure and Processing > :ATTACH_RES

:ATTACH_RES

Script statement: This statement is used in conjunction with the Storage objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task to specify the resources you want to use with the UNIX or Windows agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host. You may use it in a scriptA particular Automation Engine object type. in the Process Tab of Job objects (JOBS) on Windows or UNIX.

Syntax

:ATTACH_RES ObjectName, ResourceName, [Usage], [Variable]

Key

Description/Format

ObjectName

Name of the Storage object

ResourceName Name of the resource you attach, i.e. want to transfer to the agent.
Usage

Allowed values:

Default value: "T"

Variable

(optional) An Automation EngineThis component drives an Automation Engine system and consists of different types of server processes. variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. replacement is performed for a text type storage resource right before it is transferred to the agent.

Allowed values: "Y"[es] or "N"[o]

Default value: "N"

This key may only be used on resources with these attributes:
Type="Text" and Usage="Task-specific"

 

You may use the following System variables with :ATTACH_RES to get information about the absolute paths of resources:

Variable name System location
&$AGENT_RESOURCES_CLIENT# client wide cache directory
&$AGENT_RESOURCES_TASK# task specific cache directory

As resources are attached to the Storage object, paths will be defined in the Automation Engine system, but are not visible to 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.. Using these variables you will be able to have details displayed in the Job object's reportA report provides more detailed information about a task's execution or a component..

Comments

This script statement will determine the resources to be attached to the Storage object for transfer to the OS agent, either on Windows or on UNIX.

The agent creates a listShows entities in a grid view of all files to be transferred for a jobAn Automation Engine object type for a process that runs on a target system., where :ATTACH_RES is specified. If the transfer of listed files is unsuccessful, the agent will cancel the job.

As the agent transfers information about OS, hardware and platform to the Automation Engine system, the Automation Engine system transfers only resources from the Storage object that fit these values.

You also may transfer resources into a special directory by using :ATTACH_RES first and then copy files by using an external script.

The size of resources is limited. As of version 11 you may attach and transfer up to 71 MB (74448896 bytes).
To set a lower limit, use the key MAXIMUM_STORE_RESOURCE_SIZE in the system variable UC_SYSTEM_SETTINGS.

In a text-type resource, system variables will only be replaced with their corresponding values, when the same system variable is used in the Process Tab. This has performance reasons.

If you try to transfer text type resources with variable replacement set to "Yes" into the client-wide cache, an error message will be displayed.

Examples:

In the following example all resource files contained in the Storage object are transferred:

:ATTACH_RES "STORAGE12", "*"

This example will transfer all resources where the name starts with the expression "file"

:ATTACH_RES "STORAGE12", "file*"

The third example transfers all resources into a client-wide cache.

:ATTACH_RES "STORAGE12", "*", C

This example conducts a variable replacement for all transferred files:

:ATTACH_RES "STORAGE12", "*.ini", ,Y

In this example the above mentioned System variables for :ATTACH_RES are used to attach a .jar-file which then is started with Java:

:ATTACH_RES "PCK.AUTOMIC_SIEBEL.PRV.STORE", "SIEBELTOOL.JAR", C
JAVA -JAR
"&$AGENT_RESOURCES_CLIENT#SIEBELTOOL.JAR" SIEBEL IMPORTBUSINESSOBJECT

 

See Also

 

 


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

Copyright © 2016 Automic Software GmbH