Thread View: de.comp.sources.unix
1 messages
1 total messages
Started by Frank Kaefer
Wed, 22 Jul 1992 05:04
v01i008: Pcomm 2.0 - telecommunication program for Unix, Part08/08
Author: Frank Kaefer
Date: Wed, 22 Jul 1992 05:04
Date: Wed, 22 Jul 1992 05:04
2351 lines
86278 bytes
86278 bytes
Submitted-by: egray@osiris.cso.uiuc.edu (Emmet P. Gray)
Posting-number: Volume 1, Issue 8
Archive-name: pcomm/part08
#! /bin/sh
# This is a shell archive. Remove anything before this line, then unpack
# it by saving it into a file and typing "sh file". To overwrite existing
# files, type "sh file -c". You can also feed this as standard input via
# unshar, or by typing "sh <file", e.g.. If this archive is complete, you
# will see the following message at the end:
# "End of archive 8 (of 8)."
# Contents: pcomm-2.0/Doc.out
# Wrapped by fkk@stasys on Tue Jul 21 22:06:01 1992
PATH=/bin:/usr/bin:/usr/ucb ; export PATH
if test -f 'pcomm-2.0/Doc.out' -a "${1}" != "-c" ; then
echo shar: Will not clobber existing file \"'pcomm-2.0/Doc.out'\"
else
echo shar: Extracting \"'pcomm-2.0/Doc.out'\" \(79590 characters\)
sed "s/^X//" >'pcomm-2.0/Doc.out' <<'END_OF_FILE'
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X PPPPPP CCCC OOOO MM MM MM MM
X P P C O O M M M M M M M M
X PPPPPP C O O M M M M M M
X P C O O M M M M
X P CCCC OOOO M M M M
X
X
X
X
X
X
X
X
X Pcomm Reference Manual
X
X version 2.0
X
X
X
X written by
X
X Emmet P. Gray
X ...!uunet!uiucuxc!fthood!egray
X fthood!egray@uxc.cso.uiuc.edu
X
X
X
X
X
X
X Pcomm is a public domain telecommunication program for Unix that
X is designed to operate similarly to the MSDOS program, ProComm.
X ProComm (TM) is copyrighted by Datastorm Technologies, Inc. This
X is a completely new program and contains no ProComm source code.
X This is not a Datastorm product.
X
X
X
X
X
X Table of Contents
X
X
X
X
X 1 INTRODUCTION ...............1 6 FILE FUNCTIONS .............25
X 1.1 Abbreviations ..........1 6.1 External protocols .....25
X 1.2 Requirements ...........1 6.2 Send files .............25
X 1.3 Support files ..........2 6.3 Receive files ..........27
X 6.4 Pass thru mode .........27
X 2 RUNNING PCOMM ..............3 6.5 Directory ..............28
X 2.1 Hot key ................3 6.6 Screen dump ............29
X 2.2 Status line ............4 6.7 Start data logging .....29
X 2.3 Help screen ............4 6.8 Toggle logging .........29
X 2.4 Exit Pcomm .............5
X 7 DIALING WINDOW .............31
X 3 SETUP SCREENS ..............7
X 3.1 Prompting ..............7 8 SCRIPT COMMANDS ............33
X 3.2 TTY setup ..............7 8.1 Pcomm_cmd command ......33
X 3.3 Modem setup ............9 8.2 Waitfor command ........36
X 3.4 Terminal setup .........10 8.3 Matches command.........37
X 3.5 General setup ..........12 8.4 Examples ...............38
X 3.6 ASCII xfer setup .......13
X 3.7 External protocol ......14 Appendix A - Typical Modem
X Configuration ...........41
X 4 MAJOR FUNCTIONS ............17
X 4.1 Dialing directory ......17 Appendix B - AT&T Unix PC
X 4.2 Redial .................19 7300/3b1 Dial Codes .....43
X 4.3 Keyboard macros ........20
X 4.4 Line settings ..........21 Appendix C - Using High Speed
X 4.5 Exit Pcomm .............22 Modems ..................45
X 4.6 Unix gateway ...........22
X 4.7 Command files ..........22
X
X 5 UTILITY FUNCTIONS ..........23
X 5.1 Program info ...........23
X 5.2 Setup screen ...........23
X 5.3 Change directory .......23
X 5.4 Clear screen ...........23
X 5.5 Toggle duplex ..........23
X 5.6 Hang up the phone ......24
X 5.7 Printer logging ........24
X 5.8 Toggle CR - CR/LF ......24
X 5.9 Break ..................24
X
X
X
X
X
X Pcomm Reference Manual Page 1
X
X
X 1. INTRODUCTION
X
X Pcomm is a public domain, menu driven, telecommunication program
X designed to provide the same "ease of use" as similar programs
X available in MSDOS. Some of its features are:
X
X o Large dialing directory
X o Full scripting feature
X o Automatic redial feature
X o Six built-in file transfer protocols
X o External file transfer program support
X o Data logging (log of the terminal session)
X o Printer logging
X o Screen dump to a file
X o Shell escapes to Unix
X o Help screen
X o Keyboard macros
X o User customization
X o Optional modem configuration per dialing directory entry
X o Administrative logging of phone calls
X o Administrative limits on long distance access
X
X Pcomm does not emulate any particular terminal. Whatever
X terminal you're on, is what the remote system "sees".
X
X
X 1.1. Abbreviations
X
X Pcomm uses the notation "^A-X" to mean control-A followed by the
X letter X. The dash (-) in the notation is just for clarity; it is
X not included in the actual command sequence. Also, there is no
X distinction between upper and lower case letters.
X
X The following abbreviations appear in Pcomm:
X
X <CR> carriage return key (sometimes labeled Enter)
X <ESC> escape key
X <SPACE> space bar
X <DEL> del key
X <up> up arrow key
X <down> down arrow key
X LF line feed character (control-J)
X CR carriage return character (control-M)
X
X
X 1.2. Requirements
X
X Pcomm will not run on terminals with a screen size of less than
X 80 columns by 24 lines or on terminals that lack cursor movement
X capabilities. For terminals without arrow keys, use the letter
X "U" in place of "up arrow" and the letter "N" in place of "down
X arrow" (the letter "D" would have been a more obvious choice,
X
X
X
X
X
X Page 2 Pcomm Reference Manual
X
X
X but, unfortunately, it is used elsewhere).
X
X
X 1.3. Support files
X
X Pcomm uses four support files, namely:
X
X pcomm.dial_dir the dialing directory
X pcomm.extrnl the external file transfer programs
X pcomm.modem the modem/TTY database
X pcomm.param the start-up default parameters
X
X There is a default directory (typically "/usr/local/lib/pcomm")
X where the "standard" support files live. Since the average user
X won't have write permission on these files, it's assumed that
X they will copy one or more of these standard files to their own
X directories and edit them to suit their needs.
X
X Pcomm can use the environmental variable "PCOMM" to search for
X these "private" support files. If used, the variable must
X contain the path to the directory containing the files. You can
X "mix and match" the use of standard and private support files.
X For example, the pcomm.modem file is rarely changed by the user
X so there would be no need to copy that file to the private
X directory.
X
X Pcomm also uses normal Unix shell scripts to perform the "chat"
X sequences necessary to automatically log a user onto a system.
X
X The following directories are searched to find the support files
X and the shell scripts:
X
X 1) directory given with the "-d" option
X 2) directory in the PCOMM environmental variable
X 3) the current working directory
X 4) the default directory (compiled into Pcomm)
X
X
X
X
X
X Pcomm Reference Manual Page 3
X
X
X 2. RUNNING PCOMM
X
X Pcomm has the following command line syntax.
X
X pcomm [-d directory] [-f system name] [-a auxiliary file]
X [-e|o|n] [-w word length] [-b baud rate] [-p phone number]
X
X The "-d" option allows you to specify an additional path to be
X used when searching for the Pcomm support files. This option is
X often useful for "borrowing" someone else's dialing directory.
X
X The "-f" option is used to specify automatic dialing of an entry
X in the dialing directory. The name field in the dialing
X directory (described later) is checked against the string given
X on the command line. If a match is found, that entry is
X automatically dialed. The match does not consider upper and
X lower case differences.
X
X The "-a" option is used to specify a script file to be "played"
X prior to dialing, to specify TTY to be used, or to specify the
X modem to be used. This feature can be used to customize Pcomm
X options or perform unattended operations.
X
X The remaining options are used to set the parity, data bits, baud
X rate, and telephone number from the command line.
X
X -e Set the parity to even
X -o Set the parity to odd
X -n Set the parity to none
X -b Set the baud rate
X -p Dial this number
X
X
X 2.1. Hot key
X
X Pcomm uses a "hot key" to precede each command. (The value of
X the hot key is a user tunable parameter, but for the purpose of
X this document we'll assume the hot key is defined as control-A).
X
X The hot key is used to put Pcomm in the command mode. For
X example, to get the help screen, you type control-A (to get to
X the command mode) then the number 0 (to display the help screen).
X When a command is completed, Pcomm returns to the terminal mode.
X
X NOTE: While in the command mode, the communication with the
X remote system is temporarily suspended.
X
X
X
X
X
X Page 4 Pcomm Reference Manual
X
X
X 2.2. Status line
X
X Whenever Pcomm is in the command mode (or is not currently
X connected to a remote) a status line is displayed at the bottom
X of the screen. A typical status line might look like this:
X
X +-----------+---------+------+-----------+----------+----------+------+------+
X | ^A-0 HELP | No TTY | FDX | 1200 E71 | LOG OFF | PTR OFF | CR | CR |
X +-----------+---------+------+-----------+----------+----------+------+------+
X
X The eight fields of the status line are:
X
X o help screen command (or a temporary message)
X o name of the TTY device in use
X o duplex mode (FDX = full duplex, HDX = half duplex)
X o current connection settings (not necessarily DTE speed)
X o status of data logging option
X o status of printer logging option
X o incoming CR translation
X o outgoing CR translation
X
X NOTE: If the DTE interface speed is locked, the status line will
X show the "connected" speed rather than the speed of the serial
X port.
X
X 2.3. Help screen
X
X The help screen gives a brief review of all the available
X commands. To access the help screen type ^A and "0" (zero). The
X typical help screen will look like this:
X
X +------------------------------------------------------------------------------+
X | P C O M M H E L P |
X +------------------------------------------------------------------------------+
X | |
X | Major Functions Utility Functions File Functions |
X | |
X | Dialing Directory. ^A-D Program Info .... ^A-I Send Files .... ^A-<up> |
X | Auto Redial ...... ^A-R Setup Screen .... ^A-S Receive Files . ^A-<down> |
X | Keyboard Macros .. ^A-M Change Directory. ^A-B Pass Thru Mode. ^A-T |
X | Line Settings .... ^A-P Clear Screen .... ^A-C Directory ..... ^A-F |
X | Exit Pcomm ....... ^A-X Toggle Duplex ... ^A-E Screen Dump ... ^A-G |
X | Unix Gateway ..... ^A-4 Hang Up Phone ... ^A-H Start Data Log. ^A-1 |
X | Command Files .... ^A-5 Printer On/Off .. ^A-L Toggle Log .... ^A-2 |
X | Toggle CR-CR/LF . ^A-3 |
X | Break Key ....... ^A-7 |
X | |
X +------------------------- Press any key to contiue ---------------------------+
X
X
X
X
X
X Pcomm Reference Manual Page 5
X
X
X 2.4. Exit Pcomm
X
X To exit Pcomm, you type ^A and "x" to access the exit window.
X
X +-- Exit -----------------------+
X | |
X | Exit to Unix? (y/n): _ |
X | |
X +-------------------------------+
X
X To exit, you press the letter "y" (carriage return not required).
X
X
X
X
X
X Page 6 Pcomm Reference Manual
X
X
X
X
X
X Pcomm Reference Manual Page 7
X
X
X 3. SETUP SCREENS
X
X Pcomm allows you to change many of the default parameters. The
X setup screen is accessed by typing ^A and "s". The following
X screen shows the sub-menu choices:
X
X ------------------------- Setup Menu ----------------------------
X
X 1) TTY Setup
X 2) Modem Setup
X 3) Terminal Setup
X 4) General Setup
X 5) ASCII Transfer Setup
X 6) External Protocol Setup
X S) Save setup to disk
X
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to exit
X
X To select one of the sub-menu choices, you type the number (or
X letter) at the "OPTION ==>" prompt. To exit from a sub-menu and
X return to this setup menu screen, you press the escape key.
X
X Changes made affect the current Pcomm session only. To make the
X changes become the default, you select the "s" option.
X
X
X 3.1. Prompting
X
X There are several different types of prompts used in the setup
X screens. The prompts use the bottom two lines on the display for
X user input and to give more information on what is being asked.
X Pcomm will beep at any illegal input. The escape key <ESC> will
X abort any prompt. The prompt types are:
X
X o Character prompt. Asks you to input a single character.
X o String prompt. Asks you to input a word or group of
X characters.
X o Numeric prompt. Asks you for a number.
X o Menu prompt. Shows a selection and allows you to choose
X the current selection by pressing the carriage return or
X change the selection by pressing the space bar.
X
X
X 3.2. TTY setup
X
X The TTY setup allows you to assign the serial ports that Pcomm is
X allowed to use, and what is attached to each port. A typical TTY
X setup screen might look like this:
X
X
X
X
X
X Page 8 Pcomm Reference Manual
X
X
X -------------------------- TTY Setup ----------------------------
X
X TTY name Modem name Locked speed
X
X 1) tty10 HAYES 0
X 2) tty11 HAYES 0
X 3) tty12 DIRECT 0
X 4) tty13 TELEBIT 38400
X 5) tty13 TELEBIT_V.32 38400
X 6) tty13 TELEBIT_PEP 38400
X 7) 0
X 8) 0
X 9) 0
X 10) 0
X
X A) Add a TTY entry
X D) Delete a TTY entry
X
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X You may edit an entry by typing the entry number at the prompt.
X To add an entry, you type "A" at the prompt, etc.
X
X The TTY setup fields are:
X
X 1) TTY name. This is the name of the serial port that Pcomm
X will be allowed to use. Notice that the path component of
X the name, "/dev/" is not used.
X
X 2) Modem name. This a key word that is used later to link
X the modem database with the TTY database. The name could be
X any combination of letters or numbers (both upper and lower
X case).
X
X NOTE: All hard-wired ports (ports without modems attached)
X must use the word "DIRECT" for the modem name.
X
X 3) Locked speed. Normally Pcomm will use the baud rate in
X the dialing directory when talking to the modem. If the
X locked speed is non-zero, then the baud rate specified is
X the only one that will ever be used. The baud rate is
X selected from a "menu prompt". See Appendix C for more
X information about the use of this feature.
X
X NOTE: It is often best to put the fastest modem/TTYs at the
X end of the TTY database.
X
X
X
X
X
X Pcomm Reference Manual Page 9
X
X
X 3.3. Modem setup
X
X The modem setup contains the commands to make the modem dial,
X hang up the phone, etc. A typical modem setup screen might look
X like this:
X
X -------------------------- Modem Setup --------------------------
X
X 1) Modem name (1 of 5) ... HAYES
X 2) Modem init string ..... ATS7=60S11=70E0Q0V1X4&D2!
X 3) Dialing command ....... ATDT
X 4) Dialing cmd suffix .... !
X 5) Hang up string ........ ~~+++~~ATH0!
X 6) Auto baud detect ...... Y
X 7) 300 baud connect ...... CONNECT!
X 8) 1200 baud connect ..... CONNECT 1200
X 9) 2400 baud connect ..... CONNECT 2400
X 10) 4800 baud connect .....
X 11) 9600 baud connect .....
X 12) 19200 baud connect ....
X 13) 38400 baud connect ....
X 14) No connect string 1 ... BUSY
X 15) No connect string 2 ... VOICE
X 16) No connect string 3 ... NO CARRIER
X 17) No connect string 4 ...
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X The fields of the modem setup are:
X
X 1) Modem name. This is the key word that links the modem
X database with the TTY database. A menu prompt is used to
X select the modem name (and the remaining parameters that go
X with it). The "(1 of 5)" field indicates there are
X additional modems in the database.
X
X 2) Modem initialization string. This is sent to the modem
X whenever the port is selected. Consult your modem manual
X for the codes to be used. Notice the use of the "!"
X character. This is the "character synonym" for the carriage
X return.
X
X NOTE: See section 3.5 for the complete list of character
X synonyms. To remove the special meaning of a character
X synonym, you must prepend a "\" to the character.
X
X 3) Dialing command. The first part of the command to make
X the modem dial. It is assumed that the phone number will
X immediately follow.
X
X
X
X
X
X Page 10 Pcomm Reference Manual
X
X
X 4) Dialing command suffix. The last part of the command to
X make the modem dial. Typically this will be the carriage
X return "character synonym".
X
X 5) Hang up string. The command to make the modem hang up
X the phone. The character synonym for a 1 second pause is
X the tilde "~" character.
X
X 6) Auto baud detect. Should Pcomm attempt to change the
X baud rate of the TTY to the baud rate matching the connect
X string? This feature requires the connect strings to be
X unique. This does not override the locked speed feature
X (discussed in paragraph 3.2).
X
X 7-13) Connect strings. The return messages when the modem
X has connected to the remote. If different messages are
X returned for each baud rate at which the modem answers, then
X they should be specified.
X
X NOTE: Pcomm uses the connect strings to determine which
X baud rates the modem is capable of supporting. For example,
X if the 4800 baud connect string is empty, Pcomm assumes the
X modem can not support 4800 baud.
X
X NOTE: If two connect strings are very similar, (for
X example, "CONNECT" is entirely contained in "CONNECT 1200"),
X it is possible that the return code from the modem will
X match the incorrect string. To prevent this from happening,
X use the command synonym for the carriage return to terminate
X the shorter string (for example, use "CONNECT!" instead of
X "CONNECT").
X
X 14-17) No connect strings. The messages returned by the
X modem when no connection is made.
X
X
X 3.4. Terminal setup
X
X The terminal setup allows you to define the hot key and the
X mapping of the end-of-line characters. A typical terminal setup
X menu will look like this:
X
X
X
X
X
X Pcomm Reference Manual Page 11
X
X
X ---------------------- Terminal Setup ---------------------------
X
X 1) Hot key (decimal) ...... 1
X 2) ASCII version of hot ... ^A
X
X 3) Duplex ................. FULL
X 4) Flow control ........... XON/XOFF
X 5) CR translation (in) .... CR
X 6) CR translation (out) ... CR
X
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X The fields in the terminal setup are:
X
X 1) Hot key. This is the decimal code for the user definable
X hot key. Consult an ASCII/decimal conversion chart for the
X decimal values of other characters.
X
X 2) ASCII version of hot key. This is the printable version
X of the hot key used by Pcomm in the help screen and status
X line.
X
X 3) Duplex. A menu prompt is shown to select between FULL
X duplex and HALF duplex. In the half duplex mode, characters
X sent to the remote system are also sent to the screen. (The
X duplex mode can also be changed "on the fly" by the ^A-E
X command.)
X
X 4) Flow control. A menu prompt is shown to select between
X XON/XOFF flow control and NONE. A value of NONE assumes
X that the hardware (not Pcomm) will perform the flow control.
X
X NOTE: If your terminal gets "stuck" due to a flow control
X problem, any ^A (hot key) sequence will resume the flow.
X
X 5-6) CR translations. The end-of-line characters for both
X incoming and outgoing carriage returns can be altered to
X suit the remote system's needs. A menu prompt provides the
X following choices:
X
X o CR (no translation)
X o CR/LF translate CR to CR/LF
X
X The incoming CR translation can also be changed "on the fly"
X with the ^A-3 command.
X
X
X
X
X
X Page 12 Pcomm Reference Manual
X
X
X 3.5. General setup
X
X The general setup allows you to define the character synonyms and
X the default files used by the screen dump and other features. A
X typical general setup screen might look like this:
X
X ------------------------- General Setup -------------------------
X
X 1) Default log file ....... pcomm.log
X 2) Screen dump file ....... pcomm.dump
X
X 3) Strip high bit ........ YES
X
X 4) Pause character ........ ~
X 5) CR character ........... !
X 6) CTRL character ......... ^
X 7) ESC character .......... |
X 8) Break character ........ %
X
X 9) Aborted downloads ...... KEEP
X
X 10) Connect delay (sec) .... 35
X 11) Redial delay (sec) ..... 5
X
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X The general setup fields are:
X
X 1) Default log file. The file name to be used as the
X default when the data logging is activated (^A-1). The log
X file name can be changed "on the fly" by the ^A-1 command.
X
X 2) Screen dump file. The file name to be used for the
X screen dump command (^A-G).
X
X 3) Strip high bit. Should Pcomm strip the eighth bit on
X incoming and outgoing characters? A menu prompt allows you
X to select YES or NO. This feature is not used during file
X transfers.
X
X 4-8) Character synonyms. These are symbols that Pcomm uses
X to represent special characters (or perform special
X functions) when sending commands to the modem. Synonyms are
X useful for entering and displaying special characters in a
X human readable form. The synonyms are:
X
X o Pause for 1 second
X o The carriage return character (control-M)
X o Convert the next character to control-xx
X o The escape character (control-[)
X o Send a modem break
X
X
X
X
X
X Pcomm Reference Manual Page 13
X
X
X NOTE: To prevent the special meaning of one of these
X characters prepend a "\" to it.
X
X 9) Aborted downloads. When a download aborts (fails),
X should the partially completed file be kept? The menu
X prompt allows "KEEP" or "DELETE".
X
X 10) Connect delay. The number of seconds Pcomm will wait
X for the modem to return a status code.
X
X 11) Redial delay. The number of seconds to wait before
X Pcomm tries to call the number again.
X
X
X 3.6. ASCII transfer setup
X
X This setup screen allows you to select options to be used for
X ASCII uploads and downloads. A typical ASCII transfer setup will
X look like this:
X
X ---------------------- ASCII Transfer Setup ---------------------
X
X ASCII UPLOAD
X
X 1) Echo locally ........... NO
X 2) Expand blank lines ..... NO
X 3) CR delay (ms) .......... 0
X 4) Pace the output ........ NO
X 5) CR translation ......... NONE
X 6) LF translation ......... ADD CR
X
X ASCII DOWNLOAD
X
X 7) Transfer timeout (sec) . 5
X 8) CR translation ......... STRIP
X 9) LF translation ......... NONE
X
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X The fields are:
X
X 1) Echo locally. This is similar to the duplex option in
X that it copies outgoing characters to the screen. The
X options are YES and NO.
X
X 2) Expand blank lines. Should a blank line (LF alone) be
X expanded to a space and LF? Some BBS systems use a blank
X line to signal the end of an ASCII upload. The options are
X YES and NO.
X
X
X
X
X
X Page 14 Pcomm Reference Manual
X
X
X 3) CR delay. The delay in milliseconds to be used when
X sending a CR. The menu prompt limits the choice to 0, 100,
X or 150.
X
X 4) Pace output. Should each character sent be delayed?
X Very old BBS systems may require this. The choice is YES or
X NO.
X
X 5) CR translation. The menu prompt provides the following
X choices for upload translations:
X
X o NONE (no translation)
X o ADD LF translate CR to CR/LF
X o STRIP remove the CR character
X
X 6) LF translation. Same as above except the choices are:
X
X o NONE (no translation)
X o ADD CR translate LF to CR/LF
X o STRIP remove the LF character
X
X 7) Transfer timeout. The number of seconds to be used to
X determine the end of an ASCII download. You can halt the
X transfer before the timer goes off by hitting the <ESC> key.
X
X 8-9) Same as 5) and 6) above, except the translations apply
X to ASCII downloading.
X
X
X 3.7. External protocol setup
X
X This setup screen allows you to embed the name of external file
X transfer programs into the list of available protocols. When
X transferring files, the external program name will appear on the
X list of options along with the built-in protocols.
X
X
X
X
X
X Pcomm Reference Manual Page 15
X
X
X -------------------- External Protocol Setup --------------------
X
X UPLOAD
X
X Name Command Line Requires file list?
X 1) zmodem sz Y
X 2) kermit kermit -ivs Y
X 3) N
X
X DOWNLOAD
X
X Name Command Line Requires file list?
X 4) zmodem rz N
X 5) kermit kermit -ivr Y
X 6) N
X
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X To change a line (or add a new one), enter the line number at the
X prompt. You will be prompted for the Name, the Command Line, and
X the "Requires file list?" flag. To remove an entry, enter a
X single space character at the Name prompt.
X
X The Command Line is the Unix command that you would normally type
X in to invoke the program (minus the names of the files to be
X transferred). The last field in the setup is used to indicate
X whether or not Pcomm should prompt for a list of file names to be
X added to the command.
X
X NOTE: Pcomm adds a single space character and the file names (if
X any) to the end of the command.
X
X NOTE: The program itself isn't "embedded" into Pcomm (it still
X gets called like any other external program), only the name and
X invocation information is actually incorporated into Pcomm.
X
X
X
X
X
X Page 16 Pcomm Reference Manual
X
X
X
X
X
X
X Pcomm Reference Manual Page 17
X
X
X 4. MAJOR FUNCTIONS
X
X When Pcomm is invoked without the "-f" or "-a" command line
X option, you're placed in the terminal mode with a blank screen
X and a status line. However, since Pcomm hasn't yet selected a
X serial port to use, characters typed at the blank screen are
X ignored. Normally the first command you'll use is ^A-D to bring
X up the dialing directory menu.
X
X
X 4.1. Dialing directory
X
X To dial another system, you type ^A-D to access the dialing
X directory menu, then enter the entry number at the prompt.
X
X The entry number could be preceded by a special long distance
X dialing code such as "#5" in lieu of "5" alone. Long distance
X codes could contain access numbers such as those that MCI and
X Sprint require.
X
X A typical dialing directory will look like this:
X
X +---------------------------------------------------------------------------+
X | D I A L I N G D I R E C T O R Y |
X +---------------------------------------------------------------------------+
X | Name Number Baud P D S Dpx Auxiliary |
X | 1- Abbey Road 1 (512) 590-6036 2400-N-8-1 F |
X | 2- Tel-Med-Com 555-8686 9600-E-7-1 F TELEBIT_V.32|
X | 3- C Board 1 (619) 722-8724 2400-N-8-1 F |
X | 4- Crest 1 (213) 471-2518 2400-N-8-1 F Sample |
X | 5- Last Chance 1 (219) 762-8411 2400-E-7-1 F |
X | 6- Killer 1 (214) 827-1994 1200-E-7-1 F |
X | 7- System A (direct) 19200-N-8-1 F tty12 |
X | 8- 1200-E-7-1 F |
X | 9- 1200-E-7-1 F |
X | 10- 1200-E-7-1 F |
X | |
X | ==> _ R Revise M Manual Dialing Entry to Dial |
X | P LD Codes D Delete Entry <CR> Scroll Down |
X | <up>/<down> Page L Print Entries <ESC> Exit |
X | |
X | LD Codes Active: @ # |
X | |
X +---------------------------------------------------------------------------+
X
X The fields of the dialing directory are:
X
X Name) The name of the remote system.
X
X
X
X
X
X Page 18 Pcomm Reference Manual
X
X
X Number) The telephone number to the remote system.
X
X NOTE: The "(", ")", "-", and space characters are just for
X looks, and don't get sent to the modem. To prevent the
X stripping of one of these characters, prepend a "\" to it.
X
X Line settings) The communications settings to be used when
X dialing that entry. The range of values are:
X
X Baud Parity Data bits Stop bits
X ________________________________________
X 300 N - none 7 1
X 1200 E - even 8 2
X 2400 O - odd
X 4800
X 9600
X 19200
X 38400
X
X Duplex) The duplex mode. Either "F" for full or "H" for
X half.
X
X Auxiliary) This field has one of three uses:
X
X 1) Name of the shell script to be used during the
X auto-login "chat" sequence.
X 2) Name of the TTY to be used for the entry.
X 3) Name of the modem to be used for this entry.
X
X NOTE: On all hard-wired ports, this field is used to
X contain the name of the port. For example, if tty12 is a
X hard-wired port to "System A", then the dialing directory
X entry for "System A" will have "tty12" in the auxiliary
X field.
X
X NOTE: The ability to specify a modem allows you to
X customize each dialing directory entry to use its own
X peculiar modem initialization string. See Appendix C for
X more details.
X
X The commands at the dialing directory prompt are:
X
X R) Revise (or add) a dialing directory entry or long
X distance dialing code. Prompts you to save the changes to
X disk. A typical revise screen would look like this:
X
X
X
X
X
X Pcomm Reference Manual Page 19
X
X
X +----------------------------------------------------------+
X | |
X | Entry to revise? _ (Entry Number, +,-,@,#) |
X | |
X +----------------------------------------------------------+
X
X If a dialing directory entry is selected, each field of the
X entry is shown with its current settings. You can enter a
X new value, press a carriage return to skip past a field, or
X enter a single space character to erase a field. An <ESC>
X at any field will abort the command.
X
X P) Print (display) the long distance dialing codes.
X
X <up>/<down>) Scroll the dialing directory up or down 10
X lines. Use the up and down arrow keys to access this
X feature.
X
X M) Manual dial. Prompts you for a phone number rather than
X using a number already in the dialing directory.
X
X D) Delete an entry or a range of entries. Prompts you to
X save the changes to disk.
X
X L) Print. Send the dialing directory to the printer or a
X file of your choice.
X
X 1-100) Entry number. Dial the phone for that entry number.
X If the script field contains the name of a valid Unix shell
X script, that script is "played" after the connection is made
X to perform the auto-login "chat" sequences. See section 8
X of this manual for more details on the format and use of
X script commands.
X
X NOTE: To access the port directly without dialing (perhaps
X to send the dial codes yourself), select an empty entry or
X enter a single space character at the phone number prompt of
X the manual dial option.
X
X <CR> Carriage return. Scroll the dialing directory down one
X line.
X
X
X 4.2. Redial
X
X The redial feature is a misnomer; it really is a queuing system
X that allows Pcomm to dial several numbers in a cycle until one of
X them answers.
X
X
X
X
X
X Page 20 Pcomm Reference Manual
X
X
X When you invoke the redial command with ^A-R, you're prompted for
X a list of dialing directory numbers. (You may also prepend a
X long distance code to the entry number).
X
X +-- Redial Queue -----------------------------------------------+
X | |
X | Directory Entry Number(s): _ |
X | |
X | (<CR> for previous numbers) |
X +---------------------------------------------------------------+
X
X To redial the previous number, press a carriage return alone at
X the prompt. An <ESC> aborts this command.
X
X
X 4.3. Keyboard macros
X
X Keyboard macros are used as a shortcut to send commonly used
X strings to the remote system with only a few keystrokes. The
X characters used to identify the macros are the shifted number
X keys. For example, if the string "ls -alRF \| more!" was
X assigned to the "!" key (the shifted number 1 key), then when you
X press ^A-!, the string "ls -alRF | more" is sent to the remote
X (followed by a <CR> because of the "!" character synonym).
X
X To review or edit the keyboard macros, you type ^A-M. The
X following screen will appear:
X
X +-------------------------------------------------------+
X | Keyboard Macros |
X +-------------------------------------------------------+
X | |
X | ^A-! ls -alRF \| more! |
X | ^A-@ |
X | ^A-# |
X | ^A-$ |
X | ^A-% |
X | ^A-^ |
X | ^A-& |
X | ^A-* |
X | ^A-( |
X | ^A-) |
X | |
X | Macro key to revise: _ |
X | |
X +-------------- Press <ESC> to contineu ----------------+
X
X To edit a macro, you type the macro key character (without the
X leading hot key). After typing the new string information, you
X will be prompted to save the changes to disk. To erase an entry
X enter a single space character.
X
X
X
X
X
X Pcomm Reference Manual Page 21
X
X
X NOTE: All of the character synonyms described in section 3.5 are
X available for use with the keyboard macros.
X
X
X 4.4. Line settings
X
X The line settings menu is invoked by ^A-P. A typical line
X settings menu will look like this:
X
X +------------------------------------------------+
X | Line Settings |
X +------------------------------------------------+
X | |
X | Current Settings: 1200,E,7,1 |
X | |
X | 1) 300,E,7,1 8) 300,N,8,1 |
X | 2) 1200,E,7,1 9) 1200,N,8,1 |
X | 3) 2400,E,7,1 10) 2400,N,8,1 |
X | 4) 4800,E,7,1 11) 4800,N,8,1 |
X | 5) 9600,E,7,1 12) 9600,N,8,1 |
X | 6) 19200,E,7,1 13) 19200,N,8,1 |
X | 7) 38400,E,7,1 14) 38400,N,8,1 |
X | |
X | Parity Data Bits Stop Bits |
X | 15) Odd 16) 7 bits 18) 1 bit |
X | 17) 8 bits 19) 2 bits |
X | |
X | 20) Save Changes YOUR CHOICE: _ |
X | |
X +------------ Press <ESC> to return -------------+
X
X While dialing a remote, the line settings in the dialing
X directory entry are automatically used. Therefore the line
X settings menu is used to fine tune the values during a terminal
X session or to select the parameters for manual dialing. You can
X make the current setting the default by selecting the "Save
X Changes" option.
X
X The current line settings are also displayed in the status line.
X
X NOTE: During file transfers, certain parameters (namely the data
X bits and parity) will be temporarily changed. The status line
X will not reflect these temporary promotions.
X
X
X
X
X
X Page 22 Pcomm Reference Manual
X
X
X 4.5. Exit Pcomm
X
X To exit Pcomm, you type ^A-X. The phone is hung up (if a call
X was in progress), the print and data logging features are closed,
X and the TTY resources are released.
X
X NOTE: Pcomm drops the DTR (Data Terminal Ready) on the port
X before exiting to Unix.
X
X
X 4.6. Unix gateway
X
X To temporarily suspend Pcomm and spawn a Unix shell, you type
X ^A-4. To return to Pcomm, you exit the shell normally, typically
X with ^D or "exit".
X NOTE: The SHELL environmental variable is used to determine
X which program to invoke.
X
X
X 4.7. Command files
X
X Command files (shell scripts) can be envoked by typing ^A-5 to
X automate keyboard input and to perform Pcomm command sequences.
X The following window will prompt for the file name.
X
X +-- Command Files ----------------------------------------------+
X | |
X | Shell script: _ |
X | |
X +---------------------------------------------------------------+
X
X The use of shell scripts is discussed in Section 8.
X
X
X
X
X
X Pcomm Reference Manual Page 23
X
X
X 5. UTILITY FUNCTIONS
X
X The following commands perform secondary functions.
X
X
X 5.1. Program information
X
X To display the opening information screen, you type ^A-I. Press
X any key to return to the terminal mode.
X
X
X 5.2. Setup screen
X
X The setup screens are described in detail in section 3 of this
X manual.
X
X
X 5.3. Change directory
X
X To change the current working directory while still inside Pcomm,
X you type ^A-B. A screen similar to the following will appear:
X
X +-- Change Directory -------------------------------------------+
X | |
X | Current directory: /usr/egray |
X | New directory: _ |
X | |
X +---------------------------------------------------------------+
X
X Abbreviations known to the shell are acceptable; for example, the
X "~" character will be translated to the home directory in the csh
X or ksh shell.
X
X
X 5.4. Clear screen
X
X To clear the local screen and home the cursor, you type ^A-C.
X
X NOTE: The remote system may not "know" the screen has been
X cleared, and may make assumptions about the screen that are
X incorrect.
X
X
X 5.5. Toggle duplex
X
X The ^A-E command changes the duplex mode from FULL to HALF, or
X from HALF to FULL. The status line shows the current duplex
X mode. Use the Terminal Setup to make permanent changes to the
X duplex mode.
X
X
X
X
X
X Page 24 Pcomm Reference Manual
X
X
X 5.6. Hang up the phone
X
X To hang up the phone, you type ^A-H. The word "disconnecting"
X will briefly show in the status line.
X
X NOTE: Pcomm does not drop the DTR (Data Terminal Ready) during
X the hang up.
X
X
X 5.7. Printer logging
X
X The ^A-L command toggles the printer logging on or off. The
X current printer status is displayed in the status line.
X
X NOTE: Since all printing goes to the normal Unix print spool
X program, the characters will not print on the printer as they
X appear on the screen. The printing will actually begin when the
X printer logging is turned off and the complete print job is sent
X to the spool.
X
X
X 5.8. Toggle CR - CR/LF
X
X The ^A-3 command toggles the incoming line termination characters
X between CR and CR/LF. The status line shows the current settings
X (in the next to the last field).
X
X
X 5.9. Break
X
X The ^A-7 command sends a modem break to the remote system. The
X word "break" is (very) briefly displayed on the status line.
X
X NOTE: This not the same as the break key on the keyboard (we
X don't want to send a break to the local system, we want to send
X it to the remote system).
X
X
X
X
X
X Pcomm Reference Manual Page 25
X
X
X 6. FILE FUNCTIONS
X
X One of the most important features of a telecommunication program
X is the ability to transfer files. The following file transfer
X protocols are implemented:
X
X Protocol Packet Error Multiple
X name size detection files?
X _______________________________________________
X xmodem 128 checksum/CRC no
X xmodem-1k 128/1024 checksum/CRC no 1
X modem7 128 checksum yes 2
X ymodem 128/1024 CRC 3 yes
X ymodem-g 128/1024 none yes
X ASCII 4 none none no
X zmodem 128/1024 CRC yes
X (external) ? ? ?
X
X Notes: 1 CP/M style file name
X 2 MSDOS style file name and file size
X 3 Not needed!
X 4 zmodem is implemented as an external program
X
X NOTE: The built-in protocols that send file name information,
X convert the Unix style file name to fit the MSDOS name
X restrictions.
X
X
X 6.1. External protocols
X
X The external "protocol" is really a method of running an external
X program from Pcomm to accomplish a file transfer. The most
X common use of this feature would be to run Kermit or some
X proprietary program.
X
X Frequently used external file transfer programs (such as zmodem)
X can have their names embedded into the list of available
X protocols by using the External Protocol Setup in section 3.7.
X
X To abort an external file transfer, you hit the <ESC> key. All
X other characters typed at the keyboard are ignored.
X
X NOTE: The external protocol feature can also be used (misused?)
X to pipe the output of a Unix command to the remote.
X
X
X 6.2. Send files
X
X To send a file to the remote, you'll first have to instruct the
X remote system to receive the file, then type ^A-"up arrow". The
X following screen will appear:
X
X
X
X
X
X Page 26 Pcomm Reference Manual
X
X
X +---- Upload -----+
X | |
X | 1) xmodem |
X | 2) xmodem-1k |
X | 3) modem7 |
X | 4) ymodem |
X | 5) ymodem-g |
X | 6) ASCII |
X | 7) zmodem |
X | 8) kermit |
X | E) (external) |
X | |
X | <ESC> to Abort |
X | |
X | Protocol: _ |
X | |
X +-----------------+
X
X You then select the type of protocol at the prompt, and another
X window similar to this will appear:
X
X +-- Send xmodem ------------------------------------------------+
X | |
X | Enter filename: _ |
X | |
X +---------------------------------------------------------------+
X
X Now you type in the file name or names you'd like to send.
X Wildcards known to the shell are acceptable.
X
X Now the file transfer actually begins. A screen similar to the
X following is displayed during the transfer:
X
X
X
X
X
X Pcomm Reference Manual Page 27
X
X
X +------------- Uploading --------------+
X | |
X | Protocol: xmodem |
X | File name: main.c |
X | File size: 4420 |
X | Error check method: CRC |
X | Est transfer time: 0:00:50 |
X | Block count: 5 |
X | Percent complete: 11.2% |
X | Bytes transferred: 640 |
X | Errors this block: 0 |
X | Total error count: 0 |
X | Last message: NONE |
X | |
X +-------- Press <ESC> to abort --------+
X
X As the transfer progresses, the "block count", "percent
X complete", and "bytes transferred" fields will be continuously
X updated. If errors occur the "errors this block" and "total
X error count" fields will be updated and the "last message" field
X will contain a message about the error.
X
X At the end of the transfer, Pcomm will beep and return to the
X terminal mode. If an error occurred and the transfer was
X aborted, you will be prompted to acknowledge the error by
X pressing a key before returning to the terminal mode.
X
X
X 6.3. Receive files
X
X To receive a file (or group of files) from a remote system,
X you'll have to first instruct the remote system, then type ^A-
X "down arrow". Receiving a file is basically the same as sending
X a file.
X
X NOTE: Some systems do not pad the end of the file with control-
X Z's and therefore files might grow in length when received.
X
X
X 6.4. Pass thru mode
X
X The pass through mode is used when you have two or more machines
X in a communications daisy chain. The following diagram shows an
X example of this type of arrangement:
X
X
X
X
X
X Page 28 Pcomm Reference Manual
X
X
X +---------+ +----------+ +----------+
X |IBM PC | | Unix | | IBM PC |
X |running | <---- | running | <---- | running |
X |ProComm | -----> | Pcomm | ----> | RBBS |
X +---------+ +----------+ +----------+
X
X If a file is to be transferred from the last machine to the first
X machine, the middle machine must appear completely transparent.
X The middle machine must "forward the data" without altering it in
X any way. The pass through mode "expires" after a designated
X period of inactivity, after which the user is returned to the
X terminal mode.
X
X To access the pass through mode, you type ^A-T. The following
X screen will appear:
X
X +-- Pass Thru Mode ---------------------------------------------+
X | |
X | Enter the expiration time (5-60 sec) : _ |
X | |
X +---------------------------------------------------------------+
X
X NOTE: While in the pass through mode, no Pcomm command to the
X middle machine will be honored. Therefore, the only way to exit
X this mode is to not type anything on the keyboard until the
X expiration period has elapsed.
X
X NOTE: The baud rates to and from the middle machine need not be
X the same, however the slowest speed determines the overall speed
X of the transfer (the weakest link in the chain).
X
X
X 6.5. Directory
X
X To obtain a listing of a directory on the local system while
X still running Pcomm, you type ^A-F. The following screen will
X appear:
X
X +-- List Directory ---------------------------------------------+
X | |
X | Current directory: /usr/egray |
X | File spec (wildcards allowed): _ |
X | |
X +---------------------------------------------------------------+
X
X
X
X
X
X Pcomm Reference Manual Page 29
X
X
X Abbreviations known to the shell are valid. Output is sent
X through a "more" like program.
X
X NOTE: Since we're really doing a popen() to the "ls" command,
X additional command line options are also valid.
X
X
X 6.6. Screen dump
X
X To dump the contents of the current screen (minus any windows
X showing) you type ^A-G. The contents of the screen are written
X to the file specified in the general setup for this purpose. If
X the file already exists, the screen contents are appended to the
X file. The message "screen dump" will briefly appear in the
X status line.
X
X NOTE: The screen contents are subject to the available VCS
X (video command sequence) emulation, so an exact representation is
X not guaranteed.
X
X
X 6.7. Start data logging
X
X To start the data logging, or change the file used for data
X logging, you type ^A-1. The following screen will appear:
X
X +-- Start Data Logging -----------------------------------------+
X | |
X | Default log file: pcomm.log |
X | New log file: _ |
X | |
X +---------------------------------------------------------------+
X
X To keep the default file, just press a carriage return at the
X prompt, otherwise, enter a new file name. If the file already
X exits, the new data is appended to the file.
X
X The status of the logging is shown in the status line.
X
X
X 6.8. Toggle logging
X
X To temporarily suspend data logging or to start it again without
X being prompted for the file name, you type ^A-2.
X
X
X
X
X
X Page 30 Pcomm Reference Manual
X
X
X
X
X
X Pcomm Reference Manual Page 31
X
X
X 7. DIALING WINDOW
X
X While Pcomm is dialing another system, a screen similar to the
X following is shown:
X
X +--------------------------------------------------------------------+
X | D I A L I N G W I N D O W |
X +--------------------------------------------------------------------+
X | |
X | System name: C Board |
X | Pass number: 1 |
X | Elapse time this try: 4 |
X | Time at start of dial: 14:53:36 |
X | Time at start of this try: 14:53:36 |
X | Connect delay time: 35 |
X | Redial delay time: 5 |
X | Auxiliary: |
X | Result of last try: |
X | |
X | <SPACE>: Recycle <DEL>: Remove from queue E: Change delays |
X | |
X +---------------------- Press <ESC> to abort ------------------------+
X
X Items in the window are continuously updated to show the progress
X of the dialing attempt.
X
X The options available during the dialing window are:
X
X SPACE) Press the space bar to stop the dialing of the
X current entry and go on to the next entry in the queue. If
X there is only one entry in the queue, that number is
X redialed.
X
X DEL) Press the DEL key to remove the current number from the
X queue.
X
X E) Press the letter "E" to change the connect delay time, or
X the redial delay time (the pause between dialing attempts).
X You will be prompted to save the changes to disk.
X
X
X
X
X
X Page 32 Pcomm Reference Manual
X
X
X +-- Change Delay Times ---------------------+
X | |
X | Current connect delay time: 35 |
X | Current redial delay time: 5 |
X | |
X | New connect delay: _ |
X | New redial delay: |
X | |
X +-------------------------------------------+
X
X NOTE: While the DEL and E options are being processed, the
X dialing is temporarily suspended.
X
X
X
X
X
X Pcomm Reference Manual Page 33
X
X
X 8. SCRIPT COMMANDS
X
X Pcomm doesn't have a built-in script language, instead it uses
X Unix shell scripts (Bourne shell, C shell, Korn shell, etc) to
X perform the necessary "chat" sequences to log a user on to a
X remote system.
X
X Since shell scripts are run "outside" of Pcomm, the "pcomm_cmd"
X program is used to transmit command sequences to Pcomm. For
X example, a script can contain a line such as "pcomm_cmd data_log
X on" to turn on the data logging feature. The shell scripts
X specified in the dialing directory are run after the connection
X to the remote system has been made.
X
X You may hit the <ESC> key at any time to abort an auto-login
X script before it has completed.
X
X WARNING: Any file that has a "clear text" (un-encrypted) version
X of your password is a significant security threat. You should
X remove the read permission to all others.
X
X In order to assist in the creation of auto-login scripts, the
X following external programs have been provided.
X
X
X 8.1. Pcomm_cmd command
X
X Pcomm_cmd is an external Pcomm support program. It is used from
X inside shell scripts to access Pcomm commands, such as "pcomm_cmd
X send xmodem junk" for sending the file "junk" to the remote using
X the xmodem file transfer protocol.
X
X The following command line options are supported.
X
X SET BAUD [ 300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 ]
X Set the baud rate for the current connection. This
X feature is for use with the DIAL MANUAL command, since
X the baud rate information in the dialing directory
X entries overrides this value.
X
X SET PARITY [ EVEN | ODD | NONE ]
X Set the parity for the current connection. For use
X with the DIAL MANUAL command.
X
X SET DATA_BITS [ 7 | 8 ]
X The number of data bits (word length) used for the
X current connection. For use with the DIAL MANUAL
X command.
X
X SET STOP_BITS [ 1 | 2 ]
X The number of stop bits for the current connection.
X For use with the DIAL MANUAL command.
X
X
X
X
X
X Page 34 Pcomm Reference Manual
X
X
X SET DUPLEX [ HALF | FULL ]
X Set the duplex mode (local echo). The HALF option is
X used if the remote system does not echo characters as
X they are typed.
X
X SET AUX filename
X Use the argument as the auxiliarY file associated with
X the current connection. Since chaining of scripts is
X not supported, this feature would only be used to set
X the TTY or modem.
X
X SET HOT_KEY [1-256]
X Change the decimal value of the "hot key" to this
X value.
X
X SET ASCII_HOT string
X Change the ASCII representation of the hot key to the
X given argument. The length of the string must be no
X more than 4 characters wide.
X
X SET FLOW_CTRL [ XON/XOFF | NONE ]
X Set the flow control between the local and remote
X systems to either XON/XOFF or NONE.
X
X SET CR_IN [ CR | CR/LF ]
X Translate in-comming carriage returns carriage return
X followed by a line feed, or pass the carriage return
X through unchanged.
X
X SET CR_OUT [ CR | CR/LF ]
X Translate out-going carriage returns to CR or CR/LF.
X
X SET LOGFILE filename
X Change the name of the default log file. For use with
X the DATA_LOG command.
X
X SET DUMPFILE filename
X Change the name of the screen dump file. For use with
X the SCREEN_DUMP command.
X
X SET STRIP [ YES | NO ]
X Should the in-comming data be stripped to 7 bits?
X
X SET LOCAL_ECHO [ YES | NO ]
X Should data be shown on the screen during ASCII
X uploads?
X
X SET EXPAND [ YES | NO ]
X Should blank lines be "expanded" to a line with a
X single space? For use only during ASCII uploads.
X
X
X
X
X
X
X Pcomm Reference Manual Page 35
X
X
X SET CR_DELAY [ 0 | 100 | 150 ]
X Set the delay for the carriage returns for ASCII
X uploads.
X
X SET PACE [ YES | NO ]
X Should the entire upload be artificially slowed down?
X For use during ASCII uploads.
X
X SET CR_UP [ NONE | ADD_LF | STRIP ]
X Controls the translation of carriage returns during
X ASCII uploads.
X
X SET LF_UP [ NONE | ADD_CR | STRIP ]
X Controls the translation of line feeds during ASCII
X uploads.
X
X SET TIMER [5-150]
X Controls the timer (in seconds) that detects the end of
X an ASCII download.
X
X SET CR_DN [ NONE | ADD_LF | STRIP ]
X Controls the translation of carriage returns during
X ASCII downloads.
X
X SET LF_DN [ NONE | ADD_CR | STRIP ]
X Controls the translation of line feeds during ASCII
X downloads.
X
X QUERY TTY_NAME
X Returns the name of the current TTY in use or NONE.
X
X QUERY MODEM_NAME
X Returns the name of the current modem in use or NONE.
X
X IF CONNECTED
X Returns a 1 if Pcomm is currently connected to a
X remote, otherwise a 0.
X
X IF LOG_STATUS
X Returns a 1 if the data logging feature is turned on,
X otherwise 0.
X
X IF PRINTER_STATUS
X Returns a 1 if the printer is turned on, otherwise 0.
X
X DIAL [ MANUAL phone_number ] entry_number
X Dial an entry from the dialing directory. The MANUAL
X option is used to optionaly dial a phone number without
X the use of the dialing directory. DIAL returns after 1
X attempt. A return code of 1 means a connection was
X made.
X
X
X
X
X
X Page 36 Pcomm Reference Manual
X
X
X REDIAL entry_number
X Similar to the DIAL command, but 10 attempts are made.
X
X EXIT
X Hang up the phone and exit from Pcomm.
X
X CLEAR_SCREEN
X Clear the screen.
X
X CHG_DIR directory
X Change the current working directory to the given
X directory.
X
X HANG_UP
X Hang up the phone, but remain in Pcomm.
X
X PRINTER [ ON | OFF ]
X Control the logging of data to the printer.
X
X MODEM_BREAK
X Send a modem break to the remote system. This is
X typically used to tell the remote to switch to a
X different baud rate.
X
X SEND protocol filename
X Send a file to the remote. The valid protocols are
X XMODEM, XMODEM_1K, MODEM7, YMODEM, YMODEM_G, ASCII,
X EXT_1, EXT_2, and EXT_3.
X
X RECEIVE protocol filename
X Receive a file from the remote. The valid protocols
X are XMODEM, XMODEM_1K, MODEM7, YMODEM, YMODEM_G, ASCII,
X EXT_1, EXT_2, and EXT_3.
X
X SCREEN_DUMP
X Dump the current contents of the screen to the
X DUMPFILE. If the file already exists, the new contents
X are appended to the file.
X
X DATA_LOG [ ON | OFF ]
X Control logging of the terminal session to the LOGFILE.
X If the file already exists, the new contents are
X appended to the file.
X
X
X 8.2. Waitfor command
X
X The waitfor command has the following syntax:
X
X waitfor -n string
X
X
X
X
X
X
X Pcomm Reference Manual Page 37
X
X
X where "n" is the number of seconds to wait and "string" is the
X string to wait for.
X
X Waitfor returns a 0 if the string was found, a 1 if it didn't
X find the string within the allotted time, and a -1 if there was
X an error. Waitfor returns immediately if the string is found.
X
X The waitfor command would typically be used in a script to
X indicate that the desired prompt has appeared. For example:
X
X waitfor -5 "ogin:"
X if [ "$?" -eq 0 ]
X then
X echo "egray"
X fi
X
X would wait up to 5 seconds for the string "ogin:". If the return
X code is 0 (the strings did appear), send the string "egray" (my
X user ID).
X
X NOTE: Upper and lower case letters are considered different. If
X you are not sure if the prompt is "Login:" or "login:", then skip
X the first letter in the string and use "ogin:".
X
X
X 8.3. Matches command
X
X The matches command has the following syntax:
X
X matches string1 string2
X
X Matches returns a 0 if string2 is contained in string1, and
X returns a 1 if it does not. Unlike waitfor, the matches command
X does not read the TTY port.
X
X The matches command could be used to test string values such as:
X
X read junk
X matches $junk "login failed"
X if [ "$?" -eq 0 ]
X then
X exit
X fi
X
X
X
X
X
X Page 38 Pcomm Reference Manual
X
X
X 8.4. Examples
X
X It is not my intention to teach the reader the fundamentals of
X Unix shell programming. There are several good books on the
X subject available in stores.
X
X Remember to add execute permission to the file and remove the
X read permission to all others.
X
X The simplest auto-login script may contain the following:
X
X # send a <CR>
X echo ""
X # wait 5 seconds for the login prompt
X waitfor -5 ogin:
X # send my user ID
X echo "egray"
X # wait 5 seconds for the password prompt
X waitfor -5 assword:
X # send my password
X echo "abcdefg"
X # return to Pcomm
X exit 0
X
X
X
X
X
X Pcomm Reference Manual Page 39
X
X
X A more complex script is required if the user must send a modem
X break to synchronize the baud rate of the remote. For example:
X
X echo ""
X try=0
X # loop until done
X while true
X do
X # wait 5 seconds for the login prompt
X waitfor -5 ogin:
X # test the exit code of the waitfor command
X if [ "$?" -eq 0 ]
X then
X # send my user ID and exit the loop
X echo "egray"
X break
X fi
X
X # increment the number of attempts
X try=`expr $try + 1`
X # test to see if we should give up
X if [ "$try" -eq 5 ]
X then
X exit 1
X fi
X
X # send a modem break and loop again
X pcomm_cmd modem_break
X echo ""
X done
X # wait 5 seconds for the password prompt
X waitfor -5 assword:
X # test the return code from waitfor
X if [ "$?" -eq 0 ]
X then
X # send my password
X echo "abcdefg"
X else
X exit 1
X fi
X # return to Pcomm
X exit 0
X
X
X
X
X
X
X Page 40 Pcomm Reference Manual
X
X
X The following is an example fo a shell script that will dial a
X system, log a user on, transfer a file called "junk" using
X xmodem, log out, and exit Pcomm.
X
X # are we already connected?
X answer=`pcomm_cmd if connected`
X if [ "$answer" -eq 0 ]
X then
X # dial entry number 23 in my dialing directory
X pcomm_cmd dial 23
X fi
X # wait for the login prompt
X waitfor ogin:
X # send my user id
X echo egray
X # wait for the password prompt
X waitfor assword:
X # send my passwd
X echo abcdefg
X # wait for a Unix prompt
X waitfor $
X # start up an xmodem file transfer
X echo sx junk
X # wait for the sx command to say its ready
X waitfor now
X sleep 1
X # do a file transfer
X pcomm_cmd receive xmodem junk
X # wait for the prompt
X waitfor $
X # log me out
X echo "^D"
X sleep 1
X # exit pcomm
X pcomm_cmd exit
X
X
X
X
X
X Pcomm Reference Manual Page 41
X
X
X Appendix A - Typical Modem Configuration
X
X I can't begin to describe how to configure every modem to work
X with Pcomm. There are, however, several guidelines that will
X apply to virtually any modem.
X
X 1) Pcomm doesn't care about the DCD (Data Carrier Detect)
X settings of the modem.
X
X 2) It would be nice (but not essential) if the loss of the
X DTR (Data Terminal Ready) caused the modem to hang up.
X
X 3) Pcomm doesn't care if commands are echoed back by the
X modem (it might save a few milliseconds if echoing was
X turned off).
X
X 4) Some sort of result codes are required. Numeric result
X codes are ok... but since they are displayed on the screen,
X verbose (word) result codes will make more sense.
X
X 5) If the modem can return different result codes for each
X baud rate at which it answers, then by all means, use them.
X Match the odd-ball codes (such as CONNECT FAST for Telebit
X PEP) to the closest matching speed.
X
X 6) Anything that is returned by the modem, but not listed in
X the modem setup, is ignored.
X
X 7) Systems running older versions of uugetty (the
X bi-directional version of getty that comes with HDB uucp)
X may require extra commands in the initialization string to
X assure that uugetty switches to its dial out mode.
X Normally, "AT!~AT!~" causes enough dialogue to force uugetty
X to release the line.
X
X For example, a 2400 baud Hayes compatible modem might be
X configured with the following command:
X
X AT S7=60 S11=70 E0 Q0 V1 X4 &D2
X
X AT Hayes attention command
X S7=60 Wait 60 seconds for an answer
X S11=70 70 ms touch tone dialing
X E0 Don't echo commands (not essential)
X Q0 Turn result codes on
X V1 Return word result codes
X X4 Use as many result codes as you've got
X &D2 Hang up when DTR is lost (nice to have)
X
X
X
X
X
X Page 42 Pcomm Reference Manual
X
X
X
X
X
X Pcomm Reference Manual Page 43
X
X
X Appendix B - AT&T Unix PC 7300/3b1 Dial Codes
X
X The dialing codes used by the OBM (On Board Modem) are not
X straight-forward. The modem setup, as distributed, looks like
X this:
X
X -------------------------- Modem Setup --------------------------
X
X 1) Modem name (1 of 2) ... OBM
X 2) Modem init string .....
X 3) Dialing command ....... %
X 4) Dialing cmd suffix .... @
X 5) Hang up string ........
X 6) Auto baud detect ...... N
X 7) 300 baud connect ...... CONNECT
X 8) 1200 baud connect ..... CONNECT
X 9) 2400 baud connect .....
X 10) 4800 baud connect .....
X 11) 9600 baud connect .....
X 12) 19200 baud connect ....
X 13) 38400 baud connect ....
X 14) No connect string 1 ...
X 15) No connect string 2 ...
X 16) No connect string 3 ...
X 17) No connect string 4 ...
X -----------------------------------------------------------------
X OPTION ==> _ Press <ESC> to return
X
X The relevant fields of the modem setup are:
X
X 1) Modem name. This must be "OBM".
X
X NOTE: Pcomm uses the modem name as a flag to determine
X which dialing method to use. The string "OBM" is a
X "reserved word" that Pcomm uses to switch to the AT&T Unix
X PC 7300/3b1 dialing method.
X
X 3) Dialing command. This should be "%" for touch tone
X dialing or "^" for pulse dialing.
X
X 4) Dialing cmd suffix. This must be the "@" character.
X
X 6) Auto baud detect. The OBM cannot use the auto baud
X detect feature.
X
X 7-8) Connect strings. Although the OBM doesn't actually
X return any result codes, these fake fields are required.
X
X Additional OBM dialing codes from the phone(7) manual:
X
X
X
X
X
X Page 44 Pcomm Reference Manual
X
X
X "~" wait for next dial tone
X "," pause 2 seconds
X ":" pause 10 seconds
X "&" perform a hookflash
X "%" begin tone dialing
X "^" begin pulse dialing
X
X These codes can be inserted into the phone number string, for
X example:
X
X 555-1234~56 dial 555-1234, wait for tone, dial 56
X 9,555-1234 dial 9, wait 2 seconds, dial 555-1234
X %555^1234 dial 555 using tone, 1234 using pulse
X
X NOTE: The dialing codes for the OBM are not subject to character
X synonym translations, therefore the "%", "^", and "~" characters
X do NOT have to be preceded by the "\" character to remove their
X special meaning.
X
X
X
X
X
X Pcomm Reference Manual Page 45
X
X
X Appendix C - High Speed Modems
X
X The features and complexities of newer high speed intelligent
X modems available today warrants a more detailed discussion.
X
X 1) Locked interface speed
X
X Newer modems have the ability to maintain a locked interface
X speed with the computer without regard to the connected baud
X rate. For example, it is a good idea to lock the interface
X speed at 19200 baud (or 38400) when the modem is "talking"
X at 14400 baud.
X
X The "locked speed" field of the TTY database was created to
X solve this problem. If this value is non-zero, Pcomm will
X only use this baud rate when talking to the modem. The true
X connected baud rate (14400 for example) will continue to be
X displayed in the status line.
X
X 2) Multiple setups
X
X Users of newer modems may require a different "init string"
X or "dial string" depending on the target machine being
X called. For example, when trying to connect to older V.32
X modems, the V.42 and V.42bis features may have to be
X disabled. In this case the dial string would contain
X contain the commands to disable the unwanted features.
X
X This problem is solved by creating additional modem entries
X in the modem database. For example, you could have an entry
X called "TELEBIT" for normal connections, one called
X TELEBIT_V.32 for connecting to older V.32 modems, and
X another called "TELEBIT_PEP" for connections to other PEP
X modems.
X
X Pcomm uses the connect strings to determine if a modem can
X handle the requested baud rate. If there are multiple
X modems that satisfy that baud rate, then the first modem
X entry is used. You can influence the choice of suitable
X modems by placing the name of the modem in the Auxiliary
X field of the dialing directory. In this way, you can have a
X default modem and a specific modem for each dialing
X directory entry that may require one.
X
X Your choices are virtually unlimited... you can have a
X separate modem setup to control modem features such as error
X correction, compression, protocol spoofing, etc.
X
X
X
X
X
X Page 46 Pcomm Reference Manual
X
X
X 3) Telebit WorldBlazer register settings
X
X The following configuration is what I personally use for my
X Telebit WorldBlazer on bi-directional lines (ones with
X uugetty).
X
X &F Restores factory settings
X L1 Low speaker volume
X Q2 Use result codes only when dialing out
X X2 Use the most detailed result codes
X &C1 Set DCD to follow the carrier
X &D3 Hard reset on loss of DTR
X S0=1 Answer on first ring
X S7=60 Wait at least 60 seconds for a carrier
X S51=6 Set interface speed to 38400 baud
X S58=2 Full duplex RTS/CTS flow control
X S59=15 Use result code extensions
X S61=0 Pass modem breaks to the other end
X &W Save in NVM
X
X
X 4) Sample TTY database
X
X The following is the contents of the sample TTY database:
X
X TTY name Modem name Locked speed
X
X 1) tty10 HAYES 0
X 2) tty11 HAYES 0
X 3) tty12 DIRECT 0
X 4) tty13 TELEBIT 38400
X 5) tty13 TELEBIT_V.32 38400
X 6) tty13 TELEBIT_PEP 38400
X
X Notice that last 3 entries share the same TTY and are
X physically the same modem.
X
X 5) Sample modem database entry for TELEBIT
X
X The third entry in the sample modem database is for the
X Telebit modem designated for use under normal conditions.
X
X
X
X
X
X Pcomm Reference Manual Page 47
X
X
X 1) Modem name (3 of 5) .... TELEBIT
X 2) Modem init string ...... ATZ!~~
X 3) Dialing command ........ ATDT
X 4) Dialing cmd suffix ..... !
X 5) Hang up string ......... ~~+++~~ATH0!
X 6) Auto baud detect ....... Y
X 7) 300 baud connect ....... CONNECT 300
X 8) 1200 baud connect ...... CONNECT 1200
X 9) 2400 baud connect ...... CONNECT 2400
X 10) 4800 baud connect ...... CONNECT 4800
X 11) 9600 baud connect ...... CONNECT 9600
X 12) 19200 baud connect ..... CONNECT FAST
X 13) 38400 baud connect .....
X 14) No connect string 1 .... BUSY
X 15) No connect string 2 .... ERROR
X 16) No connect string 3 .... NO CARRIER
X 17) No connect string 4 .... NO DIALTONE
X
X 6) Sample modem database entry for TELEBIT_V.32
X
X The 4th entry is for the Telebit modem designated for use
X with older V.32 modems that are confused by V.42 and
X V.42bis.
X
X 1) Modem name (4 of 5) .... TELEBIT_V.32
X 2) Modem init string ...... ATZ!~~
X 3) Dialing command ........ ATS180=0S50=6DT
X 4) Dialing cmd suffix ..... !
X 5) Hang up string ......... ~~+++~~ATH0!
X 6) Auto baud detect ....... Y
X 7) 300 baud connect ....... CONNECT 300
X 8) 1200 baud connect ...... CONNECT 1200
X 9) 2400 baud connect ...... CONNECT 2400
X 10) 4800 baud connect ...... CONNECT 4800
X 11) 9600 baud connect ...... CONNECT 9600
X 12) 19200 baud connect .....
X 13) 38400 baud connect .....
X 14) No connect string 1 .... BUSY
X 15) No connect string 2 .... ERROR
X 16) No connect string 3 .... NO CARRIER
X 17) No connect string 4 .... NO DIALTONE
X
X
X
X
X
X Page 48 Pcomm Reference Manual
X
X
X 7) Sample modem database entry for TELEBIT_PEP
X
X The 5th entry is for the Telebit modem designated for use
X with other Telebit PEP modems.
X
X 1) Modem name (5 of 5) .... TELEBIT_PEP
X 2) Modem init string ...... ATZ!~~
X 3) Dialing command ........ ATS50=255DT
X 4) Dialing cmd suffix ..... !
X 5) Hang up string ......... ~~+++~~ATH0!
X 6) Auto baud detect ....... Y
X 7) 300 baud connect .......
X 8) 1200 baud connect ......
X 9) 2400 baud connect ......
X 10) 4800 baud connect ......
X 11) 9600 baud connect ......
X 12) 19200 baud connect ..... CONNECT FAST
X 13) 38400 baud connect .....
X 14) No connect string 1 .... BUSY
X 15) No connect string 2 .... ERROR
X 16) No connect string 3 .... NO CARRIER
X 17) No connect string 4 .... NO DIALTONE
END_OF_FILE
if test 79590 -ne `wc -c <'pcomm-2.0/Doc.out'`; then
echo shar: \"'pcomm-2.0/Doc.out'\" unpacked with wrong size!
fi
# end of 'pcomm-2.0/Doc.out'
fi
echo shar: End of archive 8 \(of 8\).
cp /dev/null ark8isdone
MISSING=""
for I in 1 2 3 4 5 6 7 8 ; do
if test ! -f ark${I}isdone ; then
MISSING="${MISSING} ${I}"
fi
done
if test "${MISSING}" = "" ; then
echo You have unpacked all 8 archives.
rm -f ark[1-9]isdone
else
echo You still need to unpack the following archives:
echo " " ${MISSING}
fi
## End of shell archive.
exit 0
--
Frank Kaefer # fkk@stasys.sta.sub.org # Starnberg, Germany
Thread Navigation
This is a paginated view of messages in the thread with full content displayed inline.
Messages are displayed in chronological order, with the original post highlighted in green.
Use pagination controls to navigate through all messages in large threads.
Back to All Threads