Automation Engine Script Guide > Ordered by Function > Read or Modify Objects > :DELETE_VAR

:DELETE_VAR

Script Statement: Deletes one or all values of a static Variable object.

Syntax

:DELETE_VAR Variable, [Key]

Syntax	Description/Format
Variable	Name of the Variable object in which contents should be deleted. Format: AE name, script literal or script variable.
Key	Key that should be deleted including its value. Format: AE name, script literal or script variable

Comments

Note that this script element can only be used for static Variable objects. For more detailed information refer to the description of the Variable tab.

This script statement deletes all lines of a Variable object if only the parameter variable has been specified.

If the parameter Key has also been specified, only the relevant line in the Variable object is removed. If "*" has been specified in the Key, the whole content of the Variable object is deleted.

Wildcard characters must not be used. Therefore, you cannot use "*" or "?" to filter several lines in the parameter Key.

Examples

The first example uses this script statement to delete the whole content.

:DELETE_VAR "DATABASE_MAINTENANCE"

The second example only deletes the line which contains the key "Client".

:DELETE_VAR "DATABASE_MAINTENANCE", "Client"

See also:

Script element	Description
:PUT_VAR	This stores a value in a static Variable object.
GET_VAR	This returns the value of a Variable object.
RESOLVE_VAR	Resolves any kind of variable (prompt values, system variables, script variables, variable objects) in text.
:SET_SCRIPT_VAR	Sets the values of script variables by indirect access.
GET_SCRIPT_VAR	Returns the values of script variables by indirect access.
PREP_PROCESS_VAR and PREP_PROCESS_VAR_XML	Prepares the processing of a data sequence (values of a Variable object).

Script Elements - Read or Modify Objects

About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by function