Domain:
UTILITIES
Required authorization:
STD-PROCESSING
TSOS
You can use the DELETE-MAIL-ORDER command to delete e-mail send orders transferred to the ASTI subsystem that have not yet been processed. For orders that have already been processed, the DELETE-MAIL-ORDER command deletes the information on the associated execution status in the ASTI-internal tables. The associated SYS files under the user ID of the e-mail sender are also deleted.
DELETE-MAIL-ORDER |
ORDER-ID = *ALL / <x-text 1..16> ,SENDER-USERID = *OWN / *ANY / <name 1..8> |
Operands
ORDER-ID = *ALL / <x-text 1..16>
Specifies which orders are to be deleted.
ORDER-ID = *ALL
All orders of the user ID specified under SENDER-USERID are deleted. It can happen that new e-mails are also deleted that are sent by another task of the same user ID parallel to the execution of DELETE-MAIL-ORDER.
If DELETE-MAIL-ORDER returns an error, it may not have been possible to delete all orders. In this case, repeat the command in order to delete the remaining orders.
ORDER-ID = <x-text 1..16>
The order with the specified ASTI order ID is deleted if the specified user is the owner of the order. Only users with TSOS authorization can delete orders with a different user ID.
SENDER-USERID = *OWN / *ANY / <name 1..8>
Specifies the users whose orders are to be deleted.
SENDER-USERID = *OWN
Only the orders of the command caller are deleted.
SENDER-USERID = *ANY
For users without TSOS authorization, this has the same effect as specifying *OWN. For users with TSOS authorization, it means that the orders of all users are deleted.
SENDER-USERID = <name 1..8>
User ID of the owner of the orders to be deleted. Only users with TSOS privileges can delete orders of another user ID.
Return codes
(SC2) | SC1 | Maincode | Meaning |
| 0 | CMD0001 | No error. | |
| 64 | CMD0216 | The user does not have the required authorization for the command. | |
| 32 | CMD0220 | Internal error. | |
| 64 | YML0120 | The ASTI subsystem is not available. | |
| 32 | YML0176 | Unexpected ASTI error. | |
| 64 | YML0210 | Order not found. | |
| 64 | YML0216 | Order executed by external task. | |
| 64 | YML0220 | The user is not entitled to delete this order. | |
| 64 | YML0221 | The user is not authorized to delete orders of other users. |