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:\r\n A forced end of line or wordwrap is CR NL eop:\t\r 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:NO\sCARR 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) 2021 and previous years FingerPost Ltd.