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.