HP 3000 Manuals HP 3000 Manuals
SHOW Command
The SHOW command displays the contents of fields on the current screen.
Formats
SHOW [*REFRESH] [from_data_ref [to_data_ref]]
Parameters
from_data_ref, to_data_ref
The starting and ending field numbers to be displayed. Each can be one
of the following:
* A whole number.
* A screen field name.
* A * (representing the current field).
* A relative screen field reference such as *-9 to *+9.
In the SHOW command you can specify a screen field by the field name
only, and you can optionally omit the screen name.
If you only specify one data reference, HP ALLBASE/4GL only displays one
field.
Description
The SHOW command displays the contents of a single screen field, a range
of screen fields, or all fields on the current screen.
The SHOW command with no arguments displays the contents of all fields on
the current screen.
If you only specify one data reference with the SHOW command, HP
ALLBASE/4GL only displays the contents of that one field.
If you specify both a from data reference and a to data reference with
the SHOW command, HP ALLBASE/4GL displays the contents of all fields
within that range on the current screen.
The SHOW command does not change the movement of the cursor on the
screen.
*REFRESH Option
The normal operation of the SHOW displays the contents of the internal
screen buffer only.
If you use the *REFRESH command argument, HP ALLBASE/4GL refreshes the
internal screen buffer from the data movement fields specified on the
screen field detail screen (refer to chapter 6).
HP ALLBASE/4GL refreshes the internal screen buffer from:
- The primary data movement field, or
- The default data movement field.
HP ALLBASE/4GL only uses the contents of the default data movement field
if the screen field buffer is blank. (A screen field cannot have a
default data movement field if it has a primary data movement field.)
Typically, you would use the *REFRESH argument to display the contents of
a file record after it has been read. By specifying the file record
fields as primary data movement fields for the relevant screen fields,
the SHOW *REFRESH command transfers the contents of the file buffer to
the screen buffer and displays the data on the screen.
Example 1
SHOW 2 8
This command displays the contents of fields number 2 to number 8
inclusive from the screen buffer.
Example 2
1 FILE *NEXT stock
2 SHOW *REFRESH
3 MESSAGE Stock_record
4 TIE 4
These commands:
* Read the next record from the file stock.
* Display the contents of the record on the screen. (Assuming that
you have defined the file record fields as the primary data
movement fields for the screen fields.)
* Display the message Stock_record.
* Position the cursor at field number 4 ready to accept data.
Example 3
SHOW *REFRESH *
This command moves the contents of the primary data movement field (or
the default data movement field) into the screen buffer and displays the
contents on the screen at the current field.