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

Overview

Scripts help eliminate repetitive manual tasks and human error:

• Automatically read, import, modify and load data or files
• Create, read, update and delete values in objects and object attributes
• Create and delete certain types of objects
• Verify settings and conditions before carrying out other steps
• Customize settings and behavior for particular target systems or applications

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:

• Perform arithmetic functions
• Loop processes
• Activate objects
• Define conditions
• Output data in reports
• Send notifications
• Create user dialogs

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:

• Process Pages
• Data Lines and Job Control Language

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: