Scripting

The Automation Engine provides a proprietary scripting language that lets you add functional logic to Object Types. As an object designer, write scripts to extend the configuration options that the AWI provides for objects. Scripts are processed by a script interpreter on the Automation Engine server.

Tip: Watch the Video: Scripting and Script Objects

This page includes the following:

Overview

Scripts help eliminate repetitive manual tasks and human error:

The Automation Engine scripting language provides a comprehensive set of statements and functions for automating a broad range of activities. For example, you can write scripts that carry out the following actions:

See Automation Engine Script Reference for lists of all available script elements.

Permissions

You can write scripts in any object that you have write permission for. If your script starts any other objects, you also need permission to execute those objects. For more information about permissions, see Granting Automation Engine Authorizations.

Where to Include Scripts

Write scripts in the Process pages of any executable object. All executable objects include a Process page, and Job objects additionally include Pre-Process and Post-Process pages. Some types of objects also include other pages where you can store statements and functions.

In the Process pages of Job objects, you can include commands in the Job Control Language of the target system in addition to Automation Engine scripting language.

More Information:

Script Limitations

Each Process page can contain up to 32767 lines. However, script generation is canceled if the script generates more than 1000 JCL lines. If your script generates more JCL lines, you can use the MAX_JCL_LINES parameter in a :PUT_ATT script statement to change the limit.

Script Objects

You can write scripts for any executable object, but there is also a dedicated Script object (SCRI) that lets you store scripts that contain internal processing instructions. The Script object has no other purpose than to store and reuse such scripts. Scripts in Script objects are executed in the Automation Engine itself, and not on a target system. For more information, see Scripts (SCRI).

See also:

seealso

Writing Scripts

Script Elements Ordered by Purpose

Alphabetical List of Script Statements and Functions

seealso1

Automation Engine Script Reference

Script Elements and Syntax