There really is nothing that needs to be quoted. The requirement is that the
various expressions have the correct value, and there is not much practical
difference between
foo='BAR'
baz=value(foo,,env)
and
baz=value('BAR',,env)
WRT ADDRESS, the command is the value of one string expression. The arguments
are part of that value.
In general, the documentation should have a correct description followed by
some examples. The examples could include using a single string literal and
using a more complicated expression.
--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3
________________________________________
From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of
Paul Gilmartin [0000000433f07816-dmarc-requ...@listserv.ua.edu]
Sent: Saturday, June 6, 2020 1:55 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Gratuitous EXECIO Documentation
On Fri, 5 Jun 2020 17:13:58 +0000, Seymour J Metz wrote:
>foo = value('BAR',,baz)
>________________________________________
>From: Charles Mills
>Sent: Friday, June 5, 2020 12:27 PM
>
>It is SO counter-intuitive to put the name of a variable in quotes. You would
>not code ENQ ('MYMAJOR','MYMINOR',E,8).
>Once you realize that EXECIO is an external command, not a language keyword,
>you start to get it.
>
Rexx grammar is a glorious context-sensitive chaos. As when
I tried to understand the ANSI spec for ADDRESS and failed.
MFC's intent was to be intuitive rather than axiomatic.
Perhaps Rexx General Concepts should contain a section
on use of symbol names with an incomplete list:
PROCEDURE EXPOSE
not quoted
ADDRESS
sometimes not quoted
VALUE(); SYMBOL();
quoted
ADDRESS LINK*/ATTCH*
arguments quoted in separate strings
EXECIO ... ( STEM )
quoted
Documented elsewhere:
BPXWDYN( ... MSG() )
stem, descriptor, keyword lexically distinguished
BPXWUNIX( stdin, stdout, stderr )
stem, ddname lexically distinguished
ADDRESS SYSCALL
quoted ( symbol name )
ADDRESS ISPEXEC/ISREDIT
shared variable references
ADDRESS SDSF
various stems
And your favorites?
-- gil
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
