home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / programme / trionbbs110 / Trion / docs / Utils / trion.doc < prev    next >
Encoding:
Text File  |  1998-10-06  |  4.6 KB  |  186 lines
  1.  
  2.  
  3.  
  4.    =====( Trion V1.10 )===============================================
  5.  
  6.  
  7.         Trion Commander Utility.
  8.  
  9.         (c) Copyright Paul Spijkerman, '94-'98. All rights reserved.
  10.  
  11.         Written for use with the Trion BBS package.
  12.  
  13.  
  14.    ===================================================================
  15.  
  16.  
  17.    This is a little Utility to send command's to one, some or
  18.    all BBS nodes.
  19.  
  20.    This is very convenient if you want to controle your BBS with scripts.
  21.  
  22.    For example, you can call out to a system for mail just by
  23.    typing 'trion -c -1 14:103/204' in a shell window.
  24.  
  25.  
  26.  
  27.  
  28.    These commands area very usefull if you use a 'cron' utility that
  29.    spawns programmas or scripts to start processing mail or to
  30.    call to your mail HUB/HOST.
  31.  
  32.    With the trion utility you can also Warn a user that it's about time
  33.    to log him so you can poll for your mail.
  34.    Also you can force logoff this user with this utility.
  35.  
  36.    For examples look in the 'trion:scripts/' directory.
  37.    For instance the PollHub script where first a user is
  38.    warned that the system will call out in a few minutes,
  39.    later he will be disconnected and the system will call out.
  40.    Also there is some explanation of options in this file.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.    ===( 'TRION' use of commands  )=============
  48.  
  49.  
  50.    First you have to specify to which nodes the commands will be
  51.    send:
  52.  
  53.  
  54.    -0 .. -9   = Send message to nodes.
  55.    -A         = Send message to all nodes.
  56.  
  57.    If you don't specify a BBS node number .. the utility will send a
  58.    command to node 0.
  59.    You can send commands to more nodes at once by using a
  60.    list of numbers:
  61.        for instance:   trion -0 -1 -2  ............
  62.        or              trion -124      ............
  63.    Or you can send commands to all BBS nodes (Node 0 to 9)
  64.        for instance:   trion -A        ............
  65.  
  66.  
  67.  
  68.  
  69.    You can use an optional command to make the utility quiet.
  70.    
  71.    -X         = Quiet operation.
  72.  
  73.  
  74.  
  75.  
  76.    Then you have to specify a command:
  77.  
  78.  
  79.     -C       = Make FidoNet call.
  80.     -N       = Make FidoNet call (no mail pickup).
  81.     -H       = Make FidoNet call (only main address).
  82.     -M       = Send node message.
  83.     -Q       = Quit a node.
  84.     -L       = Logoff a user.
  85.     -P0      = Serial Port Off.
  86.     -P1      = Serial Port On.
  87.     -I0      = Don't accept calls.
  88.     -I1      = Accept calls.
  89.     -U0      = Sysop not available.
  90.     -U1      = Sysop available.
  91.     -S       = Sysop login.
  92.     -O       = Normal login.
  93.     -V0      = Modem sound Off.
  94.     -V1      = Modem sound On.
  95.     -F0      = Freq's not allowed.
  96.     -F1      = Freq's are allowed.
  97.     -W0      = Iconize a node.
  98.     -W1   -D = DeIconize a node.
  99.  
  100.  
  101.  
  102.    Note:  The -C, -N and -H commands are followed with a nodenumber.
  103.           The -M command is followed by a line of text to
  104.              send to nodes, place text between "" if you want
  105.              to use spaces in the text.
  106.  
  107.    Note:  You can write multiple characters after a '-' sign.
  108.  
  109.           Like:   'Trion  -246MX  Test'
  110.  
  111.           To send text "Test" quiet to nodes 2, 4 and 6.
  112.  
  113.  
  114.  
  115.  
  116.    ===( 'TRION' utility. Some examples of use.  )=============
  117.  
  118.  
  119.  
  120.    Send a line of text to a BBS node:
  121.  
  122.    trion  -1      -x  -m  "Hello, some one there ? .."
  123.    trion  -0 -1       -m  Test
  124.    trion  -a      -x  -m  "system slows down due to mail processing"
  125.  
  126.  
  127.    You can use this in a menu to send a message to all nodes that a
  128.    User is loged in on an other node (in quiet mode).
  129.    Add the folowing line to the 'trion:menus/start.src' directly
  130.    before all 'GotoMenu main.menu' lines:
  131.  
  132.    DosCommand  "trion:utils/trion -max 'User ~200 logged in on node ~50.'"
  133.  
  134.    Note that the '' are translated by the menu compiler to "" characters.
  135.  
  136.  
  137.  
  138.  
  139.    Call a BBS to deliver or get mail:
  140.  
  141.    trion  -1  -c  14:103/204
  142.  
  143.    Note: This will only work when there is mail for the called system
  144.    in the trion:outbound/ directory.
  145.    When there is no mail you can create a poll packet with the 'poll'
  146.    command like this:
  147.  
  148.    Poll 14:103/204
  149.  
  150.  
  151.  
  152.    This command logs the sysop in wihout deIconizing with the mouse
  153.    and the need to type in his name and password.
  154.  
  155.    trion  -0  -s
  156.  
  157.  
  158.  
  159.    This command stops and removes a node from memory.
  160.  
  161.    trion  -0  -q
  162.  
  163.  
  164.  
  165.    This command Logs off a User from node 0.
  166.  
  167.    trion  -0  -l
  168.  
  169.  
  170.  
  171.    You can do strange things with the message command as an
  172.    example how you can use it very creative with tilde codes
  173.    a little example (maybe not very practical):
  174.  
  175.    If you add the folowing line to a Crontab or a scheduler
  176.    you could make a clock .. if it was run for instance
  177.    every 5 or 15 minutes.
  178.  
  179.    trion -m -a -x "Hello ~200, it's now ~252."
  180.  
  181.    Users are shown something like: 'Hello Sysop , it's now 20:30:00'
  182.  
  183.  
  184.  
  185.  
  186.