doc.out

通讯程序源码

		     PPPPPP    CCCC    OOOO    MM   MM   MM   MM
		     P    P   C       O    O   M M M M   M M M M
		     PPPPPP   C       O    O   M  M  M   M  M  M
		     P        C       O    O   M     M   M     M
		     P         CCCC    OOOO    M     M   M     M








			       Pcomm Reference Manual

				     version 2.0



				      written by

				    Emmet P. Gray
			   ...!uunet!uiucuxc!fthood!egray
			    fthood![e-mail]






	  Pcomm is a public domain telecommunication program for Unix  that
	  is  designed to  operate similarly to the MSDOS program, ProComm.
	  ProComm (TM) is copyrighted by Datastorm Technologies, Inc.  This
	  is  a completely new program and contains no ProComm source code.
	  This is not a Datastorm product.





				  Table of Contents




	  1 INTRODUCTION ...............1   6 FILE FUNCTIONS .............25
	    1.1 Abbreviations ..........1     6.1 External protocols .....25
	    1.2 Requirements ...........1     6.2 Send files .............25
	    1.3 Support files ..........2     6.3 Receive files ..........27
					      6.4 Pass thru mode .........27
	  2 RUNNING PCOMM ..............3     6.5 Directory ..............28
	    2.1 Hot key ................3     6.6 Screen dump ............29
	    2.2 Status line ............4     6.7 Start data logging .....29
	    2.3 Help screen ............4     6.8 Toggle logging .........29
	    2.4 Exit Pcomm .............5
					    7 DIALING WINDOW .............31
	  3 SETUP SCREENS ..............7
	    3.1 Prompting ..............7   8 SCRIPT COMMANDS ............33
	    3.2 TTY setup ..............7     8.1 Pcomm_cmd command ......33
	    3.3 Modem setup ............9     8.2 Waitfor command ........37
	    3.4 Terminal setup .........10    8.3 Matches command.........37
	    3.5 General setup ..........12    8.4 Examples ...............38
	    3.6 ASCII xfer setup .......13
	    3.7 External protocol ......14  Appendix A - Typical  Modem
						 Configuration ...........41
	  4 MAJOR FUNCTIONS ............17
	    4.1 Dialing directory ......17  Appendix B - AT&T  Unix  PC
	    4.2 Redial .................19       7300/3b1 Dial Codes .....43
	    4.3 Keyboard macros ........20
	    4.4 Line settings ..........21  Appendix C - Using High Speed 
	    4.5 Exit Pcomm .............22       Modems ..................45
	    4.6 Unix gateway ...........22
	    4.7 Command files ..........22

	  5 UTILITY FUNCTIONS ..........23
	    5.1 Program info ...........23
	    5.2 Setup screen ...........23
	    5.3 Change directory .......23
	    5.4 Clear screen ...........23
	    5.5 Toggle duplex ..........23
	    5.6 Hang up the phone ......24
	    5.7 Printer logging ........24
	    5.8 Toggle CR - CR/LF ......24
	    5.9 Break ..................24





			       Pcomm Reference Manual                Page 1


	  1.  INTRODUCTION

	  Pcomm is a public domain, menu driven, telecommunication  program
	  designed  to  provide  the same "ease of use" as similar programs
	  available in MSDOS.  Some of its features are:

	       o Large dialing directory
	       o Full scripting feature
	       o Automatic redial feature
	       o Six built-in file transfer protocols
	       o External file transfer program support
	       o Data logging (log of the terminal session)
	       o Printer logging
	       o Screen dump to a file
	       o Shell escapes to Unix
	       o Help screen
	       o Keyboard macros
	       o User customization
	       o Optional modem configuration per dialing directory entry
	       o Administrative logging of phone calls
	       o Administrative limits on long distance access

	  Pcomm  does  not  emulate  any  particular  terminal.    Whatever
	  terminal you're on, is what the remote system "sees".


	  1.1.  Abbreviations

	  Pcomm uses the notation "^A-X" to mean control-A followed by  the
	  letter X. The dash (-) in the notation is just for clarity; it is
	  not included in the actual command sequence.  Also, there  is  no
	  distinction between upper and lower case letters.

	  The following abbreviations appear in Pcomm:

	       <CR>      carriage return key (sometimes labeled Enter)
	       <ESC>     escape key
	       <SPACE>   space bar
	       <DEL>     del key
	       <up>      up arrow key
	       <down>    down arrow key
	       LF        line feed character (control-J)
	       CR        carriage return character (control-M)


	  1.2.  Requirements

	  Pcomm will not run on terminals with a screen size of  less  than
	  80  columns by 24 lines or on terminals that lack cursor movement
	  capabilities.  For terminals without arrow keys, use  the  letter
	  "U"  in  place of "up arrow" and the letter "N" in place of "down
	  arrow" (the letter "D" would have been  a  more  obvious  choice,





	  Page 2               Pcomm Reference Manual


	  but, unfortunately, it is used elsewhere).


	  1.3.  Support files

	  Pcomm uses four support files, namely:

	       pcomm.dial_dir   the dialing directory
	       pcomm.extrnl     the external file transfer programs
	       pcomm.modem      the modem/TTY database
	       pcomm.param      the start-up default parameters

	  There is a default directory  (typically  "/usr/local/lib/pcomm")
	  where  the "standard" support files live.  Since the average user
	  won't have write permission on these  files,  it's  assumed  that
	  they  will  copy one or more of these standard files to their own
	  directories and edit them to suit their needs.

	  Pcomm can use the environmental variable "PCOMM"  to  search  for
	  these  "private"  support  files.   If  used,  the  variable must
	  contain the path to the directory containing the files.  You  can
	  "mix  and  match"  the use of standard and private support files.
	  For example, the pcomm.modem file is rarely changed by  the  user
	  so  there  would  be  no  need  to  copy that file to the private
	  directory.

	  Pcomm also uses normal Unix shell scripts to perform  the  "chat"
	  sequences necessary to automatically log a user onto a system.

	  The following directories are searched to find the support  files
	  and the shell scripts:

	       1) directory given with the "-d" option
	       2) directory in the PCOMM environmental variable
	       3) the current working directory
	       4) the default directory (compiled into Pcomm)





			       Pcomm Reference Manual                Page 3


	  2.  RUNNING PCOMM

	  Pcomm has the following command line syntax.

	       pcomm [-d directory] [-f system name] [-a auxiliary file]
		     [-e|o|n] [-w word length] [-b baud rate] [-p phone number]

	  The "-d" option allows you to specify an additional  path  to  be
	  used  when searching for the Pcomm support files.  This option is
	  often useful for "borrowing" someone else's dialing directory.

	  The "-f" option is used to specify automatic dialing of an  entry
	  in  the  dialing  directory.   The  name  field  in  the  dialing
	  directory (described later) is checked against the  string  given
	  on  the  command  line.   If  a  match  is  found,  that entry is
	  automatically dialed.  The match  does  not  consider  upper  and
	  lower case differences.

	  The "-a" option is used to specify a script file to  be  "played"
	  prior  to  dialing,  to specify the TTY to be used, or to specify
	  the modem to be used.  This feature  can  be  used  to  customize
	  Pcomm options or perform unattended operations.

	  The remaining options are used to set the parity, data bits, baud
	  rate, and telephone number from the command line.

	       -e   Set the parity to even
	       -o   Set the parity to odd
	       -n   Set the parity to none
	       -w   Set the world length (number of data bits)
	       -b   Set the baud rate
	       -p   Dial this number


	  2.1.  Hot key

	  Pcomm uses a "hot key" to precede each command.   (The  value  of
	  the  hot  key is a user tunable parameter, but for the purpose of
	  this document we'll assume the hot key is defined as control-A).

	  The hot key is used to  put  Pcomm  in  the  command  mode.   For
	  example,  to  get  the help screen, you type control-A (to get to
	  the command mode) then the number 0 (to display the help screen).
	  When a command is completed, Pcomm returns to the terminal mode.

	  NOTE:  While in the command  mode,  the  communication  with  the
	  remote system is temporarily suspended.





	  Page 4               Pcomm Reference Manual


	  2.2.  Status line

	  Whenever Pcomm is in  the  command  mode  (or  is  not  currently
	  connected  to  a remote) a status line is displayed at the bottom
	  of the screen.  A typical status line might look like this:

    +-----------+---------+------+-----------+----------+----------+------+------+
    | ^A-0 HELP |  No TTY |  FDX |  1200 E71 |  LOG OFF |  PTR OFF |  CR  |  CR  |
    +-----------+---------+------+-----------+----------+----------+------+------+

	  The eight fields of the status line are:

	       o help screen command (or a temporary message)
	       o name of the TTY device in use
	       o duplex mode (FDX = full duplex, HDX = half duplex)
	       o current connection settings (not necessarily DTE speed)
	       o status of data logging option
	       o status of printer logging option
	       o incoming CR translation
	       o outgoing CR translation

	  NOTE:  If the DTE (Data Terminal Equipment)  interface  speed  is
	  locked,  the  status  line will show the "connected" speed rather
	  than the speed of the serial port.

	  2.3.  Help screen

	  The help screen  gives  a  brief  review  of  all  the  available
	  commands.  To access the help screen type ^A and "0" (zero).  The
	  typical help screen will look like this:

   +------------------------------------------------------------------------------+
   |                            P C O M M    H E L P                              |
   +------------------------------------------------------------------------------+
   |                                                                              |
   |    Major Functions          Utility Functions           File Functions       |
   |                                                                              |
   | Dialing Directory. ^A-D   Program Info .... ^A-I   Send Files .... ^A-<up>   |
   | Auto Redial ...... ^A-R   Setup Screen .... ^A-S   Receive Files . ^A-<down> |
   | Keyboard Macros .. ^A-M   Change Directory. ^A-B   Pass Thru Mode. ^A-T      |
   | Line Settings .... ^A-P   Clear Screen .... ^A-C   Directory ..... ^A-F      |
   | Exit Pcomm ....... ^A-X   Toggle Duplex ... ^A-E   Screen Dump ... ^A-G      |
   | Unix Gateway ..... ^A-4   Hang Up Phone ... ^A-H   Start Data Log. ^A-1      |
   | Command Files .... ^A-5   Printer On/Off .. ^A-L   Toggle Log .... ^A-2      |
   |                           Toggle CR-CR/LF . ^A-3                             |
   |                           Break Key ....... ^A-7                             |
   |                                                                              |
   +------------------------- Press any key to continue --------------------------+





			       Pcomm Reference Manual                Page 5


	  2.4.  Exit Pcomm

	  To exit Pcomm, you type ^A and "x" to access the exit window.

	       +-- Exit -----------------------+
	       |                               |
	       |   Exit to Unix? (y/n): _      |
	       |                               |
	       +-------------------------------+

	  To exit, you press the letter "y" (carriage return not required).





	  Page 6               Pcomm Reference Manual





			       Pcomm Reference Manual                Page 7


	  3.  SETUP SCREENS

	  Pcomm allows you to change many of the default  parameters.   The
	  setup  screen  is  accessed  by typing ^A and "s".  The following
	  screen shows the sub-menu choices:

	  ------------------------- Setup Menu ----------------------------

				1) TTY Setup
				2) Modem Setup
				3) Terminal Setup
				4) General Setup
				5) ASCII Transfer Setup
				6) External Protocol Setup
				S) Save setup to disk

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

	  To select one of the sub-menu choices, you type  the  number  (or
	  letter)  at the "OPTION ==>" prompt.  To exit from a sub-menu and
	  return to this setup menu screen, you press the escape key.

	  Changes made affect the current Pcomm session only.  To make  the
	  changes become the default, you select the "s" option.


	  3.1.  Prompting