z/OS V1R9.0 TSO/E Command Reference

EDIT—COPY SubcommandEDIT—COPY subcommand syntax►►COPYCO*line_1line_2 line_3* 1 *'string'count line_4INCR(lines)►◄EDIT—COPY subcommand operandsline_1specifies the first line or the lower limit of the range to be copied. If thespecified line number does not exist in this data set, the range begins with thenext higher line number.line_2specifies the last line or the upper limit of the range to be copied. If thespecified line number does not exist in this data set, the range ends with thehighest line number that is less than line_2. If line_2 is not entered, the valuedefaults to the value of line_1; that is, the source becomes one line. Do notenter an asterisk for line_2.If COPY is followed by two line number operands, the system assumes them torepresent line_1 and line_3, and defaults line_2 to the value of line_1.line_3specifies the target line number; that is, the line at which the copied-to dataarea starts. If the line_3 value corresponds to an existing line, the target line ischanged to line_3 + INCR(lines) and either becomes a new line or displaces anexisting line at that location. When the copy operation begins, existing linesencountered in the target area are renumbered to make room for the incomingdata. The increment for renumbered lines is one (1). Specifying zero (0) forline_3 puts the copied data at the top of the data set, only if line 0 is empty. Ifline 0 has data, enter TOP followed by COPY with line_3 set to *. Note thatline_3 defaults to *.The value of line_3 should not fall in the range from line_1 to line_2. The targetline must not be in the range being copied. Exception: Line_3 can be equal toline_2.* represents the value of the current line pointer.INCR(lines)specifies the line number increment to be used for this copy operation. Thedefault is the value in effect for this data before the copy operation. When thecopy operation is complete, the increment reverts to the value in effect beforeCOPY was issued. Range: 1-8 decimal digits, but not zero.The increment for any renumbered lines is one (1).‘string’specifies a sequence of alphanumeric characters with a maximum length equalto or less than the logical record length of the data set you are editing. When acharacter string is specified, a search starting at the current line is done for theline containing the string. When found, that line is the start of the range to becopied for either numbered or unnumbered data sets.countspecifies the total number of lines (the range) to be copied. Enter 1-8 decimaldigits, but not zero (0) or asterisk (*). The default for count depends on what isChapter 1. TSO/E commands and subcommands 95