Script Elements - Alphabetical Listing

This document lists all AE Script elements in an alphabetical order and gives a short description about their usage.

Script Statements

Script Statement	Description
:ADD_ATT	Adds recipients to a notification at runtime.
:ADD_COMMENT	Adds a comment to a task.
:ATTACH_SYNC	Assigns a Sync object to a task.
:ATTACH_RES	Transfers resources from a Storage object to the Windows or UNIX agent.
:BEGINREAD... :ENDREAD	Beginning and end of a dialog for user queries.
:BEGIN_EXT_INTERPRETERS... :END_EXT_INTERPRETERS	Marks the beginning and end of an external interpreter's script in the Process Tab of Windows and UNIX Job objects. Used in conjunction with the Storage object.
:CLEAR	Resets a script array to its initial values.
:CLOSE_PROCESS	Discards a data sequence within a script.
:CONST	Creates a script variable as a constant with a specific value.
:DATA	Explicit declaration of a DATA Line in a script.
:DEFINE	Defines a variable and declares the data type of the variable.
:DELETE_VAR	Deletes one or all values of a Variable object.
:DISCONNECT	Disconnects a connection to the AE system.
:EXIT	Terminates the processing of a script and sends a return code.
:EXT_REPORT_OFF	Deactivates the logging of a task's script.
:EXT_REPORT_ON	Activates the logging of a task's script.
:FILL	Stores several values in a script array.
:GENERATE	Controls the processing of script lines during execution.
:IF... :ELSE... :ENDIF	Branching under certain conditions.
:INCLUDE	Integrates an Include object into the current script.
:INC_SCRIPT	Integrates a script into another script of the same object.
:IFVERS [:ELSEVERS] :ENDVERS	Pre-compiler instructions for skipping script blocks depending on the installed Automation Engine version.
:JCL_CONCAT_CHAR	Forms JCL lines to a size of up to 2 KB.
:JCL_SUBSTITUTE	Replaces a character set in the JCL with another character set.
:MODIFY_STATE	Modifies the return code or status text of a job when it has finished.
:ON_ERROR	Determines the reaction to certain errors and messages of script elements.
:PRINT	Writes text to a dialog for user queries or to the activation report of an object.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	The definition of a loop for the line by line processing of a data sequence such as the content of a sequential file or the text result of a command.
:PSET	Stores a value in an object variable and passes it to the parent object.
:PUBLISH	Defines script variables and arrays as object variables.
:PUT_ATT	Sets or changes attributes of objects.
:PUT_ATT_APPEND	Extends the Notification object's message text at runtime.
:PUT_PROMPT_BUFFER	Puts name and content of a script variable in an input buffer.
:PUT_READ_BUFFER	Puts name and content of a script variable in an input buffer.
:PUT_VAR	Stores a value in a Variable object.
:PUT_VAR_COL	Stores a value to a particular column of a static Variable object.
:PUT_VAR_PROCESS	Writes the content of a data sequence to a static Variable object.
:READ	Queries the user in a dialog.
:REGISTER_VARIABLE	Available on Windows and UNIX, used in a Job object's (JOBS) Process Tab inside :BEGIN_EXT_INTERPRETER... :END_EXT_INTERPRETER for an external interpreter script call.
:REGISTER_OUTPUTFILE	Registers a file as an external job output.
:REMOVE_ATT	Removes recipients in a notification at runtime.
:REPLACE_STRUCTURE	Replaces the structure of a workflow with the structure of another workflow at activation.
:RESOLVE	Tries to resolve all variables in the string.
:RESTART	Sets restart points in an object.
:RSET	Assigns a value to a script variable and stores it in the activation report.
:SEND_MSG	Sends messages to the user of the Automic Web Interface.
:SEND_SNMP_TRAP	Sends an SNMP trap.
:SET	Stores a value in a script variable.
:SET_CALE	Inserts/deletes a date or time period in a calendar.
:SET_CONDITION	Sets the earliest start time in workflows.
:SET_LAST_ERR	Sets error number and text.
:SET_SCRIPT_VAR	Sets the values of script variables by indirect access.
:SET_UC_SETTING	Changes system settings during system operation.
:SHUTDOWN	Ends an AE system.
:STOP	This cancels the processing of a script.
:SWITCH... :CASE... :ENDSWITCH	It verifies whether the value of a variable complies with certain values and depending on the result, it runs various statements.
:TERMINATE	Ends an agent, a work, or communication process.
:WAIT	Processing of the script is stopped for a specified time period.
:WHILE... :ENDWHILE	Loop for repeated execution of script statements.
:XML_CLOSE	Closes an XML document.

Script Functions

[Script Statements] [Script Functions]

Script Function	Description	Predefined Variable
ACTIVATE_UC_OBJECT	Activates an object.
ADD	Adds.
ADD_DAYS	Adds days to a given date.
ADD_PERIOD	Adds a period to a specified date.
ADD_TIME	Adds two times.
ADD_TIMESTAMP	Adds time to a Time Stamp.
ALPHA2RUNNR	Converts the name of a job or report file to a RunID.
ARRAY_2_STRING	Converts a script array to a string.
AUTOFORECAST	Calculates forecast data for future activities.
CALE_LOOK_AHEAD	Returns the next date based on calendar conditions.
CANCEL_UC_OBJECT	Cancels execution of an activated object.
CHANGE_LOGGING	Causes the log file to be changed.
CONV_DATE	Converts a date from one date format to another.
CONV_LC	Converts all characters of a string to lowercase letters.
CONV_TIMESTAMP	Converts date and time for use in another time zone.
CONV_UC	Converts all characters of a string to uppercase letters.
CONVERT	Converts the data type of a value.
CREATE_OBJECT	Creates an object (Calendar, Login and Variable only).
CREATE_PROCESS	Creates a new data sequence.
DAY_OF_YEAR	Returns the current day of the year.
DEACTIVATE_UC_OBJECT	Deactivates a completed task.
DELETE_FORECAST	Deletes any number of or given Forecasts from the Automation Engine database.
DIFF_DATE	Determines the difference between two date entries in days.
DIFF_TIME	Returns the difference between two time entries.
DIV	Divides.
EXPORT	Exports objects to an XML file.
FIND	Searches a script array and returns the corresponding index.
FIRST_OF_PERIOD	Determines the first day of the period for a specified date.
FORECAST_OBJECT	Creates a forecast of a given object.
FORECAST_TASK	Creates a forecast of a running task.
FORMAT	Changes the formatting of a number.
GENERATE_SCRIPT_VARS	Generates a script variable via VARA object or data sequence on-the-fly.
GET_ATT	Returns the values of attributes of an object during its generation.
GET_ATT_SUBSTR	Supplies part of the message text in a notification.
GET_BIT	Checks if a bit is set in a bit field.
GET_CONDITION	Determines the earliest start time in workflows.
GET_CONNECTION	Reads information from a DB-type Connection object.
GET_CONSOLE	Reads message data of an occurred console event.
GET_EVENT_INFO	Reads data of occurred Console, FileSystem and Database events.
GET_FILESYSTEM	Retrieves several file-system values from a defined path of a computer.
GET_MSG_TXT	Retrieves the message text of the last error.
GET_MSG_TYPE	Retrieves the type of a message number.
GET_LOGIN	Reads information from Login objects.
GET_OBJECT_TYPE	Returns a task's object type.
GET_OH_IDNR	Supplies an object's internal number.
GET_PARENT_NAME	Returns the name of the superordinate task (Parent).
GET_PARENT_NR	Returns the run number of the superordinate task (Parent).
GET_PARENT_TYPE	Returns the object type of the superordinate task (Parent).
GET_PROCESS_INFO	Retrieves information of a data sequence
GET_PROCESS_LINE	Returns the content of the current line of a data sequence.
GET_PUBLISHED_VALUE	Retrieves the value or PromptSet variable of a certain task.
GET_SCRIPT_VAR	Returns the values of script variables by indirect access.
GET_STATISTIC_DETAIL	Retrieves details from the statistical record of an executable object.
GET_SYNC	Queries the current condition or value of a Sync object.
GET_UC_OBJECT_NR	Returns the RunID of an activated object.
GET_UC_OBJECT_STATUS	Returns the status of an activated object.
GET_UC_SERVER_NAME	Determines the name of the work process in which the script runs.
GET_UC_SETTING	Reads current system settings.
GET_UC_SYSTEM_NAME	Determines the name of the AE system.	&$SYSTEM#
GET_VAR	Returns the content of a Variable object.
GET_WIN_EVENT	Determines entries in the Windows system, security and application logs if an event occurs.
HEX	Converts a character set into hexadecimal form.
ILM	Controls ILM functionality.
IMPORT	Imports objects from an XML file.
IS_GROUP_MEMBER	Checks a user's membership status within a user group.
ISNUMERIC	Checks if a character set is numeric.
LAST_OF_PERIOD	Determines the last day of period of a specified date.
LENGTH	Retrieves the size of a script array.
LOAD_PROCESS	Loads a stored data sequence.
MID	Copies string characters.
MOD	Returns the remainder of a division.
MODIFY_OBJECT	Changes an existing object (only Calendar, Login and Variable).
MODIFY_SYSTEM	Processes ServiceManager actions or queue modifications.
MODIFY_TASK	Modifies active workflows.
MODIFY_UC_OBJECT	Modifies the attribute of an activated object.
MOVE_OBJECT	Moves an object to a folder.
MULT	Multiplies.
PREP_PROCESS	Via specific Job objects (event jobs), this script function processes commands on a computer and returns the Console output as an internal list (data sequence) which can further be processed.
PREP_PROCESS_AGENTGROUP	Uses selection criteria to retrieve the agents of an AgentGroup object and provides the result for further processing in the form of an internal list (data sequence).
PREP_PROCESS_COMMENTS	Uses filter settings to retrieve the timestamp, user and text of task comments and provides the result for further processing in the form of an internal list (data sequence).
PREP_PROCESS_DOCU	Provides the content of a Documentation tab as an internal list (data sequence) for further processing.
PREP_PROCESS_FILE	Uses filter criteria in order to retrieve the content of a text file which is available on a particular computer line by line. It provides the result for further processing in the form of an internal list (data sequence).
PREP_PROCESS_FILENAME	Retrieves a list of file names which are available in a specified computer directory. It provides the result for further processing in the form of an internal list (data sequence).
PREP_PROCESS_PROMPTSET	Reads the definition of PromptSet objects and provides them as an internal list (data sequence) for further processing.
PREP_PROCESS_REPORT	Uses filter criteria to retrieve the report lines of executable objects and provides the result for further processing in the form of an internal list (data sequence).
PREP_PROCESS_REPORTLIST	Retrieves the list of the registered output of jobs that have already run and provides the result in the form of an internal list (data sequence) for further processing.
PREP_PROCESS_VAR and PREP_PROCESS_VAR_XML	Use selection criteria to retrieve a list of Variable object values and provide the result for further processing in the form of an internal list (data sequence).
PUT_PROCESS_LINE	Adds a line to a certain data sequence
RANDOM	Generates random numbers.
REMOVE_OBJECT	Deletes an existing object.
RERUN_UC_OBJECT	Continues a certain workflow.
RESOLVE_VAR	Resolves any kind of variable (Prompt values, System variables, Script variables, Variable objects) in text.
RESTART_UC_OBJECT	Repeats the execution of a task.
ROLLBACK_UC_OBJECT	Executes the rollback of a specific task
RUNNR2ALPHA	Converts the RunID to the corresponding file names.
SAVE_PROCESS	Stores a certain data sequence.
SEND_MAIL	Sends email to a user.
SET_SYNC	Executes the defined action of a Sync object.
STR_CAT	Combines two strings to a new string.
STR_CUT	Copies string characters.
STR_ENDS_WITH	Checks whether a string ends with a certain other string.
STR_FIND	Searches for a character or a string within a string.
STR_FIND_REVERSE	Searches for a character or a string within a string. The search begins at the end of the string being searched.
STR_ISLOWER	Checks whether the characters of a string are written in lowercase letters.
STR_ISUPPER	Checks whether the characters of a string are written in uppercase letters.
STR_LC	Converts all characters of a string to lower-case.
STR_LENGTH	Returns the length of a string.
STR_LNG	Returns the length of a string.
STR_LTRIM	Deletes empty spaces at the beginning of a character set.
STR_PAD	Extends a string to a certain length.
STR_MATCH	Compares two character sets.
STR_REVERSE	Reverses the order of the characters within a string.
STR_RTRIM	Deletes the empty spaces at the end of a character set.
STR_SPLIT	Splits a string into several parts using a separator.
STR_STARTS_WITH	Checks whether a string starts with a certain other string.
STR_SUBSTITUTE	Replaces character or string within a string.
STR_SUBSTITUTE_VAR	Replaces script-variable names by their values.
STR_TRIM	Removes empty spaces at the beginning and the end of a character set.
STR_UC	Converts all characters of a string to uppercase characters.
SUB	Subtracts.
SUB_DAYS	Subtracts days from a given date.
SUB_PERIOD	Subtracts a period from a specified date.
SUB_TIME	Subtracts two times.
SUB_TIMESTAMP	Subtracts time from a Time Stamp.
SUBSTR	Copies string characters.
SYS_ACT_CLIENT	Returns the number of the current client.	&$CLIENT#
SYS_ACT_CLIENT_TEXT	Returns the text of the current client.	&$CLIENT_DESC#
SYS_ACT_HOST	Returns the name of the host.
SYS_ACT_JP	Determines if a task was activated in a workflow.	&$IN_PROCESSFLOW#
SYS_ACT_ME_LNR	Returns the placement number of a task in a workflow
SYS_ACT_ME_NAME	Returns the name of the own object.	&$NAME#
SYS_ACT_ME_NR	Returns the run number (RunID) of the own object.	&$RUNID#
SYS_ACT_ME_TYPE	Returns the object type of the own object.	&$OBJECT_TYPE#
SYS_ACT_PARENT_NAME	Supplies the name of a superordinate task.	&$ACTIVATOR# &$PROCESSOR#
SYS_ACT_PARENT_NR	Supplies the run number (RunID) of the superordinate task.	&$ACTIVATOR_RUNID# &$PROCESSOR_RUNID#
SYS_ACT_PARENT_TYPE	Returns the object type of the superordinate task.	&$ACTIVATOR_TYPE# &$PROCESSOR_TYPE#
SYS_ACT_PREV_NAME	Returns the name of the previous task in a workflow.
SYS_ACT_PREV_NR	Returns the run number (RunID) of a previous task in a workflow.
SYS_ACT_PTTYP	Returns the partner type of the user.	&$PARTNER_TYPE#
SYS_ACT_RESTART	Retrieves whether the object was activated in restart mode.	&$RESTARTED#
SYS_ACT_RESTART_COUNT	Supplies the number of restarts that have been executed for workflow tasks using the script statement RESTART TASK (Postconditions).	&$RESTART_COUNT#
SYS_ACT_RESTART_ME_NR	Returns the run number (RunID) of an object activated in restart mode.	&$RESTART_RUNID#
SYS_ACT_TOP_NAME	Supplies the name of the top workflow.	&$TOP_PROCESSFLOW_NAME#
SYS_ACT_TOP_NR	Supplies the run number (RunID) of the top workflow.	&$TOP_PROCESSFLOW_RUNID#
SYS_ACT_USERID	Supplies the User ID under which the job will run.
SYS_ACTIVE_COUNT	Returns the number of all activated objects.
SYS_BUSY_01	Returns the size of the workload of the Automation Engine during the last minute (in percent).
SYS_BUSY_10	Returns the size of the workload of the Automation Engine during the last 10 minutes (in percent).
SYS_BUSY_60	Returns the size of the workload of the Automation Engine during the last hour (in percent).
SYS_DATE	Returns the current date at the beginning of the script processing	&$DATE_format#
SYS_DATE_PHYSICAL	Returns the current date	&$PHYS_DATE_format#
SYS_HOST_ALIVE	Checks if a certain host is active
SYS_INFO	Reads AE-system information
SYS_LAST_ARRAY_INDEX	Return the last filled index of an array.
SYS_LAST_ERR_INS	Supplies the variable message part of the error that has last occurred.
SYS_LAST_ERR_NR	Returns the number of the error that has last occurred.
SYS_LAST_ERR_SYSTXT	Retrieves the last-occurred error message from the operating system.
SYS_LAST_REGISTERED_OFILE	Returns the last used output file of the command :REGISTER_OUTPUTFILE
SYS_LAST_REGISTERED_ULOGIN	Returns the last used login of the command :REGISTER_OUTPUTFILE
SYS_LAST_REGISTERED_VALUENAME	Returns the last used variable-value of the command :REGISTER_VARIABLE
SYS_LAST_REGISTERED_VARNAME	Returns the last used variable name of the command :REGISTER_VARIABLE
SYS_LAST_RESTART_POINT	Supplies the name of the previous restart point in the script.
SYS_LAST_RESTART_TEXT	Supplies the text of the previous restart point as defined in the script.
SYS_LDATE	Returns the logical date.	&$LDATE_format#
SYS_RESTART_POINT	Supplies the restart point from which the object will be executed.	&$RESTART_POINT#
SYS_SERVER_ALIVE	Checks if a certain server process is active.
SYS_SNMP_ACTIVE	Checks if the SNMP connection (Simple Network Management Protocol) of AE if active.	&$SNMP_ACTIVE#
SYS_STATE_ACTIVE	Checks if an object is already active.
SYS_STATE_JOB_ACTIVE	Checks if a job has already been activated.
SYS_STATE_JOBS_IN_GROUP	Returns the number of jobs that are registered in groups.
SYS_STATE_JP_ACTIVE	Checks if a workflow has already been activated.
SYS_TIME	Retrieves the current time of day at the beginning of the script processing.	&$TIME_format#
SYS_TIME_PHYSICAL	Determines the current time of day.	&$PHYS_TIME_format#
SYS_TIMESTAMP_PHYSICAL	Provides current date and time.
SYS_USER_ALIVE	Checks if a user is logged with an Automic Web Interface in AE.
SYS_USER_DEP	Supplies the department of the user who started the task.	&$DEPARTMENT#
SYS_USER_LANGUAGE	Supplies the language in which the Server generates the log files.	&$SYS_LANGUAGE#
SYS_USER_LNAME	Supplies the first and last name of the user who started the task.	&$USER_FL#
SYS_USER_NAME	Supplies the name of the user who started the task.	&$USER#
TOGGLE_OBJECT_STATUS	Stops or starts the automatic processing of several object types .
TOGGLE_SYSTEM_STATUS	Stops or starts automatic processing of a client.
UC_CRLF	Returns a page break.
VALID_CALE	Checks whether a date is included in the calendar keyword.
VALID_DATE	Checks if the date is valid.
VALID_TIME	Checks if the time is valid.
WEEK_NR	Returns the calendar week of a given date.
WEEKDAY_NR	Returns the day of a week of a given date as a number.
WEEKDAY_XX	Returns the day of the week of a given date as an abbreviation.
WRITE_PROCESS	It writes the content of a data sequence to a file.
XML_APPEND_BEFORE	Moves an XML element in front of another element.
XML_APPEND_CHILD	Adds a new sub-element to an XML element.
XML_APPEND_CLONE	Duplicates an XML element and attaches it to another element.
XML_APPEND_ELEMENT	Attaches an existing XML element to another element.
XML_BEAUTIFY	Beautifies the display of an element's structure.
XML_CLONE_AND_RENAME	Duplicates and renames an XML element.
XML_DELETE_NODE	Removes a specific XML element.
XML_DOM_TO_PROCESS	Creates a data sequence based upon a certain XML document.
XML_GET_ATTRIBUTE	Supplies the value of an attribute.
XML_GET_CHILD_COUNT	Counts the sub-elements of an element.
XML_GET_FIRST_CHILD	Identifies the first sub-element of an element.
XML_GET_LAST_CHILD	Identifies the last sub-element of an element.
XML_GET_NEXTSIBLING	Identifies the succeeding element.
XML_GET_NODE_NAME	Supplies the name of an element.
XML_GET_NODE_TEXT	Supplies the text of an element.
XML_INSERT_BEFORE	Creates a new XML element and inserts this in front of another element.
XML_OPEN	Opens an XML document for processing.
XML_PRINTINTOFILE	Writes the XML document in a file.
XML_PROCESS_TO_DOM	Creates an XML document from a data sequence.
XML_REMOVE_CHILDREN	Removes all the sub-elements of an XML element.
XML_SELECT_NODE	Identifies any element.
XML_SET_ATTRIBUTE	Adds a new attribute to an XML element or changes an existing attribute.
XML_SET_NODE_TEXT	Changes or sets the value of an XML element.
XML_TO_STRING	Returns the XML of a specific element as text.
YEAR_9999	Extracts the year from a given date.