COPYNEXT

9.1A

The COPYNEXT instruction allows transfer of multiple data blocks during an Enhanced Mode COPYFILE operation. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

retcount

Optional. A Numeric Variable that returns the number of blocks required to complete the transfer.

Flags Affected: ZERO,OVER

Note the following:

1. The ZERO flag is set when the COPYNEXT instruction completes successfully.

2. The OVER flag is set when the block count that is stored into the {retcount} variable is too large and causes an overflow that loses data.

3. An I72 error occurs if a COPYNEXT instruction is executed and a COPYFILE operation is not currently active.

See Also: Example Code, System Interface Instructions