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!egray@uxc.cso.uiuc.edu	  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