Difference: BLAH_guide (3 vs. 4)

Revision 42008-06-25 - ElisabettaMolinari

Line: 1 to 1
 

BLAH Introduction

BLAHPD is a light component accepting commands according to the BLAH (Batch Local Ascii Helper) protocol to manage jobs on different Local Resources Management Systems (LRMS).
Line: 469 to 469
 This section contains the syntax for the Request, Return, and Result line for each command.
Changed:
<
<
COMMANDS

List all the commands from this protocol specification which are implemented by this BLAHP server.

+ Request Line:

COMMANDS <CRLF>

+ Return Line:

S <SP> <SP> <SP> ... <CRLF>

+ Result Line:

None.

VERSION

Return the version string for this BLAHP. The version string follows a specified format (see below). Ideally, the version entire version string, including the starting and ending dollar sign ($) delimiters, should be a literal string in the text of the BLAHP server executable. This way, the Unix/RCS "ident" command can produce the version string.

The version returned should correspond to the version of the protocol supported.

+ Request Line:

VERSION

+ Return Line:

S $GahpVesion: .. <build-month> <build-day-of-month> <build-year> <general-descrip> $

>
>
  • COMMANDS: List all the commands from this protocol specification which are implemented by this BLAHP server.
    + Request Line: COMMANDS <CRLF>
    + Return Line: S <SP> <SP> <SP> ... <CRLF>
    + Result Line: None.
 
Added:
>
>
  • VERSION: Return the version string for this BLAHP. The version string follows a specified format (see below). Ideally, the version entire version string, including the starting and ending dollar sign ($) delimiters, should be a literal string in the text of the BLAHP server executable. This way, the Unix/RCS "ident" command can produce the version string. The version returned should correspond to the version of the protocol supported.
    + Request Line: VERSION <CRLF>
    + Return Line:
    • S <SP> $GahpVesion: <SP> .. <SP> <build-month> <SP> <build-day-of-month> <SP> <build-year> <SP> <general-descrip> <SP>$ <CRLF>
 
  • major.minor.subminor = for this version of the protocol, use version 1.0.0.
Deleted:
<
<
 
  • build-month = string with the month abbreviation when this BLAHP server was built or released. Permitted values are: "Jan", "Feb", "Mar", "Apr", "May", "Jun",
Line: 520 to 484
 
  • build-day-of-month = day of the month when BLAHP server was built or released; an integer between 1 and 31 inclusive.
Deleted:
<
<
 
  • build-year = four digit integer specifying the year in which the BLAHP server was built or released.
Deleted:
<
<
 
  • general-descrip = a string identifying a particular BLAHP server implementation.
Added:
>
>

+ Result Line: None.
+ Example:
S: VERSION R: S $GahpVersion: x.y.z Feb 31 2004 INFN\ Blahpd $
 
Changed:
<
<
+ Result Line:

None.

+ Example:

S: VERSION
      R: S $GahpVersion: x.y.z Feb 31 2004 INFN\ Blahpd $
>
>
  • QUIT: Free any/all system resources (close all sockets, etc) and terminate as quickly as possible.
    + Request Line: QUIT <CRLF>
    + Return Line: S <CRLF>
    Immediately afterwards, the command pipe should be closed and the BLAHP server should terminate.
    + Result Line: None.
 
Added:
>
>
  • RESULTS: Display all of the Result Lines which have been queued since the last RESULTS command was issued. Upon success, the first return line specifies the number of subsequent Result Lines which will be displayed. Then each result line appears (one per line) -- each starts with the request ID which corresponds to the request ID supplied when the corresponding command was submitted. The exact format of the Result Line varies based upon which corresponding Request command was issued.
    IMPORTANT: Result Lines must be displayed in the exact order in which they were queued!!! In other words, the Result Lines displayed must be sorted in the order by which they were placed into the BLAHP's result line queue, from earliest to most recent.
    + Request Line: RESULTS
    + Return Line(s): S <SP><num-of-subsequent-result-lines> <CRLF> <SP> ... <CRLF> <SP> ... <CRLF>...
    * reqid = integer Request ID, set to the value specified in the corresponding Request Line.
    + Result Line: None.
    + Example:
S: RESULTS
      R: S 1
      R: 100 0
 
 
This site is powered by the TWiki collaboration platformCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback