HP 3000 Manuals

HP RPG/XL Utilities-Part 2 RISE

COMMENT 

COMMENT produces a comment banner to contain the comments you enter.

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 banner occupies 10
                 lines.)  The "C" parameter displays a banner with the
                 Column Indicator form instead of the RPG Record
                 Specification form.  A space is not required between
                 this 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 source 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).


The next example is of the fifteen line comment banner shown with the
column indicator (2).

MPE/iX 5.0 Documentation