org.globus.replica.rls
Class RLSClient

java.lang.Object
  |
  +--org.globus.replica.rls.RLSClient

public class RLSClient

extends java.lang.Object

This class implements the interface to an RLS server.

Nested Class Summary

class	RLSClient.LRC This class implements the LRC interface to an RLS server.
class	RLSClient.RLI This class implements the RLI interface to an RLS server.

Field Summary

static int	ADMIN_PING
static int	ADMIN_QUIT
static int	ADMIN_SSU
static int	RLIFLAG_BLOOMFILTER
static int	RLS_ATTR_EXIST
static int	RLS_ATTR_INUSE
static int	RLS_ATTR_NEXIST
static int	RLS_ATTR_VALUE_NEXIST
static int	RLS_BADARG
static int	RLS_BADMETHOD
static int	RLS_BADURL
static int	RLS_DBERROR
static int	RLS_GLOBUSERR
static int	RLS_INV_ATTR_OP
static int	RLS_INV_ATTR_TYPE
static int	RLS_INV_OBJ_TYPE
static int	RLS_INVHANDLE
static int	RLS_INVSERVER
static int	RLS_LFN_EXIST
static int	RLS_LFN_NEXIST
static int	RLS_LRC_EXIST
static int	RLS_LRC_NEXIST
static int	RLS_MAPPING_EXIST
static int	RLS_MAPPING_NEXIST
static int	RLS_NOMEMORY
static int	RLS_OVERFLOW
static int	RLS_PERM
static int	RLS_PFN_EXIST
static int	RLS_PFN_NEXIST
static int	RLS_RLI_EXIST
static int	RLS_RLI_NEXIST
static int	RLS_SUCCESS
static int	RLS_TIMEOUT
static int	RLS_TOO_MANY_CONNECTIONS
static int	RLS_UNSUPPORTED

Constructor Summary

RLSClient()
Connect to an RLS server on the local host at the default port.

RLSClient(java.lang.String url)
Connect to an RLS server at the specified url.

RLSClient(java.lang.String url, java.lang.String proxyfile)
Connect to an RLS server at the specified url, using proxycert for authentication.

RLSClient(java.lang.String url, java.lang.String certfile, java.lang.String keyfile)
Connect to an RLS server at the specified url, using certfile/key for authentication.

Method Summary

void	Admin(int cmd) Miscellaneous administrative operations.
static void	Certificate(java.lang.String certfile, java.lang.String keyfile) Set name of cert and key files.
void	Close() Close connection to RLS server.
java.util.ArrayList	GetConfiguration(java.lang.String option) Return server configuration.
java.lang.String	getErrorMessage(int rc) Map status code returned by RLS to string.
RLSClient.LRC	getLRC()
RLSClient.RLI	getRLI()
int	GetTimeout() Get timeout, in seconds, used in IO calls.
java.lang.String	GetURL() Return URL of RLS server.
void	LRCAdd(java.lang.String lfn, java.lang.String pfn) Deprecated. Use getLRC().add()
void	LRCAttrAdd(java.lang.String key, org.globus.replica.rls.RLSAttribute attr) Deprecated. Use getLRC().attributeAdd()
void	LRCAttrCreate(java.lang.String name, int objtype, int valtype) Deprecated. Use getLRC().attributeCreate()
void	LRCAttrDelete(java.lang.String name, int objtype, boolean clearvalues)
java.util.ArrayList	LRCAttrGet(java.lang.String name, int objtype) Deprecated. Use getLRC().attributeGet()
void	LRCAttrModify(java.lang.String key, org.globus.replica.rls.RLSAttribute attr) Deprecated. Use getLRC().attributeModify()
void	LRCAttrRemove(java.lang.String key, org.globus.replica.rls.RLSAttribute attr) Deprecated. Use getLRC().attributeRemove()
java.util.ArrayList	LRCAttrSearch(java.lang.String name, int objtype, int op, org.globus.replica.rls.RLSAttribute op1, org.globus.replica.rls.RLSAttribute op2, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getLRC().attributeSearch()
java.util.ArrayList	LRCAttrValueGet(java.lang.String key, java.lang.String name, int objtype) Deprecated. Use getLRC().attributeValueGet()
void	LRCClear() Deprecated. Use getLRC().clear()
void	LRCCreate(java.lang.String lfn, java.lang.String pfn) Deprecated. Use getLRC().create()
void	LRCDelete(java.lang.String lfn, java.lang.String pfn) Deprecated. Use getLRC().delete()
boolean	LRCExists(java.lang.String key, int objtype) Deprecated. Use getLRC().exists()
java.util.ArrayList	LRCGetLFN(java.lang.String pfn) Deprecated. Use getLRC().getLFN()
java.util.ArrayList	LRCGetLFN(java.lang.String pfn, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getLRC().getLFN()
java.util.ArrayList	LRCGetLFNWC(java.lang.String pfnpat) Deprecated. Use getLRC().getLFNWC()
java.util.ArrayList	LRCGetLFNWC(java.lang.String pfnpat, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getLRC().getLFNWC()
java.util.ArrayList	LRCGetPFN(java.lang.String lfn) Deprecated. Use getLRC().gePLFN()
java.util.ArrayList	LRCGetPFN(java.lang.String lfn, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getLRC().gePLFN()
java.util.ArrayList	LRCGetPFNWC(java.lang.String lfnpat) Deprecated. Use getLRC().gePLFNWC()
java.util.ArrayList	LRCGetPFNWC(java.lang.String lfnpat, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getLRC().gePLFNWC()
boolean	LRCMappingExists(java.lang.String lfn, java.lang.String pfn) Deprecated. Use getLRC().mappingExists()
void	LRCRLIAdd(java.lang.String rliurl, int flags, java.lang.String pattern) Deprecated. Use getLRC().rliAdd()
void	LRCRLIDelete(java.lang.String rliurl, java.lang.String pattern) Deprecated. Use getLRC().rliDelete()
java.util.ArrayList	LRCRLIGetPart(java.lang.String rliurl, java.lang.String pattern) Deprecated. Use getLRC().rliGetPart()
org.globus.replica.rls.RLSRLIInfo	LRCRLIInfo(java.lang.String rliurl) Deprecated. Use getLRC().rliInfo()
java.util.ArrayList	LRCRLIList() Deprecated. Use getLRC().rliList()
static int	OSSystem(java.lang.String cmd) Make call to system(), hack to allow me to invoke globus-url-copy for the sc2002 demo.
static void	ProxyCertificate(java.lang.String proxyfile) Set name of proxy cert file.
boolean	RLIExists(java.lang.String key, int objtype) Deprecated. Use getRLI().exists()
java.util.ArrayList	RLIGetLRC(java.lang.String lfn) Deprecated. Use getRLI().getLRC()
java.util.ArrayList	RLIGetLRC(java.lang.String lfn, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getRLI().getLRC()
java.util.ArrayList	RLIGetLRCWC(java.lang.String lfnpat) Deprecated. Use getRLI().getLRCWC()
java.util.ArrayList	RLIGetLRCWC(java.lang.String lfnpat, org.globus.replica.rls.RLSOffsetLimit offlim) Deprecated. Use getRLI().getLRCWC()
java.util.ArrayList	RLILRCList() Deprecated. Use getRLI().lrcList()
boolean	RLIMappingExists(java.lang.String lfn, java.lang.String lrc) Deprecated. Use getRLI().mappingExists()
int	SetConfiguration(java.lang.String option, java.lang.String value) Set server configuration.
void	SetTimeout(int seconds) Set timeout value for IO calls.
org.globus.replica.rls.RLSStats	Stats() Return stats about an RLS server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RLS_SUCCESS

public static final int RLS_SUCCESS

See Also:

Constant Field Values

RLS_GLOBUSERR

public static final int RLS_GLOBUSERR

See Also:

Constant Field Values

RLS_INVHANDLE

public static final int RLS_INVHANDLE

See Also:

Constant Field Values

RLS_BADURL

public static final int RLS_BADURL

See Also:

Constant Field Values

RLS_NOMEMORY

public static final int RLS_NOMEMORY

See Also:

Constant Field Values

RLS_OVERFLOW

public static final int RLS_OVERFLOW

See Also:

Constant Field Values

RLS_BADARG

public static final int RLS_BADARG

See Also:

Constant Field Values

RLS_PERM

public static final int RLS_PERM

See Also:

Constant Field Values

RLS_BADMETHOD

public static final int RLS_BADMETHOD

See Also:

Constant Field Values

RLS_INVSERVER

public static final int RLS_INVSERVER

See Also:

Constant Field Values

RLS_MAPPING_NEXIST

public static final int RLS_MAPPING_NEXIST

See Also:

Constant Field Values

RLS_LFN_EXIST

public static final int RLS_LFN_EXIST

See Also:

Constant Field Values

RLS_LFN_NEXIST

public static final int RLS_LFN_NEXIST

See Also:

Constant Field Values

RLS_PFN_EXIST

public static final int RLS_PFN_EXIST

See Also:

Constant Field Values

RLS_PFN_NEXIST

public static final int RLS_PFN_NEXIST

See Also:

Constant Field Values

RLS_LRC_EXIST

public static final int RLS_LRC_EXIST

See Also:

Constant Field Values

RLS_LRC_NEXIST

public static final int RLS_LRC_NEXIST

See Also:

Constant Field Values

RLS_DBERROR

public static final int RLS_DBERROR

See Also:

Constant Field Values

RLS_RLI_EXIST

public static final int RLS_RLI_EXIST

See Also:

Constant Field Values

RLS_RLI_NEXIST

public static final int RLS_RLI_NEXIST

See Also:

Constant Field Values

RLS_MAPPING_EXIST

public static final int RLS_MAPPING_EXIST

See Also:

Constant Field Values

RLS_INV_ATTR_TYPE

public static final int RLS_INV_ATTR_TYPE

See Also:

Constant Field Values

RLS_ATTR_EXIST

public static final int RLS_ATTR_EXIST

See Also:

Constant Field Values

RLS_ATTR_NEXIST

public static final int RLS_ATTR_NEXIST

See Also:

Constant Field Values

RLS_INV_OBJ_TYPE

public static final int RLS_INV_OBJ_TYPE

See Also:

Constant Field Values

RLS_INV_ATTR_OP

public static final int RLS_INV_ATTR_OP

See Also:

Constant Field Values

RLS_UNSUPPORTED

public static final int RLS_UNSUPPORTED

See Also:

Constant Field Values

RLS_TIMEOUT

public static final int RLS_TIMEOUT

See Also:

Constant Field Values

RLS_TOO_MANY_CONNECTIONS

public static final int RLS_TOO_MANY_CONNECTIONS

See Also:

Constant Field Values

RLS_ATTR_VALUE_NEXIST

public static final int RLS_ATTR_VALUE_NEXIST

See Also:

Constant Field Values

RLS_ATTR_INUSE

public static final int RLS_ATTR_INUSE

See Also:

Constant Field Values

ADMIN_PING

public static final int ADMIN_PING

See Also:

Constant Field Values

ADMIN_QUIT

public static final int ADMIN_QUIT

See Also:

Constant Field Values

ADMIN_SSU

public static final int ADMIN_SSU

See Also:

Constant Field Values

RLIFLAG_BLOOMFILTER

public static final int RLIFLAG_BLOOMFILTER

See Also:

Constant Field Values

Constructor Detail

RLSClient

public RLSClient()
          throws RLSException

Connect to an RLS server on the local host at the default port.

RLSClient

public RLSClient(java.lang.String url)
          throws RLSException

Connect to an RLS server at the specified url.

Parameters:

url - The location of the RLS server. It should be of the form rls://host[:port] or rlsn://host[:port]. The latter form is used if no authentication is desired.

RLSClient

public RLSClient(java.lang.String url,
                 java.lang.String proxyfile)
          throws RLSException

Connect to an RLS server at the specified url, using proxycert for authentication.

Parameters:

url - The location of the RLS server. It should be of the form rls://host[:port] or rlsn://host[:port]. The latter form is used if no authentication is desired.

proxyfile - Proxy certificate filename to use for authentication.

RLSClient

public RLSClient(java.lang.String url,
                 java.lang.String certfile,
                 java.lang.String keyfile)
          throws RLSException

Connect to an RLS server at the specified url, using certfile/key for authentication.

Parameters:

url - The location of the RLS server. It should be of the form rls://host[:port] or rlsn://host[:port]. The latter form is used if no authentication is desired.

certfile - Certificate file to use for authentication.

keyfile - Key file to use for authentication.

Method Detail

Admin

public void Admin(int cmd)
           throws RLSException

Miscellaneous administrative operations. Most operations require the ADMIN privilege.

Parameters:

cmd - Command to be sent to RLS server. See admin commands.

RLSException

Certificate

public static void Certificate(java.lang.String certfile,
                               java.lang.String keyfile)

Set name of cert and key files.

ProxyCertificate

public static void ProxyCertificate(java.lang.String proxyfile)

Set name of proxy cert file.

Close

public void Close()
           throws RLSException

Close connection to RLS server.

RLSException

getErrorMessage

public java.lang.String getErrorMessage(int rc)

Map status code returned by RLS to string.

Parameters:

rc - Status code.

Returns:

String Error message.

getLRC

public RLSClient.LRC getLRC()

getRLI

public RLSClient.RLI getRLI()

GetTimeout

public int GetTimeout()

Get timeout, in seconds, used in IO calls. The default is 30 seconds.

Returns:

seconds Timeout value.

SetTimeout

public void SetTimeout(int seconds)

Set timeout value for IO calls. This value applies to all RLS connections, not just the current one.

Parameters:

seconds - Timeout value.

GetURL

public java.lang.String GetURL()

Return URL of RLS server.

LRCAttrAdd

public void LRCAttrAdd(java.lang.String key,
                       org.globus.replica.rls.RLSAttribute attr)
                throws RLSException

Deprecated. Use getLRC().attributeAdd()

Add an attribute to an object in the LRC database.

Parameters:

key - Logical or Physical File Name (LFN or PFN) that identifies object attribute should be added to.

attr - Attribute to be added to object. See object types.

RLSException

LRCAttrCreate

public void LRCAttrCreate(java.lang.String name,
                          int objtype,
                          int valtype)
                   throws RLSException

Deprecated. Use getLRC().attributeCreate()

Define new attribute in LRC database.

Parameters:

name - Name of attribute.

objtype - Object (LFN or PFN) type that attribute applies to. See object types.

valtype - Type of attribute value. See attribute types.

RLSException

LRCAttrDelete

public void LRCAttrDelete(java.lang.String name,
                          int objtype,
                          boolean clearvalues)
                   throws RLSException

RLSException

LRCAttrGet

public java.util.ArrayList LRCAttrGet(java.lang.String name,
                                      int objtype)
                               throws RLSException

Deprecated. Use getLRC().attributeGet()

Return definitions of attributes in LRC database.

Parameters:

name - Name of attribute. If name is null all attributes of the specified objtype are returned.

objtype - Object (LFN or PFN) type that attribute applies to. See object types.

Returns:

attr_list Any attribute definitions found will be returned as a list of RLSAttribute objects.

RLSException

LRCAttrModify

public void LRCAttrModify(java.lang.String key,
                          org.globus.replica.rls.RLSAttribute attr)
                   throws RLSException

Deprecated. Use getLRC().attributeModify()

Modify an attribute value.

Parameters:

key - Name of object (LFN or PFN).

attr - Attribute to be modified.

RLSException

LRCAttrRemove

public void LRCAttrRemove(java.lang.String key,
                          org.globus.replica.rls.RLSAttribute attr)
                   throws RLSException

Deprecated. Use getLRC().attributeRemove()

Remove an attribute from an object (LFN or PFN) in the LRC database.

Parameters:

key - Name of object (LFN or PFN).

attr - Attribute to be removed.

RLSException

LRCAttrSearch

public java.util.ArrayList LRCAttrSearch(java.lang.String name,
                                         int objtype,
                                         int op,
                                         org.globus.replica.rls.RLSAttribute op1,
                                         org.globus.replica.rls.RLSAttribute op2,
                                         org.globus.replica.rls.RLSOffsetLimit offlim)
                                  throws RLSException

Deprecated. Use getLRC().attributeSearch()

Search for objects (LFNs or PFNs) in a LRC database that have the specified attribute whose value matches a boolean expression.

Parameters:

name - Name of attribute.

objtype - Object (LFN or PFN) type that attribute applies to.

op - Operator to be used in searching for values. See operators.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

attr_obj_list Any objects with the specified attribute will be returned, with the attribute value, in a list of RLSAttributeObject objects.

RLSException

LRCAttrValueGet

public java.util.ArrayList LRCAttrValueGet(java.lang.String key,
                                           java.lang.String name,
                                           int objtype)
                                    throws RLSException

Deprecated. Use getLRC().attributeValueGet()

Return attributes in LRC database for specified object (LFN or PFN).

Parameters:

key - Logical or Physical File Name (LFN or PFN) that identifies object attributes should be retrieved for.

name - Name of attribute to retrieve. If null all attributes for key, objtype are returned.

objtype - Object (LFN or PFN) type that attribute applies to.

Returns:

attr_list Any attributes found will be returned in a list of RLSAttribute objects.

RLSException

LRCAdd

public void LRCAdd(java.lang.String lfn,
                   java.lang.String pfn)
            throws RLSException

Deprecated. Use getLRC().add()

Add mapping to PFN to an existing LFN.

Parameters:

lfn - LFN to add pfn mapping to, should already exist.

pfn - PFN that lfn should map to.

RLSException

LRCClear

public void LRCClear()
              throws RLSException

Deprecated. Use getLRC().clear()

Remove all lfns, pfns, mappings and attribute values from LRC database.

RLSException

LRCCreate

public void LRCCreate(java.lang.String lfn,
                      java.lang.String pfn)
               throws RLSException

Deprecated. Use getLRC().create()

Create new mapping to PFN from LFN.

Parameters:

lfn - LFN to add pfn mapping to, should not exist.

pfn - PFN that lfn should map to.

RLSException

LRCDelete

public void LRCDelete(java.lang.String lfn,
                      java.lang.String pfn)
               throws RLSException

Deprecated. Use getLRC().delete()

Delete mapping from LRC database.

Parameters:

lfn - LFN to remove mapping from.

pfn - PFN that LFN maps to be removed.

RLSException

LRCExists

public boolean LRCExists(java.lang.String key,
                         int objtype)
                  throws RLSException

Deprecated. Use getLRC().exists()

Test if object (LFN or PFN) exists.

Parameters:

key - Name of object.

objtype - Type of object.

Returns:

boolean True if object exists, else false.

RLSException

LRCGetLFN

public java.util.ArrayList LRCGetLFN(java.lang.String pfn,
                                     org.globus.replica.rls.RLSOffsetLimit offlim)
                              throws RLSException

Deprecated. Use getLRC().getLFN()

Return LFNs mapped to PFN in the LRC database.

Parameters:

pfn - PFN to search for.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

str2_list List of RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetLFN

public java.util.ArrayList LRCGetLFN(java.lang.String pfn)
                              throws RLSException

Deprecated. Use getLRC().getLFN()

Return all LFNs mapped to PFN in the LRC database.

Parameters:

pfn - PFN to search for.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetLFNWC

public java.util.ArrayList LRCGetLFNWC(java.lang.String pfnpat,
                                       org.globus.replica.rls.RLSOffsetLimit offlim)
                                throws RLSException

Deprecated. Use getLRC().getLFNWC()

Return LFNs mapped to PFNs matching pfnpat in the LRC database.

Parameters:

pfnpat - PFN pattern to search for.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetLFNWC

public java.util.ArrayList LRCGetLFNWC(java.lang.String pfnpat)
                                throws RLSException

Deprecated. Use getLRC().getLFNWC()

Return all LFNs mapped to PFNs matching pfnpat in the LRC database.

Parameters:

pfnpat - PFN pattern to search for.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetPFN

public java.util.ArrayList LRCGetPFN(java.lang.String lfn,
                                     org.globus.replica.rls.RLSOffsetLimit offlim)
                              throws RLSException

Deprecated. Use getLRC().gePLFN()

Return PFNs mapped to LFN in the LRC database.

Parameters:

lfn - LFN to search for.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetPFN

public java.util.ArrayList LRCGetPFN(java.lang.String lfn)
                              throws RLSException

Deprecated. Use getLRC().gePLFN()

Return all PFNs mapped to LFN in the LRC database.

Parameters:

lfn - LFN to search for.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetPFNWC

public java.util.ArrayList LRCGetPFNWC(java.lang.String lfnpat,
                                       org.globus.replica.rls.RLSOffsetLimit offlim)
                                throws RLSException

Deprecated. Use getLRC().gePLFNWC()

Return PFNs mapped to LFNs matching lfnpat in the LRC database.

Parameters:

lfnpat - LFN pattern to search for.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCGetPFNWC

public java.util.ArrayList LRCGetPFNWC(java.lang.String lfnpat)
                                throws RLSException

Deprecated. Use getLRC().gePLFNWC()

Return all PFNs mapped to LFNs matching lfnpat in the LRC database.

Parameters:

lfnpat - LFN pattern to search for.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,pfn mappings.

RLSException

LRCMappingExists

public boolean LRCMappingExists(java.lang.String lfn,
                                java.lang.String pfn)
                         throws RLSException

Deprecated. Use getLRC().mappingExists()

Test if mapping exists in LRC.

Parameters:

lfn - Name of LFN.

pfn - Name of PFN.

Returns:

boolean True if mapping exists, else false.

RLSException

LRCRLIAdd

public void LRCRLIAdd(java.lang.String rliurl,
                      int flags,
                      java.lang.String pattern)
               throws RLSException

Deprecated. Use getLRC().rliAdd()

LRC servers send information about LFNs in their database to the the list of RLI servers in the database, added with the following function. Updates may be partitioned amongst multiple RLIs by specifying one or more patterns for an RLI.

Parameters:

flags - Should be zero or RLSClient.RLIFLAG_BLOOMFILTER if the RLI should be updated via Bloom filters.

pattern - If not NULL used to filter which LFNs are sent to rli_url. Standard Unix wildcard characters (*, ?) may be used to do wildcard matches. Patterns are ignored if Bloom filters are used for updates.

RLSException

LRCRLIDelete

public void LRCRLIDelete(java.lang.String rliurl,
                         java.lang.String pattern)
                  throws RLSException

Deprecated. Use getLRC().rliDelete()

Delete an entry from the LRC rli/partition tables.

Parameters:

pattern - If not null then only the specific rli_url/pattern is removed, else all partition information for rli_url is removed.

RLSException

LRCRLIGetPart

public java.util.ArrayList LRCRLIGetPart(java.lang.String rliurl,
                                         java.lang.String pattern)
                                  throws RLSException

Deprecated. Use getLRC().rliGetPart()

Get RLI update partitions from LRC server.

Parameters:

pattern - If not NULL returns only partitions with matching patterns, otherwise all patterns are retrieved.

Returns:

str2_list List of rls.RLSString2 objects, containing the RLI URLs and patterns (if any) updated by the LRC.

RLSException

LRCRLIInfo

public org.globus.replica.rls.RLSRLIInfo LRCRLIInfo(java.lang.String rliurl)
                                             throws RLSException

Deprecated. Use getLRC().rliInfo()

Get info about RLI server updated by an LRC server.

Returns:

info Data about the RLI server will be returned in an RLSRLIInfo object.

RLSException

LRCRLIList

public java.util.ArrayList LRCRLIList()
                               throws RLSException

Deprecated. Use getLRC().rliList()

Return URLs of RLIs that LRC sends updates to.

Returns:

A list of RLSRLIInfo objects containing the RLI URLs updated by this LRC.

RLSException

RLIGetLRC

public java.util.ArrayList RLIGetLRC(java.lang.String lfn,
                                     org.globus.replica.rls.RLSOffsetLimit offlim)
                              throws RLSException

Deprecated. Use getRLI().getLRC()

Return LRCs mapped to LFN in the LRC database.

Parameters:

lfn - LFN to search for.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,lrc mappings.

RLSException

RLIGetLRC

public java.util.ArrayList RLIGetLRC(java.lang.String lfn)
                              throws RLSException

Deprecated. Use getRLI().getLRC()

Return all LRCs mapped to LFNs matching lfnpat in the LRC database.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,lrc mappings.

RLSException

RLIGetLRCWC

public java.util.ArrayList RLIGetLRCWC(java.lang.String lfnpat,
                                       org.globus.replica.rls.RLSOffsetLimit offlim)
                                throws RLSException

Deprecated. Use getRLI().getLRCWC()

Return LRCs mapped to LFNs matching lfnpat in the LRC database.

Parameters:

lfnpat - LFN pattern to search for.

offlim - Offset and limit used to retrieve results incrementally. Use null, or 0,0, to retrieve all results.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,lrc mappings.

RLSException

RLIGetLRCWC

public java.util.ArrayList RLIGetLRCWC(java.lang.String lfnpat)
                                throws RLSException

Deprecated. Use getRLI().getLRCWC()

Return all LRCs mapped to lfns matching lfnpat in the LRC database.

Parameters:

lfnpat - LFN pattern to search for.

Returns:

str2_list List of rls.RLSString2 objects containing matching lfn,lrc mappings.

RLSException

RLIExists

public boolean RLIExists(java.lang.String key,
                         int objtype)
                  throws RLSException

Deprecated. Use getRLI().exists()

Test if object (LFN or LRC) exists.

Parameters:

key - Name of object.

objtype - Type of object.

Returns:

boolean True if object exists, else false.

RLSException

RLILRCList

public java.util.ArrayList RLILRCList()
                               throws RLSException

Deprecated. Use getRLI().lrcList()

Return URLs of LRCs that update this RLI.

Returns:

A list of RLSLRCInfo objects containing the RLI URLs updated by this LRC.

RLSException

RLIMappingExists

public boolean RLIMappingExists(java.lang.String lfn,
                                java.lang.String lrc)
                         throws RLSException

Deprecated. Use getRLI().mappingExists()

Test if mapping exists in RLI.

Parameters:

lfn - Name of LFN.

lrc - Name of LRC.

Returns:

boolean True if mapping exists, else false.

RLSException

GetConfiguration

public java.util.ArrayList GetConfiguration(java.lang.String option)
                                     throws RLSException

Return server configuration.

Parameters:

option - Configuration option to retreive. If null all options are returned

Returns:

str2_list List of RLSString2 objects containing configuration option names and values.

RLSException

SetConfiguration

public int SetConfiguration(java.lang.String option,
                            java.lang.String value)
                     throws RLSException

Set server configuration.

Parameters:

option - Configuration option to set.

value - Value to set.

RLSException

Stats

public org.globus.replica.rls.RLSStats Stats()
                                      throws RLSException

Return stats about an RLS server.

Returns:

RLSStats.

RLSException

OSSystem

public static int OSSystem(java.lang.String cmd)

Make call to system(), hack to allow me to invoke globus-url-copy for the sc2002 demo.

Returns:

int system() result.