*DEL, Val1
, Val2
Deletes a parameter or parameters (GUI).
Val1
Command behavior key:
Delete all user-defined
parameters, or all user-defined parameters and all system parameters, as specified by Val2
.
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.
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).
When Val1
is (blank), deletes only those parameters named with a trailing
underscore (_).
When Val1
is ALL, a (blank) value for Val2
causes all user-defined parameters
to be deleted.
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.