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