bkwire

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) 2024 and previous years FingerPost Ltd.