Caché ObjectScript Reference - InterSystems Documentation

Caché ObjectScript CommandsDescriptionThere are three forms of the KILL command:• KILL without an argument (argumentless KILL.)• KILL with a variable list (inclusive KILL.)• KILL with a variable list enclosed in parentheses (exclusive KILL.)The KILL command without an argument deletes all local variables. It does not delete processprivateglobals, globals, or user-defined special variables.KILL with a variable or comma-separated variable list as an argument:KILL variable,...is called an inclusive KILL. It deletes only the variable(s) you specify in the argument. Thevariables can be local variables, process-private variables, or globals. They do not have tobe actual defined variables, but they must be valid variable names. You cannot kill a specialvariable, even if its value is user-specified. Attempting to do so generates a error.KILL with a variable or comma-separated variable list enclosed in parentheses as an argument:KILL (variable,...)is called an exclusive KILL. It deletes all local variables except those you specify in theargument. The variables you specify can only be local variables. The local variables youspecify do not have to be actual defined variables, but they must be valid local variable names.Note:KILL can delete local variables created by Caché objects. Therefore, do not useeither argumentless KILL or exclusive KILL in any context where they might affectsystem structures (such as %objTX currently used in %Save) or system objects (suchas the stored procedure context object). In most programming contexts, these formsof KILL should be avoided.Using KILL to delete variables frees up local variable storage space. To determine or set themaximum local variable storage space (in kilobytes), use the $ZSTORAGE special variable.To determine the currently available local variable storage space (in bytes), use the $STOR-AGE special variable.74 Caché ObjectScript Reference