HP 3000 Manuals

HP RPG/XL Utilities-Part 2 RISE

SHOW 

SHOW displays a page of your source file for direct editing on the
screen.

Form 

         S[HOW] [lb] [C[OL]]

Parameter Explanation 

lb               First line of the page you wish to have displayed.  (If
                 omitted, the first page of the work file is displayed.)

COL              Display column indicator rather than RPG Record
                 Specification form (15 lines will be displayed with the
                 COL parameter).

Purpose 

The SHOW command displays a page (10 lines) for direct screen editing in
Block Mode.  If you do not specify a line number ("lb"), the first page
of your work file will be displayed.  "COL" is specified, a page of 15
lines is displayed with the column indicator.  Otherwise, the page
appears with the RPG Record Specification form appropriate to the line or
lines being displayed.  (An exception occurs when column 6 of a line
contains an illegal RPG form entry.  The screen display defaults to a
column indicator in such an instance.)

In SHOW mode the terminal's cursor control keys and two of the editing
keys--INSERT CHAR[acter] and DELETE CHAR[acter]--will prove particularly
useful in your editing.  (INSERT LINE and DELETE LINE keys are not
activated.)  Also, tabs have been set to correspond with the important
Record Specification form columns.  Using the TAB key rather than the
space bar to position your cursor, you move quickly from column to column
to the position where changes are necessary.  You then type your changes
in directly.

When you are satisfied with your changes, press the ENTER key to update
the work file with your newly edited page.

Related Commands 

Two sets of special function key labels can appear at the top of the
screen with the SHOW command.  They are the Master set and the Scroll
set.  To change sets, you press softkey F1, which is a toggle switch.

When the Master set is activated, the special function keys perform the
following functions:

F1               Switch to Scroll set.

F2               Insert lines.

F3               Show page with or without edit sequence numbers.

F4               Move cursor to Command Window.

F5               Scroll forward to next page.

F6               Scroll backward one page.

F7               Enter Line Mode.

F8               Display main menu.

Softkey F3 will display the RPG source file on the screen with or without
the sequence line numbers of the work file.  If F3 is on, the sequence
numbers will appear on the left hand side of the screen.

RPG source records are 80 columns long.  When RISE displays the source
records on the screen without the sequence numbers, the individual
records will fit on a single line.  When you press F3, calling for a
display of sequence numbers, columns 72-80 of each record are not shown.
These columns are not deleted in such an instance, but the screen no
longer contains the complete record since room is made to display the
sequence numbers on the lefthand side.

Thus, you may display complete source records without the sequence
numbers when you wish.  If, however, you wish to determine where you are
in the work file, and need sequence numbers to accomplish this, you will
do so at the cost of truncating columns 72-80 from the screen display.
They are not accessible at this time and cannot be altered.

Inserting Lines 

When you wish to insert new lines between existing lines you may have to
make room for them.  If this is necessary you press F2 when the Master
set of function keys is activated.  This changes the special function key
labels so that F1 through F4 are prepared to receive insertion commands.
You then position the cursor at the line preceding the position where you
wish to begin the insertion.

When the cursor is positioned correctly, you press softkeys F1, F2, F3,
or F4, depending on how many lines you are adding (F1 adds 1 line; F4 
adds 4 lines).  An example of the correct procedure for inserting lines
is included in the examples below.


NOTE  If the terminal is unexpectedly locked out at this point, see the
      section on Recovery Procedures.


Scroll Set 

While in SHOW mode, you can increase your scrolling capabilities by
switching to Scroll set.  Again, this is accomplished by pressing F1.

The softkeys have the following functions when Scroll set is activated:

F1               Switch to Master set.

F2               Display first page.

F3               Display last page.

F4               Move cursor to Command Window.

F5               Scroll forwards a page.

F6               Scroll backwards a page.

F7               Scroll forwards 1/2 page.

F8               Scroll backwards 1/2 page.

Execution mode:  Block.

Examples 

The following are legal abbreviations which may be used with the SHOW
command and its parameters:

S F C            Enter Show mode displaying the first line of the source
                 file with the column indicator.

S 10             Enter Show mode and display line 10 with the appropriate
                 Record Specification form.

SHO              Enter Show mode.

In the first example, the SHOW FIRST command brings the Header
Specification form to the screen along with the first line of the source
file (1).  In the second display, the cursor has been moved into
position, and new data is added to the first line.  Note that RISE is now
in Block mode, and the ENTER key must be pressed to make changes to the
first line permanent (2).

         > SHOW FIRST



In the next examples, the special function key labeled SCROLL FORWARD is
used while the Header Specification form is displayed.  The first time
the scrolling occurs, the RPG File Specification form appears on the
screen with the associated source file lines (1).  The next form to be
brought to the screen by the SCROLL FORWARD softkey is the RPG Input
Specification form.  Again, the associated lines are also displayed (2).



In the next example, the form shown with the message in the bottom line
communication window, and the changed labels for the softkeys are
produced when the INSERT LINES softkey (F2) is pressed.  Note that the
SHOW MODE window contains precise instructions for inserting from one to
four lines (1).  The second display is produced by pressing softkey #3
(INSERT 3 LINES) after the cursor has been positioned at line 18.  Note
that the column 6 entries, which designate the Record Specification form
appropriate to the lines being inserted, are supplied automatically by
RISE (2).  The user is then ready to position the cursor and insert new
data.


In the next example, the screen is switched to Scroll Set following the
insertion by pressing special function key #1 (MASTER SCROLL). Note that
the asterisk in the softkey label for F1 is now next to "SCROLL".  This
indicates that the Scroll Set of keys are now active (1).  Special
function key #3 (SCROLL LAST) produces the next screen display, which
contains the final lines of the source file associated with the RPG
Output Specifications form (2).


In the next example, the SHOW FIRST COL command brings the column
indicator to the screen.  In the first display, Scroll set is activated
as the softkey labels indicate (1).  Pressing special function key #1
(MASTER SCROLL) brings the next display to the screen.  Note that the
asterisk is now next to the word "MASTER." RISE is again in Show mode,
Master Set, with the column indicator shown (2).  (The spaces created
between lines 18 and 19 by the insertion example have been deleted by
erasing the "I's" in column 6 and then pressing the ENTER key to make the
changes permanent in the work file.  If they were not, the spaces would
be retained on the screen.)


To produce the first display in the final example, the user has entered
SHOW FIRST COL command or some valid abbreviation.  Also, special
function key #3 has been pressed while in Master Set (this key toggles
sequence numbers on and off).  A fifteen line "page" is brought to the
screen and with it the sequence line numbers which RISE keeps for use in
referencing records.  Note the command in the command window (1).  The
next display follows the execution of the command, SHOW 11, after the
user hits the ENTER key.  The column indicator form is cleared and the
RPG Calculation Specifications form, which is appropriate to line 11, is
brought to the screen.  Sequence line numbers continue to be displayed
and will be until special function key #3 is pressed (2).

MPE/iX 5.0 Documentation