Use this file- or record-level keyword to return control to your program when you press the Help key. If HLPRTN is not specified, online help information associated with the current cursor location is displayed. (Refer to HLPARA (Help Area) Keyword for Display Files for more information on specifying help areas.)
Refer to Appendix F, System/36 Environment Considerations Using DDS, for special considerations when specifying the HLPRTN keyword in files that are used in the System/36 environment.
The format of the keyword is:
HLPRTN[(response-indicator ['text'])]
If you specify a response indicator, the response indicator is set on and returned to your program. No input data is transmitted from the device. Processing is similar to that of a command attention key.
The optional text is included on the computer printout created at program compilation time to explain the intended use of the indicator. This text has no function in the file or program other than as a comment. The apostrophes are required. If you specify more than 50 characters between the apostrophes, the text is truncated to 50 characters on the program computer printout.
HLPRTN at either the file or record level takes priority over any HLPRCD, HLPPNLGRP, or HLPDOC keywords. Any HLPRTN keyword found in the file is processed before any other applicable help keyword.
When you specify HLPRTN, control may or may not return to your program, depending on whether you use an option indicator:
Option indicators are valid for this keyword.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.