Function
The SHOW command controls which, if any, page of the operator's console log
is displayed on an OPER screen. Using a page key (page forward or page reverse)
is equivalent to a specific form of the command, as is entering a null input
message.
(DME only)
Format
SHOW action,screen
The action parameter may be null, and the screen parameter may be omitted or null.
action may be any of:-
AUTO
OFF
LATEST
OLDEST
n
@n
The default value for action is +1.
screen is the number of the OPER screen to which action applies. The interactive screen is screen zero, the primary monitor is screen 1. The default value for screen is 1.
Forbidden contexts
NOT OPERATOR, REMOTE
Execution
Actions other than AUTO or OFF cause the page which they specify to be displayed on screen. A page may be specified by its position relative to the page currently being built up (the active page). The n'th page before the active is specified by @n. It is also possible to specify a page by its position relative to the one currently being shown on screen (the displayed page for screen.
The n'th page before the current displayed page for a screen is specified by the number n. Thus -1 specifies the page one older than the current displayed page for screen whereas +1 specifies the page one later.
LATEST specifies the latest full page and is identical to @1.
OLDEST specifies the oldest page in the recall file.
AUTO is only allowed for monitor screens. Its effect is to display the LATEST page on screen and to refresh the display with the new LATEST page as each newactive page is started.
OFF switches of SHOWing on screen. If screen is a monitor, it is cleared. If it is the interactive screen it reverts to logging.
If a page older than OLDEST is specified (for example, SHOW @30 wgeb only 20 pages are retained in the recall file), the OLDEST page is displayed. If a page later than LATEST is specified (for example, SHOW +2 when screen is SHOWing LATEST) for a monitor, it is put on AUTO. The interactive screen reverts to logging instead.
AUTO SHOWing is switched off by any action other than AUTO itself or an attempt to SHOW a page later than LATEST as described above.
Single key SHOW commands are provided. The Page Forward key is treated as SHOW 1,1. The Page Reverse key is treated as SHOW -1,1. A null input messaeg is treated as SHOW OFF,0.
Examples
SHOW OLDEST
SH OFF,1
SH -2
SH @3,0
SH
Error Messages
THIS COMMAND IS ONLY ALLOWED IN A DME ENVIRONMENT
NO RECALL FILE
AUTO NOT ALLOWED FOR SCREEN ZERO