JNOS Commands Manual - The C Commands

The C Command Set

callserver hostname [<hostname>]

     Sets the host address of the system to be querried by the "callbook"
or mailbox "Q" command. The specified server system responds at tcp port
1235.  <hostname> may be that of the local system if a server has been
started with the "start" command. See the "readme.now" file for further
information that pertains to QRZ, SAM, and Buckmaster cdrom databases.



comm <asy_iface> <"text_string">

     Sends "text_string", followed by a CR character, to the specified
asynch interface.  Normally, this command is used to place a TNC into
KISS mode when JNOS is started, but it may also be useful to send AT
commands to attached phone modems.

Example 1:  Ensure kiss mode is on:
     comm tnc "kiss on" 
     comm tnc "restart" pause 4 param tnc txdelay 10

Example 2:  have telephone modem answer on first ring:
     param dialup up comm dialup "atz e0 s0=1" pause 2 start tip dialup
     modem 360



connect <iface> <destination> [<digi1,digi2...digi3>];

     Initiate an ax25 connection at interface <iface> to
<destination>. Use the "ports" command when in the mailbox or
mailboxto discover the proper id of <iface>.  <destination> may be
either callsign-ssid or an alias. Note that there is only a 'space'
between <destination> and <digi...>.

     Examples:

      c ax0 n5knx-2   -> connect to n5knx-2 on port ax0


convers <subcommands>

     These commands configure the network conference server.


    convers channel [<default_chan_number>]           Default: 0

     Displays or sets the default channel number, that is, the initial
     channel to which new users are assigned.

        convers channel 2


    convers drop [<addr>]

     Drop the remote convers link to <addr>.  See also 'convers link'.
     If <addr> is not given, all links are dropped.

        convers drop 44.26.1.19


    convers filter                           Default: refuse (nobody)

     Set how the convers node will respond to connect requests.

       convers filter mode [accept | refuse]

        Sets or displays the filter mode.  'filter mode accept' allows
        links from only the hosts in the filter list.  'filter mode
        refuse' allows links from all hosts except those in the list.

       convers filter [ipaddress | hostname]

        Builds the filter list used in conjunction with the 'convers
        filter mode' command.


    convers host <name>

     Displays or set the convers hostname as will be used when announcing
     the system to conference users or remote links. Maximum length is
     10 chars, but if you want to stay compatible with JNOS.EXE based
     convers servers use a maximum of 8 character for the convers host
     name (unless the system runs JNOS-v1.04 or later).

     If the 'hostname' gets set and the 'convers host' isn't set yet,
     it will be set to the first 10 chars of the 'hostname'. After this,
     if any sub domains (i.e. periods) exist in the hostname, the convers
     hostname will be terminated at the right-most period.  e.g. If
     'converse host' is not set, and 'hostname jnos.wg7j.ampr.org'
     is given, then after this the converse hostname will be 'jnos.wg7j'.

         convers host Corvallis


    convers interface [<iface>] [on|OFF]

     Displays or sets the active convers interfaces. This command needs
     to be given for each interface that which will allow connections
     to the conference call (see 'convers mycall'); e.g., this command
     can be used to allow conference call access only on the user ports
     but not on the backbone/linking ports. This can also be useful
     to avoid confusion when different nodes have the same conference
     call. (Locally, we use the call 'QSO' for the conference server
     for different nodes, and ran into problems when a user tried to
     connect to it from a backbone node. All of a sudden two nodes were
     answering the connect!)  Default is off.

          convers interface port1 on


    convers  link [<addr> [port] [name]] 
    convers xlink [<addr> [port] [name]]

     If no <addr> is given, display the list of linked nodes with
     link status and statistics indicated. If <addr> is given, add
     a convers link to another (remote) conference server. The link
     is LZW-compressed if xlink, instead of link, is specified (and
     XCONVERS was #define'd at compile time).

     <addr> is the ip address or hostname of the remote server to which
       to link.
     [port] is the tcp port number to use for the server connection.
     [port] defaults to 3600 if the link command is used, and 3601 if
       the xlink command is used.
     [name] is the optional name that will show up in the links
       listing shown with the '/links' command if the link has not
       yet been established. [name] can be a maximum of 10 characters;
       the first character must be a non-integer.

     After the link has been established, the name will be set to the
     name with which the remote system introduced itself.

        convers link 44.26.1.19 Testing


    convers [u|h]maxq [<bytes>]

     Display or set the upper limit for the number of bytes that can
     be queued up waiting for transmission on a connection to another
     server. If there is more data than this limit, the connection to
     the other server will be closed.

     You are able to set individual limits for users and hosts with
     'convers hmaxq' and 'convers umaxq'. If set to 0, there is no limit,
     otherwise connections will be reset if there is more than the
     []maxq value data outstanding on the connection.  The connections
     will be RESET instead of gracefully closed.

     Default values are umaxq of 1024 and hmaxq of 5120.  Note that any
     changes will only affect new connections, not existing connections.


    convers maxwait [<seconds>]                     Default: 10800

     Display or set the upper limit for the time the system will wait
     to reestablish a disconnected convers link that originated at this
     system. Time is given in seconds.

        convers maxwait 600


    convers motd [<"yourmessage">]

     Set or show the message of the day for the convers server.
     This message is displayed when users connect to the server. NOTE:
     this option is obsolete in recent convers implementations. Instead,
     the contents of the file /spool/convmotd.txt are displayed. This
     filename can be changed by setting the ConvMotd string in nos.cfg.

    convers mycall <mycall>

     Display or set the 'conference call'.  <mycall> is a separate
     ax.25 callsign. If set, users can connect to it to get immediately
     connected to the conference bridge. However, each port or interface
     that this call should be allowed on should be enabled with the
     'convers interface' command. Conference call connections bypass the
     regular node interface. This is independent from the settings of
     'mbox convers' or whether the network conference server has been
     started. See also 'convers t4'.

        convers mycall QSO


    convers online [long | call | @host]

     Display a list of convers users known to the convers server.
     This is the same report as a /who listing made from within the
     convers facility. The default report is a "quick" format listing
     of the connected users. The "long" option specified a long-format
     report, which can be restricted to a particular "call" or "host".

     Example:  conv on @luzana   -or-   conv on wu3v   -or-   conv on


    convers setinfo [yes | NO]

     Display or the set the ability of conference users to change their
     personal info as stored in /finger/dbase.dat.  This sub-command
     is only available when CNV_CHG_PERSONAL was #define'd when JNOS
     was compiled.


    convers t4 [<seconds>]                           Default: 7200

     Display or the set the conference call connection T4 timer.  t4 is
     the 'redundancy timer' for ax.25 connections to the conference
     server.  This allows you to set a different inactivity time-out for
     ax25 node and conference connections. Default is 7200, i.e. 2 hours.

        convers t4 900


    convers tdisc [<seconds>]                           Default: 0

     Display or the set the conference call general redundancy timer that
     applies to all connections to the conference server. Connections
     which are idle longer than <seconds> will be disconnected.
     Default is 0, i.e. disable idle timeouts.

        convers tdisc 1200



    Files used by the convers facility:
     Keyword       Default value        Usage
     ConvMotd      /spool/convmotd.txt  Connect greeting.
     Cinfo         /finger/dbase.dat    Convers user personal info
     Cinfobak      /finger/dbase.bak    Previous Cinfo file (after
      update) 
     Channelfile   /spool/channel.dat   Channel number to name mapping 
     --            /spool/help/convers.hlp Help file (/help command)

    Cinfo line format:  <name|call> <personal data, i.e., QTH, etc.>
    Channelfile line format: <channel_number> <channel_name>


    Note: Converse users often wonder why the /help report is not
    complete. This is because the default compilation options for
    convers.c include "noblocking".  This results in JNOS dropping data
    destined for any output queue that exceeds certain length limits, and
    thus ensures that JNOS will not run low on buffer space due to the
    inability of a slow RF link to process the output queue fast enough.
    The limits at which lossage occurs depends on how a user connects to
    JNOS: telnet users are limited by the tcp window size, ax.25 users
    are limited by the JNOS 'ax25 window' setting, and the local console
    is limited by the LOCSFLOW constant (2048).  The convers.c source
    could be edited to #undef noblocking, and recompiled in an attempt
    to rectify this limitation, but (worse?) instability might result!