...
write
takes a serialized string representing thencsa.service.vizier.tspace.ConfigurationEntry
object (see below); returns the entry id.writeB
is a batch method which does the same thing aswrite
on multiple entries; returns array of ids corresponding to each entry.read
andtake
are batch methods, both requiring a serialized string representing thencsa.service.vizier.tspace.ConfigurationMatchRequest
object (see below), along with an integer indicating the maximum number of tuples entries to return (default is 10; it is advisable not to set this number too high, as Axis will have trouble managing extremely large SOAP packets); the array returned contains serializedncsa.service.vizier.tspace.ConfigurationEntry
objects.take
also requires a timeout (if set to t <= 0, the non-blocking method is called), whereastakeNB
will return immediately subsequent to issuing the request against the data store.takeNB
can returnnull
if no tuples entries satisfy the request constraints.take
will not returnnull
unless timeout <= 0.take
may return an empty array (length 0) if its timeout has been exceeded.
...
- If
id
isnull
, the object will be added as a new entry. - If
id
is notnull
, an attempt will be made to update an existing object with that id. The fields subject to update are:- timeTaken
- timeCompleted
- retried
- ranOn
See further the ncsa.tools.ogrscript.tspace page.
If the id
is set, it is not necessary to provide a complete description of the entry; only the XML elements or attributes corresponding to the 4 updateable fields above will be processed. See further the ncsa.tools.ogrscript.tspace page.
ncsa.service.vizier.tspace.ConfigurationMatchRequest
...