z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Conditional delete

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014