doc.out

通讯程序源码

	  There are several different types of prompts used  in  the  setup
	  screens.  The prompts use the bottom two lines on the display for
	  user input and to give more information on what is  being  asked.
	  Pcomm  will beep at any illegal input.  The escape key <ESC> will
	  abort any prompt.  The prompt types are:

	       o Character prompt.  Asks you to input a single character.
	       o String prompt.  Asks you to  input  a  word  or  group  of
		 characters.
	       o Numeric prompt.  Asks you for a number.
	       o Menu prompt.  Shows a selection and allows you  to  choose
		 the  current  selection by pressing the carriage return or
		 change the selection by pressing the space bar.


	  3.2.  TTY setup

	  The TTY setup allows you to assign the serial ports that Pcomm is
	  allowed to use, and what is attached to each port.  A typical TTY
	  setup screen might look like this:





	  Page 8               Pcomm Reference Manual


	  -------------------------- TTY Setup ----------------------------

		      TTY name        Modem name     Locked speed

		      1) tty10        HAYES               0
		      2) tty11        HAYES               0
		      3) tty12        DIRECT              0
		      4) tty13        TELEBIT             38400
		      5) tty13        TELEBIT_V.32        38400
		      6) tty13        TELEBIT_PEP         38400
		      7)                                  0
		      8)                                  0
		      9)                                  0
		     10)                                  0

		      A) Add a TTY entry
		      D) Delete a TTY entry

	  -----------------------------------------------------------------
	  OPTION ==> _                                Press <ESC> to return

	  You may edit an entry by typing the entry number at  the  prompt.
	  To add an entry, you type "A" at the prompt, etc.

	  The TTY setup fields are:

	       1) TTY name.  This is the name of the serial port that Pcomm
	       will  be  allowed to use.  Notice that the path component of
	       the name, "/dev/" is not used.

	       2) Modem name.  This a key word that is used later  to  link
	       the modem database with the TTY database.  The name could be
	       any combination of letters or numbers (both upper and  lower
	       case).

	       NOTE:  All hard-wired ports (ports without modems  attached)
	       must use the word "DIRECT" for the modem name.

	       3) Locked speed.  Normally Pcomm will use the baud  rate  in
	       the dialing directory when talking to  the  modem.   If  the
	       locked speed is non-zero, then the baud  rate  specified  is
	       the  only  one  that  will  ever  be used.  The baud rate is
	       selected from a "menu prompt".   See  Appendix  C  for  more
	       information about the use of this feature.

	       NOTE:  It is often best to put the fastest modem/TTYs at the
	       end of the TTY database.





			       Pcomm Reference Manual                Page 9


	  3.3.  Modem setup

	  The modem setup contains the commands to  make  the  modem  dial,
	  hang  up the phone, etc.  A typical modem setup screen might look
	  like this:

	  -------------------------- Modem Setup --------------------------

		     1) Modem name (1 of 5) ... HAYES
		     2) Modem init string ..... ATS7=60S11=70E0Q0V1X4&D2!
		     3) Dialing command ....... ATDT
		     4) Dialing cmd suffix .... !
		     5) Hang up string ........ ~~+++~~ATH0!
		     6) Auto baud detect ...... Y
		     7) 300 baud connect ...... CONNECT!
		     8) 1200 baud connect ..... CONNECT 1200
		     9) 2400 baud connect ..... CONNECT 2400
		    10) 4800 baud connect .....
		    11) 9600 baud connect .....
		    12) 19200 baud connect ....
		    13) 38400 baud connect ....
		    14) No connect string 1 ... BUSY
		    15) No connect string 2 ... VOICE
		    16) No connect string 3 ... NO CARRIER
		    17) No connect string 4 ...
	  -----------------------------------------------------------------
	  OPTION ==> _                                Press <ESC> to return

	  The fields of the modem setup are:

	       1) Modem name.  This is the key word that  links  the  modem
	       database  with  the  TTY database.  A menu prompt is used to
	       select the modem name (and the remaining parameters that  go
	       with  it).   The  "(1  of  5)"  field  indicates  there  are
	       additional modems in the database.

	       2) Modem initialization string.  This is sent to  the  modem
	       whenever  the  port  is selected.  Consult your modem manual
	       for the codes to  be  used.   Notice  the  use  of  the  "!"
	       character.  This is the "character synonym" for the carriage
	       return.

	       NOTE:  See section 3.5 for the complete  list  of  character
	       synonyms.   To  remove  the  special  meaning of a character
	       synonym, you must prepend a "\" to the character.

	       3) Dialing command.  The first part of the command  to  make
	       the  modem  dial.   It is assumed that the phone number will
	       immediately follow.





	  Page 10              Pcomm Reference Manual


	       4) Dialing command suffix.  The last part of the command  to
	       make  the  modem  dial.  Typically this will be the carriage
	       return "character synonym".

	       5) Hang up string.  The command to make the  modem  hang  up
	       the  phone.   The  character synonym for a 1 second pause is
	       the tilde "~" character.

	       6) Auto baud detect.  Should Pcomm  attempt  to  change  the
	       baud  rate  of the TTY to the baud rate matching the connect
	       string?  This feature requires the  connect  strings  to  be
	       unique.   This does  not  override  the locked speed feature
	       (discussed in section 3.2).

	       7-13) Connect strings.  The return messages when  the  modem
	       has  connected  to  the  remote.   If different messages are
	       returned for each baud rate at which the modem answers, then
	       they should be specified.

	       NOTE:  Pcomm uses the connect  strings  to  determine  which
	       baud rates the modem is capable of supporting.  For example,
	       if the 4800 baud connect string is empty, Pcomm assumes  the
	       modem can not support 4800 baud.

	       NOTE:  If  two  connect  strings  are  very  similar,   (for
	       example, "CONNECT" is entirely contained in "CONNECT 1200"),
	       it is possible that the return  code  from  the  modem  will
	       match the incorrect string.  To prevent this from happening,
	       use the command synonym for the carriage return to terminate
	       the  shorter  string (for example, use "CONNECT!" instead of
	       "CONNECT").

	       14-17) No connect strings.  The  messages  returned  by  the
	       modem when no connection is made.


	  3.4.  Terminal setup

	  The terminal setup allows you to  define  the  hot  key  and  the
	  mapping  of the end-of-line characters.  A typical terminal setup
	  menu will look like this:





			       Pcomm Reference Manual               Page 11


	  ---------------------- Terminal Setup ---------------------------

			1) Hot key (decimal) ...... 1
			2) ASCII version of hot ... ^A

			3) Duplex ................. FULL
			4) Flow control ........... XON/XOFF
			5) CR translation (in) .... CR
			6) CR translation (out) ... CR

	  -----------------------------------------------------------------
	  OPTION ==> _                                Press <ESC> to return

	  The fields in the terminal setup are:

	       1) Hot key.  This is the decimal code for the user definable
	       hot  key.  Consult an ASCII/decimal conversion chart for the
	       decimal values of other characters.

	       2) ASCII version of hot key.  This is the printable  version
	       of  the  hot key used by Pcomm in the help screen and status
	       line.

	       3) Duplex.  A menu prompt is shown to  select  between  FULL
	       duplex and HALF duplex.  In the half duplex mode, characters
	       sent to the remote system are also sent to the screen.  (The
	       duplex  mode  can  also  be changed "on the fly" by the ^A-E
	       command.)

	       4) Flow control.  A menu prompt is shown to  select  between
	       XON/XOFF  flow  control  and  NONE.  A value of NONE assumes
	       that the hardware (not Pcomm) will perform the flow control.

	       NOTE:  If your terminal gets "stuck" due to a  flow  control
	       problem, any ^A (hot key) sequence will resume the flow.

	       5-6) CR translations.  The end-of-line characters  for  both
	       incoming  and  outgoing  carriage  returns can be altered to
	       suit the remote system's needs.  A menu prompt provides  the
	       following choices:

		    o CR (no translation)
		    o CR/LF translate CR to CR/LF

	       The incoming CR translation can also be changed "on the fly"
	       with the ^A-3 command.





	  Page 12              Pcomm Reference Manual


	  3.5.  General setup

	  The general setup allows you to define the character synonyms and
	  the  default files used by the screen dump and other features.  A
	  typical general setup screen might look like this:

	  ------------------------- General Setup -------------------------

			1) Default log file ....... pcomm.log
			2) Screen dump file ....... pcomm.dump

			3) Strip high bit  ........ YES

			4) Pause character ........ ~
			5) CR character ........... !
			6) CTRL character ......... ^
			7) ESC character .......... |
			8) Break character ........ %

			9) Aborted downloads ...... KEEP

		       10) Connect delay (sec) .... 35
		       11) Redial delay (sec) ..... 5

	  -----------------------------------------------------------------
	  OPTION ==> _                                Press <ESC> to return

	  The general setup fields are:

	       1) Default log file.  The  file  name  to  be  used  as  the
	       default  when the data logging is activated (^A-1).  The log
	       file name can be changed "on the fly" by the ^A-1 command.

	       2) Screen dump file.  The file  name  to  be  used  for  the
	       screen dump command (^A-G).

	       3) Strip high bit.  Should Pcomm strip  the  eighth  bit  on
	       incoming  and outgoing characters?  A menu prompt allows you
	       to select YES or NO.  This feature is not used  during  file
	       transfers.

	       4-8) Character synonyms.  These are symbols that Pcomm  uses
	       to   represent   special   characters  (or  perform  special
	       functions) when sending commands to the modem.  Synonyms are
	       useful  for  entering and displaying special characters in a
	       human readable form.  The synonyms are:

		    o Pause for 1 second
		    o The carriage return character (control-M)
		    o Convert the next character to control-xx
		    o The escape character (control-[)
		    o Send a modem break





			       Pcomm Reference Manual               Page 13


	       NOTE:  To prevent  the  special  meaning  of  one  of  these
	       characters prepend a "\" to it.

	       9) Aborted  downloads.   When  a  download  aborts  (fails),
	       should  the  partially  completed  file  be  kept?  The menu
	       prompt allows "KEEP" or "DELETE".

	       10) Connect delay.  The number of seconds  Pcomm  will  wait
	       for the modem to return a status code.

	       11) Redial delay.  The number  of  seconds  to  wait  before
	       Pcomm tries to call the number again.


	  3.6.  ASCII transfer setup

	  This setup screen allows you to select options  to  be  used  for
	  ASCII uploads and downloads.  A typical ASCII transfer setup will
	  look like this:

	  ---------------------- ASCII Transfer Setup ---------------------

				    ASCII UPLOAD

			  1) Echo locally ........... NO
			  2) Expand blank lines ..... NO
			  3) CR delay (ms) .......... 0
			  4) Pace the output ........ NO
			  5) CR translation ......... NONE
			  6) LF translation ......... ADD CR

				   ASCII DOWNLOAD

			  7) Transfer timeout (sec) . 5
			  8) CR translation ......... STRIP
			  9) LF translation ......... NONE

	  -----------------------------------------------------------------
	  OPTION ==> _                                Press <ESC> to return

	  The fields are:

	       1) Echo locally.  This is similar to the  duplex  option  in
	       that  it  copies  outgoing  characters  to  the screen.  The
	       options are YES and NO.

	       2) Expand blank lines.  Should a blank line  (LF  alone)  be
	       expanded  to  a  space and LF?  Some BBS systems use a blank
	       line to signal the end of an ASCII upload.  The options  are
	       YES and NO.





	  Page 14              Pcomm Reference Manual


	       3) CR delay.  The delay in  milliseconds  to  be  used  when
	       sending  a CR.  The menu prompt limits the choice to 0, 100,
	       or 150.

	       4) Pace output.  Should  each  character  sent  be  delayed?
	       Very old BBS systems may require this.  The choice is YES or
	       NO.

	       5) CR translation.  The menu prompt provides  the  following
	       choices for upload translations:

		    o NONE (no translation)
		    o ADD LF translate CR to CR/LF
		    o STRIP remove the CR character