doc.out

通讯程序源码

	  4.7.  Command files

	  Command files (shell scripts) can be invoked by  typing  ^A-5  to
	  automate  keyboard  input and to perform Pcomm command sequences.
	  The following window will prompt for the file name.

	  +-- Command Files ----------------------------------------------+
	  |                                                               |
	  |   Shell script: _                                             |
	  |                                                               |
	  +---------------------------------------------------------------+

	  The use of shell scripts is discussed in section 8.





			       Pcomm Reference Manual               Page 23


	  5.  UTILITY FUNCTIONS

	  The following commands perform secondary functions.


	  5.1.  Program information

	  To display the opening information screen, you type ^A-I.   Press
	  any key to return to the terminal mode.


	  5.2.  Setup screen

	  The setup screens are described in detail in section  3  of  this
	  manual.


	  5.3.  Change directory

	  To change the current working directory while still inside Pcomm,
	  you type ^A-B.  A screen similar to the following will appear:

	  +-- Change Directory -------------------------------------------+
	  |                                                               |
	  |   Current directory: /usr/egray                               |
	  |   New directory: _                                            |
	  |                                                               |
	  +---------------------------------------------------------------+

	  Abbreviations known to the shell are acceptable; for example, the
	  "~" character will be translated to the home directory in the csh
	  or ksh shell.


	  5.4.  Clear screen

	  To clear the local screen and home the cursor, you type ^A-C.

	  NOTE:  The remote system may  not  "know"  the  screen  has  been
	  cleared,  and  may  make  assumptions  about  the screen that are
	  incorrect.


	  5.5.  Toggle duplex

	  The ^A-E command changes the duplex mode from FULL  to  HALF,  or
	  from  HALF  to  FULL.   The  status line shows the current duplex
	  mode.  Use the Terminal Setup to make permanent  changes  to  the
	  duplex mode.





	  Page 24              Pcomm Reference Manual


	  5.6.  Hang up the phone

	  To hang up the phone, you type ^A-H.   The  word  "disconnecting"
	  will briefly show in the status line.

	  NOTE:  Pcomm does not drop the DTR (Data Terminal  Ready)  during
	  the hang up.


	  5.7.  Printer logging

	  The ^A-L command toggles the printer  logging  on  or  off.   The
	  current printer status is displayed in the status line.

	  NOTE:  Since all printing goes to the  normal  Unix  print  spool
	  program,  the  characters  will  not print on the printer as they
	  appear on the screen.  The printing will actually begin when  the
	  printer  logging is turned off and the complete print job is sent
	  to the spool.


	  5.8.  Toggle CR - CR/LF

	  The ^A-3 command toggles the incoming line termination characters
	  between CR and CR/LF.  The status line shows the current settings
	  (in the next to the last field).


	  5.9.  Break

	  The ^A-7 command sends a modem break to the remote  system.   The
	  word "break" is (very) briefly displayed on the status line.

	  NOTE:  This not the same as the break key  on  the  keyboard  (we
	  don't  want  to send a break to the local system, we want to send
	  it to the remote system).





			       Pcomm Reference Manual               Page 25


	  6.  FILE FUNCTIONS

	  One of the most important features of a telecommunication program
	  is  the  ability  to transfer files.  The following file transfer
	  protocols are implemented:

	       Protocol     Packet     Error          Multiple
	       name         size       detection      files?
	       _______________________________________________
	       xmodem       128        checksum/CRC   no
	       xmodem-1k    128/1024   checksum/CRC   no  1
	       modem7       128        checksum       yes 2
	       ymodem       128/1024   CRC  3         yes
	       ymodem-g     128/1024   none           yes
	       ASCII  4     none       none           no
	       zmodem       128/1024   CRC            yes
	       (external)   ?          ?              ?

	       Notes:   1 CP/M style file name
			2 MSDOS style file name and file size
			3 Not needed!
			4 zmodem is implemented as an external program

	  NOTE:  The built-in protocols that send  file  name  information,
	  convert   the  Unix  style  file  name  to  fit  the  MSDOS  name
	  restrictions.


	  6.1.  External protocols

	  The external "protocol" is really a method of running an external
	  program  from  Pcomm  to  accomplish  a  file transfer.  The most
	  common use of this  feature  would  be  to  run  Kermit  or  some
	  proprietary program.

	  Frequently used external file transfer programs (such as  zmodem)
	  can  have  their  names  embedded  into  the  list  of  available
	  protocols by using the External Protocol Setup in section 3.7.

	  To abort an external file transfer, you hit the <ESC>  key.   All
	  other characters typed at the keyboard are ignored.

	  NOTE:  The external protocol feature can also be used to pipe the
	  output of a Unix command to the remote.


	  6.2.  Send files

	  To send a file to the remote, you'll first have to  instruct  the
	  remote  system to receive the file, then type ^A-"up arrow".  The
	  following screen will appear:





	  Page 26              Pcomm Reference Manual


				          +---- Upload -----+
				          |                 |
				          | 1) xmodem       |
				          | 2) xmodem-1k    |
				          | 3) modem7       |
				          | 4) ymodem       |
				          | 5) ymodem-g     |
				          | 6) ASCII        |
				          | 7) zmodem       |
				          | 8) kermit       |
				          | E) (external)   |
				          |                 |
				          | <ESC> to Abort  |
				          |                 |
				          | Protocol: _     |
				          |                 |
				          +-----------------+

	  You then select the type of protocol at the prompt,  and  another
	  window similar to this will appear:

	  +-- Send xmodem ------------------------------------------------+
	  |                                                               |
	  |   Enter filename: _                                           |
	  |                                                               |
	  +---------------------------------------------------------------+

	  Now you type in the file  name  or  names  you'd  like  to  send.
	  Wildcards known to the shell are acceptable.

	  Now the file transfer actually begins.  A screen similar  to  the
	  following is displayed during the transfer:





			       Pcomm Reference Manual               Page 27


				  +------------- Uploading --------------+
				  |                                      |
				  |           Protocol: xmodem           |
				  |          File name: main.c           |
				  |          File size: 4420             |
				  | Error check method: CRC              |
				  |  Est transfer time: 0:00:50          |
				  |        Block count: 5                |
				  |   Percent complete: 11.2%            |
				  |  Bytes transferred: 640              |
				  |  Errors this block: 0                |
				  |  Total error count: 0                |
				  |       Last message: NONE             |
				  |                                      |
				  +-------- Press <ESC> to abort --------+

	  As  the  transfer  progresses,  the   "block   count",   "percent
	  complete",  and  "bytes  transferred" fields will be continuously
	  updated.  If errors occur the  "errors  this  block"  and  "total
	  error  count" fields will be updated and the "last message" field
	  will contain a message about the error.

	  At the end of the transfer, Pcomm will beep  and  return  to  the
	  terminal  mode.   If  an  error  occurred  and  the  transfer was
	  aborted, you  will  be  prompted  to  acknowledge  the  error  by
	  pressing a key before returning to the terminal mode.


	  6.3.  Receive files

	  To receive a file (or group  of  files)  from  a  remote  system,
	  you'll  have  to  first instruct the remote system, then type ^A-
	  "down arrow".  Receiving a file is basically the same as  sending
	  a file.

	  NOTE:  Some systems do not pad the end of the file with  control-
	  Z's and therefore files might grow in length when received.


	  6.4.  Pass thru mode

	  The pass through mode is used when you have two or more  machines
	  in  a communications daisy chain.  The following diagram shows an
	  example of this type of arrangement:





	  Page 28              Pcomm Reference Manual


	       +----------+        +----------+        +----------+
	       | IBM PC   |        |  Unix    |        | IBM PC   |
	       | running  | <----  | running  | <----  | running  |
	       | ProComm  | -----> | Pcomm    | ---->  | RBBS     |
	       +----------+        +----------+        +----------+

	  If a file is to be transferred from the last machine to the first
	  machine,  the  middle machine must appear completely transparent.
	  The middle machine must "forward the data" without altering it in
	  any  way.   The  pass  through  mode "expires" after a designated
	  period of inactivity, after which the user  is  returned  to  the
	  terminal mode.

	  To access the pass through mode, you type  ^A-T.   The  following
	  screen will appear:

	  +-- Pass Thru Mode ---------------------------------------------+
	  |                                                               |
	  |   Enter the expiration time (5-60 sec) : _                    |
	  |                                                               |
	  +---------------------------------------------------------------+

	  NOTE:  While in the pass through mode, no Pcomm  command  to  the
	  middle  machine will be honored.  Therefore, the only way to exit
	  this mode is to not type  anything  on  the  keyboard  until  the
	  expiration period has elapsed.

	  NOTE:  The baud rates to and from the middle machine need not  be
	  the  same, however the slowest speed determines the overall speed
	  of the transfer (the weakest link in the chain).


	  6.5.  Directory

	  To obtain a listing of a directory  on  the  local  system  while
	  still  running  Pcomm,  you type ^A-F.  The following screen will
	  appear:

	  +-- List Directory ---------------------------------------------+
	  |                                                               |
	  |   Current directory: /usr/egray                               |
	  |   File spec (wildcards allowed): _                            |
	  |                                                               |
	  +---------------------------------------------------------------+





			       Pcomm Reference Manual               Page 29


	  Abbreviations known to the  shell  are  valid.   Output  is  sent
	  through a "more" like program.

	  NOTE:  Since we're really doing a popen() to  the  "ls"  command,
	  additional command line options are also valid.


	  6.6.  Screen dump

	  To dump the contents of the current  screen  (minus  any  windows
	  showing)  you  type ^A-G.  The contents of the screen are written
	  to the file specified in the general setup for this purpose.   If
	  the  file already exists, the screen contents are appended to the
	  file.  The message "screen  dump"  will  briefly  appear  in  the
	  status line.

	  NOTE:  The screen contents  are  subject  to  the  available  VCS
	  (video command sequence) emulation, so an exact representation is
	  not guaranteed.


	  6.7.  Start data logging

	  To start the data logging, or  change  the  file  used  for  data
	  logging, you type ^A-1.  The following screen will appear:

	  +-- Start Data Logging -----------------------------------------+
	  |                                                               |
	  |   Default log file: pcomm.log                                 |
	  |   New log file: _                                             |
	  |                                                               |
	  +---------------------------------------------------------------+

	  To keep the default file, just press a  carriage  return  at  the
	  prompt,  otherwise,  enter  a new file name.  If the file already
	  exits, the new data is appended to the file.

	  The status of the logging is shown in the status line.


	  6.8.  Toggle logging

	  To temporarily suspend data logging or to start it again  without
	  being prompted for the file name, you type ^A-2.