doc.out

通讯程序源码

	       6) LF translation. Same as above except the choices are:

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

	       7) Transfer timeout.  The number of seconds to  be  used  to
	       determine  the  end  of an ASCII download.  You can halt the
	       transfer before the timer goes off by hitting the <ESC> key.

	       8-9) Same as 5) and 6) above, except the translations  apply
	       to ASCII downloading.


	  3.7.  External protocol setup

	  This setup screen allows you to embed the name of  external  file
	  transfer  programs  into  the  list of available protocols.  When
	  transferring files, the external program name will appear on  the
	  list of options along with the built-in protocols.





			       Pcomm Reference Manual               Page 15


	  -------------------- External Protocol Setup --------------------

				      UPLOAD

		  Name     Command Line             Requires file list?
	       1) zmodem   sz                               Y
	       2) kermit   kermit -ivs                      Y
	       3)                                           N

				     DOWNLOAD

		  Name     Command Line             Requires file list?
	       4) zmodem   rz                               N
	       5) kermit   kermit -ivr                      Y
	       6)                                           N

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

	  To change a line (or add a new one), enter the line number at the
	  prompt.  You will be prompted for the Name, the Command Line, and
	  the "Requires file list?" flag.  To  remove  an  entry,  enter  a
	  single space character at the Name prompt.

	  The Command Line is the Unix command that you would normally type
	  in  to  invoke  the  program  (minus the names of the files to be
	  transferred).  The last field in the setup is  used  to  indicate
	  whether or not Pcomm should prompt for a list of file names to be
	  added to the command.

	  NOTE:  Pcomm adds a single space character and the file names (if
	  any) to the end of the command.

	  NOTE:  The program itself isn't "embedded" into Pcomm  (it  still
	  gets  called  like any other external program), only the name and
	  invocation information is actually incorporated into Pcomm.





	  Page 16              Pcomm Reference Manual






			       Pcomm Reference Manual               Page 17


	  4.  MAJOR FUNCTIONS

	  When Pcomm is invoked without  the  "-f"  or  "-a"  command  line
	  option,  you're  placed  in the terminal mode with a blank screen
	  and a status line.  However, since Pcomm hasn't  yet  selected  a
	  serial  port  to  use,  characters  typed at the blank screen are
	  ignored.  Normally the first command you'll use is ^A-D to  bring
	  up the dialing directory menu.


	  4.1.  Dialing directory

	  To dial another system, you  type  ^A-D  to  access  the  dialing
	  directory menu, then enter the entry number at the prompt.

	  The entry number could be preceded by  a  special  long  distance
	  dialing  code  such  as "#5" in lieu of "5" alone.  Long distance
	  codes could contain access numbers such as  those  that  MCI  and
	  Sprint require.

	  A typical dialing directory will look like this:

    +---------------------------------------------------------------------------+
    |                  D I A L I N G       D I R E C T O R Y                    |
    +---------------------------------------------------------------------------+
    |         Name                 Number         Baud P D S   Dpx  Auxiliary   |
    |  1- Abbey Road          1 [phone]    2400-N-8-1    F               |
    |  2- Tel-Med-Com                 555-8686    9600-E-7-1    F   TELEBIT_V.32|
    |  3- C Board             1 [phone]    2400-N-8-1    F               |
    |  4- Crest               1 [phone]    2400-N-8-1    F   Sample      |
    |  5- Last Chance         1 [phone]    2400-E-7-1    F               |
    |  6- Killer              1 [phone]    1200-E-7-1    F               |
    |  7- System A (direct)                      19200-N-8-1    F   tty12       |
    |  8-                                         1200-E-7-1    F               |
    |  9-                                         1200-E-7-1    F               |
    | 10-                                         1200-E-7-1    F               |
    |                                                                           |
    |   ==> _      R Revise           M Manual Dialing    Entry to Dial         |
    |              P LD Codes         D Delete Entry      <CR> Scroll Down      |
    |              <up>/<down> Page   L Print Entries     <ESC> Exit            |
    |                                                                           |
    |   LD Codes Active: @ #                                                    |
    |                                                                           |
    +---------------------------------------------------------------------------+

	  The fields of the dialing directory are:

	       Name) The name of the remote system.





	  Page 18              Pcomm Reference Manual


	       Number) The telephone number to the remote system.

	       NOTE:  The "(", ")", "-", and space characters are just  for
	       looks,  and  don't  get  sent  to the modem.  To prevent the
	       stripping of one of these characters, prepend a "\" to it.

	       Line settings) The communications settings to be  used  when
	       dialing that entry.  The range of values are:

		     Baud    Parity    Data bits   Stop bits
		    ________________________________________
		      300   N - none       7           1
		     1200   E - even       8           2
		     2400   O - odd
		     4800
		     9600
		    19200
		    38400

	       Duplex) The duplex mode.  Either "F" for  full  or  "H"  for
	       half.

	       Auxiliary) This field contains the name of a file which  has
	       one of three uses:

		     1) A shell script to be  used  during  the  auto-login
		     "chat" sequence.
	       	     2) A particular TTY to be used for hard-wired ports.
		     3) A customized modem configuration  to  be  used  for
		     this entry.

	       NOTE:  On all  hard-wired  ports,  this  field  is  used  to
	       contain  the  name  of the port.  For example, if tty12 is a
	       hard-wired port to "System A", then  the  dialing  directory
	       entry  for  "System  A"  will  have "tty12" in the auxiliary
	       field.

	       NOTE:   The  ability   to   specify   a   customized   modem
	       configuration  allows  you  to tailor each dialing directory
	       entry to meet the peculiar needs of the modem at  the  other
	       end of the connection.  See Appendix C for more details.

	  The commands at the dialing directory prompt are:

	       R) Revise  (or  add)  a  dialing  directory  entry  or  long
	       distance  dialing  code.  Prompts you to save the changes to
	       disk.  A typical revise screen would look like this:





			       Pcomm Reference Manual               Page 19


	       +----------------------------------------------------------+
	       |                                                          |
	       |   Entry to revise? _        (Entry Number, +,-,@,#)      |
	       |                                                          |
	       +----------------------------------------------------------+

	       If a dialing directory entry is selected, each field of  the
	       entry  is  shown with its current settings.  You can enter a
	       new value, press a carriage return to skip past a field,  or
	       enter  a  single space character to erase a field.  An <ESC>
	       at any field will abort the command.

	       P) Print (display) the long distance dialing codes.

	       <up>/<down>) Scroll the dialing  directory  up  or  down  10
	       lines.   Use  the  up  and  down  arrow  keys to access this
	       feature.

	       M) Manual dial.  Prompts you for a phone number rather  than
	       using a number already in the dialing directory.

	       D) Delete an entry or a range of entries.   Prompts  you  to
	       save the changes to disk.

	       L) Print.  Send the dialing directory to the  printer  or  a
	       file of your choice.

	       1-100) Entry number.  Dial the phone for that entry  number.
	       If  the script field contains the name of a valid Unix shell
	       script, that script is "played" after the connection is made
	       to  perform  the auto-login "chat" sequences.  See section 8
	       of this manual for more details on the  format  and  use  of
	       script commands.

	       NOTE:  To access the port directly without dialing  (perhaps
	       to  send  the dial codes yourself), select an empty entry or
	       enter a single space character at the phone number prompt of
	       the manual dial option.

	       <CR> Carriage return.  Scroll the dialing directory down one
	       line.


	  4.2.  Redial

	  The redial feature is a misnomer; it really is a  queuing  system
	  that allows Pcomm to dial several numbers in a cycle until one of
	  them answers.





	  Page 20              Pcomm Reference Manual


	  When you invoke the redial command with ^A-R, you're prompted for
	  a  list  of  dialing  directory numbers.  (You may also prepend a
	  long distance code to the entry number).

	  +-- Redial Queue -----------------------------------------------+
	  |                                                               |
	  |   Directory Entry Number(s): _                                |
	  |                                                               |
	  |                  (<CR> for previous numbers)                  |
	  +---------------------------------------------------------------+

	  To redial the previous number, press a carriage return  alone  at
	  the prompt.  An <ESC> aborts this command.


	  4.3.  Keyboard macros

	  Keyboard macros are used as a  shortcut  to  send  commonly  used
	  strings  to  the  remote  system with only a few keystrokes.  The
	  characters used to identify the macros  are  the  shifted  number
	  keys.   For  example,  if  the  string  "ls  -alRF  \| more!" was
	  assigned to the "!" key (the shifted number 1 key), then when you
	  press  ^A-!,  the  string "ls -alRF | more" is sent to the remote
	  (followed by a  <CR>  because  of  the  "!"  character  synonym).
	  Notice the use of the "\" character to remove the special meaning
	  of the "|" character synonym.

	  To review or edit  the  keyboard  macros,  you  type  ^A-M.   The
	  following screen will appear:

	      +-------------------------------------------------------+
	      |                   Keyboard Macros                     |
	      +-------------------------------------------------------+
	      |                                                       |
	      |  ^A-! ls -alRF \| more!                               |
	      |  ^A-@                                                 |
	      |  ^A-#                                                 |
	      |  ^A-$                                                 |
	      |  ^A-%                                                 |
	      |  ^A-^                                                 |
	      |  ^A-&                                                 |
	      |  ^A-*                                                 |
	      |  ^A-(                                                 |
	      |  ^A-)                                                 |
	      |                                                       |
	      |  Macro key to revise: _                               |
	      |                                                       |
	      +-------------- Press <ESC> to continue ----------------+

	  To edit a macro, you type the macro key  character  (without  the
	  leading  hot  key).  After typing the new string information, you
	  will be prompted to save the changes to disk.  To erase an  entry
	  enter a single space character.





			       Pcomm Reference Manual               Page 21


	  NOTE:  All of the character synonyms described in section 3.5 are
	  available for use with the keyboard macros.


	  4.4.  Line settings

	  The line settings menu  is  invoked  by  ^A-P.   A  typical  line
	  settings menu will look like this:

		  +------------------------------------------------+
		  |                Line Settings                   |
		  +------------------------------------------------+
		  |                                                |
		  |       Current Settings:  1200,E,7,1            |
		  |                                                |
		  |     1)    300,E,7,1      8)    300,N,8,1       |
		  |     2)   1200,E,7,1      9)   1200,N,8,1       |
		  |     3)   2400,E,7,1     10)   2400,N,8,1       |
		  |     4)   4800,E,7,1     11)   4800,N,8,1       |
		  |     5)   9600,E,7,1     12)   9600,N,8,1       |
		  |     6)  19200,E,7,1     13)  19200,N,8,1       |
		  |     7)  38400,E,7,1     14)  38400,N,8,1       |
		  |                                                |
		  |   Parity       Data Bits       Stop Bits       |
		  |   15) Odd      16) 7 bits      18) 1 bit       |
		  |                17) 8 bits      19) 2 bits      |
		  |                                                |
		  |   20) Save Changes      YOUR CHOICE: _         |
		  |                                                |
		  +------------ Press <ESC> to return -------------+

	  While  dialing  a  remote,  the  line  settings  in  the  dialing
	  directory  entry  are  automatically  used.   Therefore  the line
	  settings menu is used to fine tune the values during  a  terminal
	  session  or to select the parameters for manual dialing.  You can
	  make the current setting  the  default  by  selecting  the  "Save
	  Changes" option.

	  The current line settings are also displayed in the status line.

	  NOTE:  During file transfers, certain parameters (namely the data
	  bits  and  parity)  will be temporarily changed.  The status line
	  will not reflect these temporary promotions.





	  Page 22              Pcomm Reference Manual


	  4.5.  Exit Pcomm

	  To exit Pcomm, you type ^A-X.  The phone is hung up  (if  a  call
	  was in progress), the print and data logging features are closed,
	  and the TTY resources are released.

	  NOTE:  Pcomm drops the DTR (Data  Terminal  Ready)  on  the  port
	  before exiting to Unix.


	  4.6.  Unix gateway

	  To temporarily suspend Pcomm and spawn a  Unix  shell,  you  type
	  ^A-4.  To return to Pcomm, you exit the shell normally, typically
	  with ^D or "exit".

	  NOTE:  The SHELL environmental  variable  is  used  to  determine
	  which program to invoke.