*---------*---------------*-----------------*----------------*---------------* | CODE | FACTOR 1 | FACTOR 2 | RESULT | INDICATORS | | | | | FIELD | | *---------*---------------*-----------------*----------------*---------------* | FORCE | | File name | | | *---------*---------------*-----------------*----------------*---------------*
The FORCE operation allows selection of the file from which the next record is to be read. It can be used only for primary or secondary files.
Factor 2 must contain the name of a file from which the next record is to be selected.
If the FORCE operation is processed, the record is read at the start of the next program cycle. If more than one FORCE operation is processed during the same program cycle, all but the last is ignored. FORCE must be issued at detail time, not total time.
FORCE operations override the multifile processing method by which the program normally selects records. However, the first record to be processed is always selected by the normal method. The remaining records can be selected by FORCE operations. For information on how the FORCE operation affects match-field processing, see -- Reference detlobj not found --.
If FORCE is specified for a file that is at end of file, no record is retrieved from the file. The program cycle determines the next record to be read.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.