NET/MASTER Network Control Language (NCL) Reference Manual

FILE DEL
Verbs
3–76 106126 Tandem Computers Incorporated
OPT
specifies a generic retrieval operand that determines the search argument for the
record(s) to be deleted. In both the following operands, a partial key can be
specified using the KEY= keydata operand.
KEQALL
specifies that a series, or generic set of records, is to be deleted. Only those
records that match the specified partial key are deleted.
KGEALL
specifies that all records, commencing with the previously specified partial
key through to the end of the file, are to be deleted.
ID= fileid
specifies the identity of the file, or pair of files, you want to access by using the
FILE DEL verb. This file, or pair of files, becomes the current file, or pair of files.
If this operand is omitted, NCL accesses the last file, or pair of files, identified by
the ID operand in a previous file operation.
KEY= keydata
specifies the key of the record you want to delete. The length of the key operand
depends on the length of the key for the current file being processed. The
maximum key length supported is 255 characters.
Considerations
The &SYS.FILE.RC system variable reflects the result of all file operations within
NCL. NCL sets this variable on completion of the FILE DEL verb, as follows:
Return Code Meaning
0 Record(s) deleted successfully.
4 Record not found.
8 A file system error occurred during processing. Further information is contained
in the &SYS.FILE.ERROR system variable.
12 Not used.
16 An error occurred. Further information is contained in &SYSMSG.
It is the user’s responsibility to test the &SYS.FILE.RC system variable for errors.
There is an implicit resumption of the NCL procedure after any errors, unless the
user has coded an error handler for the FILE_ERROR condition. See the core
statements ON and RESUME in Section 2, “Core Statements.”
For return codes other than 0 (zero) and 4, the FILE_ERROR condition is signalled.
This condition can be trapped (or intercepted) by an error handler.