GETRETAIN (Get Retain) keyword for display files

You use this record-level keyword with the UNLOCK keyword to specify that the IBM® i operating system is not to erase input-capable fields on input operations as described under the UNLOCK keyword.

This keyword has no parameters.

Using GETRETAIN reduces input typing when successive records contain mostly identical input. With GETRETAIN specified, the workstation user needs only to change certain input fields rather than retyping the entire record.

You must specify the UNLOCK keyword without any parameters when using GETRETAIN. The UNLOCK(*MDTOFF) specification provides the same function as GETRETAIN.

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the GETRETAIN keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00101A          R REC1                      GETRETAIN
     A                                      UNLOCK
     A