On Tue 26 September, 2006 19:49 Charles Mills wrote:

[I think your clock is a little fast...]

> ACCESS XXXXX(IN|OUT) other parameters ...
> 
> what should XXXXX be? TYPE seems non-specific, "could be anything."
> DIRECTION seems overblown and over-long. IO(IN|OUT) is kind 
> of confusing.

I agree with John Gilmore that there is no need for an XXXXX keyword. Just
use IN, OUT, <whatever>, as keywords in their own right.

Of course if you have multiple datasets that this choice might apply to, and
individual choice makes sense in your product, you'll need something else.
You might use something along the line of INDATASET(dsname) and
OUTDATASET(dsname). This is what several AMS commands use, though I hesitate
to recommend AMS as a model of command syntax. As for DIRECTION being long,
you could always accept unambiguous abbreviations, and most people would
probably use DIR(...).

> This sounds like a trivial question but I believe in good 
> design and I've been thinking about this off and on for a 
> couple of weeks and have not been able to come up with a good 
> answer. I usually look to the IBM products for examples -- 
> following the IBM lead seems like the principle of least 
> surprise  [...]

I wish IBM cared as much about this as you do.

Tony H.

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [EMAIL PROTECTED] with the message: GET IBM-MAIN INFO
Search the archives at http://bama.ua.edu/archives/ibm-main.html

Reply via email to