WNOS4 Command Reference


                           Mike Chace (G6DHU)

                     WNOS Version 4 (29th May 1992)







1.  Command Syntax

This section details each command (and its sub  commands)  available  in
WNOS4. The following syntax is used...

command [<parameter>]      -  Denotes that <parameter> is optional
command <alt1|alt2>        -  Either the alt1 or the alt2 parameter
                              must be supplied to command.
command [<parameter>...]   -  Parameter <parameter> is optional and
                              there can be more than one <parameter>
                              specified.

For example, The "icmp trace" command syntax is

icmp trace [yes|no]

so valid commands would be

icmp trace
icmp trace yes
icmp trace no

The word argument is often used as a synonym for a <parameter> above.

Note that some of the commands  below  may  not  be  available  in  your
version  of  WNOS4.  For  example,  the  NNTP  system is not part of the
general release program and so the  "nntp  ..."  commands  will  not  be
available.

Note that to include spaces in most text string  arguments,  you  should
use double quotes to surround the string eg

motd "Welcome to the G6DHU TCP/IP Mailbox and node in Bath!"







                                                                        



                                                                        


1.1.  WNOS Program Command Line Arguments

1.1.1.  wnos -b [-s <sockets>] [-d <root_directory>] [<startup_file>]


1.1.1.1.  -b

Use BIOS calls to perform output to the console. Us this option  if  you
use  WNOS  with  a  windowing  package  and  have  trouble  with  output
"bleeding" on top of other windows.


1.1.1.2.  -s <sockets>

Specifies the number sockets available in the program.  The  default  is
40.


1.1.1.3.  -d <root_directory>

Allows WNOS to run with a "root" directory other than the default  which
is  the  root of the system (C:, D: etc). NOTE that a drive letter *MUST
NOT* be given! (see example below)


1.1.1.4.  <startup_file>

Defaults to "autoexec.nos" if not given.


1.1.1.5.  Example wnos startup line

wnos -b -s 50 -d/tcpip autoexec.wno

Would start WNOS with BIOS output, a socket array of 50, starting in the
sub-directory  /tcpip  (either  forward  or back slashes are acceptable)
with a startup file called "autoexec.wno".

1.2.  WNOS4 Mailbox Commands

The bbs commands are not directly  accessible  from  the  WNOS4  command
window,  instead  a  connection  to the local mailbox must be made first
using the "bbs" command. The same commands are accessible  to  any  user
connecting  to  your  mailbox,  either by telnet to TCP port 23 or by an
AX.25 connection followed by a Carriage Return to wake the mailbox up.

The extent to which commands are useable by each user depends upon their
Permissions set in the "ftpusers" file.

Mailbox commands are as follows








                                                                        



                                                                        


1.2.1.  ?

List commands


1.2.2.  @

Start sysop mode (see WNOS3 manual for details).


1.2.3.  <CR> (Return)

Read current mail message in current area


1.2.4.  CTRL-X

Escape back to mailbox command level


1.2.5.  a[rea] [<area>|<callsign>]

Without argument, show list of available mail areas, otherwise make  the
given  area  the default area. The list of areas accessible to all users
is defined by the area names specified in the "spool/areas" file.


1.2.6.  b[ye]

Logoff and disconnect. If any mail was sent within this session, it will
now be delivered.


1.2.7.  c[hat]

Chat to sysop (if "mbox attended" on).


1.2.8.  conv[ers] [<channel>]

Connect to the local convers node. An optional channel on which to  join
the server may also be given.

From the mailbox, login to the convers node is automatic  and  the  user
name is taken from their AX.25 callsign.


1.2.9.  co[nnect] <callsign> | [<iface>] <callsign> [<digi1>..<digi7>]

With no interface given, autoconnect to the given destination. Otherwise
make a connection to the given destination using the optional digipeater
list over the given interface. The outgoing connect is  made  using  the
inverted  SSID  of  the  connected  user.  For example, G7XXX's outgoing
connects will be made with the callsign G7XXX-15. A connection either in
the  link setup state or if it is in progress, can be killed sending the
Escape character (CTRL-X by default).


                                                                        



                                                                        


If no <iface> is specified and the destination callsign is  not  in  the
autorouter  list,  then  a  connect  to  the  destination on the default
interface is attempted. (See "ax25 route add default" command).


1.2.10.  d[ownload] <filename>

Download the given ASCII file. (Use the "what" command to find out which
files are available for downloading).


1.2.11.  du[uencode] <filename>

UUencode the given binary file and download it.


1.2.12.  e[scape] [<character>]

Without argument, show the default escape character, otherwise set a new
one.  The  default is Control-X. Sending this character whilst a connect
is in setup or in progress, will kill  it  and  return  to  the  mailbox
prompt.

Note that Control-X can also be used  to  kill  connections  other  than
AX.25,  especially  to kill a 'chat to sysop' session, when the sysop is
not present.


1.2.13.  f[inger] <user>|@<host> [<user>@<host> ...]

Query the local (or remote  if  @<host>  is  given)  finger  server  for
information on users of that system.


1.2.14.  h[elp] [command]

Without argument, display a message about the usage of the Help  command
otherwise,  send  detailed help on the specified command. The help files
are help in the "spool/help" directory and are named <command>.hlp.  For
example, the help file for the "mheard" command is called MHEARD.HLP.


1.2.15.  i[nfo]

Show information about the local system. The information  is  listed  in
the  "INFO.HLP"  file in the "spool/help" directory. If this file is not
present, a short error message will be given.


1.2.16.  k[ill] <message_number> [<message_number>...]

Delete the given mail message numbers (in a Private mail area). Only the
given  messages  are killed. In other words, "kill 4 8" kills messages 4
and 8, and not messages 4 to 8.




                                                                        



                                                                        


1.2.17.  l[ist] [<number> [<number>...]]

Display mail headers of the specified messages (all if  none  given)  in
the  default  message area. Information shown for each message includes,
the sender address, message title, size and message status (N = New, Y =
Read, D = Deleted (killed)). The current message is shown with a ">", as
well as being shown in the mailbox prompt (in the WNOS UK version).


1.2.18.  ll[ast] [<number> [<number>...]]

Show the last (specified) message headers in the current message area.


1.2.19.  m[heard] [<iface>]

Without argument, display the monitor heard  list  for  all  interfaces.
Otherwise just list those stations heard on the given interface.


1.2.20.  n[odes] [tcp|<nodename>]

Without argument, show all  locally  known  NET/ROM  nodes.  Adding  the
argument  "tcp" displays only those NET/ROM nodes which are likely to be
IP nodes (aliases containing either TCP, IP or NOS).

Specifying a node callsign or alias as argument lists all known  routing
information to that node.


1.2.21.  nc[onnect] <callsign>|<alias>

Make a NET/ROM (Level 4)  connection  to  the  given  node.  The  escape
character can be used to kill a pending connection.


1.2.22.  p[ath] [<destination_callsign>] [<destination_callsign> ...]

Without argument, displays all  known  AX.25  auto-router  destinations.
Specifying  a  callsign shows the path information for that destination.
Stations listed as the paths can be connected to using the short form of
the  connect  command  that does not require an interface (eg "c gb7imb-
2").


1.2.23.  os

Outputs the same as the internal "status"  command.  Useful  for  remote
sysops.


1.2.24.  q[uit]

Logoff and disconnect. If any mail was sent during this session,  it  is
now delivered.



                                                                        



                                                                        


1.2.25.  r[ead]  <number> [<number>...]

Read the given message(s) from the current area.


1.2.26.  s[end][r|b|f] <callsign>[@<host>]

Send mail to the given user. If "@<host>" is  not  specified,  the  mail
will be delivered locally.


1.2.26.1.  send <callsign>[@<host>]

Send mail to given user. Addresses supplied have  any  address  rewrites
(see  the  "spool/rewrite" file) applied and if a match results, this is
shown in the To: line rather than the address typed in.


1.2.26.2.  sr <message_number>

Send a reply to the given message number. To: is automatically filled in
before the user is prompted for the Subject.


1.2.27.  t[elnet] <host> [<port>]

Connect to another TCP/IP node using telnet. The default port to connect
to  is  port  23.  This usually results in having to login to the remote
machine.  The connection can be killed at any time  using  the  "escape"
character.


1.2.28.  up[load] <filename>

Upload the given ASCII! text file to the public file area. Binary  files
cannot  be  uploaded  using  this  command.  The  end of the file can be
signalled with any of, Control-Z, "/EX", "*** END" or  ".".  The  upload
can  be  aborted at any time by sending a Control-A. The filename of the
file to be uploaded must not already exist.


1.2.29.  u[ser]

Display information about all currently connected users.


1.2.30.  [w]hat <directory>

Gives a directory listing of the public file area or  of  the  directory
given.


1.3.  Special Mailbox Commands





                                                                        



                                                                        


These commands are not shown in the listing given by  a  "?"  or  "help"
command.  They  are  mainly  for  mailbox-mailbox communication (Store &
Forward) and SysOp use.


1.3.1.  [

Recognises that the connected  station  is  a  forwarding  mailbox.  The
characters  following  the [ are evaluated since they denote the various
features of the remote mailbox. For example, receipt of  [YFB-3.42-HMR$]
lets WNOS know that remote mailbox supports Hierarchical Addressing (H),
Message-IDs (M), Reverse Forwarding (R) and Bulletin-IDs ($).

When WNOS recognises a mailbox, it changes its operation to BBSFWD  (BBS
Forwarding) mode, indicated by the prompt changing to a single ">".


1.3.2.  F>

On receipt of this command (whilst in BBSFWD mode), tells WNOS that  the
remote  mailbox  is offering a "reverse forward". WNOS can then send any
mail waiting for forwarding to that BBS.


1.3.3.  v[erbose] <message_number>

Like the "read" command, except show all the  mail  headers  as-is.  The
"read"  command  cuts  the  non-essential  headers when the mail is read
whereas this command shows them verbatim.


1.3.4.  xr <host>

This is the remote chat command. If you nominate a remote sysop (ie that
user  has  the  "64" permission bit set in the /ftpusers file), they may
issue this command to redirect the destination  for  a  "chat"  command.
For example, I nominate g4wrw as my remote sysop. When I am away from my
system for a long period, he may connect to my  mailbox  and  issue  the
command;

(Msg #12: G4WRW) G4WRW de G6DHU> xr g4wrw1

Now, whenever a user connects to my mailbox and  types  "c"  or  "chat",
they  will be directed to the chat port at g4wrw1.ampr.org instead. This
is also a useful command for a remotely sited WNOS node.


1.3.5.  *** <text>

Denotes that the remote mailbox sent a forwarding error.








                                                                        



                                                                        


1.4.  Command Keys


1.4.1.  Return (Enter)

Switches from current mode (Trace or Command) to curent session.


1.4.2.  ESCape & F10

Switches from current session to Command Mode.


1.4.3.  F1....F8

Switch to session (eg F2 switches to session 2 (if active)).


1.4.4.  F9

Selects the Trace output screen. If there are active  sessions  it  will
toggle  between  Trace  and  the  current  session, otherwise it toggles
between Trace and Command screens.



2.  WNOS Program Commands


2.1.  ?

A synonym for the "help" command. Shows a list of top-level commands.


2.2.  ! [<program_name> [<parameters>] | /c <DOS-command>

A synonym for the "shell" command. Starts a DOS  session  (use  the  DOS
"exit" command to return to WNOS). (See also the "swap" command).

A "!" as the sole command loads a plain DOS shell.

Optionally, the name of the DOS program  to  be  run,  and  any  command
parameters to be supplied to it can also be specified.

! /c <DOS-Command>

Run a DOS command. Most of the useful  ones  (cd,  delete,  dir,  mkdir,
rmdir) are implemented.


2.3.  #

Denotes that this line is a comment.  Useful  in  the  autoexec.nos  and
other startup files.




                                                                        



                                                                        


2.4.  . <segment | .> [<decimal_range>

Gives a hexadecimal listing of the  memory  contents  of  the  specified
address.  If  a  "."  is  given  istead  of  a segment address, the last
specified address is used as the start address  for  the  listing.  (See
also "dump").


2.5.  abort [<session_number>]

Aborts file transfer in the given FTP session. If no  session_number  is
given, the current FTP-DATA session is aborted.


2.6.  arp

Display the ARP (Address Resolution Protocol) table  which  defines  the
mapping  of Internet addresses to link layer addresses (AX.25 or NET/ROM
callsigns or EtherNet addresses).


2.6.1.  arp add <host> ax25|ether|netrom <ethernet_address|callsign>

Add an ARP table entry  for  host  <host>  and  define  its  link  layer
mapping.


2.6.2.  arp drop <host> ax25|ether|netrom

Remove the entry for host <host> from the ARP table.


2.6.3.  arp flush

Flush the ARP table of all dynamic ARP entries.


2.6.4.  arp publish <host> ax25|ether|netrom <ethernet_address|callsign>

Like "arp add" except the system will respond to *any* ARP request  that
seeks the specified address. !Use with care!.


2.7.  asystat

Show statistics from the attached asynchronous (RS-232/V24) ports.


2.8.  attach <hardware_type>

Attach a communications driver of the given type.

Note that comms drivers  a  compiled  into  WNOS  according  to  desired
configurations. WNOS supports the following drivers;

PC100     = PacComm PC100 TNC Card


                                                                        



                                                                        


HAPN      = Hamilton Area Packet Network driver card
ARCNET    = ArcNet driver
SLIP      = Serial Line IP
HS        = High Speed (56k bps) modem card
EAGLE     = Eagle Card Driver
Packet    = FTP Software Inc driver/G8BPQ Node
Appletalk = Mac Appletalk Network Interface
NRS       = NET/ROM Back End interface
DRSI      = DRSI card driver
SLFP      = Serial Line Framing Protocol driver
VANESSA   = HB9RWM/ETH Zurich PC TNC card

The following terminology is used in the sections below;

Address   - Hexadecimal (hardware) address of the port.

Aoff            - Address Offset from the chip base address to
                  the Channel-A control registers.

asy_label       - The name of the interface declared asy "parent"
                  interface.

Boff            - Address offset from the chip base address to
                  the Channel-B control registers.

bufsize         - Size in bytes of the ring-buffer for temporary
                  holding of data received from the port.
                  Its value should be at least 1/4 of the port
                  speed, perhaps 1/2 on slower machines. If the
                  value is made too small, data in the buffers
                  can get overwritten whilst the program is unable
                  to read them. This is most likely to happen
                  during long reads/writes of the floppy/Hard disk.

call            - AX.25 Callsign (perhaps with SSID too).

channel         - Channel on a Z8530 SCC chip.

clock           - Clock frequency of SCC card (Hz)

Dataoff         - Address offset between Control and Data registers.

devices         - Number of Z8530 devices present.

int#            - Address (in Hexadecimal) of software interrupt
                  vector.

intack          - Address of INTACK/Read vector on Port 0.

ip_addr         - IP address of interface. If this is not specified,
                  the default is that set by the "ip address" command.

ip_addr_A       - IP address of channel A interface.

ip_addr_B       - IP address of channel B interface.



                                                                        



                                                                        


label           - Interface name. Usual names for asy interfaces are
                  "ax0", "ax1" etc. I prefer names that indicate
                  frequencies, eg "144", "432" etc. The name should
                  not be longer than 6 characters and can contain
                  mixed case and digits.

mtu             - Interface Maximum Transmission Unit. The largest
                  size of information frames that can be sent over
                  the interface in one go.

persistance     - Value of "aggresiveness" (0..255) in determining
                  when to use channel.

port            - "Virtual" port number in a multi-port KISS interface.

port#           - Port number on VANESSA PC TNC card.

remote_host     - For AXIP links.

spacing         - Spacing between chip base addresses.

speed           - Asynchronous (asy) interfaces - data rate.

speed           - Other interfaces - data rate to modem.

speed_A         - Data rate on Channel A interface.

speed_B         - Data rate on Channel B interface.

txdelay         - Time (milliseconds) between keying transmitter PTT and
                  start of sending data to TNC.

vector          - Address (in Hexadecimal) of Hardware interrupt vector.


2.8.1.  attach asy <address> <vector> slip|nrs|ax25 <label> <bufsize>
           <mtu> <speed> [<c|v>]

Attach an asynchronous comms driver to WNOS. The types are as follows

slip - SLIP (Serial Line Internet Protocol) IP encapsulation
nrs  - NET/ROM asynchronous framing protocol (NET/ROM "back-end")
ax25 - AX.25 using the KISS (Keep It Simple, Stupid) TNC protocol

Flags - c = Use CTS/RTS handshaking between host and TNC
      - v = Use VJ header compression on SLIP lines


Examples

     # Attach KISS TNC to COM1: with a serial link speed of 9600bps
     # The interface is called "144"

     attach asy 0x3f8 4 ax25 144 2048 256 9600

     # Attach SLIP line, called sl0 to COM2:


                                                                        



                                                                        


     attach asy 0x2f8 3 slip sl0 2048 1024 9600


2.8.2.  attach netrom

Attach the NET/ROM port.


2.8.3.  attach axip <label> <mtu> <remote_host>

Attach the SLIP AX.25 encapsulator interface.


2.8.4.  attach drsi <address> <vector> ax25 <label> <bufsize> <mtu>
            <speed_A> <speed_B> [<ip_addr_A> [<ip_addr_B>]]

Attach a DRSI PC*PA PC card.


2.8.5.    attach   scc   <devices>   init   <addr>   <spacing>    <Aoff>
<Boff><Dataoff>
               <intack> <vec> [p|r]<clock>

Initialise the PE1CHL SCC (Zilog 8530) generic  driver.  This  may  also
drive DRSI cards (see example in supplied autoexec.nos).


2.8.6.  attach scc <channel> slip|ax25|nrs|kiss <label> <mtu> <speed>
               <bufsize> [<call>]

Configure and attach the SCC driver. (an "attach scc .. init" must  have
appeared first).


2.8.7.  attach packet <int#> <label> <queue> <mtu> [<ip_address>]

Attach packet driver conforming to the FTP Software  Inc  packet  driver
standard.   This is also used to interface to the G8BPQ TheNode software
using the "NODEDRV4" TSRs to provide the channel to the radio(s).


2.8.8.  attach kiss <asy_iface_label> <port> <label> [<mtu>]

Attach a multi-port KISS TNC (eg KAM, KPC4 etc). These TNCs  encode  two
RF  channels  onto  one  serial  KISS  channel  and  attaching  a "kiss"
interface will enable decoding of both channels. It must be attached  to
an  existing  interface  (asy type) and <port> specifies the encoded bit
that carries the other channel. An optional  MTU  (Maximum  Transmission
Unit)  may  also  be specified. The new interface will be called <label>
and copies the parameters of the existing "parent" interface.


2.9.  attended [<yes|no>]





                                                                        



                                                                        


Flag whether the local sysop is present. If yes, connects to the station
via  "chat"  will then be signalled with the connect bell (if the "bell"
command is >= 1). If the sysop is not present, users are asked to  leave
a message.

With no argument, just show the current "attended" state. The default is
"yes".


2.10.  attribute [colour|mono]

Display the status line in colour or black/white (in mono). The  default
is colour.


2.11.  ax25  -  (Amateur X.25 Protocol)

These commands deal with all aspects of the machine's  handling  of  the
AX.25 link-layer protocol.

Abbreviations used in the following sections are;

axcb      - AX.25 Control Block. The internal memory address where
                  all the information pertaining to an AX.25 connection
                  is kept. This information is displayed by the "ax25
                  status" command.

CWind     - Congestion Window. The current value of MAXFRAME for
                  a given AX.25 connection. Its value varies according
                  to the link quality.



2.11.1.  ax25 bc <iface>

Sends an AX.25 broadcast (UI frame) out  on  the  given  interface.  The
frame is sent to destination callsign "ID".


2.11.2.  ax25 bcinterval [<seconds>]

With argument, set the interval in seconds  between  broadcasts  of  the
IDent  (range  is  0..65536  seconds).  Use ax25 bcinterval 0 to disable
IDents.

Without argument, just display the current setting.


2.11.3.  ax25 bctext [<text>]

Define the text string to be sent out as an IDent. The same text is used
on all interfaces.

Without argument, display the current broadcast text.




                                                                        



                                                                        


2.11.4.  ax25 bud <call>

The callsign specified  in  the  command  argument  will  be  completely
ignored by the AX.25 server. This applies for all SSIDs of that call.

Each call to be ignored must  be  specified  by  a  separate  "ax25  bud
<call>"  command.  There  is  no way to show the "bud" list. You have to
remember what you entered. In any case, the command should only be  used
in the case of severe trouble with an idiot user :-)


2.11.5.  ax25 close <axcb>

Disconnects the given AX.25 connection after all outstanding frames have
been processed.


2.11.6.  ax25 digipeat <iface> [0|1|2]

With argument, set the mode to be used by the digipeater

     0 = Digipeater Off
     1 = Normal Digipeating
     2 = Digipeating with autorouting to destination calls (default)

Without argument, display the current digipeater setting. The default is
2.

The digipeat mode  can  be  set  separately  on  each  configured  AX.25
interface.


2.11.7.  ax25 flush

Clears out the heard stations list.


2.11.8.  ax25 heard [<iface>]

Without argument, display the heard list on  all  active  interfaces.  A
maximum of the last 40 callsigns are displayed, the last heard is first.
The time since last hearing each station is also displayed.

With argument, only show stations heard on the given interface.


2.11.9.  ax25 kick <axcb>

Forces timeout of the  ax25  T1  (retransmission  timer)  on  the  given
connection  control block. Pending frames are sent with the Poll bit set
to illicit a response from the remote end.







                                                                        



                                                                        


2.11.10.  ax25 maxframe <iface> [<frames>]

Set  the  maximum   number   of   frames   that   can   be   outstanding
(unacknowledged)  at  any  one  time. The range is 1..7. Note that WNOS4
will dynamically adjust the maxframe value according to  performance  of
the  link  and this is shown as CWind in the output of the "ax25 status"
command. The value of maxframe specified by this command  will  only  be
used  in  the  initial  stages  of  the  connection. A different initial
MAXFRAME can be specified for each configured interface. The default  is
a maxframe of 2.

Without arguments, show the default initial maxframe.


2.11.11.  ax25 maxheard <iface> [<number_stations>]

Limit the number of stations  in  the  'monitor  heard'  list.  If  just
<iface>  is given, display the current number of stations allowed in the
list for that interface. The default is to  show  20  stations  on  each
configured interface.


2.11.12.  ax25 mycall [<callsign>]

Set the AX.25 callsign to be used by the system. Without argument,  just
display the current setting.

Note that this command MUST be used BEFORE any ax25 type interfaces  can
be attached and it cannot be changed after startup.


2.11.13.  ax25 paclen <iface> [<length>]

Set the maximum number of data bytes that can be sent in an I-frame. The
default  is 256 bytes. The range is 5..2048. Beware that values over 256
bytes cannot be handled by  most  other  AX.25  software.  This  applies
particularly  if you use "traditional" TNCs to digipeat over. PACLEN can
be set for each configured interface.

Without argument, just display the current setting.


2.11.14.  ax25 pthresh <iface> [<length>]

Set the poll threshold. With short I-frames, it is often more  efficient
to  resend the I-frame rather than poll (send a REJ or RR frame). If the
unacknowledged I-frame has a length greater than "pthresh",  the  system
will  poll  instead. The default is 64 bytes with a range of 1..256. The
PTHRESH may set for each configured interface.

Without argument, display the current poll threshold.







                                                                        



                                                                        


2.11.15.  ax25 reset <axcb>

Immediately kill the connection at the given  control  block.  This  may
result   in  lost  packets  and  is  often  used  for  clearing  "stuck"
connections.


2.11.16.  ax25 retry <iface> [<0 .. 50>]

Set the number of  retries.  The  default  is  10  with  a  range  of  0
(infinite) to 50. The RETRY limit may set for each configured interface.
Retry is also set according to the link state as follows;

Conn Pending (Link Setup) - Value of AX.25 retry
Connected                 - Value of AX.25 retry * 2
Disc Pending (Link Close) - Value of AX.25 retry / 2

Without argument, display the number of retries.


2.11.17.  ax25 route

Display and set information used by the AX.25 autorouter.  This  command
on  its  own will give a summary of the numbers of routes known for each
interface.  The default interface is marked with an  asterisk.  See  the
"ax25   route  add"  command  for  details  about  setting  the  default
interface.


2.11.17.1.  ax25 route add <iface> default

Marks <iface> as the default interface. It is very much recommended that
you  set  this.  For  example,  if  you  have  set  "144" as the default
interface then typing "connect gb7zz-5", where GB7ZZ-5  is  not  in  the
route  list already, will use 144 as the interface to attempt connection
on.


2.11.17.2.    ax25   route   add    [permanent]    <iface>    <callsign>
[<digi1>...<digi7>]

Add the given callsign and path to the AX.25 route list. If the argument
"permanent"  is  included  (typed in FULL), that route will be marked as
being permanent (much like locking a  NET/ROM  route  in  TheNet).  Upto
seven optional digipeaters maybe included. Note that the word VIA is not
needed in the digi path.

Note that in case where digis are present, the router will  assume  that
you have a path to each of the intermediate calls via the previous digi.
An example (if my call is g6dhu)

ax25 route add 432 gb7zz-5 g4otj-2 g4wrw-4 g4wub-5

will result in the following decomposed routes

g6dhu TO g4otj-2


                                                                        



                                                                        


g6dhu TO g4wrw-4 via g4otj-2
g6dhu TO g4wub-5 via g4otj-2 g4wrw-4
g6dhu TO gb7zz-5 via g4otj-2 g4wrw-4 g4wub-5

since the autorouter can assume that each of the  digi's  specified  are
also reachable by the preceding one!


2.11.17.3.  ax25 route hold [<days>]

Specify the time after which routes in the routing list are  dropped  if
they  have  no longer been used. The default is 30 days, with a range of
1..120.

Without argument, display the current hold time.


2.11.17.4.  ax25 route list [<call> [<call>]..]

Display the routing information to the callsign(s) specified.  Permanent
routes are marked with an asterisk "*".

Without argument, display the complete routing table.


2.11.17.5.  ax25 route stat

Show the number of known routes on each interface. The default interface
(see the "ax25 route add <iface> default" command) is shown with a "*".


2.11.18.  ax25 status [<axcb>]

Shows the complete information for the AX.25  connection  owned  by  the
given AX.25 control block.

Without argument, display a summary for all  active  AX.25  connections.
Connections  set  up  using  the  WNOS autorouter are implemented as two
independent connections, one on "each side" of your node. Each  side  of
the connection is managed separately (Hop-2-Hop Acknowledgement).


2.11.19.  ax25 t1 <iface> [<sec>]

Set the value of the AX.25 T1 (Retransmission) timer. The default is  10
seconds,  with  a range of 3..30 seconds. This timer determines the time
to wait for an acknowledgement of an outstanding I-frame. If  the  frame
remains  outstanding and this timer times out, the frame is resent. WNOS
automatically adjusts this timer according to the  link  conditions  and
the  value set above is used for initial purposes only.  The timer value
may be set for each configured interface.

Without argument, display the current setting of the T1 timer.





                                                                        



                                                                        


2.11.20.  ax25 t2 <iface> [<sec>]

Set the value of the AX.25 T2 (Acknowledgement Delay) timer. The default
is 2 seconds, with a range of 1..t1/2. This timer determines the time to
wait after receiving an I-frame, before the acknowledgement is sent. Its
value may be set for each configured interface.

Without argument, display the current setting of the T2 timer.


2.11.21.  ax25 t3 <iface> [<sec>]

Set the value of the AX.25 T3 (Link Redundancy) timer.  The  default  is
600  seconds,  with  a  range  of 1..3600. After time out of this timer,
according to the setting of "ax25 t3disc", the node will either send  an
RR(P) frame or a DISC frame to the remote end. This therefore determines
the action when a link has been idle (ie either poll the remote end  for
activity  or disconnect it). The T3 timer may be set for each configured
interface.

Without argument, display the current setting of the T3 timer.


2.11.22.  ax25 t3disc <iface> [yes|no]

Determines whether to poll for activity (no) or disconnect (yes) a  link
that has been idle for the time specified by "ax25 t3". Its value may be
set for each configured interface. The default is  "yes"  ie  disconnect
idle links.


2.11.23.  ax25 t4 <iface> [<sec>]

Set the value of the AX.25 T4 (Busy) timer. The default is  60  seconds,
with a range of (T1*2..20*t1). This timer is started after receipt of an
RNR frame from the remote end. On timeout, if no more frames  have  been
received,  an RR(P) frame is sent out. After a maximum of 900 seconds in
this Busy Status, the link is disconnected. The setting may  be  entered
for each configured interface.

Without argument, display the current setting of the T4 timer.


2.11.24.  ax25 t5 <iface> [<sec>]

Set the value of the AX.25 T5 (Frame Reassembly) timer. The default is 1
second,  with  a  range of 1..t1-1. Data to send is not immediately sent
out on a link rather only when this timer runs  out.  The  advantage  is
that,  while  this  timer  runs, new data to send may be appended to the
other data waiting to  be  sent  and  thereby  send  as  few  frames  as
possible. Obviously, this only applies as long as the data waiting to be
sent added to the new data, does not exceed the setting of "ax25 paclen"
for the current interface. T5 may be set for each configured interface.





                                                                        



                                                                        


Without argument, display the current setting of the T5 timer.


2.11.25.  ax25 window <iface> [<bytes>]

Set the maximum number of bytes in the  receive  queue  over  which  the
remote  end  will  be sent an RNR (Receiver Not Ready ie "I'm choking!")
frame. The default is 2048 bytes with a  range  of  (PACLEN/2..PACLEN*8)
bytes. WINDOW may be set for each configured interface.

Without argument, display the current AX.25 window.


2.12.  bbs

Start a connection to the local mailbox.


2.13.  bell [<0..10>]

Sets the number of times the connect bell will be rung if someone  types
"(c)hat"  in the mailbox or connects to your TTYlink port (TCP port 87).
The default is 1.

The connect bell only sounds if the "attended" flag is set on.


2.14.  cd [<directory>]

Change to the  directory  given.  Without  argument,  show  the  current
working directory. (see also "pwd")


2.15.  chat <hostname>

Connect to the chat (TTYlink) port of the specified host. Uses TCP  port
number 87. This is the short form of the "telnet <host> 87" command.

Beware that older TCP/IP implementations ie some  NET  programs  do  not
support the chat port on TCP port 87.


2.16.  close [<session_number>]

Disconnect the given session (IP, NET/ROM or AX.25).  Without  argument,
disconnect  the  current  session  (the  one  marked with the "*" in the
output from the "session" command).


2.17.  connect [<iface>] <callsign> [<digipeater1> .. <digipeater7>]

Start a connection to the given destination using  the  AX.25  Protocol.
Upto 7 optional digipeaters can be specified.





                                                                        



                                                                        


The interface and digipeaters can be omitted if the route  is  known  to
the AX.25 autorouter (see the "ax25 route add" command).

If no interface is given and the destination callsign and path  are  NOT
in  the  autorouter  list,  the  connect  attempt is made on the default
interface ie that set by the "ax25 route add <iface>  default"  command.
The given callsign and path are also added to the autorouter list.


2.18.  delete <filename>

Delete the given file in the current directory (se  the  "cd"  command).
Eventually, a directory name will be supported too!


2.19.  detach <iface>

Detach the given interface from WNOS. It can no longer be used  and  all
references  to  it  in  tables  show  "Not Present Status". Since memory
reallocation does not take place after a  subsequent  "attach"  command,
you may experience problems.


2.20.  dir [<directory_name>]

Displays a listing of files in the given  directory.  Without  argument,
give a listing of files in the current directory (see the "cd" command).
Both drive names (eg C:) and directory paths are supported  as  well  as
filename wildcards ("*" etc).


2.21.  domain....

Display and set information about the Domain Name Service.


2.21.1.  domain add <server_name> [<port>]

Add the given server to the  list  of  known  domain  name  servers.  An
optional port number (UDP port) on which that server listens for queries
can also be specified. The default port for connecting to  is  UDP  port
53.


2.21.2.  domain cache ...

Set and display information about the domain cache.


2.21.2.1.  domain cache garb

Force a reallocation of memory used to hold the domain  cache.  This  is
done automatically each time a session is switched (including Command to
Trace and vice versa).




                                                                        



                                                                        


2.21.2.2.  domain cache list

Display all entries  in  the  domain  cache.  IP  addresses  are  always
displayed irrespective of the "domain translate" setting.


2.21.2.3.  domain cache size [<number>]

Set (or display) the maximum number of entries in the domain cache.  The
default is 20 with a range of 2..50. This command should appear early if
set in the AUTOEXEC.NOS file since it is at this  time  that  memory  is
allocated for the cache.


2.21.2.4.  domain cache reset

Delete all entries from the cache, deallocate the memory freed and  move
the cache to a new part of memory.


2.21.3.  domain dfile [<filename>]

Set the path and filename of the local domain file. Default path is  the
WNOS  "root"  and  filename is DOMAIN.TXT. Useful for placing the domain
file in a RAM Drive to improve domain search speed.


2.21.4.  domain drop <server_name>

Remove the given server from the list of known Domain Name servers.


2.21.5.  domain list

List all known Domain Name servers and  statistics  such  as  number  of
queries sent, number returned etc.


2.21.6.  domain load [<filename>]

Load  the  specified  domain  file  (default  DOMAIN.TXT)  into  memory.
!Improves   response  times  but  eats  memory!.  ***  Not  in  standard
executable ***


2.21.7.  domain nslookup <server_name> <record_type> <name>

Query the given server and lookup the record under the  given  name  and
record type (eg CNAME, A, MX etc). *** Not in standard executable ***


2.21.8.  domain retries [<retries>]

Set the number of times to try for a query before giving up. The default
is to try twice with a range of 0..10.



                                                                        



                                                                        


Without argument, display the current domain retry setting.


2.21.9.  domain save [<filename>]

Saves the currently  loaded  domain  file  under  the  optionally  given
filename (default DOMAIN.NEW). *** Not in standard executable ***


2.21.10.  domain suffix [<suffix>]

Append the given suffix to domain names to  make  them  Fully  Qualified
Domain   Names   when  searching  for  the  corresponding  address.  The
recommended setting is

     ampr.org. (Note the trailing ".")


2.21.11.  domain timeout [<seconds>]

Set the timeout on waiting for responses to domain queries. The  default
is 60 with a range of 15..600.


2.21.12.  domain translate [yes|no]

Determine display of IP addresses. A  setting  of  "no"  (the  default),
displays  IP  addresses  in  "dotted  decimal  format" eg 44.131.20.3. A
setting of "yes" will display domain names rather  than  addresses.  For
reasons  of  performance,  only  the domain cache is searched for domain
names in this case (see the "domain verbose" command)


2.21.13.  domain verbose [yes|no]

Determine display of Domain names. A setting of "no"  chooses  a  faster
method  of  display.  A  setting  of "yes" (the default) causes the full
domain name to be displayed (host.subnet.net etc)


2.21.14.  domain zoneinit <server> [<bootname> <filename>]

This command can be used to fetch a domain file  from  a  remote  domain
name server. The default bootfile name is DOMAIN.TXT and the filename is
DOMAIN.NEW. The transfer of the domain file is done using UDP and should
only be attempted on good links. The received domain records are written
to the "filename". A file of the  same  name,  if  it  exists,  will  be
overwritten.


2.22.  drsistat

Dispay information about the connected DRSI card.





                                                                        



                                                                        


2.23.  dump

(See the "." command).


2.24.  echo [refuse|accept]

Set method of character echo on Telnet connections. Default is refuse.


2.25.  eol [standard|null]

Set Telnet's end-of-line behaviour when in "will echo" mode. Default  is
"standard". Unix mode EOL is <CR><LF>.


2.26.  escape [<character>]

Set character  that  returns  to  Command  Mode.  Default  is  Control-[
(ESCape).


2.27.  exit

Quit WNOS. AX.25 and NET/ROM links in use are not disconnected  but  TCP
connections  are  sent  a  frame  to  indicate that the connection is no
longer in existance. Serial port parameters are reset.  The  DOS  prompt
then reappears.


2.28.  finger [<name>]@<hostname> ...

Interrogate the finger server at  the  given  remote  host.  The  finger
server  typically  returns station information at the remote machine. If
no name is given, the remote server will return a  list of known  users.
Finger  server  files  are  held  in  the /finger directory and have the
format <call>.txt eg my own finger file is /finger/g6dhu.txt.


2.29.  ftp <hostname> [<port>]

Start a session using the FTP (File Transfer Protocol). Automatic  login
at the remote host is available (see the "nos.rc" file). The default FTP
port is TCP port 21 (Control) and  port  20  is  opened  for  each  file
transfer (signalled by FTP-DATA on the session status line).

Commands available at the ftp> prompt are....


2.29.1.  ascii

Select ASCII transfer mode. If a binary file is detected in this mode, a
warning is issued.





                                                                        



                                                                        


2.29.2.  batch [yes|no]

If batch is set to "yes", then send the greatest number of FTP  commands
possible in a single frame.


2.29.3.  binary

Set  binary  file  transfer  mode.  Text  (ASCII)  files  may  also   be
transferred in this mode.


2.29.4.  cd <remote_directory>|..

Change to the given directory or to the parent of  the  current  working
directory.


2.29.5.  dele <remote_filename>

Delete the named file.


2.29.6.  dir [<remote_directory> [<filename>]]

List the files in the current directory optionally saving the listing in
the  local  file  given. The list is a 'long' listing and gives all file
information (name, size etc).


2.29.7.  get [<remote_filename> [<filename>]]

Get the given file. If the second  argument  is  given,  give  the  file
transferred that name locally.


2.29.8.  hash

Print a hash mark (#) for each kilobyte acknowledged when either sending
or  receiving  a  file.  Useful to see at a glance how much work a given
transfer has done.


2.29.9.  list <filespec>

List the contents short listing format) of the given directory.


2.29.10.  ls

As the 'dir' command except gives a 'short' listing of filenames only.







                                                                        



                                                                        


2.29.11.  mget [<remote_filename> [<remote_filename>..]]

Multiple Get. Get more than one file in a single transfer  request.  The
'wildcards'  "*"  (match  any  string  in a filename) and "?" (match any
single character in a filename) maybe used.


2.29.12.  mkdir <remote_directory_name>

Create a directory on the remote machine (if no path given, this creates
a sub-directory within the current working directory).


2.29.13.  mput <local_filename> [<local_filename>..]

Send the named local files to the remote machine in one request.


2.29.14.  nlst

Show a long format listing of the files in the current directory.


2.29.15.  put <local_filename> [<remote_filename>]

Send the given file to the remote  machine.  If  a  second  argument  is
given, this is the name of the file as stored on the remote machine.


2.29.16.  q|uit

Logoff the remote file transfer service and close the session.


2.29.17.  rest <local_filename> <remote_filename>

This command can recover a failed ftp 'get' if, for example, the  remote
host  crashed midway through a transfer. WNOS4 will restart the FTP data
connection and join the 'lost'  part  of  the  file  with  that  already
received.


2.29.18.  rmdir <remote_directory_name>

Delete the given directory on the remote machine. (If no path is  given,
the  directory  is  assumed to be a sub-directory of the current working
directory).


2.29.19.  type [a|i|b|l <byte_size>]

Set the type of file for a put/get/mput or mget. Type a =  ASCII  (plain
text).   Type  i  or b = Image (A binary file with default wordsize of 8
bits). Type l is also a binary file but has the given logical byte size.




                                                                        



                                                                        


Given without argument, the "type" command just reports the current file
transfer type.


2.29.20.  verbose [0|1|2|3]

Be more detailed about what is going  on  during  a  transfer.  0  =  be
quiet!..  3 = show as much detail as possible.


2.30.  help

Give a list of the top-level commands supported by the program.


2.31.  hostname <name>

Set the local hostname.  This  is  not  used  for  anything  apart  from
Greetings  texts  sent  to  other hosts. Without argument, just show the
current hostname.  It should be set directly  or  very  soon  after  the
"ax25 mycall" statement in the AUTOEXEC.NOS file.


2.32.  icmp

Show information about ICMP (the Internet Control Message Protocol).


2.32.1.  icmp echo [yes|no]

Setting this command to "yes" (the default) allows the system to  handle
asynchronous  ICMP Echo Reply packets (otherwise known as ping replies).
This command must be switched on to allow the use of "one-shot" pings to
other hosts.

Without argument, just display the setting of the command.


2.32.2.  icmp status

Display ICMP statistics.


2.32.3.  icmp trace [yes|no]

Setting this command to "yes" will allow  the  printing  of  ICMP  error
messages  to  the  console.  Without  argument,  just display the flag's
value. The default is "no".


2.33.  ifconfig

Display  and  set  information  pertaining  to  the  currently  attached
interfaces.




                                                                        



                                                                        


2.33.1.  ifconfig [<iface>]

Display the interface configuration for the named interface (or  all  if
no interface given).


2.33.2.  ifconfig <iface> broadcast <hex_address|dotted_decimal_address>

Set the Internet broadcast address to be used on the given interface.


2.33.3.  ifconfig <iface> encapsulation
          <none|ax25|slip|ethernet|netrom|slfp>

Set the packet encapsulation to be used on  the  given  interface.  Note
that  this  does  not  afftect  the  transport protocol used to send the
frames on.


2.33.4.  ifconfig <iface_in> forward <iface_out>

Forward all packets arriving on the incoming <iface_in> interface to the
outgoing interface <iface_out>.


2.33.5.  ifconfig <iface> ipaddress <address>

Set the Internet Address to be used  on  the  given  interface.  If  not
specified,  this  address  defaults  to that entered in the "ip address"
command.


2.33.6.  ifconfig <iface> linkaddress <callsign>

Set the Link callsign to be used on a IP-IP interface.


2.33.7.  ifconfig <iface> mtu <bytes>

Set the interface MTU (Maximum Transmission  Unit)  in  bytes.  If,  for
AX.25  interfaces,  this  exceeds  the  "ax25 paclen", IP frames will be
fragmented.  Note  that  NET  and  NOS  IP  fragmentation  methods   are
incompatible  and  some  TNC  digipeaters  are  also  unable  to  handle
fragmented IP.


2.33.8.  ifconfig <old_iface_name> name <new_iface_name>

This command can be used to change the name of an already configured and
attached  interface.  It  is  particularly  useful for users of the DRSI
PC*PA card driver, where the card supports two ports. On  attaching  the
DRSI  driver,  the  ports  are given names with "a" and "b" appended, eg
"tnc0a" and "tnc0b". This command may be used to give the ports  a  more
meaningful  interface  name  eg  "144"  and "432". (Supported in WNOS4a7
onwards).



                                                                        



                                                                        


2.33.9.  ifconfig <iface> netmask <address>

Set the Network Masking Address used on a Internet type interface. A net
mask  will  only work if there is no default route (see "route add") for
the given interface. For example, "ifconfig eth0 netmask 2c000000" would
only accept AMPRNET addresses over the "eth0" interface.


2.33.10.  ifconfig <iface> rxbuf <bytes>

Set the size of the interface receive buffer.


2.34.  ip

Display or set information used by the Internet Protocol (IP).


2.34.1.  ip address [<address>]

Set the Internet address of this machine. Without argument, display  the
IP address. Dotted Decimal format should be used (eg 44.131.20.3).


2.34.2.  ip rtimer [<seconds>]

Set the IP Packet Reassembly timer. The default is  30  seconds  with  a
range  of  0..2^15.  Without  argument, display the current setting. The
rtimer is used to set a time to wait for TCP  or  UDP  frames  when  one
segment  has  been  received  but is incomplete. The incomplete frame is
buffered for a time equal to rtimer. If  the  next  part  of  the  frame
arrives,  the two parts are assembled into a whole and processed. If the
next part does not arrive before the  timer  runs  out,  the  buffer  is
cleared.


2.34.3.  ip status

Show IP statistics for this machine.


2.34.4.  ip ttl [<hops>]

Set the IP Time To Live (TTL) counter. Each IP switch forwarding  an  IP
packet  will  decrement  the  TTL  counter  as it passes through. If the
counter reaches zero, the packet is discarded. It is used as   a  safety
measure  to prevent packets from continuously circulating a network. The
default is 255 hops with a range of 0..255. Suggested value is 10 or  25
on AMPRNet.


2.35.  kick [<session_number>]

Forces a retransmission timeout on the given session (default session is
the current one if none given).



                                                                        



                                                                        


2.36.  log [<filename>|off]

If a filename is given, start logging to the given  file.  The  argument
"off"  closes  the  current logfile and stops logging. Without argument,
display the current logging setting (filename).


2.37.  lzw

Set and display parameters for use by the  LZW  data  compression  code.
This  provides  real  time  data  compression  in SMTP, NNTP and Convers
(xconvers).  Settings must be  set  before  any  connection  using  data
compression  are  made  in  order to be active for that session. Only in
exceptional circumstances should there be a need  to  diverge  from  the
default  settings.  SMTP and NNTP can communicate settings to each other
and therefore have to negotiate them, but XConvers cannot and  therefore
both ends must have the same settings to ensure compatibility.


2.38.  lzw bits [9..16]

Set the number of code bits used in  compression.  A  9  bit  code  word
results  in  loose compression whereas 16 gives tighter compression. The
default is to use 16 bit compression.


2.39.  lzw mode [compact|fast]

Set the data compression mode. The compact option (the default)  results
in  more  efficient  compression  but  takes  up more CPU time. The fast
option on the other hand is quicker but results in "looser" compression.


2.40.  mail

Shell out and start up the mailer program. The default is BM.EXE in  the
current directory. (See also the DOS "MAILER" environment variable).


2.41.  mbox

Display or set information used by the local mailbox (bbs).


2.41.1.  mbox attend [yes|no]

Allow mailbox users to connect to the system operator. Default  is  yes.
If  the  mailbox is not attended, a short message will be given to users
asking to chat to the sysop.


2.41.2.  mbox f...

These two commands are used to set fields in a BBS  standard  R:  header
which  is  prepended  to  mail  messages sent via AX.25 (bulletins or P-
mail).


                                                                        



                                                                        


The format of the R: header is as follows

R:YYMMDD/HHMMz <msg_no>@:<mycall>.<mbox_fnic> "["<mbox_finfo>"]" (WNOS4)

where <mycall> = "ax25 mycall" with any SSID (eg -5) removed.

the <mycall><forward nic>  part  should  therefore  generate  a  mailbox
hierarchical address. Note that this format of R: header is only used if
BOTH "mbox fnic" and "mbox finfo" are set. If neither  or  only  one  is
set, the format of the R: header is

R:YYMMDD/HHMMz @:<mycall>

Example: I set

mbox finfo "Bath, Avon"
mbox fnic "GB7WRW.#41.GBR.EU"

so my full hierarchical address appears as "G6DHU.GB7WRW.#41.GBR.EU"

Note that the leading dot in the "mbox fnic" string is no longer needed.


2.41.2.1.  mbox finfo [<info_string>]

This command is used to set the information field in mailbox R:  headers
added  to  mail  sent  to  AX.25 Mailboxes (BBS, PMS, PBBS etc). Without
argument, display the current info string. The  info_string  should  not
exceed 24 characters in length.


2.41.2.2.  mbox fnic [<NIC_string>]

This command is used to set the NIC field in mailbox R: headers added to
mail  sent  to  AX.25  Mailboxes (BBS, PMS, PBBS etc). Without argument,
display the current NIC string.  The  NIC_string  should  no  exceed  24
characters in length.


2.41.3.  mbox fkick

Start forwarding any pending AX.25/BBS mail.


2.41.4.  mbox ftimer [<seconds>]

Set the time interval between forwarding  AX.25/BBS  mail.  The  default
interval  is  0  (don't  forward  at all). Without argument, display the
current forwarding interval.


2.41.5.  mbox log [yes|no]

Log all mailbox activity to the file spool\node.log if enabled.  Default
is "no".



                                                                        



                                                                        


2.41.6.  mbox maxmsg [<number>]

Set the maximum number of messages allowed in any one mail  "area".  The
default  is  200 with a range of 0..200. A warning message will be given
if this limit is exceeded.


2.41.7.  mbox motd [<text>]

Specify some extra connect text to be sent out to  users  connecting  to
the  mailbox.  Without  argument,  display the current text. The text is
limited to 250 chracters including spaces.


2.41.8.  mbox more [yes|no]

If yes, then stop  after  every  page  of  output  whilst  reading  mail
messages via telnet connections only. The default is to "page" output.


2.41.9.  mbox remote [<hostname>]

Set or display the hostname to be connected to when a mailbox user types
the "chat" command.

This command is useful if the  station  is  remotely  sited  or  remains
unattended for long periods. Normally, a user typing the "chat" command,
will be connected to the console of the station. Setting  "mbox  remote"
allows the chat connection to be redirected to the chat port of the host
specified.  It is the "console equivalent"  of  the  mailbox  privileged
"xr" command.


2.41.10.  mbox status

Show information about the mailbox.


2.41.11.  mbox tiptimeout [<seconds>]

Set the timeout on connections to the mailbox using tip. The default  is
180 seconds.


2.41.12.  mbox user

Show information about users connected to the  mailbox,  what  they  are
doing and what connection method they are using.


2.42.  mem

Set and display information concerned with memory useage and allocation.





                                                                        



                                                                        


2.42.1.  mem freelist

Display a list of free memory areas administered by WNOS.


2.42.2.  mem garbage [yes]

Force a garbage collection.


2.42.3.  mem ibufize [<bytes>]

Set the size of the interrupt buffers to be used. The  default  is  2048
bytes  with  a  range of 1..32767. Without argument, display the current
size of the interrupt buffers. Values down to 512 bytes should be OK  on
asynchronous  (serial  port)  interfaces.  The setting of this parameter
should appear early in the AUTOEXEC.NOS file.


2.42.4.  mem nibufs [<number>]

Set the number of interrupt buffers to  be  used  by  the  program.  The
default is to use 8. Asynchronous (serial ports) may use a value of 2.


2.42.5.  mem reboot [yes|no]

If set to yes, when the program free memory ("coreleft" as shown by  the
"mem  status"  command)  drops  below  the limit set by the "mem thresh"
command, the program will exit and reboot the machine.  The  default  is
"no".


2.42.6.  mem record [<filename>|no]

if  a  filename  argument  is  given,  write  information  about  memory
allocations  to  that  file.  Switch it off with the "off" argument. The
default is "off". Only really useful for debugging purposes.


2.42.7.  mem sizes

Display a list of allocated memory blocks and their sizes.


2.42.8.  mem snap start

Writes a text representation of the current memeory useage. The filename
is   automatically  generated  and  displayed  (Note  it!).  Useful  for
debugging.


2.42.9.  mem status





                                                                        



                                                                        


Display general memory  statistics  (eg  free  memory  left,  number  of
garbage  collections  etc).  (From  v3a9_1)  This  command will show the
amount of Extended (XMS) memory used and free. WNOS4 does  not  use  XMS
memory  except  when the "swap" command is activated and there is enough
memory to swap into.


2.42.10.  mem thresh <value (bytes)>

Set the threshold for free memory below which the  program  will  refuse
any further incoming connect requests (and reboot if "mem reboot" is set
to "yes"). The default value is 12288 bytes


2.42.11.  mem usedlist

Displays a list of allocated (in use) memory areas.


2.43.  mkdir <directory_name>

Create a new subdirectory.


2.44.  mode <host> [datagram|vc|ipcam] <path>

Set the connection method and path used to reach the specified, directly
reachable host. Connection methods are

     datagram - Use AX.25 UI (broadcast) frames with a PID of "IP"
     vc       - Use a normal AX.25 connection with a PID of "IP"
     ipcam    - For use in networks that support just PID F0
                   (text only/no upper protocol)

If just the hostname is given, the mode (and path) used  to  reach  that
host is reported. IPCAM = Internet Protocol CAMouflaged.

The "ipcam" mode is  useful in networks such as TheNet where the Level 3
processor has been disabled and IP frames can therefore be passed across
such nodes using a "text only" PID of F0.


2.45.  more <filename>

View the given file (in a separate session) a page at a time. The "space
bar"  moves  down  a page, "q" quits and closes the session and Carriage
Return moves down 2 lines at a time. Each page is shown  with  the  "---
more---" prompt at the foot.


2.46.  motd [<text>]

Set the "Message Of The Day" text, sent out  to  all  connecting  users.
Without  argument,  just  display  the  current  motd.  The limit is 250
characters (including spaces).



                                                                        



                                                                        


2.47.  multitask [yes|no]

No longer implemented.


2.48.  netrom ...

Display and set information used by the NET/ROM network  protocol.  Some
abbreviations used in this section are;

destination - NET/ROM Callsign (eg G6DHU-5) or Alias (eg IP1403)

irtt        - Initial Round Trip Time

nrcb        - NET/ROM Control Block. The address of a memory area
              used to hold all information about a NET/ROM connection.
              Displayed with the "netrom status" command.


2.48.1.  netrom acktime [<seconds>]

Set the NET/ROM acknowledge timer. The default is 3 seconds.  This timer
is  like  the  T2 timer in AX.25 (see "ax25 t2") but operates at NET/ROM
Transport Level (Level 4).


2.48.2.  netrom bcnodes <iface> | <destination ...>

Force a nodes  broadcast  on  the  given  interface  and  to  the  given
destination  callsign  (default  "NODES").  It  is good practice to send
three routing broadcasts at switch on, so that local nodes will register
your   presence   immediately.   For   example,   the   last   lines  of
autoexec.nos...

netrom bcnodes 144
netrom bcnodes 144
netrom bcnodes 144

More than one destination for NET/ROM routing broadcasts may be set  per
interface. Use the AX.25 routing table to add routes via digipeaters.


2.48.3.  netrom connect <node_callsign|node_alias>

Make a Level 4 connection to the given node using the NET/ROM  protocol.
You must, of course, have a route to the given node.


2.48.4.  netrom choketime [<seconds>]

Set the NET/ROM Choke timer. This timer determines the length of time to
wait  before  breaking  a  choked  connection.  The  default  is 180 (15
minutes).





                                                                        



                                                                        


2.48.5.  netrom close <nrcb>

Disconnect the given NET/ROM Level 4 connection. Outstanding  frames  to
send  and/or acknowledge are first dealt with before disconnection takes
place.


2.48.6.  netrom derate [yes|no]

If yes, and Level-4 retries occur on a NET/ROM link, the quality of that
link  is  slowly  reduced. If one of the alternative routes to that node
then has a better quality, that route is tried instead.

If no, the normal NET/ROM  action  takes  place.  That  is,  alternative
routes  are  only  tried  if  the  link  layer to that node fails and no
reduction in node quality takes place.

The default is "yes".


2.48.7.  netrom interface <iface> <alias> <quality>

Set the alias and quality for the interface <iface> configured  for  use
as a NET/ROM node.

<alias> is the usual string of upto 6 characters and in  the  UK  it  is
recommended that IP nodes carry a unique alias denoting their IP address
subnet  numbers  in  hexadecimal.  For  example,  my   IP   address   is
44.131.20.3,  the important part is 20.3 (all UK users are 44.131). Then
convert the 20 and the 3 to hex (14 and 03 respectively)  and  construct
the alias

     IP1403

<quality>  is  the  default  quality  to  assign  to  incoming   NET/ROM
broadcasts.


2.48.8.  netrom irtt [<seconds>]

Set the IRTT Initial Round Trip Time to be used for NET/ROM connections.
Without  argument,  display  the  current  setting.  The  default  is 60
seconds.


2.48.9.  netrom kick <nrcb>

Kick (force a retransmission timeout) on the  connection  owned  by  the
given NET/ROM Control Block (nrcb).


2.48.10.  netrom minquality [<1..255>]

Set the minimum quality for a node to be included in  the  local  netrom
routing table.



                                                                        



                                                                        


2.48.11.  netrom nodefilter

Display the list of nodes that are the only  ones  used  in  determining
NET/ROM routing.


2.48.11.1.    netrom   nodefilter   add   <neighbour_callsign>   <iface>
[<quality>]

Add the specified node (directly reachable) to the nodefilter  list  via
the  given  interface. An optional quality can be specified and will set
the quality for broadcasts received from that node. The default value of
quality  if  not  specified  will  be that set in the "netrom interface"
command.

The nodefilter list should be used to filter nodes that either cannot be
heard by you but you can hear or vice versa.


2.48.11.2.  netrom nodefilter drop <neighbour_node> <iface>

Remove the given node from the nodefilter list.


2.48.11.3.  netrom nodefilter mode [none|accept|reject]

Set the mode for nodes in the node filter list.

     none    - No Filtering takes place (Ignore)
     accept  - Only nodes IN the nodefilter list are listened to.
     reject  - The only nodes NOT listened to are those in the
                  nodefilter list.

The default mode is "none".


2.48.12.  netrom nodetimer [<seconds>]

Set the interval between broadcasts of the local NET/ROM routing  table.
Without argument, just display the current setting. The default is 0.


2.48.13.  netrom obsotimer [<seconds>]

Set the interval between "ageing" each entry in the local routing table.
Nodes  having  an  obsolescence  count  of 0 are dropped from the table.
Without argument, just display the current setting. The default is 0.


2.48.14.  netrom promiscuous [yes|no]

If yes, the local node will  listen  to  all  routing  table  broadcasts
irrespective of the quality of that node. The default is "no".





                                                                        



                                                                        


2.48.15.  netrom qlimit [<1..4096>]

Set the number of bytes allowed in the NET/ROM receiver queue at any one
time.  If  more  arrive,  the  sending  node  is "choked" (asked to stop
sending for a while). The default is 2048 bytes.


2.48.16.  netrom reset <nrcb>

Reset (kill) the NET/ROM connection owned by the given  NET/ROM  Control
Block (nrcb).


2.48.17.  netrom retries [<tries>]

Set the number of times the node will attempt  a  resend  of  a  NET/ROM
Level 4 information frame. The default is to try 3 times.


2.48.18.  netrom route

List all known NET/ROM nodes (callsigns and aliases) to  which  a  route
exists.

The maximum number of nodes that may  be  accepted  and  listed  by  the
system is 150.


2.48.18.1.  netrom  route  add  <alias>  <node_call>  <iface>  <quality>
<neighbour_node>

Add a route to  the  given  node,  at  the  quality  specified  via  the
specified neighbouring node.


2.48.18.2.  netrom route drop <node_call> <neighbour_node> <iface>

Remove the given node from the local NET/ROM routing table.


2.48.18.3.  netrom route info <node_callsign>

Display  the  NET/ROM  routing  information  for  the  given  node.  The
information  displayed  is  Quality,  Obsolescence  count, Interface and
neighbour node.  Manually entered (Permanent) routes have a  Quality  of
"P".


2.48.18.4.  netrom route save [yes|no]

Display (or set) whether the NET/ROM routing table is  to  be  saved  to
disk  at  each  netrom  obsotimer  tick.  Routes  are  saved to the file
"NRROUTE.DAT" in the WNOS root. The default is "yes". If "yes", then  at
the next startup, the NET/ROM routing table is restored from disk.




                                                                        



                                                                        


2.48.19.  netrom status [<nrcb>]

Display information about users connected to this node via  the  NET/ROM
network.  Without  argument,  disply  summary status of all connections,
otherwise a detailed listing of the control block.


2.48.20.  netrom tcp

List those nodes known locally that are  likely  to  be  other  Internet
nodes (ones with the string TCP, NOS or IP appearing in the alias).


2.48.21.  netrom ttl [<hops>]

Set the Time-To-Live count for all NET/ROM frames originating from  this
node. Without argument, display the current setting.


2.48.22.  netrom user [<callsign>]

Set the callsign to be  used  when  making  an  outgoing  connection  to
another  node using the NET/ROM protocol (see "netrom connect"). Without
argument, just display the current callsign. The default is  taken  from
"ax25 mycall".


2.48.23.  netrom verbose [yes|no]

If yes, then broadcast all local routing information at each "nodetimer"
tick.  Otherwise,  just broadcast the existance of the local node. It is
recommended that users wishing to be part of the  NET/ROM  network,  but
only as an "end node", should set "netrom verbose" to "no".


2.48.24.  netrom window [<frames>]

Set the NET/ROM window size, which is negotiated by nodes on connection.
The default is 4 frames.


2.49.  nntp ...

Display or set information pertaining to  NNTP  (Network  News  Transfer
Protocol).

2.49.1.  nntp active

Show active newsgroups, articles within each group and "posting"  status
of each group.


2.49.2.    nntp   add    <server_hostname>    <seconds>    [hh:mm-hh:mm]
[<newsgroup>..]




                                                                        



                                                                        


Add the specified NNTP server to the list of servers used  to  poll  for
news.  The  server  will be polled for new news each specified number of
seconds. An optional list of newsgroups  to  retrieve  can  be  included
otherwise  all groups are checked at the given host. If the current time
is outside the limits specified by  the  optional  [hh:mm-hh:mm]  field,
then the server will not be polled for new news.

A wildcard "*" can be used in the <newsgroup> list. "!" can be  used  to
reject the offer of any newsgroups. For example;

nntp add g4otj 3600 ampr.*,!ampr.bbs,rec.humour.funny

Will poll the news server at g4otj  every  hour  for  new  news  in  all
newsgroups in the ampr hierarchy and rec.humour.funny but not ampr.bbs.


2.49.3.  nntp distrib [<distribution>,<distribution>...]

Display (or set) the limits for the distribution  of  locally  generated
news  articles.  The  set  of  distributions  is copied into the article
Distribution: header. For example, the most general distribution is  set
by

     nntp distrib world

or less general by

     nntp distrib uk,deu,fr

distribute to UK, Germany and France.


2.49.4.  nntp drop <server_hostname>

Remove the given NNTP server from the list of known news servers.


2.49.5.  nntp dump <newsgroup> [<mailbox>]

Dump the given newsgroup into  a  file  (in  spool\mail\)  suitable  for
reading  with  BM or PCelm. If the <mailbox> parameter is not given, the
mailbox name written to will  be  made  up  of  the  last  word  of  the
newsgroup and the usual .TXT suffix. For example, the command

nntp dump comp.binaries.ibm.pc.archives.wanted

will dump to the file spool\mail\wanted.txt.  If  the  mailbox  name  is
given, that is used instead.


2.49.6.  nntp fullname [<text>]

Set your name (appended to your From: article header). Use double quotes
to include spaces in the name eg

     nntp fullname "Mike Chace"


                                                                        



                                                                        


2.49.7.  nntp hostname [<hostname>]

Set the hostname of your news posting machine. Defaults to the  same  as
that set by the "hostname" command.


2.49.8.  nntp ihave [0|1|2]

Display (or set) whether client routine is allowed  to  offer  new  news
articles  to  the  current  server. The default is 0. 0 means switch off
IHAVE operation, 1 means only offer news in the groups polled for and  2
means  offer  any  new  news  with  IHAVE. Two servers communicating are
recommended to use "2" for fast turnaround of new news.


2.49.9.  nntp kick <server_hostname>

Immediately go and check the given news server for new news.


2.49.10.  nntp list

List the known NNTP servers to get news from.


2.49.11.  nntp lzw [yes|no]

Set whether LZW data compression is to be used  when  transferring  NNTP
news articles. The default is "no".


2.49.12.  nntp maxclient [<number>]

Display (or set) the maximum number of clients that  may  simultaneously
be connected to your NNTP server. The default is 3.


2.49.13.  nntp organ [<text>]

Specify the text to be included as an  "Organization:"  header  in  news
articles posted locally. Use double quotes if you need to include spaces
in the text.


2.49.14.  nntp post

Post an article to  a  newsgroup  (interactive  -  starts  an  NNTP-Post
session).


2.49.15.  nntp quiet [0|1|2|3]

The analogue of the 'smtp quiet'  command.  If  new  news  articles  are
received  by  the  NNTP  server, a message and beep will be sounded (0),
just a message (1), nothing at all (2) or (3) put message  in  log  file
(if there is a log file set by the "log" command). The default is 0.


                                                                        



                                                                        


This also applies to SMTP messages transferred to NNTP by the  SMTP/NNTP
Gateway.


2.49.16.  nntp read <newsgroup> [<message_number>]

Start  an  NNTP  Newsreader  session,  reading  news  in  the  specified
newsgroup.  If <message_number> is specified, then use that as the first
article to read in that group. Details of news articles read are kept in
the NEWS.RC file.


2.49.17.  nntp reply [<user@host>]

Set the path for inclusion in the "Reply-To:" article header. Note  that
user@host  notation  *must*  be  delimited  by  angle  brackets when the
command is given. For example

nntp reply "<mikec@praxis.co.uk>"


2.49.18.  nntp signature [<filename>]

Specify the location of the "signature"  file  to  be  appended  to  all
locally  posted  news  articles.  If  a  path  is not given, the file is
searched for in the /spool/signatur/ directory.


2.49.19.  nntp user [<username>]

Set your NNTP username.


2.49.19.1.  Example NNTP profile

Here is the NNTP profile in use at g6dhu.ampr.org

nntp distrib uk
nntp signature c:/tcpip/spool/signatur/g6dhu.sig
nntp reply "<g6dhu@g6dhu.ampr.org>"
nntp organ "84 Frankland Close, Bath, Avon, BA1 4EL"
nntp user g6dhu
nntp fullname "Mike Chace"
nntp hostname g6dhu


2.50.  param <iface> [<param>....]

Send control string to the given interface (usually used to set up a TNC
in KISS mode at startup).


2.51.  ping <host> [<length> [<interval> [<incflag>]]]





                                                                        



                                                                        


Send an ICMP "Echo Request" (ping) packet to the given  host. Pings  are
used  primarily  to  measure  the round trip time to other IP nodes. The
optional arguments do the following

        <length>   - Send a text portion of length <length> bytes in the
                     message.
        <interval> - Repeatedly ping the given host every <interval>
                     seconds. This starts a session which can be entered
                     and exited just like any other.
        <incflag>  - Increment the destination address at each attempt.
                     This is useful for checking how many hosts are up
                     in a given cluster.



2.52.  pop

Display and set information used by the Post Office Protocol (POP).  POP
is  a  "mail  collection"  service. Your mail is stored at a remote host
(the mailhost) until you request it be sent to you using POP. It is then
stored locally on your machine just as normal mail does.


2.52.1.  pop mailbox [<file>]

Specify the name of the your mailbox file at the POP host.


2.52.2.  pop mailhost [<host>]

The domain name of the machine that holds your mail for you.


2.52.3.  pop kick

Force a poll of the  mailhost  to  see  if  new  mail  has  arrived  for
collection.


2.52.4.  pop quiet [0|1|23]

Succesfully collected mail messages are notified with beep  and  console
message  (0),  no  beep  but  message  (1), no notification (2) or put a
message in the logfile (3) providing that "log" has set a log file.  The
default is 0.


2.52.5.  pop timer [<seconds>]

Set the interval between which the mailhost is polled for new mail.


2.52.6.  pop userdata <username> <password>





                                                                        



                                                                        


Set your username and password for accessing POP at  the  mailhost.  NB:
These are defined in the file POPUSERS at the mailhost.


2.53.  ps

Show information about all processes on the system.


2.54.  pwd [<dirname>]

Change the current working directory. Without argument,  just  show  the
current working directory. Like the "cd" command without argument.


2.55.  record [[<session>] <filename>|off]

Copy all input and output from the given session into the given file. If
no  session is given, the default one is assumed. Record can be switched
off at any time by using the "record  <session>  off"  or  "record  off"
commands.


2.56.   remote  [-p  <port>]  [-k  <key>]  [-a  <kick_addr>]   <address>
exit|reset|kick

Remote control the host at the given address  using  the  User  Datagram
Protocol  (UDP).  The  remote host can have connections reset, kicked or
the program stopped. Example;

remote -a 44.131.20.3 <host> kick

Would kick all connections with 44.131.20.3 at the remote host.


2.57.  rename <old_filename> <new_filename>

Rename a file.


2.58.  reset [<session_number>]

Reset (kill) the given session, or the current one if none is specified.
Note  that  this  does  not  "gracefully"  disconnect  a  session and is
primarily used to kill connections to crashed hosts etc.


2.59.  resetping <host>

Stop the setping session to the given host.


2.60.  rmdir <directory_name>





                                                                        



                                                                        


Delete the given sub-directory.


2.61.  route ....

Display and set routing information used by the Internet Protocol (IP).


2.61.1.  route add <host>[/bits] <iface> [<gateway_host> [<metric>]]

Add an IP route to the given host via the given interface. The route can
be via an optional IP switch (gateway). The optional metric is redundant
unless routing protocols are in use (RIP, RSPF etc).


2.61.2.   route   addprivate   <host>[/bits]   <iface>   [<gateway_host>
[<metric>]]

As "route add ..." except that route will be marked as private  and  not
propagated through any routing protocol.


2.61.3.  route drop <host> <iface>

Remove the specified host from the IP routing table.


2.61.4.  route flush

Flush all temporary routes from the IP routing table.


2.61.5.  route lookup <host>

Display the route to the given host.


2.62.  save [<seconds>]

Display or set the interval  between  saving  the  IP,  ARP,  AX.25  and
NET/ROM  routing  tables  to disk. The default is 0 (do not save routing
tables to disk).  Recommended value is  7200  seconds  (save  every  two
hours).


2.63.  sccstat

Show statistics about the connected SCC driver.


2.64.  session [<number>]

Without argument, display  a  list  of  all  currently  active  sessions
together  with  information  such as the size of send and receive queues
and the type of session (TCP, AX25 etc). The current default session (ie
the  one displayed if "RETURN" is pressed) is shown with an asterisk "*"


                                                                        



                                                                        


at the start of its entry.


2.65.  setping [<host> <interval>]

Send an ICMP "Echo Request"  (ping)  packet  to  the  given  host  every
<interval>  seconds. This is useful when operating in an RSPF controlled
IP network to inform RSPF gateways of your existance. In the UK version,
setping  waits  300 seconds for a ping reply before derating the quality
of that host.

Without argument, display the routing quality  table  for  each  setping
host.

The routing status  each  host  is  determined  simply  by  attaching  a
notional  quality based on the number of "ping replies" received to that
sent. Routing quality is shown as;

"Good"    - Routing OK
"Suspect" - Routing has failed on some occasions
"Bad"     - Routing Failed (Host probably down)


2.66.  shell

Start an interactive DOS session. Synonym for the "!" command.


2.67.  smtp ...

Display and set information used by SMTP (Simple Mail Transfer Protocol)
used to send electronic mail between IP nodes.


2.67.1.  smtp batch [yes|no]

If yes, send as many SMTP commands in one frame as possible.  Otherwise,
always send one command at a time and wait for the response. Please note
that this command *is not* compatible if you send  mail  using  SMTP  to
systems running MSYS - tell the MSYS operator to start running something
decent! If you operate with MSYS nodes set "smtp batch" to "no" which is
the default.


2.67.2.  smtp delete <job_number>

Kill a pending mail job (see "smtp list" for getting the job number).


2.67.3.  smtp gateway [<host>]

Set the host to send mail to if the destination address is  not  locally
known or resolveable.





                                                                        



                                                                        


2.67.4.  smtp kick [<host>]

Start the SMTP server sending any pending outgoing mail. If  a  hostname
is  supplied,  kick  out  any  mail waiting to be delivered to that host
only.


2.67.5.  smtp list

List information about all pending mail jobs. These are indexed by  Job-
ID (a unique number for each job).


2.67.6.  smpt lzw [yes|no]

Set whether LZW data compression is to be used  on  sending  mail.  WNOS
SMTP  will always negotiate three things when "smtp lzw" is enabled; the
"lzw bits" setting, the "lzw mode" and whether the remote host can  deal
with   compressed  mail.  WNOS3  and  WNOS4  are  incompatible  in  this
negotiation! The default is not to attempt use of compressed mail.


2.67.7.  smtp maxclients [<clients>]

Set the maximum number of outgoing SMTP connections allowed at  any  one
time.  The default is 10.


2.67.8.  smtp mode [route|queue]

Set the SMTP server mode. If route, all mail  jobs  are  queued  in  the
spool/mqueue/  directory  and sent out. If queue, mail jobs are not sent
but are queued for delivery in the spool/rqueue/  directory  (for  other
mail sending programs to access). The default is to route mail.


2.67.9.  smtp quiet [0|1|2|3]

Notify incoming mail deliveries with beep and message (0), no  beep  but
message  (1),  do  nothing  (2) or put a message in the logfile (3). The
default is 0.


2.67.10.  smtp timer [<seconds>]

Set the interval between sending out pending mail. Default is  0  (don't
deliver  mail).  Note  that  this  timer setting has no effect upon mail
waiting to be forwarded  by  the  Store  &  Forward  system  (see  "mbox
ftimer").


2.67.11.  smtp trace [0|1]

Trace SMTP "conversations"  between  hosts.  The  default  is  0  (don't
trace).



                                                                        



                                                                        


2.68.  socket [<number>]

Display information about the process/connection using the given socket.
Without  argument,  the  command  lists  all  active  sockets  and  type
information.


2.69.  source <filename>

Read in and execute the given command file in the current  directory  if
no path spec is given.


2.70.  start <server_name>

Start the given server.


2.70.1.  start ax25

Start the AX.25 server allowing incoming  connections  to  the  mailbox.
Note  that  even if not started, IP connections using VC mode will still
be accepted.


2.70.2.  start chat (or "start ttylink")

Start the chat port server on TCP port 87. Allows conversations with the
sysop to be made (providing "attended" is set to "yes").


2.70.3.  start convers

Start the convers (Round Table Conferencing system) server on  TCP  port
3600.  (see also "start xconvers").


2.70.4.  start discard

Start the discard server on  TCP  port  9.  This  is  used  for  testing
purposes and swallows any frames received, sending only a TCP ACK back.


2.70.5.  start domain

Start the domain name server on UDP port 53. Used to query details about
domain  names.  It  is  not  necessary  to  start this server unless you
provide a Domain Name Service (DNS) to other hosts.


2.70.6.  start echo

Start the echo server on TCP port 7. This is the opposite of the Discard
server and echoes back all received frames to the sender. Again used for
testing.



                                                                        



                                                                        


2.70.7.  start finger

Start the Finger server on TCP port 79. used  for  querying  information
about the users of a given host.


2.70.8.  start ftp

Start the FTP server on  TCP  ports  21  and  20.  Allows  files  to  be
transferred to and from the host.


2.70.9.  start netrom

Start the NET/ROM Level3/4 server. Allows other NET/ROM nodes to connect
to  the  mailbox  using NET/ROM Level 4 connections and for TCP/IP to be
received over NET/ROM's Routing (Level 3) service.


2.70.10.  start nntp

Start the NNTP server on TCP port 119. Allows transfer of network news.


2.70.11.  start pop

Start the POP server on TCP port 109. Allows mail to be collected from a
remote mail server.


2.70.12.  start remote

Start the remote server on UDP port 1234. Allows remote control of other
hosts.


2.70.13.  start smtp

Start the SMTP server on TCP port 25. Allows exchange of electronic mail
between hosts.


2.70.14.  start telnet

Start the Telnet server on TCP port  23.  Allows  connections  to  other
hosts to be made.


2.70.15.  start ttylink

See "start chat".







                                                                        



                                                                        


2.70.16.  start xconvers

Start the XConvers Round Table Conference server on TCP port 3601.  Does
the same as convers but deals with LZW compressed traffic.


2.71.  status

Display program startup and run time information.


2.72.  stop <server_name>

Stop the named server.


2.73.  swap [yes|no]

If yes, swap the WNOS image out  to  disk  or  EMS/XMS  RAM  (if  enough
available) when shelling to DOS (eg "shell", "!" or "mail"). The default
is not to swap.


2.74.  sysop <00001..99999>

Set the sysop password key  for  remote  access  from  the  mailbox  "@"
command.


2.75.  tail <filename>

Display the last few lines of the given file.


2.76.  tcp ...

Display and set information used by TCP (Transmission Control Protocol).
Some abbreviations used below are;

irtt - Initial Round Trip Time

tcb - TCP Control Block, holds information about a TCP connection.


2.76.1.  tcp close <tcb>

Close (disconnect) the stream owned  by  the  given  TCP  Control  Block
(tcb).


2.76.2.  tcp irtt [<milliseconds>]

Set the Initial Round Trip Time used to time TCP  retransmissions  (this
is  later  set dynamically by measurement as the connection progresses).
The default is 5000 (5 seconds) with a range of 0..2^15.



                                                                        



                                                                        


2.76.3.  tcp kick <tcb>

Kick (force a retransmission timeout) of the stream owned by  the  given
TCP control block.


2.76.4.  tcp mss [<bytes>]

Set the TCP Maximum Segment Size (MSS). The default is 512 bytes with  a
range of 0..65535.


2.76.5.  tcp reset <tcb>

Reset (kill) the TCP stream owned by the given TCP control block.


2.76.6.  tcp retry [<tries>]

Set the number of TCP retries before putting a TCP session  "to  sleep".
A  value of 0 disables this feature, the default if 5 tries with a range
of 0..255. The number of retries attempted  depends  on  the  connection
state;

ESTABLISHED - "tcp retry" * 5
FIN_WAIT_1  - "tcp retry" * 5
others      - "tcp retry"


2.76.7.  tcp rtt <tcb> <milliseconds>

Set the (normally dynamically adjusted) Round Trip Time (RTT)   for  the
TCP stream owned by the given TCP control block.


2.76.8.  tcp status [<tcb>]

Without argument,  display  a  summary  of  statistics  for  active  TCP
streams.

With the address of a TCP control block, show detailed information about
that stream.


2.76.9.  tcp syndata [yes|no]

If yes, TCP will not wait for the formal 3-way  handshaking  during  the
connection  phase of a TCP conversation and is allowed to send data with
the SYN "connect request" frame.

If no, TCP waits for the normal 3-way startup handshake  before  sending
any data.

Please note that if you talk to MSYS nodes, set this command to "no"!




                                                                        



                                                                        


2.76.10.  tcp trace [0|1]

Show detailed information about the TCP server activity if set to 1. The
default is 0.


2.76.11.  tcp window [<bytes>]

Set the receiver TCP window size. The default is 2048 with  a  range  of
0..65535.


2.77.  telnet <host> [<port>]

Start a telnet connection to the given host (and using the optional port
number  at  the  remote host). The default port is the telnet port (23).
The remote server will greet you and  you  will  be  required  to  login
before access to the remote mailbox is granted.


2.78.  thirdparty [yes|no]

If yes, allow local handling of third party  mail.  The  default  is  to
allow third party mail.


2.79.  tip <iface>

Start a raw ASCII session across the given interface. Kill  the  session
with a "reset".


2.80.  trace [<iface> [<BTIO> [<filename>]]]

Enable the TRACE screen  (Press  F9  to  select  it)  and  trace  packet
activity.   Trace  information  can  be  dumped to a named file (and the
printer (LPT1)).  The trace flags are

     B -> 0 = Trace all packets, 1 = Trace only those with your address
     T -> 0 = Headers only, 1 = Data in ASCII, 2 = ASCII & Hex Data
     I -> 0 = No incoming packets, 1 = Incoming packets
     O -> 0 = No outgoing packets, 1 = Outgoing packets


2.81.  udp status

Show statistics about User Datagram Protocol (UDP) frames handled.


2.82.  upload [[<session_number] <filename>|off]

Send the contents of the given file out on the given session  as  if  it
had  been  typed  at the console. Switch uploading off by specifying the
"off" keyword.




                                                                        



                                                                        


2.83.  wrap [<line_length>]

Set the maximum line length, after which a further space and  word  will
automatically  wrap  the  line,  with  the  first portion being sent out
automatically. The default wrap size is 72 with a range of 0...132.


2.84.  write <socket_number> [<socket_number>...] <text>

Send the specified text string out on all given sockets.


3.  WNOS DOS Environment Variables

WNOS reads the following DOS environment variables. These should be  set
using the DOS Batch File "SET" statement.


3.1.  TZ

Timezone. Note  the  CAPITAL  TZ!  Sets  the  timezone  to  be  used  in
timestamping  outgoing mail messages and for adjusting the machine clock
time to a local time. For example

     set TZ=GMT+0UTC

GMT is the "official" inital  timezone  name.  By  official,  I  mean  a
recognised name eg PST, UTC, CET etc.

+0 is the difference from the initial timezone.

UTC is the real (local machine ) timezone name.

For a UK example...

     set TZ=GMT+1BST

Meaning BST is GMT plus one hour.

The timezone string itself (UTC, BST, GMT etc) that you set is  used  to
stamp mail messages with the time when they were processed.

If "TZ" is not set, WNOS assumes a German timezone setting of  UTC,  one
hour behind the machine time (UTC-1UTC).


3.2.  MAILER

Set the name and location of the  mail  program  called  by  the  "mail"
command

     set MAILER=c:\tcpip\pcelm30.exe






                                                                        



                                                                        


If "MAILER" is not set, WNOS assumes that the mailer is "BM.EXE" in  the
current directory.


3.3.  COMSPEC

Used when the swap function is active to determine the name of  the  DOS
command  interpreter  to run. The default (COMMAND.COM) should be OK for
almost all users as  this  is  the  name  of  the  standard  DOS  comand
interpreter.


3.4.  TEMP

Used to determine where the program image will be swapped to when "swap"
is active. The root disk is probably best eg

    set TEMP=C:\


4.  Bug Reports

Please send any bug reports on this document (errors, omissions etc) and
I will fix it in the next release.

I can be reached in the following way

        NTS Mailbox - G6DHU @ GB7IMB
        Internet    - mikec@praxis.co.uk
        AMPRNet     - mike@g6dhu.ampr.org [44.131.20.3]
        Snail Mail  - Mike Chace
                      84 Frankland Close
                      Bath,  Avon
                      BA1 4EL

73 and enjoy WNOS4!

Mike - G6DHU




















                                                                        



                                                                        


5.  Change Log

08 May 1992 (WNOS 4a3) - 1st version.

29th May 1992 (WNOS 4a6/7) - 2nd version.