FRCDTA (Force Data) keyword for display files
You use this record-level keyword to display a record format immediately, without waiting for the next input or input/output operation. When the buffer is partially full, the FRCDTA keyword can be used to clear the buffer.
This keyword has no parameters.
When this keyword is in effect for a record format, the record format is displayed as if you had specified DFRWRT(*NO) on the Create Display File (CRTDSPF) command or the Change Display File (CHGDSPF) command.
You can use this keyword when DFRWRT(*YES) is in effect for the display file and when your program does several output operations before doing an input operation. With DFRWRT(*YES) specified, none of the record formats is displayed until the input operation. There might be a long delay for the workstation user while the program completes its processing. You can specify FRCDTA for a record format that is displayed first. This record format tells the workstation user that the delay is normal. For a step-by-step description, see the following example.
The FRCDTA keyword can be specified once for each record format.
Option indicators are valid for this keyword.
Example
The following example shows how to specify the FRCDTA keyword.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A* Following record format displays in progress message
00020A R INPROG LOCK
00030A FRCDTA
00040A 12 21'Please wait; +
00050A operations in progress'
A
00060A* Following record format uses upper part of screen
00070A R RCD1 OVERLAY
00080A 1 34'Sample Title'
00090A FLD1 8 0 3 2
00100A FLD2 20 4 2
A
00110A* Following record format uses middle part of screen
00120A R RCD2 OVERLAY
00120A FLDA 8 11 2
00140A FLDB 18 12 2
A
00150A* Following record format uses lower part of screen
00160A R RCD3 OVERLAY
00170A FLDC 8 B 15 2
00180A FLDD 8 B 16 2
A
Three record formats (RCD1, RCD2, and RCD3) are used to create a single display; each of these record formats uses only a part of the display. Record format INPROG prepares the workstation user for the delay while the other three record formats are prepared. The program does the following operations:
- Displays record format INPROG. With FRCDTA specified, this displays the in-progress notice immediately. The keyboard remains locked because the LOCK keyword is specified.
- Continues processing to prepare the other three record formats (RCD1, RCD2, and RCD3), then displays them. Because they overlap record format INPROG, it is erased.
- Reads record format RCD3. This unlocks the keyboard and the workstation user can respond to the complete display.