USRRSTDSP (User Restore Display) keyword for display files

You use this record-level keyword on a window record to specify that the application will manage the display.

Window records are not automatically removed. If this keyword is not specified, the system saves and restores the underlying display when a window record is displayed.

This keyword has no parameters.

The WINDOW keyword must be specified on the same record as the USRRSTDSP keyword. The USRRSTDSP keyword functions only when the window keyword defines a window. The USRRSTDSP keyword does not function if the window keyword specified a record format name.

Option indicators are valid for this keyword.

Example

The following example shows how to specify the USRRSTDSP keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A          R APPRCD
     A            FIELD1        10A  O  5 40
     A            FIELD2         5S 0B  6 45
     A          R WINDOW1                   WINDOW(6 15 9 30)
     A  25                                  USRRSTDSP
     A            FIELD1         5A  B  2  2
     A            FIELD2        20S  B  8  5
     A

In this example, suppose APPRCD is already on the display. If indicator 25 is set on when WINDOW1 is written to the display, the system does not save the underlying display (which contains APPRCD). When the user exits WINDOW1, the application must restore the underlying display, possibly by rewriting APPRCD to the display.

Note: With USRRSTDSP, there is no limit on the number of windows. The limit is 12 without using the USRRSTDSP keyword.