NAME

GLite::Data::FileTransfer


DESCRIPTION

GLite::Data::FileCatalog module provides a Perl client library for the FileTransfer interface.


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 FileTransfer 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 $srv = GLite::Data::FileTransfer->new('https://service.glite.org:8443/example');

string placementSubmit(PlacementJob job)
string transferSubmit(TransferJob job)
string submit(TransferJob job)
JobStatus[] listRequests(string[] inGivenStates, string channelName)
FileTransferStatus[] getFileStatus(string requestID, int offset, int limit)
JobStatus getTransferJobStatus(string requestID)
TransferJobSummary getTransferJobSummary(string requestID)
cancel(string[] requestIDs)
setJobPriority(string requestID, int priority)
addVOManager(string VOName, string principal)
removeVOManager(string VOName, string principal)
string[] listVOManagers(string VOName)
Roles getRoles()
string getVersion()
string getSchemaVersion()
string getInterfaceVersion()
string getServiceMetadata(string key)


TYPES

TransferParams
    my $myTransferParams = {
        keys => [ 'string1', 'string2', ... ], 
        values => [ 'string1', 'string2', ... ]
    };
PlacementJob
    my $myPlacementJob = {
        logicalFiles => [ 'string1', 'string2', ... ], 
        sourceSE => 'string', 
        destSE => 'string', 
        jobParams => $myTransferParams, 
        credential => 'string'
    };
TransferException
    my $myTransferException = {
        message => 'string'
    };
InvalidArgumentException
    my $myInvalidArgumentException = new TransferException (
        
    );
AuthorizationException
    my $myAuthorizationException = new TransferException (
        
    );
ServiceBusyException
    my $myServiceBusyException = new TransferException (
        
    );
InternalException
    my $myInternalException = new TransferException (
        
    );
TransferJobElement
    my $myTransferJobElement = {
        source => 'string', 
        dest => 'string'
    };
TransferJob
    my $myTransferJob = {
        transferJobElements => [ $myTransferJobElement1, $myTransferJobElement2, ... ], 
        jobParams => $myTransferParams, 
        credential => 'string'
    };
JobStatus
    my $myJobStatus = {
        jobID => 'string', 
        jobStatus => 'string', 
        channelName => 'string', 
        clientDN => 'string', 
        reason => 'string', 
        voName => 'string', 
        submitTime => $mylong, 
        numFiles => 9999, 
        priority => 9999
    };
FileTransferStatus
    my $myFileTransferStatus = {
        logicalName => 'string', 
        sourceSURL => 'string', 
        destSURL => 'string', 
        transferFileState => 'string', 
        numFailures => 9999, 
        reason => 'string', 
        reason_class => 'string', 
        duration => $mylong
    };
NotExistsException
    my $myNotExistsException = new TransferException (
        
    );
TransferJobSummary
    my $myTransferJobSummary = {
        jobStatus => $myJobStatus, 
        numDone => 9999, 
        numActive => 9999, 
        numPending => 9999, 
        numCanceled => 9999, 
        numCanceling => 9999, 
        numFailed => 9999, 
        numFinished => 9999, 
        numSubmitted => 9999, 
        numHold => 9999, 
        numWaiting => 9999, 
        numCatalogFailed => 9999, 
        numRestarted => 9999
    };
CannotCancelException
    my $myCannotCancelException = new TransferException (
        
    );
ExistsException
    my $myExistsException = new TransferException (
        
    );
StringPair
    my $myStringPair = {
        string1 => 'string', 
        string2 => 'string'
    };
Roles
    my $myRoles = {
        clientDN => 'string', 
        serviceAdmin => 'string', 
        submitter => 'string', 
        VOManager => [ $myStringPair1, $myStringPair2, ... ], 
        channelManager => [ $myStringPair1, $myStringPair2, ... ]
    };
ArrayOf_soapenc_string
    my $myArrayOf_soapenc_string = [ 'string1', 'string2', ...];
ArrayOf_tns3_JobStatus
    my $myArrayOf_tns3_JobStatus = [ $myJobStatus1, $myJobStatus2, ... ];
ArrayOf_tns3_FileTransferStatus
    my $myArrayOf_tns3_FileTransferStatus = [ $myFileTransferStatus1, $myFileTransferStatus2, ... ];


SEE ALSO

the GLite::HTTPS manpage


AUTHORS

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