DELETE (Eliminazione record)

L'operazione DELETE cancella un record da un file di database. Il file deve essere un file in grado di cancellare (identificato specificando *DELETE nella parola chiave USAGE di una definizione a forma di free-form, oppure da una U in posizione 17 di una specifica di descrizione file a forma fissa). Il record cancellato non può mai essere richiamato.

Se non viene specificato un argomento di ricerca (search - arg), l'operazione DELETE cancella il record corrente (l'ultimo record richiamato). Il record deve essere stato bloccato da una precedente operazione di input (ad esempio CHAIN o READ).

L'argomento di ricerca, search - arg, deve essere il numero record chiave o relativo utilizzato per richiamare il record da eliminare. Se l'accesso è per chiave, search - arg può essere una chiave unica sotto forma di un nome di campo, una costante denominata, una costante figurativa o una letterale.

Se il file è un file descritto esternamente, search - arg può essere anche una chiave composita sotto forma di nome KLIST, un elenco di valori o %KDS. I campi chiave grafici e UCS-2 devono avere lo stesso codice di riferimento del file. Per un esempio di %KDS, consultare l'esempio alla fine di %KDS (Ricerca Argomenti in Struttura dati). Se l'accesso avviene per numero di record relativo, ricerca - arg deve essere un letterale intero o un campo numerico con zero posizioni decimali. Per un esempio di utilizzo di un elenco di valori alla ricerca del record da eliminare, consultare Figura 2.

Consultare *STRICTKEYS per informazioni sulla parola chiave di controllo degli effetti EXPROPTS (*STRICTKEYS) ha sulle regole per specificare le chiavi con un elenco di valori o %KDS.

L'operando nome deve essere il nome del file di aggiornamento o un formato record nel file da cui è necessario cancellare un record. Un nome formato record è valido solo con un file descritto esternamente. Se search - arg non viene specificato, il nome del formato record deve essere il nome dell'ultimo record letto dal file; altrimenti si verifica un errore.

Se search - arg viene specificato, le posizioni 71 e 72 possono contenere un indicatore impostato su se il record da eliminare non viene trovato nel file. Se cerca - arg non viene specificato, lasciare vuote queste posizioni. Queste informazioni possono essere ottenute anche dalla funzione incorporata %FOUND, che restituisce '0' se non viene trovato alcun record, e '1' se si trova un record.

Per gestire le eccezioni DELETE (codici di stato file maggiore di 1000), è possibile specificare l'extender del codice di operazione o un indicatore di errore ER, ma non entrambi. Per ulteriori informazioni sulla gestione degli errori, consultare File Exception / Errori.

Nel sistema operativo IBM i, se si esegue un'operazione di lettura sul file specificato in nome-file dopo un'operazione di ELIMINAZIONE riuscita su tale file, si ottiene il record successivo a quello eliminato.

Consultare Database Null Value Support per informazioni sulla gestione dei record con campi e chiavi a capacità null.

Per ulteriori informazioni, consultare Operazioni file.