Errors
As Shipped From Factory None required
On Power-Up None required
If the Parameter is Omitted
None required
SU03 (Level 1): This command is invalid at this time. (No graphtext character is being defined.) References
<Begin-graphtext-character> command.
4110 SERIES COMMAND REFERENCE .REV, DEC 1981 . 4-123
ALPHABETICAL LISTING
<End-Panel> Command 4112, 4113
Description
This command terminates a <panel-definition>. The current panel boundary is closed, setting the graphic beam position to "st ting po nt" ,;f the panel boundary (that is, the coordinate specified in the command).
If the current fill pattern number (as specified by the most recent <select-fill~pattern> command) is greater than -8 (in the 4112) or -15 (in the 4113), and that fill pattern
exists, then the panel interior is filled with that fill pattern. The fill occurs in "overstrike" or "replace" mode according to the "overstrike/replace" parameter in the most recent <set-panel-filling-mode> command.
4 ... 124 REV, DEC 1981 4110 SERIES COMMAND REFERENCE
(
(
(
ALPHABETICAL LISTING
Defaults Parameter
Number As Shipped From Factory
On Power ... Up If the Parameter
i. Omitted None required None required None required Errors
LEOO (Level
o ) :
Unrecognized command. (The terminal is not a 4112 or a 4113).LE03 (Level 1): No panel is currently being defined.
LE02 (Level 3) : Out of memory while performing <I!::'nd-panel>
command.
References
<Begin-fill-pattern> command.
<Begin-panel-boundary> command.
<Panel-definition> syntactic construct.
<Select-fill-pattern> command.
command.
4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-125
ALPHABETICAL LISTING being defined within the segment, that <panel-definition> is also terminated, as if an <end-panel> command had been
received.
In the 4112 and 4113, the view which is selected at the time of the <end-segment> command is the view in which the
segment is visible. (Unless, of course, a <set-segment-visibility> command for "segment -2" has determined that newly-created segments are to be invisible.)
Defaults
ALPHABETICAL LISTING
<Enter-Alpha-Mode> Command
SYNTAX
<enter-alpha-mode>
=
(US) . DescriptionPuts the terminal in alpha mode.
Whil~ the terminal is in alpha mode, it interprets any ASCII characters it receives (except those comprising commands) as text to be displayed. If the dialog area is enabled, this
"alphatext" is sent there.
In the 4114, if the dialog area is not enabled, then
alphatext is directed to the screen, where it is written in storage mode.
In the 4112, the dialog area is not enabled, alphatext is directed to the current view, at the current graphic beam position in 4096-by-4096 "terminal space." (If this location falls outside the current view's window, then the alphatext does not appear in the current viewport.)
The terminal leaves alpha mQde on receiving an <enter-vector-mode> or <enter-marker-mode> command.
On the 4114, alphatext may appear in any of a variety of character sizes, according to the most recent <set-alpha-text-size> or <set-4014-alphatext-siie> command. If Option 4E is installed, the alphatext may also appear in the APL character font; this is controlled by the <set-alphatext-font> command.
If an optional keyboard is installed on a 4112, the alpha-text may appear in the APL character font (for example);
this is controlled by the <set~alphatext-font> command.
I
4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-127
ALPHABETICAL LISTING
In alpha mode, a carriage return (CR) moves the cursor to the beginning of the current line - unleSs a (crlf: Yes> has been issued. In that case, (CR) moves the cursor to th€
beginning of the next line.
In alpha mode, a line feed (LF) moves the cursor down one line, but at the same line position - unless a <lfcr: Yes>
command has been issued. In that case, the (LF) moves the cursor to the beginning of the next line.
When a segment is being defined and the dialog area is disabled, the "warp-around" features of alphatext. are
disabled. When the next character to be displayed would end past x=4095, it is not displayed and the cursor position is left unchanged. Similarly, a (BS) character is not processed if the resulting x-position would be l€ss than zero.
Like-~ise, a (CR) is not processed if the resulting y-coordinate would b€ less than zero, and a (VT) is not processed if the resulting y-coordinate would be greater than.3071.
References
(CR) Character.
<Enable-Dialog-Area> command.
<Page> command.
<Crlf> command.
<Lfcr> command.
<Set-alphatext-size> command.
<Set-4014-alphatext-size> command.
<Set-alphatext-font> command.
<Enter-vector-mode> command.
<Enter-marker-mode> command.
4 .. 128 REV, DEC 1981 4110 SERIES COMMAND REFERENCE
(
ALPHABETICAL LISTING
<Enter-Bypass-Mode> Command
SYNTAX
<enter-bypass-mode>
=
(ESC)(CAN) •Description
The terminal includes a "bypass mode," in which characters coming from the host are ignored until a special "bypass cancel character" is received. This mode is provided
primar-ily for use when the termin~l is sending report messages to the host. (Without the bypass mode, a host which provides a remote echo could cause problems, as the echoed characters would be received by the terminal and executed as commands.) However, there are circumstances when it may be helpful for the terminal to enter bypass mode even though the terminal is not sending a report to the host. The <enter-bypass-mode>
command provides this facility.
For instance, in "half duplex local echo" data communica-tions, the host can issue an <enter-bypass-mode> command to temporarily suppress the terminal's local echo while the operator types in a password.
Entering Bypass Mode. Of course, the terminal enters bypass mode when it receives an <enter-bypass-mode> command.
Besides this, it also enters bypass mode when it sends the first character of each line of a message to the host
computer - except for messages typed by the operator. For this purpose, "the first character of each line" mea~s "the first character of the message, or the first character
following an <eom-indicator> or <eom-char> within the mes-sage."
4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-129
ALPHABETICAL LISTING
For instance:
If the terminal is sending <eom-indicator>s after each
<GIN-report> within a <GIN-report-sequence> (that is, if the <report-EOM-frequency> setting is "more fre-quent"), then the terminal enters bypass mode as it sends the <si~~char> that precedes each <GIN-report>
in the <GIN-report-sequence>. (See the description of
<GIN-report-sequence> for details.)
If the terminal is executing a <copy> from a disk file most recent <set-bypass-cancel-char> command. (It also exits bypass mode in response to the <cancel> command or the
<bypass-cancel-char> and removes the terminal from bypass mode.
4-130
REV,DEC 1981 4110 SERIES COMMAND REFERENCE(
ALPHABETICAL LISTING
References
NOTE
If the current <bypass-cancel-char> is
TNu~ then the bypass mode feature is
disable~n~at case, the <enter-bY=
pass-mode>-Command has no-effect.
<Set-bypass-cancel-char> command.
<GIN-report-sequence> message type.
<Copy> command.
4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-131
ALPHABETICAL LISTING
<Enter-Marker-Mode> Command
r
SYNTAX~
<enter-marker-mode>=
(FS) .J
Description
The <enter-marker-mode> command places the terminal in mar-ker mode. Once in marmar-ker mode, subsequent alphanumeric characters are interpreted as <xy> parameters specifying coordinates at which markers are to be placed. Each <xy>
. coordinate received in marker mode not only causes a marker to be drawn, but also updates the graphic beam position.
Markers are drawn in the current line index, as set by the most recent <set-line-index> command. .
The format of the <xy> parameters is the same as that used with the <enter-vector-mode> command. See the description of the <xy> parameter type for details.
The terminal leaves marker mode on entering alpha mode.
While in marker mode, the <enter-vector-mode> command has no effect. (To go from marker mode to vector mode, you must first place the terminal in alpha mode.)
The <enter-marker-mode> command (that is, the (FS) charac-ter) also has the effect of terciinating any command which precedes it. This is described in Section 2, under the heading "Commands of More Than Three Characters."
References
<Draw-marker> comamnd.
<Set-marker-type> command.
<Xy> parameter type.
4.132 REV, DEC 1981 4110 SERIES COMMAND REFERENCE
(
(
(
ALPHABETICAL LISTING
<Enter-Vector-Mode> Command
SYNTAX
<enter-vector-mode> = (GS) •
Description
The <enter-vector-mode> command places the terminal in vector mode. Once in vector mode, subsequent alphanumeric characters are interpreted as <xy> parameters specifying positions between which vectors are to be drawn.
The first <xy> parameter received after an <enter-vector-mode> command designates a position to which the graphic writing beam is moved. (An exception to this occurs in the case of a (GS)(BEL) sequence; see the (BEL) character
description for details.) Subsequent <xy> parameters specify points to which "draws" are to be performed.
The <enter-vector-mode> command (that is, the (GS) charac-ter) also has the effect of terminating any "escape se-quence" command which may precede it. This is described in Section 2, under the heading "Commands of Three or More Characters."
References
<Draw> command.
<Move> command.
<Xy> parameter type.
4110 SERIES COMMAND REFERENCE REV, DEC 1981
4-133
ALPHABETICAL LISTING
<EOF-Str1ng> Syntactic Construct Description
The <EOF-string> (end-of-file string) is a sequence of up to ten ASCII characters. It is used in and operations to mark the end of a file transfer between the terminal and the host computer. (If the terminal is in block mode, the end-of~file
bit in the <block-control-bytes> is used instead of the
<EOF-string>.)
NOTE
When the terminal is armed for block mode or-in block mOde, it does not
aetec~<EOF-string>s comTng-IFomithe host computer. Therefore, if you are not using block mode you should ~sure ---that the terminai ~not armea-for-Dlock
moae.--- --
---References
<Arm-for-block-mode> command.
< Copy> commando.
<Port-Copy> command.
<Set-EOF-string> command.
".13"
REV, DEC 1981 4110 SERIES COMMAND REFERENCEc
(
ALPHABETICAL LISTING
<EOL-String> SyntactiC Construct Description
The <EOL-string> (end-of-line string) is a sequence of one or two ASCII characters which mark the end of a "line" of text in reports which the terminal sends to the host
computer.
,
For data typed on the keyboard, each "line" of text ends with an <eom-char>, set by the <set-EOM-chars> command.
Typically, this is (CR). Thus, whenever the operator presses RETURN, it marks the end of a line of text.
However, for text sent to the host which the terminal
originates, the mechanism is different. (SUCh text might be
GIN
reports, for example.) The terminal inserts <EOM-indica-tor>s at specific points in the reports it sends to the host. Each <EOM-indicator> marks the end of a line of text being sent to the host. If the terminal is not in block mode, the <EOM-indicator> is sent as a <EOL-string>. (If in block mode, a different mechanism is used; see the <EOM-indicator> description for details.)After sending each <EOL-string>, the terminal waits for the current transmit delay before transmitting the first charac-ter of the next line of text.
References
<EOM-char> characters.
<EOM-indicator> syntactic construct.
<Set-EOL-string> command.
<Set-EOM-chars> command.
Syntax of individual reports: <GIN-report-sequence>, <termi-nal-settings-report>, etc.
4110 SERIES COMMAND REFERENCE RE~DEC1~1 4-135
ALPHABETICAL LISTING host cannot simultaneously use the communications line.) Clearly, then, when the terminal is transmitting data to the character: the <EOM-char>. Typically, the <EOM-char> (end-of-message character) is the carriage return character,
(CR). Whenever the operator presses RETURN, the terminal (
<EOM-indicator> syntactic construct.)
The <EOM-char>s (and <EOM-indicator>s) also playa role in block mode commnunications. When the terminal encounters an
<EOM-char> (or <EOM-indicator» in the characters it is packing into a block, the terminal ends the block and and sets the end-of-message bit in the <block-control-bytes>.
(The <EOM-char> is packed into the block.)
By means of the <set-EOM-chars> command, you can specify one or two characters to serve as the current <EOM-char>s.
REV, DEC 1981 4110 SERIES COMMAND REFERENCE
(
ALPHABETICAL LISTING
References
<Block-control-bytes> syntactic construct.
<EOM-indicator> syntactic construct.
<Set-block-packing> command.
<set-EOM-chars> command.
<Set-transmit-delay> command.
4110 SERIES COMMAND REFERENCE REV, DEC 1981 lJ-137
ALPHABETICAL LISTING
<EOM-Indioator> Syntaotio Construot SYNTAX
<EOM-indicator>
=
<EOL-string>or <block-mode-end-of-message> •
<block-mode-end-of-messag~>
=
the end of a block, in which the end-of-message bit has been set iti the<block-control-bytes> .
Description
Data sent from the terminal to the hOst is divided into
"lines" of text. At the end of such line, the terminal pauses (for the current transmit delay) before sending the next line. This gives the host computer a chance to "talk back" to the 'terminal. (This is especially important in half
duplex data communications, in which the terminal and the (-host cannot simultaneously use the communications line.)
Clearly, then, when the terminal is transmitting data to the host it must have a way to know'when it has reiched the end of a line. There are two mechanisms for this: <EOM-char>s and <EOM-indicator>s.
<EOM-char>s are used for ~ata which the operator types on the keyboard. (See the description of the <EOM-char>
characters for details.)
For messages (such as GIN reports) which the terminal itself originates, <EOM-indicator>s mark the end of the "lines" of text. The syntax of the ~articular report being sent deter-mines at which pOint in that report these <EOM-indicator>s occur. (See, for example, the descriptions of <GIN-report-sequence> and <errors-report> syntactic constructs.)