iprnsd

iprnsd

This program has two modes :
    1. Sits on the Broadcast line of a LMIL circuit and pumps data to IPXRNS on
this or another system.
        Any Sequence errors are noted, logged and a file created with FipHdr fields
for
            S1:StartOfMissingDataSeqno
            S2:EndOfMissingDataSeqno
            DU:rnsrpt
        Normally this file is left in 'spool/2go' for IPWHEEL to move to the system
running the Interactive IPRNSD
        Note the Interactive version needs to be logged on before LMIL will send any
data.
    2. Sits on the Interactive port of an LMIL circuit.
        It Logs on, checks for errors on the LMIL side and also checks the
'spool/rnserr' queue for RqstRpts.
        These Rpts can be either 
            - an S1/S2 record from the Broadcast
            - an S9 record for LOGOFF and STOP :    S9:LOGOFF
            - an S9 record for LOGOFF and LOGON :   S9:RESET
            - an S9 record for RESTART :    S9:START or S9:RESTART

IPRNSD uses a parameter file in tables/setup which defaults to RNSD.

Syntax for the parameter file are :
    ; comment
    interactive-host: (extranet host)
    interactive-port: (extranet port)

    broadcast-host: (extranet host)
    broadcast-port: (extranet port)
    broadcast-mbone-host: (extranet host)
    broadcast-mbone-port: (extranet port)
    mbone-local-address: (IP address of the 2nd card for Mcast)
or
    interactive-address: (x25 address)
        x25 address for the Interactive service (used only if input switch -i is
specified)
    broadcast-address: (x25 address)
        x25 address for the Broadcast service (used only if input switch -i is NOT
specified)

    broadcast-cug:      Closed user group
    interactive-cug:    Closed user group
    usap:           LSE supplied USAP

    repeat-wait: (secs)     default: 1
        wait for repeat re-re-request where the LSE system is too slow and we get
Q015 messages.
    repeat-retries: (goes)      default: 4
        no of retires for a re-request

Where sections of FipHdr fields are required or changes to the output style,
use keywords : fixed, partial, combie, optional, repeat and/or style. (see The
SysAdmin manual for more information).

    They are normally specified :
        fixed:QZ    1234543
        partial:QT  ST,3,2,U,<,>
        combie:QY   ep|na,(0000000)a 
        option:QE   ep,11,7,s
        repeat:QK   XK,-,3  
    or  repeat:QP   PK,,4,#X
        style:QS    XN,%.03d 

Input Parameters are :
    Mandatory parameters :
    -s : HostName where Program 'ipxrns'            default: none
    -p : Host port number                   default: none
    -n : Service name and name of parameter file        default: RNS

    Optional parameters :
    -d : dump incoming data to /usr/fip/dump/(NAME)_(DOY)   default: none
    -i or -I : This is the INTERACTIVE line and will    default BROADCAST line
        scan queue spool/rnserr for errors
    -N : Mbone (win2k) - no of buffers to use       default: 1
    -O : Mbone (win2k) - do NOT use overlapped io   default: do
    -o : Output Queue for BroadCast Rqst Rpts       default: spool/2go
    -q : Error Input Queue for Interactive Rqst Rpts    default: spool/rnserr
    -r : allow restarts - stop on E147 and start on START   default: ignore
            (interactive only)
    -R : ignore repeats (interactive only)          default: allow
    -X : do NOT add a leading STX to each packet        default: do
    -v : print version no and exit

-----------Example------------
broadcast-address:2341811000610
broadcast-cug:\x61
interactive-address:23418110009101
interactive-cug:\x91
usap:FHH010
participation-code:FTEXTEL  - not yet
service-code:B16        - not yet

-----------Notes---------------

-- Setup
The x25/hdlc parameters for the Eicon card MUST be setup EXACTLY as per the
LMIL specs SEQ605.
These are DIFFERENT to each other :
Use the Eicon Manager program to do the necessary.

To stop and restart the card :
    1. Cmd window
    2. cd \wsnt
    3. eccard stop
    4. eccard start

-- Checking the link
Use the Eicon program to check :
    1. Cmd window
    2. cd \wsnt
    3. ecmodule stats  hdlc
    3. ecmodule status hdlc
    3. ecmodule stats  x25
    3. ecmodule status x25

-- Start ipdump/ipxrns on news1 first

    ipdump -P9051 -nzbd -z &
    ipdump -P9052 -nzint -z &
then
    iprnsd -snews1 -p9051 -nrnstst          for the bdcast
    iprnsd -snews1 -p9052 -nrnstst -i       for the interactive

Version control
;002m2  08aug02 extranet - ignore x25 in this version pls
    ;c 28aug02 bug in interactive - not filling buffer
    ;d-h 02aug04 WINNT mcast and cleanups
    ;i-k 09nov06 bug in interactive resends for big files
    ;l-m2 29sep08 WIN2k overlapped io

(copyright) 2017 and previous years FingerPost Ltd.