DBS Image List handling commands
The list of external commands available for the handling of image lists are:
SET IMGLIST <command> [<parameter1> ..... <parameterN>
]
commands
DELETE
description
Tells the DBS module to delete an specific image name from the list,
or to clean (delete) the whole list. The DBS module WILL NOT DELETE THE IMAGE,
but only the reference to the image on the list (the name of the image on
the image list, so it will not appear anymore as an available image)
sintax
DELETE <path | all>
path: is the complete path to the image name to be
deleted
all : delete the whole list
example
SET IMGLIST DELETE /home2/wirc/images/obj0012.fits
return values
On error, "ERR <error message>"
On success, "OK" on success
GET IMGLIST [<command>] [<paramete1> ..... <parameterN>]
commands
ALL, LIST
description
Brings the whole list from the remote DBS module.
example
GET IMGLIST ALL
return values
On error, "ERR <error mesage>" on failure
On success, the image list. The list is returned is a multi-line string
with 1 image per line, as follows:
ImageName1 TimeStamp1 Status1 [status message]\n
.
.
ImageNameZ TimeStampZ StatusZ [status message]\n
ImageName field includes the whole path, not just the Image name (as /home2/wirc/images/obj0012.fits)
TimeStamp field is the time where the image was added to the list (normally
just after it was written to disk)
Status field is OK or ERR, followed by a status message that may be present
or not
FROM, UNTILL, TO, STATUS
description
Brings a list with only the images that match the given constrain.
sintax
[FROM <date1>] [TO | UNTILL <date2>][STATUS
<stat>]
FROM: starting date
TO, UNTILL: ending date
STATUS: whith the following status
<date> has the format YYYY-MM-DDTHH:MM:SS
<stat> can be OK or ERR
example
-GET IMGLIST FROM 2003-11-22T15:00:00 UNTILL 2003-11-22T17:30:00 STATUS OK
will bring all images
from the starting date untill the ending date with the specified status
-GET IMGLIST UNTILL 2003-11-22T17:30:00
will bring all images
older than the specified date
-GET IMGLIST STATUS OK
will bring all images
with OK status
-GET IMGLIST FROM 2003-11-22T15:00:00
will bring all images
newer than the specified date
return values
It will return a list of images that follows the given constrain. The list
format is the same as the one described for GET IMGLIST ALL
GET LASTIMG
description
will return the last images added on the list.
return values
On error, "ERR <error message"
a success, a single line with the following format: ImageName TimeStamp
Status [status message]\n
The fields are the same explained for GET IMGLIST ALL