bkwire BKWIRE collects wire input that is in teletex/broker feed type message format. The header is parsed and put in the FIP header field SH. The file is slotted into the spool/2brouted queue for IPROUTE to process and route. If the -b for broker output queue is specified, all files are moved there rather than 2brouted. This is for when partial screens/rows are being sent. BKWIRE also reads this queue to put everything back together. BKWIRE uses a parameter file from tables/wire of the same name (-n). The syntax is the usual : one parameter per line, comments start with a semi-colon ';', keywords end with a colon ':'. It uses the parameter file to specify which pages are to be tracked and which to ignore. It also states where to send pages and when. Pages can be sent either at regular intervals or when an update has arrived or both. For regular interval traffic, days of the week are fixed for when the service is active. There is also a switch for processing the Dow Jones Composite Feed which is all that is necessary in the parameter file. The syntax of the parameter file tables/wire/NAME is : ; comment page: (pageno) ignore: page: (pageno) dest: (dest1 [+dest2 etc]) int:(interval) head:headline pgkey: (start) : (len) lnkey: (start) : (len) data: (start) : (len) hdr: yes|no soh: (SOH chr) stx: (STX chr) etx: (ETX chr) chkpt: (interval between checkpoints) savque: (save queue under spool for chk pointed files) eoln: (end of line sequence) chrset: (Source character set to use) seqno: (yes) convlinekey: (decimal number to subtract from each byte of positioning data) convpagekey: (as for convlinekey for the page key also) dow: (wavephore|x25) where dow flags the feed as a Dow Jones Composite Feed and sets up all the parameters. It is usually the only parameter in the file. except for (possibly) 'eoln'. There are two possible options for the dow keyword: dow:x25 dow:wavephore (default) which denote which transmission medium is to be used. where pageno is the page number - up to 100 may be tracked. dest is a valid destination(s), probably a broadcast line, in USERS. There are no default destinations. There can be NO embedded spaces in dest, use + for more than 1. If a dest is specified, the output file is sent directly to spool/2go; otherwise it is sent to spool/2brouted for IPROUTE to determine where to send it. int - the interval in seconds to output the page. default: 300 int=0 : everytime the page is updated. head - a fixed text message for both headline AND 1st line of text Use double quotes to embedded spaces or use \s. ignore flag indicates no further processing is necessary soh : start of header chr default: SOH stx : start of text chr default: STX etx: end of text chr default: ETX To set to ignore, set to NUL (\000). hdr : no ignore header, page number/seqno is in text default: yes/allow crc : number of bytes to strip at the end of the record default: 0 pgkey : start position and length of page number in header (or in text) default: 1:6 lnkey : start position and length of sequence no in header (or in text) default: 10:2 data : start position and length of data default: 1:0 ie all eoln : End of line sequence default:\r\n for CR NL savque : chkpoint que to save pages in case of system failure. default: none convlinekey: Where coordinates etc are binary. default: no The parameter is a DECIMAL number - 0 and above - to subtract from each chr This can be used where the sender adds 32 to every binary byte to make it visable convpagekey: Where coordinates etc are binary. default: no seqno: add 4 digit seqno on filename default: no chrset: Source Chrset. This defaults to ASCII for those pages with a 'dest' defined and the %SC field in the tables/route file for all others. timeout: (seconds) Timeout with no data befoe the connection is dropped and reconnected. default: 300 seconds A tmeout of zero implies no timeout. Note that both key and line start positions are from 1 not zero. Input Parameters : Mandatory : -n : name of this wire (usually the agency) default: none either -s : Spider name or TTY device name default: none -p : Spider port number default: none or -P : Port on UnixBox to use for outbound default: none This is only used where Terminal Servers canNOT run reverse telnet correctly and need to set a Permanent Virtual Connection across the ethernet to a fixed port number on the UnixBox Optional : -A : name of the archive file if not the -n name field. default: 'name' -c : Change Chrs 'FS' and 'GS' (0x1C and 0x1D) to NL default: no -d : the name of a DUPLICATE wire where 2 copies of the same file is required (SD header field). default: none -e : Strip End of lines (ie make lines run on) default: preserve eoln -f : Extra FIP header information default: none For fixed header info in FIP. eg -f #QA:AA#QB:BASIC As this flag is normally the last specified, its contents can be used to overwrite any unique fields such as DU, DP, SN etc. -k : Add the message keyword as first line of text default: no -l : log incoming items when a new file is created default: no -L : For Socket/term server type connections, reestablish the link after disconnection default: no -o : output que to move incomings to default: spool/2brouted -q : Display ALL pages that are NOT defined in the table.default: no -r : the name of a DIFFERENT routing table to 'name' (SR field : used by iproute) default: name -x : dynapad x25 support default: none This wakes up the pad on startup. -X : Turn telnet transparency OFF for terminal servers default: ON -U : Raw or Telnet NO-escape mode for terminal servers default: telnet transparency ON -y : Banner string to strip from terminal server default: SpiderBanner -Y : There is no banner to strip default: as above -v : Print the version number and exit -z : Name of output format (DF field) default: BKWIRE -W : add to dump file in /fip/dump default: no Notes File ends if either filename/index changes OR seqno restarts at 0 OR nothing has been received for 10secs. (copyright) 2017 and previous years FingerPost Ltd.