[DRMAA-WG] Updated DRMAA spec for your review

[Rajic, Hrabri]

The 4th Experimental document reference link and its name would change
by the time we are done with the public review process, so that is one
comment that we need to file once the updated document is posted.

Hrabri

>-----Original Message-----
>From: drmaa-wg-bounces at ogf.org [mailto:drmaa-wg-bounces at ogf.org] On
Behalf
>Of Rajic, Hrabri
>Sent: Wednesday, August 29, 2007 10:32 AM
>To: Peter Troeger
>Cc: drmaa-wg at ogf.org
>Subject: Re: [DRMAA-WG] Updated DRMAA spec for your review
>
>Thx Peter,
>
>Great comments!   Here is updated version.
>
>All,
>
>Please provide corrected sentences (or parts) text, so we could tune
the
>modifications faster.
>
>Regards
>
>	Hrabri
>
>>-----Original Message-----
>>From: Peter Troeger [mailto:peter.troeger at hpi.uni-potsdam.de]
>>Sent: Wednesday, August 29, 2007 5:29 AM
>>To: Rajic, Hrabri
>>Cc: drmaa-wg at ogf.org
>>Subject: Re: [DRMAA-WG] Updated DRMAA spec for your review
>>
>>Hi Hrabri,
>>
>>thanks for the work. Here are my comments:
>>
>>General comment:
>>
>>	I would suggest to use consistently the terms "Proposed
>>Recommendation (GFD-R-P)" and "Grid Recommendation (GFD-R)",
>>according to GFD.1.
>>
>>"This document supercedes GFD-22 OGF document [GDF.22]"
>>
>>	The reference should be [GFD.22]
>>
>>"It is an updated version of the  original document, based on the
>>feedback from four independent DRMAA implementations as documented in
>>the OGF Experimental documents."
>>
>>	I would list them up with references, since we have official OGF
>>document numbers for three of them.
>>
>>" Listed drama_w* routines parameters with parameter comments."
>>
>>	Spelling error.
>>
>>"Explicit listing of all error codes at the end of routines"
>>
>>	I would state this as "Explicit specification of all error
>codes",
>>which was identified as basic need by the implementors. The spec
>>became more precise here.
>>
>>I would also list up the tracker item numbers, just to the express
>>the amount of work invested:
>>
>>* Explicit listing of all error codes at the end of routines. (1171 -
>>1172,1175 - 1178, 1180 - 1181, 1783 - 1184, 1186 - 1191 )
>>* Explicit and more self-sufficient text of the API semantics. (5884,
>>5882, 1786, 781, 1126, 1040, 1400)
>>o Clarification of the multithreading issues. (1174, 1793, 5879)
>>o Much detailed explanation about job reaping provided. (1568, 1686)
>>o Clarification of control routines behavior for sets of job. (1173,
>>1683, 1357)
>>o Clarification of drmaa_w* routine semantics. (1125)
>>o Listed drama_w* routines parameters with parameter comments. (1125)
>>* JOB_IDS_SESSION_ANY and JOB_IDS_SESSION_ALL constants definition.
>>(1289)
>>o Information that job submission calls are nonblocking. (5884)
>>o In which attributes is the special index placeholder allowed. (5873)
>>
>>Another modification was the change to the OGF document template.
>>
>>Regards,
>>Peter.
>>
>>
>>
>>Am 29.08.2007 um 07:10 schrieb Rajic, Hrabri:
>>
>>> Hi all,
>>>
>>> Here is the modified spec GFD.22 mod2.pdf, according to Steven's
>>> suggestions and a fully commented text of the previous final spec
>>> version, so you could scan for the spec modifications yourselves to
>>> verify the new test.
>>>
>>> If you copy the sections of the new text in separate e-mails when
>>> responding, than the comments/edits could be done in parallel.
Send
>>> then to all the people, so we could  reach a quick consensus if
>>> needed.
>>>
>>> I have put back the original authors list, plus the maintainer to
>make
>>> it consistent with the old version.
>>>
>>> If you could provide the comments by 4pm or earlier my time today,
>>> so I
>>> could do the modifications and engage Steven that would be great.
>>>
>>> Greetings
>>>
>>> -Hrabri
>>>
>>> <ggf-rec-drmaa-1_0-2nd_stage_final_comments.pdf>
>>> <GFD.22 mod2.pdf>
>>> --
>>>   drmaa-wg mailing list
>>>   drmaa-wg at ogf.org
>>>   http://www.ogf.org/mailman/listinfo/drmaa-wg