:DELETE_VAR

Use the :DELETE_VAR statement to delete one or all lines of values in a static VARA object. Define parameters for the statement to assign values to a particular line and specific columns in the VARA object.

Syntax

:DELETE_VAR VARA object[, Key]

:DELETE_VAR
Deletes one or more lines of values in a static VARA object
Variable
Name of the VARA object in which to delete values
Format: AE name, script literal or script variable
Key
Key (line) to delete
You can use the FORCE_VARA_KEY_CI key of the UC_SYSTEM_SETTINGS variable to force context-insensitive read/write actions on STATIC VARA objects while defining the key, see FORCE_VARA_KEY_CI. When the variable is set to Y, the key is converted to and remains in uppercase.
Format: AE name, script literal or script variable

Notes:

Specify a key to delete all values in the specified line.
Do not specify a key, or write an asterisk (*) as the key, to delete all values in all lines in the VARA object.
Wildcard characters are not supported. You cannot use an asterisk or a question mark to filter for lines in the Key parameter.

Examples

The following example deletes the whole content of a VARA object called DATABASE_MAINTENANCE.

:DELETE_VAR "DATABASE_MAINTENANCE"

The following example deletes only the line with the key Client.

:DELETE_VAR "DATABASE_MAINTENANCE", "Client"