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

:INC_SCRIPT

Script Statement: Integrates a scriptA particular Automation Engine object type. into another script of the same objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task

Syntax

:INC_SCRIPT (Script ID)

Syntax

Description/Format

Script ID

Number with which the script of an object is identified
Format: Number without quotations

Allowed values: "0", "1" and "2"

"0" - Includes the script (only in jobs and events)
"1" - Includes the pre-script (only in jobs) and the !Process (only in events)
"2" - Includes the post-script (only in jobs)

Comments

This script statement was implemented for internal reasons making it possible to call a script in the Header. Certain attributes can be set in this script which are then requested in the Header (e.g. another hostComputer, target system.). Special requirements of the z/OS JCL can be handled with this script.

This script statement can also be used "normally" in order to call a script within another script - even repeatedly. Both scripts must belong to the same object. Therefore, this script statement can only be used in jobs or events at this time. These objects have two tabs each for scripts.

For creating your script in modular, Automic recommends using the :INCLUDE script statement.

Example

The "Pre Script" tab of a jobAn Automation Engine object type for a process that runs on a target system. contains a DIR command. The pre script is linked in the Script tab.

:INC_SCRIPT (1)

Afterwards, it can be seen in the job reportA report provides more detailed information about a task's execution or a component. that the DIR command was executed twice. The first time in the Header (defined in the Pre Script tab) and the second time between Header and Trailer (by the script statement in the Script tab).

 

See also:

Script element Description

:INCLUDE

This integrates an Include objectAn Automation Engine object type for a script that is frequently used in more than one object. into a script

Script Elements - Script Structure and Processing

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