                           *********************
                           * JabberRoster.rexx *
                           *  by  Roger Clark  *
                           *   15 Sept, 2003   *
                           *********************

Requirements:

- Any Amiga model or Emulation with ARexx
- Jabberwocky 1.4+
- rexxsupport.library
- Internet connection

Overview:

A  simple  ARexx  script  designed  to  make  the transition between Jabber
servers as simple as possible for Jabberwocky users.  The script will allow
the  user  to save their current roster list from the active server and add
them  to  a  new  server complete with buddy names as set by the user.  The
transition  is  made  as seamlessly as possible with minimal input required
from the user.


Usage:

RX JabberRoster.rexx [Save/Add]

  [Save] 

  This  option will save the complete roster list from the active server to
  a  textfile  as  "T:JabberRoster".  The user needs to be connected to the
  internet and the Jabber server that they wish to save their roster from.

  [Add]

  This  option  will  send  all  the  JabberID's and screen name to the new
  server,  and then accept all subscription requests.  The user needs to be
  registered  with  all appropriate Agents on the new server, as the script
  will  identify  these  agents  and  change  the  JabberID's  to  use  the
  appropriate server name.


Basic Step-by-Step Instructions:

1. Save the JabberRoster.rexx script to your Rexx: directory, or CD to the
   directory in which the script is saved.

2. Connect to the Jabber server from which you wish to save the Roster.

3. Execute the command "RX JabberRoster.rexx Save" from the CLI.

4. Disconnect from the current Jabber server and connect to the new Jabber
   server.

5. Register with all appropriate Agents (AIM, Yahoo, MSN, ICQ).

6. Execute the command "RX JabberRoster.rexx Add" from the CLI.

If  all goes well, your complete roster should now be duplicated on the new
Jabber  server.   If  some  contacts are not added, or screen names are not
updated  then you can repeat step 6 as needed.  There is 1 second delay set
between  each  command  sent  to the Jabber server, but this may need to be
adjusted  based  on your connection speed to the internet, or distance from
the  server.   If  this  needs  to be done, change the value in the Delay()
commands as necessary.  1 second = Delay(50).

If  you  need  any  additional  help,  you  may  contact  the author at the
following email address.

  Roger Clark <kaedric@sbcglobal.net>
