Summary of BLAH changes for CREAM and Condor
--------------------------------------------

Commands for multiple jobs
--------------------------
The BLAH commands BLAH_JOB_STATUS, BLAH_JOB_CANCEL, BLAH_JOB_HOLD and
BLAH_JOB_RESUME are being implemented to act simultaneously on multiple
jobs, with a syntax like this:

COMMAND requid job1\ job2\ ...jobn

If the command involved more than one job the results line will have a
composite requid number (requid.0, requid.1 etc.) in order to keep a link
between the the single job and the result line. If the command involves
single-job the answer will have an integer requid as it is for now for
backward compatibility.

Example:
BLAH_JOB_STATUS 1 pbs/20051102/3103.xxx.mi.infn.it\ pbs/20051102/3102.xxx.mi.infn.it
S
RESULTS
S 2
1.0 0 No\ Error 2 [\ BatchjobId\ =\ "3103.xxx.mi.infn.it";\ JobStatus\ =\ 2;\ WorkerNode\ =\ "\ grid001.mi.infn.it"\ ]
1.1 0 No\ Error 4 [\ ExitCode\ =\ 0;\ BatchjobId\ =\ "3102.xxx.mi.infn.it";\ JobStatus\ =\ 4\ ]

The BLAH_JOB_REFRESH_PROXY will be for now implemented in a slightly different
way. In order to keep as "clean" as possible the command syntax it will allowed
that the command will accept multiple only with the same proxy file.

Example:
BLAH_JOB_REFRESH_PROXY 1 pbs/20051102/3103.xxx.mi.infn.it\ pbs/20051102/3102.xxx.mi.infn.it abc.proxy


New commands and features
-------------------------
- New features for Cream integration (bug #12225) added to LSF BLParser.
  We  are going to test it with Cream people.
- New features for Condor (GAHP_TEMP variable)

New commands
------------
1) BLAH_GET_HOSTPORT
Gets from Logparser its hostname and port.
Syntax:
	BLAH_GET_HOSTPORT requid batchsystem
Example:
BLAH_GET_HOSTPORT 1 pbs
S
RESULTS
S 1
1 192.84.138.1:22222

2)BLAH_JOB_SIGNAL
The command is already included in the BLAH usage documentation not implemented
yet. It is being implemented in a transparent way, simply transmitting the signal
to the underlying Batch System. The success of the command depends on the lrms
ability to support this feature for the single signals.

Syntax:
BLAH_JOB_SIGNAL reqid job signal
Example:
BLAH_JOB_SIGNAL 1 pbs/20051102/3103.xxx.mi.infn.it SIGKILL