HP RPG/iX Utilities Reference Manual (30318-90006)

2- 157
Form
COM[MENT] [C] [lb] [BY inc]
Parameter Explanation
C A fifteen line comment banner is displayed. (If the C parameter is not given, the default ban-
ner occupies 10 lines.) The "C" parameter displays a banner with the Column Indicator form
insteadof the RPGRecord Specification form.A space isnot required betweenthis parameter
and the command.
lb Location where comment banner is to be added. If this parameter is omitted, the banner is
added at the end of the work file. If "lb" exists, the destination will be changed to the next
sequential line.
BY inc Increment value for each line in the comment banner.
Purpose
The COMMENT command allows you to enter comments in your s ource program wherever you wish.
When the command is entered, RISE shifts you to SHOW mode and automatically provides a banner, a
rectangle composed of asterisks. With it is the RPG Record Specification form corresponding to the line
preceding the banner. If "C" is specified, a Column Indicator is shown with the line instead.
Special Considerations
When you wish to delete your COMMENT, you may use the DELETE command and specify the sequence
range. You may also display the banner in SHOW mode and press the terminal's Clear Display key
followed by the ENTER key.
Execution mode: Block
Examples
The following are legal abbreviations which can be used with the COMMENT command and its
parameters:
COMC FIRST BY 1 Display fifteen line banner beginning at first line with
increment value of 1.
COM 20 Display ten line comment banner beginning at line 20.
The first example shows a ten line comment banner in Show Mode. It is displayed with the Header
Specification form (1).