
XMLRPC support for Perl - README
================================

(1) Installation
(2) How to use it

(1) Installation
================

To use XMLRPC with Perl, you first need these Perl modules installed on 
your machine (SuSE 7.2 tested) :

  - perl-libwww-perl
  - perl-XML-Parser

Also you need the Frontier::XMLRPC module, which is available at

  http://bitsko.slc.ut.us/~ken/xml-rpc/ (down)

or at
   
  http://www.cpan.org/authors/KMACLEOD/Frontier-RPC-0.06.tar.gz   
   
If you untar'ed and ungzip'ed the package, you just need to issue the 
following commands to install the client on your system :

  - perl Makefile.PL
  - make
  - make test       (check if everything is OK here)
  - make install    (you should be 'root')

Now everything should be ready to run Perl scripts with XMLRPC support.

(2) How to use it
=================

To show you how to use Perl and XMLRPC to access a SKYRiX server, here's
a little code example that shows the essential steps.

--- snip ---
#!/usr/bin/perl

# 'include' the XMLRPC client
use Frontier::Client;

# init the client with the target url, login & password
$client = Frontier::Client->new( url => 
                  "http://login:password@your.server.com:10000");

# send a message to fetch persons with a name like 'zaphod',
# store the result in @result
@result = $client->call('person.fetch',"name like \'*zaphod*\'");

# check how many records we received
$count = @{$result[0]}; 

# iterate over the results
for $i (0 .. $count-1)
{
  # get the current element
  $element = $result[0]->[$i];

  # get the name of the current element
  $name = $element->{"name"};
}
--- snap ---

