NAME

EDG::RLS

DESCRIPTION

EDG::RLS module provides access to some RLS methods through SOAP.

METHODS

The methods die if there was a SOAP fault. The fault string and details are added to the die message.

new($URL)
Creates an RLS object, which is initialized with the approriate SOAP endpoint. If the URL uses https protocol, then it will do the HTTPS initialization (locating proxy certificate) as well.

Note: you have to include the VO name in the URL!

    my $rls = EDG::RLS->new('https://rls.example.org:8443/example');

addMapping ($GUID, $pfn)
Add a new mapping to the Catalog. If there is already a mapping, we add this mapping to the set of mappings. If there are no mappings already, we create a new mapping. 
    $rls->addMapping ('GUID...', 'srm://...');

removeMapping ($GUID, $pfn)
Remove from the catalog a single guid to pfn mapping. 
    $rls->removeMapping ('GUID...', 'srm://...');

$GUID = guidForPfn ($pfn)
For a given pfn, return the guid that points to it.

The return value will never be undef, because if the PFN doesn't exist it will die with 'NoSuchPfnException'.

    $guid = $rls->guidForPfn('srm://....');

$pfns = getPfns ($GUID)
For a given guid, return all the physical filenames (reference to a string list) we map to in this Catalog.

This will always have at least one entry, and never be empty. If the guid does not exist in the catalog, then it will die with 'NoSuchGuidException'.

    $surls = $rls->getPfns ('GUID....');
    print join(',', @$surls), "\n";

SEE ALSO

the GLite::HTTPS manpage

AUTHORS

Peter.Kunszt <Peter.Kunszt@cern.ch>, Gavin Mccance <Gavin.Mccance@cern.ch>, Akos.Frohner <Akos.Frohner@cern.ch>

Copyright (c) 2004 CERN, on behalf of the EU EGEE project. For license conditions see LICENSE file or http://www.edg.org/license.html.