doc.me

通讯程序源码

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:
.br
.CS
.(b L
.TS
box center;
l.
.sp
.\"                                                      spaces out to here
   Entry to revise? _        (Entry Number, +,-,@,#)     
.sp
.TE
.)b
.Cs
.lp
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.
.lp
P) Print (display) the long distance dialing codes.
.lp
<up>/<down>) Scroll the dialing directory up or down 10 lines.  Use the
up and down arrow keys to access this feature.
.lp
M) Manual dial.  Prompts you for a phone number rather than using a
number already in the dialing directory.
.lp
D) Delete an entry or a range of entries.  Prompts you to save the
changes to disk.
.lp
L) Print.  Send the dialing directory to the printer or a file of your
choice.
.lp
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 \*(lqplayed\*(rq after the connection is made to perform the
auto-login \*(lqchat\*(rq sequences.  See section 8 of this manual for
more details on the format and use of script commands.
.lp
.ft I
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.
.ft
.lp
<CR> Carriage return.  Scroll the dialing directory down one line.
.ba
.sh 2 Redial
.(x
  \*($n Redial
.)x
.lp
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.
.lp
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).
.br
.CS
.(b L
.TS
box center;
l.
   Redial Queue
.sp
.\"                                                           spaces out to here
   Directory Entry Number(s): _                               
.sp
.T&
c.
(<CR> for previous numbers)
.TE
.)b
.Cs
.lp
To redial the previous number, press a carriage return alone at the
prompt.  An <ESC> aborts this command.
.sh 2 "Keyboard macros"
.(x
  \*($n Keyboard macros
.)x
.lp
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 \*(lqls -alRF \e| more!\*(rq was assigned to the \*(lq!\*(rq key
(the shifted number 1 key), then when you press ^A-!, the string
\*(lqls -alRF | more\*(rq is sent to the remote (followed by a <CR>
because of the \*(lq!\*(rq character synonym).  Notice the use of the
\*(lq\e\*(rq character to remove the special meaning of the \*(lg|\*(rq
character synonym.
.lp
To review or edit the keyboard macros, you type ^A-M.  The following
screen will appear:
.br
.CS
.(b L
.TS
box center;
c
l.
Keyboard Macros
.sp
_
.sp
.\"                                                   spaces out to here
  ^A-! ls -alRF \e| more!                             
  ^A-@ 
  ^A-# 
  ^A-$ 
  ^A-% 
  ^A-^
  ^A-&
  ^A-*
  ^A-(
  ^A-)
.sp
  Macro key to revise: _ 
.sp
.T&
c.
Press <ESC> to continue
.TE
.)b
.Cs
.lp
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.
.lp
.ft I
NOTE:\ \ All of the character synonyms described in section 3.5 are
available for use with the keyboard macros.
.ft
.sh 2 "Line settings"
.(x
  \*($n Line settings
.)x
.lp
The line settings menu is invoked by ^A-P.  A typical line settings menu
will look like this:
.br
.CS
.(b L
.TS
box center;
c
l.
Line Settings
_
.sp
       Current Settings:  1200,E,7,1           
.sp
     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      
.sp
   Parity       Data Bits       Stop Bits      
   15) Odd      16) 7 bits      18) 1 bit      
                17) 8 bits      19) 2 bits     
.sp
   20) Save Changes      YOUR CHOICE: _        
.sp
.T&
c.
Press <ESC> to return
.TE
.)b
.Cs
.lp
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 \*(lqSave Changes\*(rq option.
.lp
The current line settings are also displayed in the status line.
.lp
.ft I
NOTE:\ \ During file transfers, certain parameters (namely the data bits
and parity) will be temporarily changed.  The status line will \fBnot\fP
reflect these temporary promotions.
.ft R
.sh 2 "Exit Pcomm"
.(x
  \*($n Exit Pcomm
.)x
.lp
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.
.lp
.ft I
NOTE:\ \ Pcomm drops the DTR (Data Terminal Ready) on the port before
exiting to Unix.
.ft
.sh 2 "Unix gateway"
.(x
  \*($n Unix gateway
.)x
.lp
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
\*(lqexit\*(rq.
.lp
.ft I
NOTE:\ \ The SHELL environmental variable is used to determine which
program to invoke.
.ft
.sh 2 "Command files"
.(x
  \*($n Command files
.)x
.lp
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.
.br
.CS
.(b L
.TS
box center;
l.
   Command Files
.sp
.\"                                                           spaces out to here
   Shell script: _                                            
.sp
.TE
.)b
.Cs
.lp
The use of shell scripts is discussed in section 8.
.bp
.if e \{
.ep
.bp\}
.sh 1 "UTILITY FUNCTIONS"
.(x
 
.)x _
.(x
\*($n UTILITY FUNCTIONS
.)x
.lp
The following commands perform secondary functions.
.sh 2 "Program information"
.(x
  \*($n Program info
.)x
.lp
To display the opening information screen, you type ^A-I.  Press any key
to return to the terminal mode.
.sh 2 "Setup screen"
.(x
  \*($n Setup screen
.)x
.lp
The setup screens are described in detail in section 3 of this manual.
.sh 2 "Change directory"
.(x
  \*($n Change directory
.)x
.lp
To change the current working directory while still inside Pcomm, you
type ^A-B.  A screen similar to the following will appear:
.br
.CS
.(b L
.TS
box center;
l.
   Change Directory
.sp
.\"                                                           spaces out to here
   Current directory: /usr/egray                              
   New directory: _ 
.sp
.TE
.)b
.Cs
.lp
Abbreviations known to the shell are acceptable; for example, the
\*(lq~\*(rq character will be translated to the home directory in the
csh or ksh shell.
.sh 2 "Clear screen"
.(x
  \*($n Clear screen
.)x
.lp
To clear the local screen and home the cursor, you type ^A-C.
.lp
.ft I
NOTE:\ \ The remote system may not \*(lqknow\*(rq the screen has been
cleared, and may make assumptions about the screen that are incorrect.
.ft
.sh 2 "Toggle duplex"
.(x
  \*($n Toggle duplex
.)x
.lp
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.
.sh 2 "Hang up the phone"
.(x
  \*($n Hang up the phone
.)x
.lp
To hang up the phone, you type ^A-H.  The word \*(lqdisconnecting\*(rq
will briefly show in the status line.
.lp
.ft I
NOTE:\ \ Pcomm does not drop the DTR (Data Terminal Ready) during the hang up.
.ft
.sh 2 "Printer logging"
.(x
  \*($n Printer logging
.)x
.lp
The ^A-L command toggles the printer logging on or off.  The current
printer status is displayed in the status line.
.lp
.ft I
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 \fBoff\fP and the complete print job is sent to the spool.
.ft R
.sh 2 "Toggle CR \- CR/LF"
.(x
  \*($n Toggle CR \- CR/LF
.)x
.lp
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).
.sh 2 "Break"
.(x
  \*($n Break
.)x
.lp
The ^A-7 command sends a modem break to the remote system.  The word
\*(lqbreak\*(rq is (very) briefly displayed on the status line.
.lp
.ft I
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 \fBremote\fP system).
.ft R
.bp
.if e \{
.ep
.bp\}
.sh 1 "FILE FUNCTIONS"
.(x
 
.)x _
.(x
\*($n FILE FUNCTIONS
.)x
.lp
One of the most important features of a telecommunication program is the
ability to transfer files.  The following file transfer protocols are
implemented:
.br
.in +0.5i
.(b L
.TS
l l l l.
Protocol	Packet	Error	Multiple
name	size	detection	files?
_
xmodem	128	checksum/CRC	no
xmodem-1k	128/1024	checksum/CRC	no
modem7	128	checksum	yes \u1\d
ymodem	128/1024	CRC	yes \u2\d
ymodem-g	128/1024	none \u3\d	yes
ASCII	none	none	no
zmodem \u4\d	128/1024	CRC	yes
(external)	?	?	?
.TE
.TS
l l.
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
.TE
.)b
.in
.lp
.ft I
NOTE:\ \ The built-in protocols that send file name information, convert
the Unix style file name to fit the MSDOS name restrictions.
.ft
.sh 2 "External protocols"
.(x
  \*($n External protocols
.)x
.lp
The external \*(lqprotocol\*(rq 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.
.lp
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.
.lp
To abort an external file transfer, you hit the <ESC> key.  All other
characters typed at the keyboard are ignored.
.lp
.ft I
NOTE:\ \ The external protocol feature can also be used to pipe
the output of a Unix command to the remote.
.ft
.sh 2 "Send files"
.(x
  \*($n Send files
.)x
.lp
To send a file to the remote, you'll first have to instruct the remote
system to receive the file, then type ^A-\*(lqup arrow\*(rq.  The
following screen will appear:
.br
.in 3.2i
.CS
.(b L
.TS
box;
c
l.
Upload
.sp
 1) xmodem
 2) xmodem-1k
 3) modem7
 4) ymodem
 5) ymodem-g
 6) ASCII
 7) zmodem
 8) kermit
 E) (external)
.sp
 <ESC> to Abort 
.sp
 Protocol: _
.sp
.TE
.)b
.Cs
.in
.lp
You then select the type of protocol at the prompt, and another window
similar to this will appear:
.br
.CS
.(b L
.TS
box center;
l.
   Send xmodem
.sp
.\"                                                           space out to here
   Enter filename: _                                          
.sp
.TE
.)b
.Cs
.lp
Now you type in the file name or names you'd like to send.  Wildcards
known to the shell are acceptable.
.lp
Now the file transfer actually begins.  A screen similar to the
following is displayed during the transfer:
.br
.in 2.4i
.CS
.(b L
.TS
box;
c
n.
Uploading
.sp
.\"                          spaces out to here
 Protocol\&: xmodem