seyon.help

功能丰富的串口通讯程序

	      Echos the given string to the  terminal.	Does  not
	      send  it	to  the modem (use Transmit for that). If
	      the string consists of more than one word, it  must
	      be  quoted.  Note	that unlike the shell command of
	      the same name, this command does	not  accepts  the

							       12

	      switch -n but always appends newline to the string.
	      If the argument is omitted, an empty line	will  be
	      echoed. Examples: Echo(Hello); Echo("Hello there");
	      Echo();

       FileTransfer(entry, [file-list]);*
	      Executes the  transfer  protocol	corresponding  by
	      order  in	the  trasfer console (protocols file) to
	      ``entry''. If that protocol requires  a  file  name
	      and  file-list is omitted, Seyon will pop up a dia-
	      log box asking for the  file.  Otherwise	file-list
	      will  be	passed to that protocol. The list must be
	      quotes if it consists of more  than  one	word  and
	      items  in it should be separated by white space. It
	      can contain wild cards and shell	variables.  Exam-
	      ples:   FileTransfer(1);	FileTransfer(2,acct.wks);
	      FileTransfer(2,"*.wks $HOME/acct.wks");

       Hangup();
	      Disconnects the line. Does not pop up  a	confirma-
	      tion box.

       IconifyWindow(window [,...]);
	      Iconifies	the  given  windows.  Valid arguments to
	      this action are Main, Dial, and Term, corresponding
	      respectively  to the command center, dialing direc-
	      tory, and terminal emulator windows. When the argu-
	      ment  is	Term,  this  action will work only if the
	      terminal emulator	sets  the  envirenment	variable
	      WINDOWID,	like  xterm  does. Examples: IconifyWin-
	      dow(Main,Dial,Term); IconifyWindow(Dial);

       ManualDial([number]);*
	      Dials a number as if the	Manual	button	had  been
	      clicked  from  the dialing directory. If ``number''
	      is specified, it will be	dialed	directly  and  no
	      dialog box will be popped up asking for the number.
	      Examples: ManualDial(555-5555); ManualDial();

       Message([string]);
	      Echos the	given	string	to  the	message  box  of
	      Seyon's command center (main window). If the string
	      consists of more than one word, it must be  quoted.
	      If  the  argument is omitted, an empty line will be
	      echoed.  Examples:  Message(Hello);  Message("Hello
	      there"); Message();

							       13

       OpenWindow(window [,...]);
	      Opens  each  of  the given windows by popping it if
	      closed or de-iconifying it if in an  iconic  state.
	      Valid  arguments to this action are Main, Dial, and
	      Term, corresponding  respectively	to  the  command
	      center,  dialing	directory,  and terminal emulator
	      windows. When the argument  is  Term,  this  action
	      will  work  only	if the terminal emulator sets the
	      envirenment variable  WINDOWID,  like  xterm  does.
	      Examples:	OpenWindow(Main,Dial,Term);	OpenWin-
	      dow(Dial);

       Quit();
	      Exits Seyon completely and returns  to  the  shell.
	      Does not pop up a confirmation box.

       RunScript([script-name]);*
	      Executes	the script given by the file script-name.
	      The script will be executed  as  if  the	user  had
	      selected	it  via the Script button. If script-name
	      is omitted, a dialog box will be popped  up  asking
	      for  the	script	name.  This  is	a very versatile
	      action, as many remote and local commands or series
	      of commands can be performed by attaching appropri-
	      ate  scripts   to	SeQuickKeys.	Examples:   Run-
	      Script(login.scr); RunScript();

       Set(parameter, value);
	      Sets  the	specified  parameter to the given value.
	      Can be  used  to	set  the  various  communications
	      parameters.  Available  parameters are listed under
	      the    script    command	``set''.	Examples:
	      Set(baud,9600);  Set(parity,0); Set(idleGuard,off).

       ShellCommand(shell-command);*
	      Executes the given shell	command	via  the  user's
	      shell pointed to by the SHELL environment variable,
	      or /bin/sh if that environment variable is not set.
	      Note that the command must be quoted if it consists
	      of more than one word. If the first non-space  let-
	      ter  of  the  command  is the character ``$'', then
	      standard input and standard output  will	be  redi-
	      rected  to to the modem. This action can be used to
	      execute any external  program  from  withen  Seyon.
	      Example: ShellCommand(ls); ShellCommand("$cd $HOME;
	      sz -vv *.wks");

       Transmit(string);
	      Transmits the given string to the remote host.  The

							       14

	      string  must  be quoted if it consists of more than
	      one word. The string is transmitted as is (no  case
	      conversions are performed). No newline character or
	      carriage return is appended to the string, use  the
	      prefix  characters  for that (e.g. ^M, ^J). See the
	      discripttion of the script command ``transmit'' for
	      more details. Example: Transmit(ls^M); Transmit("ls
	      -CF^M");

SCRIPT LANGUAGE
       Script files can automate some tedious tasks such as  log-
       ging  into  a system.  A script file is an ascii text file
       and may be entered or edited using any standard text  edi-
       tor.

       The  script  file is read line by line.	Empty lines (con-
       sisting of white space only) are	ignored.   Comments  are
       lines whose first non-space character is a pound sign (#).

       The script processor  reads  each  script  line,	ignoring
       leading	white  space,  into  words.  A word is defined as
       either:

	      +o a  sequence  of	characters  delimited	by  white
	      space, or
	      +o	a  sequence  of characters enclosed in single or
	      double quotes.

       The first word of a script file is considered the  command
       word.   If  the	last  character	of the command word is a
       colon (:), the line is  considered  to  be  a  label  (the
       object  of a goto statement).  Otherwise, it is assumed to
       be a script command and is interpreted  as  such.  Command
       words are case insensative.

       Some commands take one or more arguments. Each argument is
       parsed as a single word as defined above.  If  blanks  are
       required in an argument, the argument must be quoted using
       single or double quotes.

							       15

   Script Command List
       Below is the description of all commands that may be  used
       in the Seyon script language:

       capture on|off (currently may not work)
	      The  command  capture  on	will enable capture. All
	      characters received during waitfor processing  will
	      be  appended  to the capture file. The command cap-
	      ture off will close the capture file.  This setting
	      does  not	currently  extend to terminal mode. This
	      may be offered in a later release.

       debug on|off
	      If the argument is on, all subsequent command lines
	      processed	will  be  displayed on the local screen.
	      The exception to this is lines containing a  trans-
	      mit  command.  These  lines  will just print TRANS-
	      MIT..., so that passwords, etc. can  be  protected.
	      If  the  argument is off, scripts will execute qui-
	      etly (this is the default setting).

       dial <number>
	      Dial the specified number.  Seyon supports  generic
	      "Hayes"  compatible  modems for dialing.	Note that
	      this command requires an actual phone  number.  The
	      phonebook is not used for this function.

       echo <string>
	      Echos  the  given	string to the terminal. Does not
	      send it to the modem (use transmit  for  that).  If
	      the string contains spaces, it must be quoted. Note
	      that unlike the shell command  of	the  same  name,
	      this  command  does  not	accepts the switch -n but
	      always appends newline to the string.

       exit   Terminates the script file  prior	to  the  end  of
	      file. Returns to terminal mode.

       flush  Flushes  the  modem,  i.e. discards data written to
	      the modem but not transmitted and data received but
	      not read.

       goto <label>
	      Goes  to the specified label in the script file and
	      continues execution from that point. The label  may
	      either precede or follow the actual goto statement.
	      A label is any command word whose last character is

							       16

	      a colon (:).

       hanup  Hangups up the line and disconnects from the remote
	      host.

       if, else, endif
	      Syntax:
	      if <condition>
		      <statements>
	      [else
		      <statements>]
	      endif

	      Conditionally executes statements based  on  speci-
	      fied condition. Seyon supports the following condi-
	      tions:

	      waitfor: true if the last waitfor command was  suc-
	      cessful.
	      linked:  true  if this script was executed from the
	      dialing directory.

	      Conditions may be negated using the prefix  not  or
	      the character !:

	      !waitfor:	true  If  the last waitfor command timed
	      out.
	      not waitfor: same as !waitfor above

	      The else and endif keywords must	appear	on  their
	      own lines. If statements may not be nested.

       pause <time>
	      Suspends	execution of the script for the specified
	      number of seconds.  This is usually used for timing
	      considerations;  for  example,  waiting a couple of
	      seconds after receiving  the  connect  message  and
	      typing ^C to CompuServe.

       purge  Reads  and  discards all data coming from the modem
	      for the duration of one second.

       quit   Terminates the script and exits the  whole  program
	      (returns to the shell).

							       17

       redial Redials  the last number dialed using the dial com-
	      mand.

       send_break
	      Sends a BREAK signal to te remote host.

       set <parameter> <value>
	      Sets the specified parameter to  the  given  value.
	      Can  be  used  to	set  the  various communications
	      parameters for each host. The follwoing is  a  list
	      of the set keywords that Seyon recognizes. Keywords
	      marked with an asterisk set the  current	parameter
	      only, not the default one. Refer to the corresponig
	      resource (in parentheses below) for details of  the
	      function of each keyword.

	      baud* (defaultBPS)
	      bits* (defaultBits)
	      parity* (defaultParity)
	      stopBits* (defaultStopBits)
	      stripHighBit (stripHighBit)
	      newlineTranslation (newlineTranslation)
	      del (backspaceTranslation)
	      meta_tr (metaKeyTranslation)
	      xoff (xonxoffFlowControl)
	      rtscts (rtsctsFlowControl)
	      autozm (zmodemAutoDownload)
	      idleGuard (idleGuard)

	      Boolean  keywords	accept	on or off as their argu-
	      ment, other keywords accept the same  arguments  as
	      the corresponding resources.

       shell <shell-command>
	      Executes	the  given  shell  command via the user's
	      shell pointed to by the SHELL environment variable,
	      or /bin/sh if the environment variable SHELL is not
	      set. Note that the command must  be  quoted  if  it
	      consists	of  more than one word. If the first non-
	      space letter of the command is the  character  '$',
	      then  standard  input  and  standard output will be
	      redirected to to the modem.  This	command  can  be
	      used  to	execute	any external program from withen
	      Seyon. Example: shell "cd /usr/dl; rz -vv".

       transmit <text>
	      Transmits the specified text to  the  remote  host.
	      The text argument should be quoted (using single or

							       18

	      double quotes) if there are spaces to be	transmit-
	      ted. The text is transmitted as is (no case conver-
	      sions are performed).

	      Prefix characters:

	      ^ is the Control character prefix: the next charac-
	      ter  is made into a control character. For example,
	      ^M is carriage return  (0x0D)  and  ^J  is  newline
	      (0x0A).
	      \	is quote prefix: the next character is transmit-
	      ted verbatim. For example, \^ would transmit a lit-
	      eral ^.

       tty on|off
	      This  command  specifies	whether or not characters
	      received from the modem will be  displayed  on  the
	      local  terminal.	Since	the  only  time	that the
	      script processor looks at the receive queue is dur-
	      ing waitfor processing, the displays may look a bit
	      erratic.	Use the tty off command to disable  local
	      display  of  received characters during script pro-
	      cessing.

       waitfor <text> [timeout]
	      Waits for the specified text  to	appear	from  the
	      modem.  The  text	argument should be quoted (using
	      single or double quotes) if there are spaces to  be
	      transmitted.