NAME

perfSONAR_PS::Services::MA::General - A module that provides methods for general tasks that MAs need to perform, such as querying for results.

DESCRIPTION

This module is a catch all for common methods (for now) of MAs in the perfSONAR-PS framework. As such there is no 'common thread' that each method shares. This module IS NOT an object, and the methods can be invoked directly (and sparingly).

getMetadataXQuery( { node } )

Given a metadata node, constructs and returns an XQuery statement.

getSPXQuery( { node, queryString } )

Helper function for the subject and parameters portion of a metadata element. Used by 'getMetadataXQuery', not to be called externally.

getEventTypeXQuery( { node, queryString } )

Helper function for the eventType portion of a metadata element. Used by 'getMetadataXQuery', not to be called externally.

getDataXQuery( { node, queryString } )

Given a data node, constructs and returns an XQuery statement.

xQueryParameters( { node, path, queryCount, queryString } )

Helper function for the parameters portion of NMWG elements, not to be called externally.

xQueryAttributes( { node, path, queryCount, queryString } )

Helper function for the attributes portion of NMWG elements, not to be called externally.

xQueryText( { node, path, queryCount, queryString } )

Helper function for the text portion of NMWG elements, not to be called externally.

xQueryEventType( { node, path, queryString } )

Helper function for the eventTYpe portion of NMWG elements, not to be called externally.

getDataRRD( { directory, file, timeSettings, rrdtool } )

Returns either an error or the actual results of an RRD database query.

adjustRRDTime( { timeSettings } )

Given an MA object, this will 'adjust' the time values in an data request that will end up quering an RRD database. The time values are only 'adjusted' if the resolution value makes them 'uneven' (i.e. if you are requesting data between 1 and 70 with a resolution of 60, RRD will default to a higher resolution becaues the boundaries are not exact). We adjust the start/end times to better fit the requested resolution.

getFilterParameters( { m, namespaces, default_resolution, resolution } )

Extract the filter parameters from the filter metadata block.

extractTime( { parameter, namespaces, start, end } )

Checks the various nesting combinations possible when specifying time.

complexTime( { element } )

Given an elemenet (normally time based), checks to see if it is 'complex', i.e. if there are nested elements inside. If there are none, return the text that is enclosed.

SEE ALSO

Log::Log4perl, Params::Validate, perfSONAR_PS::Common, perfSONAR_PS::Messages

To join the 'perfSONAR-PS' mailing list, please visit:

  https://mail.internet2.edu/wws/info/i2-perfsonar

The perfSONAR-PS subversion repository is located at:

  https://svn.internet2.edu/svn/perfSONAR-PS 
  

Questions and comments can be directed to the author, or the mailing list. Bugs, feature requests, and improvements can be directed here:

 https://bugs.internet2.edu/jira/browse/PSPS

VERSION

$Id: General.pm 1877 2008-03-27 16:33:01Z aaron $

AUTHOR

Jason Zurawski, zurawski@internet2.edu

LICENSE

You should have received a copy of the Internet2 Intellectual Property Framework along with this software. If not, see <http://www.internet2.edu/membership/ip.html>

COPYRIGHT

Copyright (c) 2004-2008, Internet2 and the University of Delaware

All rights reserved.