seyon.help

功能丰富的串口通讯程序

	      The fun messages to be displayed when Seyon has  no

								6

	      other important information to show. This should be
	      a list of double-quoted [funny] sentences.  Default
	      value: varies, version-dependent

       funMessagesInterval (int)
	      The temporal interval in seconds between successive
	      fun messages.  Default value: 15

       idleGuard (boolean)
	      If set to on, Seyon  will	send  a  string  to  the
	      remote  host  whenever the terminal session is idle
	      (no keyboard input) for a given amount of time. The
	      resources	idleGuardInterval  and  idleGuardString
	      specify the above time interval and the  string  to
	      be  sent to the remote host when idle. It is useful
	      to enable this features to keep the  session  alive
	      when  one	is  away  from	the computer for a while
	      (e.g.  to prevent auto-logout).  Default value: off

       idleGuardInterval (int)
	      The  amount of time in seconds Seyon is to consider
	      the session idle when there is no keyboard activity
	      at  the  terminal for that long.	Seyon will send a
	      string to the remote host every  such  interval  as
	      long as the session is idle.  Default value: 300

       idleGuardString (string)
	      The  string  to be sent to the remote host when the
	      session is idle.	This string will  be  sent  at	a
	      regular  interval	as  long  as the sesiion remains
	      idle. Note that the current  translations	will  be
	      used  in	sending	this  string;	for  example,  if
	      backspaceTranslation is enabled, then  the  default
	      string  <Space><BS>  will	be sent as <Space><DEL>.
	      Default value: \s^H (space then backspace)

       ignoreModemDCD (boolean)
	      If this resource is set  to  'on',  the  modem  DCD
	      (Data  Carrier Detect) status will be ignored. Some
	      of the consequences of setting this to 'on' is that
	      Seyon   will  always  prompt  for	hangup	(if  the
	      resource exitConfirm is set to 'on')  even  if  the
	      modem DCD status indicates that it is off-line, and
	      dialing will be attempted even  if  the  modem  DCD
	      status  indicates	that it is on-line. It is highly
	      recommended that you keep this set to 'off'  unless
	      your  modem  does	not  honor the DCD line. Consult
	      your modem's  manual  for	more  details.	Default
	      value: off

       hangupBeforeDial (boolean)
	      When set to on, Seyon will hangup the line (if con-
	      nected) before dialing the phone number. Otherwise,
	      the  number  will be dialed without hanging up, and

								7

	      it is the user's responsibility to ensure that  the
	      line   is	clear	(no  connection)  when	dialing.
	      Default value: on

       hangupConfirm (boolean)
	      Whether Seyon should ask	for  confirmation  before
	      hanging up the phone Default value: on

       hangupViaDTR (boolean)
	      When  enabled,  Seyon  will  hangup up the modem by
	      dropping DTR. This is much quicker than hanging  up
	      by  sending a Hayes-like hangup string to the modem
	      and waiting to allow for escape  guard  time.  How-
	      ever, some modems and serial drivers choke on drop-
	      ping DTR and others just don't hangup when  DTR  is
	      dropped,	so  in these cases it should be disabled.
	      If disabled, Seyon will hangup the modem by sending
	      the  string  specified  by the resource modemAtten-
	      tionString,  followed  by	that  specified  by  the
	      resource modemHangupString.  Default value: off

       metaKeyTranslation (boolean)
	      Whether  to  transmit  keys  pressed while the meta
	      (ALT) key is held down as an escape (ESC)	followed
	      by  the  key press. Most hosts do not support 8-bit
	      sessions, and hence do not recognize the meta  key.
	      Therefore,  this translation mode has to be enabled
	      when connected to such hosts to take  advantage  of
	      the  meta	key in programs that make use of it like
	      Emacs.  Default value: on

       modemAttentionString (string)
	      The string to send to the modem to get  its  atten-
	      tion  (switch to command mode). This string will be
	      sent to the modem before	the  hangup  string  when
	      hangupViaDTR is disabled.	Default value: +++

       modemHangupString (string)
	      The  hangup  string  to  send  to	the  modem  when
	      hangupViaDTR is disabled.	Default value: ATH^M

       modems (string)
	      A list of modem  devies  to  use.	Seyon	will  try
	      modems  in  this	list one after the other until it
	      finds an available modem or the list is  exhausted.
	      No default value.

       modemStatusInterval (int)
	      This  resource controls the amount of time (in sec-
	      onds) between updates to the modem  status  toggles
	      (including the clock). The default is five seconds,
	      but you can set it to one second (or any other num-
	      ber)  if	you  want  the toggles to be updated more
	      frequently. Even if you set this to a large number,

								8

	      Seyon  is	intellegent enough to update the toggles
	      after each connect or hangup.  Default value: 5

       modemVMin (int)
	      This resource specifies the minimum number of char-
	      acters that should be in the buffer before the read
	      process is satified. The	read  process  will  wait
	      until  that number of incoming characters is in the
	      buffer  or  0.1  second  has  elapsed  between  the
	      receiption  of two characters before displaying the
	      data in the buffer. This results in the data  being
	      displayed in chunks and speeds up the terminal dis-
	      play. The speedup would be most noticeable on  slow
	      machnes with fast modems.

	      Leave this resource at its default (1) or set it at
	      a low value (6) if you  have  a  slow  modem  (e.g.
	      2400bps). Otherwise you might set it to the maximum
	      value, which is  platform-dependent  but	generally
	      255.  If	you set it to any number greater than the
	      maximum value, it will be truncated to the  maximum
	      value.  Default value: 1

       newlineTranslation (string)
	      When  the	Enter	key is pressed, newline character
	      (\n) is generated.  This resource	determines  what
	      to  translate  this  character  to. Three modes are
	      possible: no translation (newline), carriage return
	      (\r), and carriage return / line feed. Unix systems
	      usually expect newline or carrage return, DOS  sys-
	      tems  expect  carraige  return or carriage return /
	      line feed. The three keywords corresponding to  the
	      above  modes are nl, cr, and cr/lf.  Default value:
	      cr

       noConnectStringX [X = 1-4] (string)
	      The response strings given by the modem  when  con-
	      nection  fails.	Default	values:  NO  CARRIER, NO
	      DIALTONE, BUSY, VOICE (respectively)

       phonelistFile (string)
	      The name of  the	phone  list  (dialing  directory)
	      file.  See  the  included example to learn how this
	      file should be formatted.	Default value: phonelist

       postConnectAction (string)
	      Specifies	a simple or compound action that will be
	      executed after a connection to  a	remote	host  is
	      made.  This  action will be executed before running
	      any script attached to that  host	in  the  dialing
	      directory. All actions here have to be synchronous.
	      Refer to the section entitled SeQuickKeys below for
	      a description of available actions.  Default value:
	      Beep();

								9

       protocolsFile (string)
	      The name of the protocols	file.	This  file  tells
	      Seyon  what  file transfer protocols are available.
	      The user will be promted with a list based on  this
	      file   when  file	transfer  is  to  be  initiated.
	      Default value: protocols

       quickKeyX
	      Refer to the section entitled SeQuickKeys below.

       rtsctsFlowControl (boolean)
	      Whether Seyon should turn on RTS/CTS hardware  flow
	      control.	Make sure the modem is set to use this as
	      well.  Default value: off

       scriptDirectory (string)
	      Seyon's script directory. When looking for scripts,
	      Seyon  will  first  try this script directory, then
	      the current directory.  Default  value:  defaultDi-
	      rectory

       showFunMessages (boolean)
	      Whether to display funny messages when Seyon has no
	      other important information  to  show.  Seyon  will
	      display  those messages at an interval specified by
	      the funMessagesInterval resource when there  is  no
	      other  important information to convey to the user.
	      To  disable  the	display	of  fun  messages,  this
	      resource has be set to off.  Default value: on

       startupAction (string)
	      Specifies	a simple or compound action that will be
	      executed on startup. This action is executed  prior
	      to  running  any script (in case the -script switch
	      is given) or  dialing  any  entry	of  the  dialing
	      directory (in case the -dial switch is given or the
	      resource dialAutoStart is enabled).  You	can  make
	      Seyon  open  the dialing directory automatically on
	      startup  by  using  the  simple  action  ``OpenWid-
	      now(Dial);''  as	a  constituent	of  this  complex
	      action stack.  Note that running the startup script
	      is  just	a special case of this resource. Refer to
	      the section entitled SeQuickKeys for a  description
	      of   available   actions.	Default   value:  Run-
	      Script(startup);

       startupFile (string)
	      Seyon's startup file. Seyon will execute	all  com-
	      mands in this file upon startup. This file can have
	      any commands acceptable  as  script  commands.  The
	      most useful command to put here is the set command,
	      to  set  the  various  communications   parameters.
	      Default value: startup

							       10

       stripHighBit (boolean)
	      Whether  to strip the high (eights) bit from incom-
	      ing characters. If set to on, the high bit  of  all
	      incoming	characters  will  be stripped, which will
	      make an  8-N-1  setting  behave  like  7-N-1,  even
	      though  eight  bits  are	used  for each character.
	      Default value: off

       xonxoffFlowControl (boolean)
	      Whether Seyon should turn on XON/XOFF software flow
	      control.	Default value: off

SEQUCKKEYS
       Seyon  allows  the  user	to  have  custom buttons, called
       SeQuickKeys  (z	quickies),  to	which  actions	can   be
       attached.  SeQuickKeys  provide a convenient way via which
       the user can invoke frequently-used operations by a  singe
       mouse   click.	SeQuickKeys  are  specified  through  the
       resources quickKeyX, where X is an  integer  corresponding
       to  the order at which that SeQuickKey is to appear on the
       command center.	Relevant subparts of  that  resource  are
       visible, action, and label. Here is an example:

	      Seyon*quickKey3.visible: on
	      Seyon*quickKey3.action: FileTransfer(1,file); Beep();
	      Seyon*quickKey3.label: Upload

       The  first line specifies that SeQuickKey3 should be visi-
       ble. The second line specifies the  action  bound  to  the
       SeQuickKey  (in	this  case,  a	compound action), and the
       third line specifies the label for that SeQuickKey's  but-
       ton.  Other  subparts  can  also be specified in a similar
       fashion (e.g.  background, foreground, ..etc.)

       Actions can be  either  simple  or  compound.  A	compound
       action  consists	of  a stack of simple actions and can be
       used as simple mini-script.  Examples:

       +o Set(idleGuard,on); DialEntries(Default);
       +o Echo("Uploading files..."); Transmit(rz); \
	     FieTransfer(1,"*.ico $HOME/acct.wks"); Echo(Done);
       +o OpenWindow(Dial); DialEntries("2 5 6");
       +o Echo("Goodbye.."); Hangup(); Quit();
       +o Set(baud,9600); ManualDial("555-5555");
       +o Echo("Will upload..."); ShellCommand("$sz *.wks");
       +o Set(parity,0); RunScript(login.scr); Echo(Finished);

       The following is a list of actions  Seyon  currently  sup-
       ports. Asterisks designate asynchronoous actions. Brackets
       designate optional arguments.

							       11

       Beep();
	      Rings the bell making a short beep.

       CloseWindow(window [,...]);
	      Closes (dismisses) the given windows. Currenly  the
	      only  valid  argument to this action is Dial, which
	      corresponds to the dialing idrectory window.  Exam-
	      ple: CloseWindow(Dial);

       DialEntries(entries-list);*
	      Dials  entries in the dialing directory correspond-
	      ing by order to the given	list.	Entries	will  be
	      dialed  as  if  the  user	had selected them on the
	      dialing directory. Entries will be  dialed  without
	      opening  the  dialing  directory.	You  can use the
	      action  ``OpenWindow(Dial);''  and  stack	the  two
	      actions  in a compound action if you want the dial-
	      ing directory to be opened.

	      The list must be quoted if it consists of more than
	      one entry, and entries should be separated by white
	      space, not commas.  If the list  consists	of  just
	      the word ``Default'', then the entries given by the
	      resource defaultPhoneEntries will be dialed,  refer
	      to  the  description  of	that  resource	for  more
	      details.

	      The most common use of this action is  attach  fre-
	      quesntly-dialed  hosts to SeQuickKeys, making dial-
	      ing those hosts  a  one-click  operation.	If  this
	      action  is not the last in a compound action stack,
	      actions specified by the resource postConnectAction
	      may  not	work properly.	Examples: DialEntries(2);
	      DialEntries("2 4 5"); DialEntries(Default);

       DivertFile([file]);*
	      Sends the given file to the remote host as  a  text
	      upload.  If  the	optional argument ``file'' is not
	      specified, Seyon will pop up a  dialog  box  asking
	      for  the	file name. In the latter case this action
	      is similar to clicking Divert from the Misc window.
	      Examples:	DivertFile("/tmp/acct.wks");	Divert-
	      File();

       Echo([string]);