Conditional delete
When deleting a note pad, specify CONDITIONS=YES to impose conditions that must be satisfied in order for the note pad to be deleted. The MUSTBE keyword indicates the conditions that must be satisfied. You can require that the note pad not contain any notes, or that it not have any connections, or both. The needs of your application determine whether you need to impose conditions on the delete of the note pad. For example, deleting a note pad that contains notes might induce loss of data. Deleting a note pad that has connections might imply that the application has not been shut down properly.
- MUSTBE=EMPTY
- The note pad is to be deleted only if it is empty. If the note
pad contains any notes, the delete request is rejected. If the note
pad has connections, the connections are to be deleted.
A connection might not discover that it was deleted until it issues an IXCNOTE request. Depending on the request and the timing, the request might be rejected because the connection does not exist or because the note pad does not exist. If you delete a note pad out from under active connections, you need to understand the potential consequences and mitigate them as appropriate.
- MUSTBE=UNUSED
- The note pad is to be deleted only if it does not have any connections. If the note pad has connections, the delete request is rejected. If the note pad has notes, the notes are to be deleted. You need to understand the potential consequences to your application of losing notes. Your program might need to take recovery actions to restore the data. You might need to document recovery procedures for the installation.
- MUSTBE=(EMPTY,UNUSED)
- The note pad is to be deleted only if it has neither notes nor connections. If the note pad contains notes, the delete request is rejected. If the note pad has connections, the delete request is rejected.