*DEL

*DEL, Val1, Val2
Deletes a parameter or parameters (GUI).

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Argument Descriptions

Val1

Command behavior key:

ALL -- 

Delete all user-defined parameters, or all user-defined parameters and all system parameters, as specified by Val2.

(blank) -- 

Delete the parameter(s) specified by Val2.

ParmName -- 

Delete a single named parameter, specified here. (Val2 is not used in this case.)

Val2

The parameter or parameters to delete (used only when Val1 = ALL or (blank)):

LOC -- 

When Val1 is (blank), specifies the location of the parameter within the Array Parameters dialog box. The location number is based on an alphabetically ordered list of all parameters in the database.

_PRM -- 

When Val1 is ALL, deletes all parameters, including those named with a leading underscore (_) (except _STATUS and _RETURN). When Val1 is (blank), deletes only those parameters named with a leading underscore (_) (except _STATUS and _RETURN).

PRM_ -- 

When Val1 is (blank), deletes only those parameters named with a trailing underscore (_).

(blank) -- 

When Val1 is ALL, a (blank) value for Val2 causes all user-defined parameters to be deleted.

Notes

This is a command generally created by the graphical user interface (GUI). It appears in the log file (Jobname.log) if an array parameter is deleted from within the Array Parameters dialog.

Usage examples:

  • Delete all user-defined parameters: *DEL,ALL

  • Delete only those user-defined parameters named with a trailing underscore: *DEL,,PRM_

  • Delete all user-defined and all system parameters (except for _STATUS and _RETURN): *DEL,ALL,_PRM

  • Delete a parameter by specifying its location within the Array Parameters dialog: *DEL,,LOC

  • Delete a single specified parameter by name: *DEL,ParmName (You cannot specify more than one named parameter at a time.)

The *DEL command does not free up memory but only deletes the specified reference. For example, memory usage increases from the continued issuance of *DEL and *DIM within *DOWHILE loops, as arrays are stored in the database (memory) and *DEL removes only the reference to the array. To release the memory in use, issue the SAVE command after *DEL.

This command is valid in any processor.

Menu Paths

This command cannot be accessed from a menu.