pcomm_cmd.1

通讯程序源码

.if n .ds rq ""
.el .ds rq ''
.if n .ds lq ""
.el .ds lq ``
.TH pcomm_cmd L
.SH NAME
pcomm_cmd \- send a command to Pcomm
.SH SYNOPSIS
.B pcomm_cmd
[ command ] [ options ] [ arguments ]
.SH DESCRIPTION
.I Pcomm_cmd
is a Pcomm support program.  It is used from inside shell scripts to access
Pcomm commands, such as
.I \*(lqpcomm_cmd send xmodem junk\*(rq
for sending the file \*(lqjunk\*(rq to the remote using the xmodem file
transfer protocol.
.PP
The following command line options are supported.
.TP
SET BAUD [ 300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 ]
Set the baud rate for the current connection.  This feature is for use
with the DIAL MANUAL command, since the baud rate information in the
dialing directory entries overrides this value. 
.TP
SET PARITY [ EVEN | ODD | NONE ]
Set the parity for the current connection.  For use with the DIAL MANUAL
command.
.TP
SET DATA_BITS [ 7 | 8 ]
The number of data bits (word length) used for the current connection.
For use with the DIAL MANUAL command.
.TP
SET STOP_BITS [ 1 | 2 ]
The number of stop bits for the current connection.  For use with the
DIAL MANUAL command.
.TP
SET DUPLEX [ HALF | FULL ]
Set the duplex mode (local echo).  The HALF option is used if the remote
system does not echo characters as they are typed.
.TP
SET AUX filename
Use the argument as the auxiliary file associated with the current
connection.  Since chaining of scripts is not supported, this feature
would only be used to set the TTY or modem.
.TP
SET HOT_KEY [1-256]
Change the decimal value of the \*(lqhot key\*(rq to this value.
.TP
SET ASCII_HOT string
Change the ASCII representation of the hot key to the given argument.  The
length of the string must be no more than 4 characters wide.
.TP
SET FLOW_CTRL [ XON/XOFF | NONE ]
Set the flow control between the local and remote systems to either XON/XOFF
or NONE.
.TP
SET CR_IN [ CR | CR/LF ]
Translate in-comming carriage returns carriage return followed by a line
feed, or pass the carriage return through unchanged.
.TP
SET CR_OUT [ CR | CR/LF ]
Translate out-going carriage returns to CR or CR/LF.
.TP
SET LOGFILE filename
Change the name of the default log file.  For use with the DATA_LOG command.
.TP
SET DUMPFILE filename
Change the name of the screen dump file.  For use with the SCREEN_DUMP 
command.
.TP
SET STRIP [ YES | NO ]
Should the in-comming data be stripped to 7 bits?
.TP
SET LOCAL_ECHO [ YES | NO ]
Should data be shown on the screen during ASCII uploads?
.TP
SET EXPAND [ YES | NO ]
Should blank lines be \*(lqexpanded\*(rq to a line with a single space?
For use only during ASCII uploads.
.TP
SET CR_DELAY [ 0 | 100 | 150 ]
Set the delay for the carraige returns for ASCII uploads.
.TP
SET PACE [ YES | NO ]
Should the entire upload be artifically slowed down?  For use during ASCII
uploads.
.TP
SET CR_UP [ NONE | ADD_LF | STRIP ]
Controls the translation of carraige returns during ASCII uploads.
.TP
SET LF_UP [ NONE | ADD_CR | STRIP ]
Controls the translation of line feeds during ASCII uploads.
.TP
SET TIMER [5-150]
Controls the timer (in seconds) that detects the end of an ASCII download.
.TP
SET CR_DN [ NONE | ADD_LF | STRIP ]
Controls the translation of carraige returns during ASCII downloads.
.TP
SET LF_DN [ NONE | ADD_CR | STRIP ]
Controls the translation of line feeds during ASCII downloads.
.TP
QUERY TTY_NAME
Returns the name of the current TTY in use or NONE.
.TP
QUERY MODEM_NAME
Returns the name of the current modem in use or NONE.
.TP
IF CONNECTED
Returns a 1 if Pcomm is currently connected to a remote, otherwise a 0.
.TP
IF LOG_STATUS
Returns a 1 if the data logging feature is turned on, otherwise 0.
.TP
IF PRINTER_STATUS
Returns a 1 if the printer is turned on, otherwise 0.
.TP
DIAL [ MANUAL phone_number ] entry_number
Dial an entry from the dialing directory.  The MANUAL option is used to
optionaly dial a phone number without the use of the dialing directory.
DIAL returns after 1 attempt.  A return code of 1 means a connection
was made.
.ft I
The dial function will not be allowed to switch TTY ports.  If the current
TTY is not suitable (i.e. not attached to the correct modem), the script
will be terminated.
.ft
.TP
REDIAL entry_number
Similar to the DIAL command, but 10 attempts are made.
.TP
EXIT
Hang up the phone and exit from Pcomm.
.TP
CLEAR_SCREEN
Clear the screen.
.TP
CHG_DIR directory
Change the current working directory to the given directory.
.TP
HANG_UP
Hang up the phone, but remain in Pcomm.
.TP
PRINTER [ ON | OFF ]
Control the logging of data to the printer.
.TP
MODEM_BREAK
Send a modem break to the remote system.  This is typically used to
tell the remote to switch to a different baud rate.
.TP
SEND protocol filename
Send a file to the remote.  The valid protocols are XMODEM, XMODEM_1K,
MODEM7, YMODEM, YMODEM_G, ASCII, EXT_1, EXT_2, and EXT_3.
.TP
RECEIVE protocol filename
Receive a file from the remote.  The valid protocols are XMODEM,
XMODEM_1K, MODEM7, YMODEM, YMODEM_G, ASCII, EXT_1, EXT_2, and EXT_3.
.TP
SCREEN_DUMP
Dump the current contents of the screen to the DUMPFILE.  If the file
already exists, the new contents are appended to the file.
.TP
DATA_LOG [ ON | OFF ]
Control logging of the terminal session to the LOGFILE.  If the file
already exists, the new contents are appended to the file.
.SH EXAMLES
The following is an example of a shell script that will dial a system,
log a user on, transfer a file called "junk" using xmodem, log out, and
exit Pcomm.
.PP
.nf
.RS 5
# dial entry number 23 in my dialing directory
pcomm_cmd dial 23
# wait for the login prompt
waitfor ogin:
# send my user id
echo egray
# wait for the password prompt
waitfor assword:
# send my passwd
echo abcdefg
# wait for terminal type prompt
waitfor vt100
# echo my type
echo vt100
# wait for a Unix prompt
waitfor $
# start up an xmodem file transfer
echo sx junk
# wait for the sx command to say its ready
waitfor now
sleep 1
# do a file transfer
pcomm_cmd receive xmodem junk
# wait for the prompt
waitfor $
# log me out
echo "^D"
sleep 1
# exit pcomm
pcomm_cmd exit
.fi
.RE
.SH "SEE ALSO"
pcomm(1), waitfor(1), matches(1), Pcomm Reference Manual