NJEROUTES(8)

NAME
njeroutes - FUNETNJE bitnet software routing database generator.

SYNOPSIS
njeroutes header.filename routes.filename database.filename

DESCRIPTION

Net_routes builds routing database of BITNET nodes for funetnje program internal usage. If no DEFAULT-ROUTE has been defined in /etc/funetnje.cf (see funetnje(8)) then this is ONLY way to route messages and files from local node to anywhere.

Example of header.file for node FINFILES having alias name HAMSTER.

*
*  Header of HUyNJE/FUNETNJE package routing table
*
*  Generic format:
*	SITE	LINE	(FORMAT/INFO)
*
 ROUTE FINFILES LOCAL ASCII
 ROUTE HAMSTER  LOCAL ASCII

It may also be usefull to define alternate routes just in case the direct link doesn't work:

 ROUTE FIGBOX FIGBOX
 ROUTE FINHUTC FIGBOX

First one defines that FIGBOX has no alternatives, while FINHUTC can get routed via FIGBOX in case direct link to it is not active.

Example routing data for same node. Used format is same as IBM RSCS v1 uses, thus it is easily obtainable using common BITNET tools. Next step connection of the example node is FIGBOX.

* * The position of the network name and country *
* * assumes that the RSCS ROUTE command does not *
* * have more than two parameters.               *
ROUTE VERS9012 FIGBOX   EARN     NL
ROUTE LINKS012 FIGBOX   BITNET   US
ROUTE FINABO   FIGBOX   EARN     FI
ROUTE FINALKO  FIGBOX   EARN     FI
ROUTE FINFUN   FIGBOX   EARN     FI
ROUTE FINGATE  FIGBOX   EARN     FI
ROUTE FINHUT   FIGBOX   EARN     FI

SEE ALSO
funetnje(8), send(1), sendfile(1), bmail(8), ucp(8).

BUGS

None, we hope.

DIAGNOSTICS
All error conditions are reported with self explanatory text messages.

If multiple entries of same node are attempted (for example one in header, other in routes), first one stays as routing definition, rest are reported as duplicates.

WARNING
It is not adviced to create output on same file, as the current database is, although they will not be intermixed, as if there is a file with the target name, it will be unlinked before the processing starts.

Once the database is generated, and placed (with mv(1), for example) on place of the active database, a `ucp(8) rescan route' -command is suggested (or full restart of the emulator.)

AUTHORS

Yehavi Bourvine, Hebrew University of Yerusalem, Israel <yehavi@hujivms.bitnet>.

Matti Aarnio, Finnish University and Research Network - FUNET, Finland <mea@nic.funet.fi> <mea@finfiles.bitnet>.

Original (VMS oriented package) software by Yehavi Bourvine, UNIX features, plenty of modifications, man-pages by Matti Aarnio.