Using DELETELIST_SUB (Functions/Subroutines/Programs)
Created at 14 NOV 1996 02:54PM
DELETELIST_SUB
DELETELIST_SUB( deleteTableName, deleteRecName )
Using DELETELIST_SUB
Removes a list saved earlier with the TCL command SAVELIST or the subroutine SAVELIST_SUB.
deleteTableName
The name of the table in which the list to be deleted is located. The default is LISTS.
deleteRecName
The name of the list to delete.
Values returned
The return status of SAVELIST_SUB is indicated by the system variable @file.error. Multiple errors are delimited with record marks (@RM). The error number appears in field 1 of each @file.error "record", and additional information about the error appears in field 2. Possible errors are:
| Error | Meaning |
| S145 | Successful deletion. |
| S140 | Process not allowed on a Runtime version of Advanced Revelation. |
| 401 | Invalid table name in deleteFileName. |
| B166 | deleteRecName does not exist in the indicated table (status( ) returns zero). |
Under some circumstances, DELETELIST_SUB sets these values for status( ):
| status( ) | Meaning |
| -2 | Successful deletion. |
| 1 | An error occurred. |
| 0 | Non-critical error occured. |
Correct use of DELETELIST_SUB
list = "phonelist"
table = "" /* defaults to LISTS */
call deletelist_sub( table, list )
if status() # -2 then
call fsmsg()
end