ipsyn (Sat Oct 25 2014 01:31:01)

ipsyn

IPSYN actually does the sending of text files to the clients. It will use the
client parameter file in tables/syn/client/CLIENTNAME to find the 2 other
parameter files which describe the ROUTE and the REMOTE SYSTEM.

It is normally started automatically by IPSYND after the operator has requested
a transmission via the MUI, SYN. IPSYND will have already allocated an unused
port from the tables/syn/PORTS file.

If  the port is greater than 1024 it is considered a Terminal server port ie a
Spider, otherwise the port number is a reference to a TTY port in the
tables/sys/PEEK file.

The Alternate route is switched to after 5 failures using the normal routing.
If it does not exist, the normal is tried a further 5 times.

Files are normally sent from a queue in spool/syn with the same name as the
client. Optionally a different queue may be specified.

For testing purposes, text can be logged as it is sent - this is useful where a
stext string is thought to be aborting the transmission. Normally a full log of
the transmission is left in log/syn/CLIENTNAME_date_time. Optionally this log
file can be forced to another file - including stdout. All files are normally
deleted once sent. An input parameter allows you to leave the files for another
test later.

If a TTY port is to be used, it can be configured using a file in
tables/stty/STTY_(clientname)_ttyx where x is the tty port name.

Valid keywords for the Preparation stage are :
	; comment
	ww:60		Wordwrap on 60 chrs
	wwx:256		Force an end-of-line (eox:xx) at 256 chrs
	eol:rn	A forced end of line or wordwrap is CR NL
	eop:tr	Any CR NL combination in the text stream is
			replaced with TAB CR
	eox:313	Place an Octal 313 every n chrs (n is from wwx:)
	nonulls:	Do NOT strip NULL chrs from the text
	ascii:		Only send printable ascii characters
			- strip unprintables and controls except Eolns.
	binary:		Binary file - make no modifications pls
	size:		Maximum take size. File is split in to takes if bigger
	speed:		Average speed for pacing traffic through a Terminal
			server
	error:NOsCARR	Communications Error message meaning broken connection
	filerror:ERROR	Message from remote system signifying it has a problem
	contto:		Message for the Continued To at end of a file split in takes
	contfrom:	Message for the Continued From at beginning of a file split
			in takes.
	first:		Name of FIRST file to be sent in a transmission - normally
			ths is a standard welcome text.
	last:
	copyr:
	banner:
	kermit:		Send the file using Kermit protocol.
	dbi:		Send the file using DBI protocol.
	xmodem:		Send the file using Xmodem protocol.
	ymodem:		Send the file using Ymodem protocol.
	zmodem:		Send the file using Zmodem protocol.
	remname:	File name for remote system when sending Kermit etc.
	single:		Send one file at a time - disconnect and reconnect for
				all subsequent files.
	zapatend	Delete the sent files ONLY after the last has been sent
				successfully. Normally each file is deleted
				after it has been sent succesfully.
	balance-seqno:  Send the Sequence number to this Balance Group (see
'ipbalance')
			Use this to make sure the sequence number is always updated on 
			any companion systems.
	max-timeout:	Maximum no Of seconds which a single 'wait' can take
			in addition the the normal no-traffic-timeout.
			default is 90 secs.
			This stops race conditions where a modem is just
			streaming rubbish.

Note that Banner and Copyright are (currently) ignored for files sent with
kermit, dbi, xmodem or zmodem.

Certain variables may be specified in the parameter files when sending text.
They are specified using the $x notation where x is :
	F : actual filename
	G : first 6 alpha numeric chrs of the filename
	T : number of files sent
	B : number of blocks sent
	C : number of characters sent
	X : approx time taken (this uses the 'speed' parameter
		and defaults to 1200)
	L : headline or first line of text

Otherwise any FipSeq - octal numbers, unix escape strings or Fip Header fields
- can be specified in the normal fashion.

Currently available commands for the scripet files are :
	; comment
	* (sectioname)
Note that only the first character is checked.

	: or +	Start of loop
	-	End of loop
	s	send string
	n	send nulls
	r, w, e, x	wait for strings or timeoutperiod
	z	sleep a couple of seconds
	d	display string on screen
	l	log string in the log file

recv, wait, exit, error are the same except the result and what to do with it.
The table below explains what happens if the command times out (ie neither
string is matched), the GOOD string is matched or the BAD string is matched.
ABORT means the transmission is aborted, stopped, backed out of, no more files
are sent and if logged on, logged off and if connected, disconnected.
YES and NO refer to whether we leave the loop or not (if we are a loop within a
section) or leave the section or not (if we are NOT in a loop).
			TIMEOUT GOOD    BAD
		r	no      no      yes
		w	no      yes     yes
		e	yes     no      yes
		x	abort   yes     abort
	
Input parameters :
	Mandatory :
	-c : name of client				default: none
	-p : port number to use				default: none
	Optional :
	-s : terminal server if not default		default: default
	-a : use alternate routing if it exists		default: use normal
	-d : display (in the log file) all text as it is sent
							default: no textdisplay
	-l : alternative log filename.	default: log/syn/CLIENT_date_time
	-q : take files from this queue in spool/syn
						default: spool/syn/clientname
	-X : Telnet Transparency off			default: on
		For terminal servers ports, set transparency to Off
		This is required for Xmodem, Ymodem and Zmodem.
	-z : do NOT delete files after sending		default: delete
	-Z : delete files only after sending the last one. default: delete each
		Normally files are deleted as they are sent. This deletes
		them ONLY after the last file has been sent with no errors.
		This is the same as adding the "zapatend" keyword in the
		remsys parameter file.
	-Y : For terminal servers there is NO signon-banner
		default: On connect, wait for a 377 back before continuing
	-v : print version number and exit

(copyright) 2014 and previous years FingerPost Ltd.