:DELETE_VAR

Use the :DELETE_VAR statement to delete one or all value lines in a static VARA object. Specify a key to delete a specific line, or omit the key to delete all lines.

Syntax

: DELETE_VAR VARA object [, Key]

Parameters

Parameter	Description	Format
VARA object	Name of the static VARA object in which to delete values	AE name, script literal, or script variable
Key (Optional)	Key (line) to delete. Omit this parameter or specify an asterisk (*) to delete all lines. Wildcard characters are not supported for filtering; an asterisk is only valid as a literal "delete all" indicator, not as a pattern match.	AE name, script literal, or script variable

Important Considerations

Note: 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. When set to Y, the key is converted to and stored in uppercase. For more information, see FORCE_VARA_KEY_CI.

Examples

The following example deletes all content in the VARA object DATABASE_MAINTENANCE.

: DELETE_VAR "DATABASE_MAINTENANCE"

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

: DELETE_VAR "DATABASE_MAINTENANCE", "Client"