doc.me

通讯程序源码

.sp
           1) Modem name (1 of 5) ... HAYES
           2) Modem init string ..... ATS7=60S11=70E0Q0V1X4&D2!
           3) Dialing command ....... ATDT
           4) Dialing cmd suffix .... !
           5) Hang up string ........ ~~+++~~ATH0!
           6) Auto baud detect ...... Y
           7) 300 baud connect ...... CONNECT!
           8) 1200 baud connect ..... CONNECT 1200
           9) 2400 baud connect ..... CONNECT 2400
          10) 4800 baud connect .....
          11) 9600 baud connect .....
          12) 19200 baud connect ....
          13) 38400 baud connect ....
          14) No connect string 1 ... BUSY
          15) No connect string 2 ... VOICE
          16) No connect string 3 ... NO CARRIER
          17) No connect string 4 ...
-----------------------------------------------------------------
OPTION ==> _                                Press <ESC> to return
.)c
.)b
.Cs
.lp
The fields of the modem setup are:
.ba +0.5i
.lp
1) Modem name.  This is the key word that links the modem database with
the TTY database.  A menu prompt is used to select the modem name (and
the remaining parameters that go with it).  The \*(lq(1 of 5)\*(rq field
indicates there are additional modems in the database.
.lp
2) Modem initialization string.  This is sent to the modem whenever the
port is selected.  Consult your modem manual for the codes to be used.
Notice the use of the \*(lq!\*(rq character.  This is the \*(lqcharacter
synonym\*(rq for the carriage return.
.lp
.ft I
NOTE:\ \ See section 3.5 for the complete list of character synonyms.  To
remove the special meaning of a character synonym, you must prepend a
\*(lq\e\*(rq to the character.
.ft
.lp
3) Dialing command.  The first part of the command to make the modem
dial.  It is assumed that the phone number will immediately follow.
.lp
4) Dialing command suffix.  The last part of the command to make the
modem dial.  Typically this will be the carriage return \*(lqcharacter
synonym\*(rq.
.lp
5) Hang up string.  The command to make the modem hang up the phone.
The character synonym for a 1 second pause is the tilde \*(lq~\*(rq
character.
.lp
6) Auto baud detect.  Should Pcomm attempt to change the baud rate of
the TTY to the baud rate matching the connect string?  This feature
requires the connect strings to be unique.  This does not override the
locked speed feature (discussed in section 3.2).
.lp
7\-13) Connect strings.  The return messages when the modem has connected
to the remote.  If different messages are returned for each baud rate at
which the modem answers, then they should be specified.
.lp
.ft I
NOTE:\ \ Pcomm uses the connect strings to determine which baud rates the
modem is capable of supporting.  For example, if the 4800 baud connect
string is empty, Pcomm assumes the modem can not support 4800 baud.
.sp
NOTE:\ \ If two connect strings are very similar, (for example,
\*(lqCONNECT\*(rq is entirely contained in \*(lqCONNECT 1200\*(rq), it
is possible that the return code from the modem will match the incorrect
string.  To prevent this from happening, use the command synonym for the
carriage return to terminate the shorter string (for example, use
\*(lqCONNECT!\*(rq instead of \*(lqCONNECT\*(rq).
.ft
.lp
14\-17) No connect strings.  The messages returned by the modem when no
connection is made.
.ba
.sh 2 "Terminal setup"
.(x
  \*($n Terminal setup
.)x
.lp
The terminal setup allows you to define the hot key and the mapping of
the end-of-line characters.  A typical terminal setup menu will look
like this:
.br
.CS
.(b L
.(c
---------------------- Terminal Setup ---------------------------
.sp
              1) Hot key (decimal) ...... 1
              2) ASCII version of hot ... ^A
.sp
              3) Duplex ................. FULL
              4) Flow control ........... XON/XOFF
              5) CR translation (in) .... CR
              6) CR translation (out) ... CR
.sp
-----------------------------------------------------------------
OPTION ==> _                                Press <ESC> to return
.)c
.)b
.Cs
.lp
The fields in the terminal setup are:
.ba +0.5i
.lp
1) Hot key.  This is the decimal code for the user definable hot key.
Consult an ASCII/decimal conversion chart for the decimal values of
other characters.
.lp
2) ASCII version of hot key.  This is the printable version of the hot
key used by Pcomm in the help screen and status line.
.lp
3) Duplex.  A menu prompt is shown to select between FULL duplex and
HALF duplex.  In the half duplex mode, characters sent to the remote
system are also sent to the screen.  (The duplex mode can also be
changed \*(lqon the fly\*(rq by the ^A-E command.)
.lp
4) Flow control.  A menu prompt is shown to select between XON/XOFF flow
control and NONE.  A value of NONE assumes that the hardware (not Pcomm)
will perform the flow control.
.lp
.ft I
NOTE:\ \ If your terminal gets \*(lqstuck\*(rq due to a flow control
problem, any ^A (hot key) sequence will resume the flow.
.ft
.lp
5\-6) CR translations.  The end-of-line characters for both incoming and
outgoing carriage returns can be altered to suit the remote system's
needs.  A menu prompt provides the following choices:
.sp
.in +0.5i
.nf
\(bu CR (no translation)
\(bu CR/LF translate CR to CR/LF
.fi
.in
.lp
The incoming CR translation can also be changed \*(lqon the fly\*(rq
with the ^A-3 command.
.ba
.sh 2 "General setup"
.(x
  \*($n General setup
.)x
.lp
The general setup allows you to define the character synonyms and the
default files used by the screen dump and other features.  A typical
general setup screen might look like this:
.br
.CS
.(b L
.(c
------------------------- General Setup -------------------------
.sp
              1) Default log file ....... pcomm.log
              2) Screen dump file ....... pcomm.dump
.sp
              3) Strip high bit  ........ YES
.sp
              4) Pause character ........ ~
              5) CR character ........... !
              6) CTRL character ......... ^
              7) ESC character .......... |
              8) Break character ........ %
.sp
              9) Aborted downloads ...... KEEP
.sp
             10) Connect delay (sec) .... 35
             11) Redial delay (sec) ..... 5
.sp
-----------------------------------------------------------------
OPTION ==> _                                Press <ESC> to return
.)c
.)b
.Cs
.lp
The general setup fields are:
.ba +0.5i
.lp
1) Default log file.  The file name to be used as the default when the
data logging is activated (^A-1).  The log file name can be changed
\*(lqon the fly\*(rq by the ^A-1 command.
.lp
2) Screen dump file.  The file name to be used for the screen dump
command (^A-G).
.lp
3) Strip high bit.  Should Pcomm strip the eighth bit on incoming and
outgoing characters?  A menu prompt allows you to select YES or NO.
This feature is not used during file transfers.
.lp
4\-8) Character synonyms.  These are symbols that Pcomm uses to represent
special characters (or perform special functions) when sending commands
to the modem.  Synonyms are useful for entering and displaying special
characters in a human readable form.  The synonyms are:
.sp
.in +0.5i
.nf
\(bu Pause for 1 second
\(bu The carriage return character (control-M)
\(bu Convert the next character to control-xx
\(bu The escape character (control-[)
\(bu Send a modem break
.fi
.in
.lp
.ft I
NOTE:\ \ To prevent the special meaning of one of these characters prepend
a \*(lq\e\*(rq to it.
.ft
.lp
9) Aborted downloads.  When a download aborts (fails), should the
partially completed file be kept?  The menu prompt allows \*(lqKEEP\*(rq
or \*(lqDELETE\*(rq.
.lp
10) Connect delay.  The number of seconds Pcomm will wait for the modem
to return a status code.
.lp
11) Redial delay.  The number of seconds to wait before Pcomm tries to
call the number again.
.ba
.sh 2 "ASCII transfer setup"
.(x
  \*($n ASCII xfer setup
.)x
.lp
This setup screen allows you to select options to be used for ASCII
uploads and downloads.  A typical ASCII transfer setup will look like
this:
.br
.CS
.(b L
.(c
---------------------- ASCII Transfer Setup ---------------------
.sp
                          ASCII UPLOAD
.sp
                1) Echo locally ........... NO
                2) Expand blank lines ..... NO
                3) CR delay (ms) .......... 0
                4) Pace the output ........ NO
                5) CR translation ......... NONE
                6) LF translation ......... ADD CR
.sp
                         ASCII DOWNLOAD
.sp
                7) Transfer timeout (sec) . 5
                8) CR translation ......... STRIP
                9) LF translation ......... NONE
.sp
-----------------------------------------------------------------
OPTION ==> _                                Press <ESC> to return
.)c
.)b
.Cs
.lp
The fields are:
.ba +0.5i
.lp
1) Echo locally.  This is similar to the duplex option in that it copies
outgoing characters to the screen.  The options are YES and NO.
.lp
2) Expand blank lines.  Should a blank line (LF alone) be expanded to a
space and LF?  Some BBS systems use a blank line to signal the end of an
ASCII upload.  The options are YES and NO.
.lp
3) CR delay.  The delay in milliseconds to be used when sending a CR.
The menu prompt limits the choice to 0, 100, or 150.
.lp
4) Pace output.  Should each character sent be delayed?  Very old BBS
systems may require this.  The choice is YES or NO.
.lp
5) CR translation.  The menu prompt provides the following choices for
upload translations:
.br
.in +0.5i
.(b L
\(bu NONE (no translation)
\(bu ADD LF translate CR to CR/LF
\(bu STRIP remove the CR character
.)b
.in
.lp
6) LF translation. Same as above except the choices are:
.br
.in +0.5i
.(b L
\(bu NONE (no translation)
\(bu ADD CR translate LF to CR/LF
\(bu STRIP remove the LF character
.)b
.in
.lp
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.
.lp
8\-9) Same as 5) and 6) above, except the translations apply to ASCII
downloading.
.ba
.sh 2 "External protocol setup"
.(x
  \*($n External protocol
.)x
.lp
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.
.br
.CS
.(b L
.(c
-------------------- External Protocol Setup --------------------
.sp
                            UPLOAD
.sp
        Name     Command Line             Requires file list?
     1) zmodem   sz                               Y
     2) kermit   kermit -ivs                      Y
     3)                                           N
.sp
                           DOWNLOAD
.sp
        Name     Command Line             Requires file list?
     4) zmodem   rz                               N
     5) kermit   kermit -ivr                      Y
     6)                                           N
.sp
-----------------------------------------------------------------
OPTION ==> _                                Press <ESC> to return
.)c
.)b
.Cs
.lp
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
\*(lqRequires file list?\*(rq flag.  To remove an entry, enter a single
space character at the Name prompt.
.lp
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.
.lp
.ft I
NOTE:\ \ Pcomm adds a single space character and the file names (if any)
to the end of the command.
.sp
NOTE:\ \ The program itself isn't \*(lqembedded\*(rq into Pcomm (it still
gets called like any other external program), only the name and
invocation information is actually incorporated into Pcomm.
.ft
.bp
.if e \{
.ep
.bp\}
.sh 1 "MAJOR FUNCTIONS"
.(x
 
.)x _
.(x
\*($n MAJOR FUNCTIONS
.)x
.lp
When Pcomm is invoked without the \*(lq\-f\*(rq or \*(lq\-a\*(rq 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.
.sh 2 "Dialing directory"
.(x
  \*($n Dialing directory
.)x
.lp
To dial another system, you type ^A-D to access the dialing directory
menu, then enter the entry number at the prompt.
.lp
The entry number could be preceded by a special long distance dialing
code such as \*(lq#5\*(rq in lieu of \*(lq5\*(rq alone.  Long distance
codes could contain access numbers such as those that MCI and Sprint
require.
.lp
A typical dialing directory will look like this:
.br
.if n .po 0				\" table may be more than 6.5in wide
.if n .ll 8.5i
.CS
.(b L
.TS
box center;
c s s s s
c c r c l
l r r c l.
.sp
D I A L I N G       D I R E C T O R Y
.sp
_
.sp
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	
.sp
.T&
l s s s s.
.nf
   ==> _      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
.sp
   LD Codes Active: @ #
.fi
.sp
.TE
.)b
.Cs
.if n .po 1.0i
.if n .ll 6.5i
.lp
The fields of the dialing directory are:
.ba +0.5i
.lp
Name) The name of the remote system.
.lp
Number) The telephone number to the remote system.
.lp
.ft I
NOTE:\ \ The \*(lq(\*(rq, \*(lq)\*(rq, \*(lq-\*(rq, 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 \*(lq\e\*(rq to it.
.ft
.lp
Line settings) The communications settings to be used when dialing
that entry.  The range of values are:
.br
.in +0.5i
.(b L
.TS
r c c c
r l c c.
Baud	Parity	Data bits	Stop bits
_
300	N - none	7	1
1200	E - even	8	2
2400	O - odd
4800			
9600			
19200			
38400			
.TE
.)b
.in
.lp
Duplex) The duplex mode.  Either \*(lqF\*(rq for full or
\*(lqH\*(rq for half.
.lp
Auxiliary) This field contains the name of a file which has one of three
uses:
.lp
.in +0.5i
1) A shell script to be used during the auto-login \*(lqchat\*(rq
sequence.
.br
2) A particular TTY to be used for hard-wired ports.
.br
3) A customized modem configuration to be used for the entry.
.in
.lp
.ft I
NOTE:\ \ On all hard-wired ports, the script field is used to contain the
name of the port.  For example, if tty12 is a hard-wired port to
\*(lqSystem A\*(rq, then the dialing directory entry for \*(lqSystem
A\*(rq will have \*(lqtty12\*(rq in the script field.
.ft
.lp
.ft I
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.
.ft
.ba
.lp
The commands at the dialing directory prompt are:
.ba +0.5i
.lp