delete command: delete a stored message
A specific message stored for a user account may be deleted with the
delete command. The message to be deleted is identified by
means of a UIDL as returned by the %msgr_uidl substitution
string of the show_user command.
This command must be presented to the user information CGI via the URL
http://host:7633/popstore_user/Parameter names and associated values accepted by the command are listed in Table 5-1 .
parameter=value |
Description | |
|---|---|---|
on_error=file-spec
|
Required | Name of the formatting file to use to format the results when the command fails. |
on_success=file-spec
|
Required | Name of the formatting file to use to format the results when the command succeeds. |
log=bvalue
|
Optional | Boolean value,
0 or
1. When
bvalue is
1, then a status message will be output indicating a successful operation. The default is
bvalue=0. Note that errors are always reported.
|
uidl=string
|
Required | UIDL for this user's instance of the message to be deleted. |
As an example, consider the following command which deletes the message
with UIDL !!!!01234:
command=delete&uidl=!!!!01234& on_success=delmsg_success.txt& on_error=delmsg_error.txt