OTSETUP.DOC -- OTERM Terminal Simulator Setup        page   1



Copyright 1981, 1982  Michael M Rubenstein
Version 4.00 (4 Oct 82)

OTSETUP  is  used to install extended  function  key
definitions in OTERM.   See OTERM.DOC for details on
using extended function keys.

The syntax for OTSETUP is

 otsetup <fkey file> <OTERM input> <OTERM output>

Only  the  fkey file is required.   The OTERM  input
file defaults to oterm.com as does the output  file.
Only  those parts of the input or output OTERM  file
names which differ from the default need be entered.
For example:

 otsetup fkeys b: b:

will use b:oterm.com and create b:oterm.com.

In  all cases,  if a file with the same name as  the
output  already  exists it will be renamed  with  an
extenstion of .bak.

The  fkeys  file contains the extended function  key
definitions in the form:

name /function key value/

The  name  may  be from 1 through  127  alphanumeric
characters.   Upper  and lower case are  equivalent.
The "/"s may be any printing character.   The  func-
tion key value may contain any characters except the
delimiter  specified (including carriage returns and
line feeds).

Any number of carriage returns,  line feeds,  spaces
or  control characters may appear between  the  name
and the delimiter or before the next name.

Commands may be entered in the function key value as
for  files  by entering esc <digit> for  a  function
key.

Control  characters may be entered in the  file,  or
may be entered as esc <char>.   For example,  esc a,
would generate ^A.  Rubout may be entered as esc ?.

Note: To  enter  a control character with  WordStar,
     precede it with control p.






OTSETUP.DOC -- OTERM Terminal Simulator Setup        page   2


Example:

a  /function key a/

verylongfunctionkeynamebutnotevenclosetomax

/line1
line2
line3
/

commands
=^[1log on
xmodem rc file.txt
^[1wait 20
^[1send file.txt
=

In the last definition, ^[ is an escape character.

If   a  function  key  is  defined  with  the   name
OTERMINIT,   it  will  be  executed  when  OTERM  is
started.   If one is defined with the name OTERMEND,
it   will  be  executed  at   program   termination.
OTERMEND  may not contain a file read  command,  but
otherwise  these function keys follow the same rules
as others and may be executed manually.


END OF DOCUMENT