-format:
[list|text|html]
The single option, -format, refers to the textual format
of the returned data, which can be formatted as a Tcl list,
formatted ascii text, or formatted HTML text.
The default format of the Tcl list is actually a list of
lists of lists of five elements. For example:
{
{
{LDAS-DEV1234 dataPipeline frame pehrens 12.98:5.43}
{LDAS-DEV1235 dataPipeline datacond isalzman 25.22:3.21}
}
{
{LDAS-DEV1236 getMetaData queued isalzman 0}
{LDAS-DEV1237 getMetaData isalzman 0}
}
}
The actual list as returned will be a single flat line
of text.
The example shows two running dataPipeline jobs, one of which
has a total runtime of 12.98 seconds and has been
in the frame API for 5.43 seconds, and the other
has been active for 25.22 seconds and in the datacond
API for 3.21 seconds.
There are two getMetaData jobs which have just been entered in
the system which have yet to be assigned to an API.
When the system is busy, jobs will be held in the
queue pending resource availablility, and they will
be represented as "queued" for some time > 0.
The 'list' is a very convenient format for parsing the
returned value using Tcl:
foreach { running queued } $retval {
foreach item [ concat $running $queued ] {
foreach { job command api user time } $item {
...
}
}
}
Comment:
This macro is especially useful for building job control
commands. It is very light weight in terms of system
resources (memory and CPU cycles).