Using DELETELIST_SUB (Functions/Subroutines/Programs) [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 d//eleteFileName//.                                                |
|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