HLPRTN (Help Return) Keyword for Display Files--Examples

Figure 183 and Figure 184 show how to use the HLPRTN keyword.

Figure 183. Specifying the HLPRTN Keyword (Example 1)

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A                                      HELP
A                                      HLPRCD(GENERAL)
A          R RECORD1
A  02                                  HLPRTN
A          H                           HLPARA(1 1 3 10)
A                                      HLPRCD(HELPREC1)
A            FIELD1        10A  B  2  2
A          R RECORD2                   HLPRTN
A            FIELDA         5A  B 10  7
A

If indicator 02 is on when RECORD1 is written to the display, control will return to the user program when the Help key is pressed. If indicator 02 is off, online help information record HELPREC1 or GENERAL will be displayed when the Help key is pressed, depending on the position of the cursor. When RECORD2 is displayed, control will return to the user program when the Help key is pressed.

Figure 184. Specifying the HLPRTN Keyword (Example 2)

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A                                      HELP
A  01                                  HLPRTN
A                                      HLPRCD(GENERAL)
A          R RECORD1
A          H                           HLPARA(1 1 3 10)
A                                      HLPRCD(HELPREC1)
A            FIELD1        10A  B  2  2
A          R RECORD2
A            FIELDA         5A  B 10  7
A

If indicator 01 is on, control returns to your program when you press the Help key regardless of the cursor position.