comparison xml/510connectbot.in @ 470:2cc170e3fc9b stable-1.9.3-8

audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
author Carl Byington <carl@five-ten-sg.com>
date Fri, 04 Oct 2019 16:44:44 -0700
parents 12e2d9dd95df
children 9ff443085f00
comparison
equal deleted inserted replaced
469:fbb1a98998fb 470:2cc170e3fc9b
27 </para> 27 </para>
28 </partintro> 28 </partintro>
29 29
30 <refentry id="x@PACKAGE@.1"> 30 <refentry id="x@PACKAGE@.1">
31 <refentryinfo> 31 <refentryinfo>
32 <date>2019-05-13</date> 32 <date>2019-10-04</date>
33 <author> 33 <author>
34 <firstname>Carl</firstname> 34 <firstname>Carl</firstname>
35 <surname>Byington</surname> 35 <surname>Byington</surname>
36 <affiliation><orgname>510 Software Group</orgname></affiliation> 36 <affiliation><orgname>510 Software Group</orgname></affiliation>
37 </author> 37 </author>
102 all 24 function keys for 5250 emulation. A hardware button can 102 all 24 function keys for 5250 emulation. A hardware button can
103 be configured to display that function keypad. 103 be configured to display that function keypad.
104 </para></listitem> 104 </para></listitem>
105 105
106 <listitem><para> 106 <listitem><para>
107 A deployment.connections text file is read (and deleted) on 107 A deployment.connections text file is read (and optionally deleted) on
108 startup. This may be used to preconfigure the global options 108 startup. This may be used to preconfigure the global options
109 and to create an initial set of host connections. This is only 109 and to create an initial set of host connections. This is only
110 useful for bulk deployments. 110 useful for bulk deployments.
111 </para></listitem> 111 </para></listitem>
112 112
177 command value, and the remaining uint16 values are the arguments 177 command value, and the remaining uint16 values are the arguments
178 if any for that command. 178 if any for that command.
179 </para> 179 </para>
180 180
181 <para> 181 <para>
182 Any arguments that are keystrokes or characters are represented 182 Any arguments that are characters are represented as 16 bit
183 as 16 bit unicode. Note that the first 256 such characters are 183 unicode. Note that the first 256 such characters are identical to the
184 identical to the ISO-8859-1 latin character set. 184 ISO-8859-1 latin character set. There is no provision for handling
185 surrogate pairs as in UTF-16. Keystroke arguments (see DEPRESS) are
186 represented as Microsoft Virtual-Key codes, defined at
187 <ulink url="https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes">here</ulink>.
185 </para> 188 </para>
186 189
187 <para> 190 <para>
188 INIT = 0 (TE -> Monitor). The argument is a string of uint16 191 INIT = 0 (TE -> Monitor). The argument is a string of uint16
189 characters. The meaning of these characters is defined by the 192 characters. The meaning of these characters is defined by the
222 <para> 225 <para>
223 SCREENCHANGE = 4 (TE -> Monitor). The first argument is the 226 SCREENCHANGE = 4 (TE -> Monitor). The first argument is the
224 number of lines. The second argument is the number of columns. 227 number of lines. The second argument is the number of columns.
225 That is followed by lines*columns uint16 character codes for 228 That is followed by lines*columns uint16 character codes for
226 the current screen contents. 229 the current screen contents.
230 </para>
231
232 <para>
233 Every SCREENCHANGE message from the TE will be followed by a
234 CURSORMOVE message.
235 </para>
236
237 <para>
238 When the TE sends the screen contents as a result of a previous screen
239 watch, the screen watch area is then reset to the entire screen. The
240 voice application is then responsible for sending a screenwatch
241 command to set the watch area to something appropriate for that new
242 screen. Once the application has set the watch area to some part of a
243 single line, there is no mechanism for the application to reset it to
244 back to the entire screen. That reset only happens when the TE sends
245 the screen contents.
227 </para> 246 </para>
228 247
229 <para> 248 <para>
230 FIELDVALUE = 5 (TE -> Monitor). 249 FIELDVALUE = 5 (TE -> Monitor).
231 SETFIELD = 5 (Monitor -> TE). 250 SETFIELD = 5 (Monitor -> TE).
235 character codes from the screen buffer. The field 254 character codes from the screen buffer. The field
236 covers N columns, where N = (message length - 4). 255 covers N columns, where N = (message length - 4).
237 When sent from the monitor to the emulator, this causes 256 When sent from the monitor to the emulator, this causes
238 the emulator to send the field codes to the host (for async 257 the emulator to send the field codes to the host (for async
239 modes) or to set the specified field contents (for block modes). 258 modes) or to set the specified field contents (for block modes).
259 If the field length is zero, the TE should move the cursor to the specified line/column.
260 </para>
261
262 <para>
240 This is also used as the reply message from the emulator to the 263 This is also used as the reply message from the emulator to the
241 monitor for a previous GETFIELD from the monitor. 264 monitor for a previous GETFIELD from the monitor.
242 </para> 265 </para>
243 266
244 <para> 267 <para>
261 to the monitor. The initial screen watch area is the entire 284 to the monitor. The initial screen watch area is the entire
262 screen. 285 screen.
263 </para> 286 </para>
264 287
265 <para> 288 <para>
289 Subsequent screenwatch requests replace the current one, so the TE
290 has only one watch area at any time.
291 </para>
292
293 <para>
266 DEPRESS = 8 (Monitor -> TE). The argument is a single uint16 294 DEPRESS = 8 (Monitor -> TE). The argument is a single uint16
267 value containing the vk_key value. This command causes the emulator 295 value containing the vk_key value. This command causes the emulator
268 to simulate a keypress for that key. The codes are defined 296 to simulate a keypress for that key. The codes are defined
269 <ulink url="http://msdn.microsoft.com/en-us/library/windows/desktop/dd375731">here</ulink>. 297 <ulink url="https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes">here</ulink>.
270 </para> 298 </para>
271 299
272 <para> 300 <para>
273 SHOWURL = 9 (Monitor -> TE). The single argument is a sequence 301 SHOWURL = 9 (Monitor -> TE). The single argument is a sequence
274 of uint16 character codes forming a URL to be displayed. 302 of uint16 character codes forming a URL to be displayed.
289 317
290 <para> 318 <para>
291 SAYSTRING = 12 (TE -> Monitor). The first argument is nonzero if 319 SAYSTRING = 12 (TE -> Monitor). The first argument is nonzero if
292 any current speech should be flushed. The second argument is nonzero 320 any current speech should be flushed. The second argument is nonzero
293 if this speech should be synchronous. That is followed by uint16 321 if this speech should be synchronous. That is followed by uint16
294 character codes to be spoken. 322 character codes to be spoken. Note that the language is specified
323 by the monitor, not the TE.
295 </para> 324 </para>
296 </refsect1> 325 </refsect1>
297 326
298 <refsect1 id='todo.1'> 327 <refsect1 id='todo.1'>
299 <title>TODO</title> 328 <title>TODO</title>
329 </refsect1> 358 </refsect1>
330 </refentry> 359 </refentry>
331 360
332 <refentry id="x@PACKAGE@.5"> 361 <refentry id="x@PACKAGE@.5">
333 <refentryinfo> 362 <refentryinfo>
334 <date>2019-05-13</date> 363 <date>2019-10-04</date>
335 <author> 364 <author>
336 <firstname>Carl</firstname> 365 <firstname>Carl</firstname>
337 <surname>Byington</surname> 366 <surname>Byington</surname>
338 <affiliation><orgname>510 Software Group</orgname></affiliation> 367 <affiliation><orgname>510 Software Group</orgname></affiliation>
339 </author> 368 </author>
405 encryption5250=NONE 434 encryption5250=NONE
406 fontsize=20 435 fontsize=20
407 fixed_size=true 436 fixed_size=true
408 fixed_width=80 437 fixed_width=80
409 fixed_height=25 438 fixed_height=25
439 monitor=socket://localhost/pub400
410 440
411 441
412 # 442 #
413 # global settings are under global:// tag 443 # global settings are under global:// tag
414 # 444 #