DROP
The character string DROP tells File Manager to not write the current
record to the primary output data set. The effect of specifying DROP
on the RETURN instruction depends upon the File Manager function or
panel being used:
- For DSC or Copy Utility (option 3.3), the current record is not copied to the target data set.
- For DSP or Print Utility (option 3.2), the current record is not printed.
- For DSU, the current record is not updated, regardless of any changes that have been made to the data in the variable OUTREC.
- For DSEB, the current record is not updated, unless the UPDATE function has already been called for the current record.
If this string is returned by a REXX procedure run in conjunction with the DSC function or Data Copy Utility and REXX member selection has been specified, it is treated as if it was a RETURN with no argument strings and a warning message is issued. Subsequent records continue to be passed to the REXX procedure until a decision has been made on whether to DROP or PROCESS the member.
Here are some examples:
RETURN 'DROP'
Return 'Drop'
Return drop /* assumes no variable named 'drop' has been assigned */