DROP

The character string DROP tells Z Data Tools to not write the current record to the primary output data set. The effect of specifying DROP on the RETURN instruction depends upon the Z Data Tools 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 */