FRCDTA (Force Data) keyword for display files

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.

Note: If this keyword is used after each write statement, performance problems will occur.

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 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 example in this topic.

FRCDTA 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. Since 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.