DDS for display files


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 below.

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:


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]