Keyword: PUTRETAIN


Description: You use this record-level or field-level keyword with the OVERLAY keyword to prevent the IBM i operating system from deleting data that is already on the display when the system displays the record again. The PUTOVR keyword has a function similar to, but more effective than, the PUTRETAIN keyword.


Status: Supported as of version 3.0.1

Converts to "put retain" property.

Support is limited. Data on the screen will be be retained when a format already on the screen is output again with PUTRETAIN and OVERLAY in effect. However, display attributes will not actually be overridden.

The DDS conversion will issue a warning if PUTRETAIN is used with fields that have conditional display attributes. Such screens should be adjusted to eliminate usage of PUTRETAIN so that the attribute conditioning can function properly.


Back to DDS keyword list