ARexx scripts
-------------

Reflex  has  got an ARexx port and this naturally means you can communicate
with Reflex through this port. The port is named 'REFLEX'.

Reflex  has  got  a very important feature and that is ARexx locking. ARexx
locking  means  you  lock the ARexx port so only your script can access the
port.  Two  ARexx  scripts being executed at the same time could cause some
nasty  consequences  - ARexx locking prevents this. ARexx locking should be
used  by  all scripts. Please read the 'OWNERSHIP' section and the commands
associated with ARexx locking in the ARexx documentation.

You  will  find  the  ARexx  documentation as 'Reflex.ARexx.doc'. The ARexx
commands are documented in an autodoc faschion.

If  you  are to write ARexx scripts I recommend you read the --background--
part of the 'Reflex.ARexx.doc' before starting.

This  directory  contains  a  few  sample ARexx documents. Especially worth
noticing  is  the  'Skeleton.flex'  script.  You can use this script as the
skeleton  for your own ARexx scripts for Reflex. It shows how you use ARexx
locking in your own script.

ARexx scripts included:

  Skeleton.flex    - shows how to use ARexx locking. Use this as a skeleton
                     for your own scripts.

  Print.flex       - simple example script. Will put up a safety requester
                     for the 'Print' menu item if renamed to '_Print.flex'.

  Poll.flex        - simple poll script to be used as '_Poll.flex'; made by
                     Uffe Holst Christiansen.

  Scheduler.flex   - a  poll scheduler; made by Anders Wegge Jakobsen. This
                     script  polls  node with mail waiting. If the node has
                     an  CM flag in the nodelist the node can be called any
                     time  of  day.  If not, the script check to see if the
                     node   has   an   Txx   flag   indicating   additional
                     availability.  If  not,  the  node will only be polled
                     during   ZMH.   Have   you  got  any  suggestions  for
                     improvements direct them to wegge@daimi.aau.dk.

  LookupNode.flex  - a script to lookup nodes in the nodelist; made by
                     Alex Holst.

If  you  write  ARexx  scripts  please  give  them  the suffix 'flex'. Keep
initializations  in  the  beginning  of  the  script.  If you can't fit the
documentation  for the script in the beginning of the script supply it in a
file  with the suffix 'doc'. Any configuration files have the suffix 'cfg'.
Use ARexx and GUI locking.

Have  you  written  an  ARexx  script  for  Reflex send it along and I will
include it in the next (if any) release of Reflex.


How to contact me:

   Uffe Holst Christiansen
   c/o Christiansen
   Strandgaards Alle 11
   DK 3600 Frederikssund
   Denmark

   Fido: 2:236/200.12
   Internet: d952412@student.dtu.dk (at least valid until summer 1997)