Figure 172 and Figure 173 show how to specify the HLPARA keyword:
Figure 172. Specifying the HLPARA Keyword (Example 1)
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 A HELP A HLPRCD(DFTHELP) A R RECORD1 A H HLPARA(1 5 3 15) A HLPDOC(FLDHELP DOC1 FOLDER1) A A H HLPARA(*RCD) A HLPRCD(HELPRCD1) A A H HLPARA(*NONE) A HLPRCD(HELPRCD2) A FIELD1 10A 2 5 A FIELD2 40A 10 10 A
In this example, the HLPARA keyword on the first H specification indicates that the area from line 1, position 5 to line 3, position 15 is to be associated with the online help information document DOC1. If the cursor is located in this area when the Help key is pressed, document DOC1 is displayed beginning at label FLDHELP.
The HLPARA keyword on the second H specification indicates that the area occupied by RECORD1 (lines 2 through 10) is to be associated with the online help information record HELPRCD1. If the cursor is located anywhere on lines 2 through 10 (outside the area defined by the first H specification) when the Help key is pressed, record HELPRCD1 is displayed.
The HLPARA keyword on the third H specification indicates that no area is to be associated with the online help information HELPRCD2. HELPRCD2 can only be displayed by pressing the Page Up or Page Down key from a online help information display.
Figure 173. Specifying the HLPARA Keyword (Example 2)
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 A HELP HLPRCD(DFTHELP) A R RECORD A H HLPARA(*FLD F1 1) A HLPRCD(UNDOHLP HLPLIB/HLPFILE) A H HLPARA(*FLD F1 2) A HLPRCD(MARKHLP HLPLIB/HLPFILE) A H HLPARA(*FLD F1 3) A HLPRCD(COPYHLP HLPLIB/HLPFILE) A H HLPARA(*FLD F2) A HLPRCD(F2HLP HLPLIB/HLPFILE) A H HLPARA(*CNST 1) A HLPRCD(TITLEHLP HLPLIB/HLPFILE) A 1 37'Title' HLPID(1) A F1 2Y 0B 10 2SNGCHCFLD A CHOICE(1 'Choice 1') A 01 CHOICE(2 'Choice 2') A CHOICE(3 'Choice 3') A F2 10A B 10 30 A
The HLPARA keyword on the first three H specifications indicates the areas occupied by Choice 1, Choice 2, and Choice 3 respectively, to be associated with online help information. If Choice 2 is optioned off so that Choice 3 moves up one line, the help area for Choice 3 automatically moves with the choice.
The HLPARA keyword specified on the 4th H specification indicates the area of F2 to be associated with online help information. This area is line 10, from position 29 through position 40.
The HLPARA keyword specified on the 5th H specification indicates the area of the constant title to be associated with online help information. This area is line 1, from position 36 through position 42.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.