Syntax

── ? ── SHOW ─┬──────────┬─────────────────────────────────────────────%
              ├─ QUEUED ─┤
              ├─ SAVED ──┤
              └─ ALL ────┘

Explanation

The ?SHOW command causes the saved text queue and/or the visible portion of the input queue to be displayed. Each line displayed is followed by an asterisk (*) to indicate the last character of text. If no modifiers are supplied, the user's saved text is displayed.

QUEUED option

Only the user's visible queued input is displayed if the QUEUED option is specified.

SAVED option

The SAVED option displays the user's entire saved text queue.

ALL option

The ALL option displays both the saved text queue and the visible queued input.

Identification and Order of Saved Text Queue Entries

When the ALL, QUEUED, or SAVED option is specified, each displayed element is preceded by its relative number. The most recently saved text entry is preceded by <0>. Saved text queue entries that are not the most recent are preceded by the queue entry number enclosed in square brackets ([ ]).

Each queued entry is preceded by its queue entry number in parentheses. A W preceding a queued input entry indicates that CANDE is waiting for a user response before taking the queued input entry out of the queue and performing it. (Refer to the ?ENTER queue manipulation command in this section.)

Changing the Saved Text Queue Depth

The saved text queue can store up to 20 entries. Use the CANDE control command ?DEPTH to change the number of entries to be saved. You must, however, be a control station to use the ?DEPTH control command. Refer to the CANDE Configuration Reference Manual for more information about the ?DEPTH command.

When the ?SHOW Cannot Be Used

The ?SHOW command cannot be used while the station is busy or is in sequence mode.

Examples

The following examples show the results of the ?SHOW command options ALL, QUEUED, and SAVED, and an example without a specified option. The saved text queue depth is set for ten entries.

For the examples, a DO file named TEST/DO was created that includes an unexecutable task (FIND /ABCD/:Z;). Because of the unexecutable task in the DO file, the remaining two tasks in TEST/DO are queued. These two queued input entries are listed with a D that indicates it is a queued task from a DO file.

Example 1

The following example shows the results of ?SHOW with the ALL option.

?SHOW ALL
[10]write cande/notes*
[9]do split*
[8]RUN NOSUM*
[7]SPLIT*
[6]get inventory/tires*
[5]list*
[4]m test/do*
[3]seq*
[2]
NEXT+ ....*....1....*....2....*....3....
00000100find /abcd/:z;
00000200run nosum;
00000300pdef (destination="pa163");*
do*
[1]do*
<0>find /abcd/:z;*
D(1)run nosum;*
D(2)
#

Example 2

The following example shows the results of ?SHOW with the QUEUED option.

?SH QUEUED
D(1)run nosum;*
D(2)pdef (destination="pa163");* 

Example 3

The following example shows the results of ?SHOW with the SAVED option.

?SHOW ALL
[10]write cande/notes*
[9]do split*
[8]RUN NOSUM*
[7]SPLIT*
[6]get inventory/tires*
[5]list*
[4]m test/do*
[3]seq*
[2]
NEXT+ ....*....1....*....2....*....3....
00000100find /abcd/:z;
00000200run nosum;
00000300pdef (destination="pa163");*
do*
[1]do*
<0>find /abcd/:z;*
#

Example 4

The following example shows the results of ?SHOW with no specified option.

?SHOW
 <0>find /abcd/:z;*
#