pcomm_cmd.out

通讯程序源码

pcomm_cmd(L)		 LOCAL COMMANDS		     pcomm_cmd(L)



NAME
     pcomm_cmd - send a	command	to Pcomm

SYNOPSIS
     pcomm_cmd [ command ] [ options ] [ arguments ]

DESCRIPTION
     Pcomm_cmd is a Pcomm  support  program.   It  is  used  from
     inside  shell  scripts  to	 access	 Pcomm	commands, such as
     pcomm_cmd send xmodem junk	for sending the	 file  "junk"  to
     the remote	using the xmodem file transfer protocol.

     The following command line	options	are supported.

     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.

     SET PARITY	[ EVEN | ODD | NONE ]
	  Set the parity for the  current  connection.	 For  use
	  with the DIAL	MANUAL command.

     SET DATA_BITS [ 7 | 8 ]
	  The number of	data bits  (word  length)  used	 for  the
	  current  connection.	For use	with the DIAL MANUAL com-
	  mand.

     SET STOP_BITS [ 1 | 2 ]
	  The number of	stop bits  for	the  current  connection.
	  For use with the DIAL	MANUAL command.

     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.

     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.

     SET HOT_KEY [1-256]
	  Change the decimal value  of	the  "hot  key"	 to  this
	  value.

     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.



Dell Computer Corp.	  Last change:				1






pcomm_cmd(L)		 LOCAL COMMANDS		     pcomm_cmd(L)



     SET FLOW_CTRL [ XON/XOFF |	NONE ]
	  Set the flow control between the local and remote  sys-
	  tems to either XON/XOFF or NONE.

     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.

     SET CR_OUT	[ CR | CR/LF ]
	  Translate out-going carriage returns to CR or	CR/LF.

     SET LOGFILE filename
	  Change the name of the default log file.  For	use  with
	  the DATA_LOG command.

     SET DUMPFILE filename
	  Change the name of the screen	dump file.  For	use  with
	  the SCREEN_DUMP command.

     SET STRIP [ YES | NO ]
	  Should the in-comming	data be	stripped to 7 bits?

     SET LOCAL_ECHO [ YES | NO ]
	  Should  data	be  shown  on  the  screen  during  ASCII
	  uploads?

     SET EXPAND	[ YES |	NO ]
	  Should blank lines be	"expanded" to a	line with a  sin-
	  gle space?  For use only during ASCII	uploads.

     SET CR_DELAY [ 0 |	100 | 150 ]
	  Set the  delay  for  the  carraige  returns  for  ASCII
	  uploads.

     SET PACE [	YES | NO ]
	  Should the entire upload be  artifically  slowed  down?
	  For use during ASCII uploads.

     SET CR_UP [ NONE |	ADD_LF | STRIP ]
	  Controls the translation  of	carraige  returns  during
	  ASCII	uploads.

     SET LF_UP [ NONE |	ADD_CR | STRIP ]
	  Controls the translation of  line  feeds  during  ASCII
	  uploads.

     SET TIMER [5-150]
	  Controls the timer (in seconds) that detects the end of
	  an ASCII download.

     SET CR_DN [ NONE |	ADD_LF | STRIP ]



Dell Computer Corp.	  Last change:				2






pcomm_cmd(L)		 LOCAL COMMANDS		     pcomm_cmd(L)



	  Controls the translation  of	carraige  returns  during
	  ASCII	downloads.

     SET LF_DN [ NONE |	ADD_CR | STRIP ]
	  Controls the translation of  line  feeds  during  ASCII
	  downloads.

     QUERY TTY_NAME
	  Returns the name of the current TTY in use or	NONE.

     QUERY MODEM_NAME
	  Returns the name of the current modem	in use or NONE.

     IF	CONNECTED
	  Returns a 1  if  Pcomm  is  currently	 connected  to	a
	  remote, otherwise a 0.

     IF	LOG_STATUS
	  Returns a 1 if the data logging feature is  turned  on,
	  otherwise 0.

     IF	PRINTER_STATUS
	  Returns a 1 if the printer is	turned on, otherwise 0.

     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.	 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.

     REDIAL entry_number
	  Similar to the DIAL command, but 10 attempts are made.

     EXIT Hang up the phone and	exit from Pcomm.

     CLEAR_SCREEN
	  Clear	the screen.

     CHG_DIR directory
	  Change the  current  working	directory  to  the  given
	  directory.

     HANG_UP
	  Hang up the phone, but remain	in Pcomm.

     PRINTER [ ON | OFF	]
	  Control the logging of data to the printer.




Dell Computer Corp.	  Last change:				3






pcomm_cmd(L)		 LOCAL COMMANDS		     pcomm_cmd(L)



     MODEM_BREAK
	  Send a modem break to	the remote system.  This is typi-
	  cally	 used to tell the remote to switch to a	different
	  baud rate.

     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.

     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.

     SCREEN_DUMP
	  Dump the current contents of the screen  to  the  DUMP-
	  FILE.	 If the	file already exists, the new contents are
	  appended to the file.

     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.

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.

	  # 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



Dell Computer Corp.	  Last change:				4






pcomm_cmd(L)		 LOCAL COMMANDS		     pcomm_cmd(L)



	  pcomm_cmd receive xmodem junk
	  # wait for the prompt
	  waitfor $
	  # log	me out
	  echo "^D"
	  sleep	1
	  # exit pcomm
	  pcomm_cmd exit

SEE ALSO
     pcomm(1), waitfor(1), matches(1), Pcomm Reference Manual












































Dell Computer Corp.	  Last change:				5