A note about quoting constants might be appropriate if it reflected a correct understanding of REXX. The quoted text should be fixed, made general and show an example.
BTW, would you repeat essentially the same verbiage for, e.g., EXECUTIL? -- Shmuel (Seymour J.) Metz http://mason.gmu.edu/~smetz3 ________________________________________ From: IBM Mainframe Discussion List [[email protected]] on behalf of Tony Thigpen [[email protected]] Sent: Friday, June 5, 2020 12:01 PM To: [email protected] Subject: Re: Gratuitous EXECIO Documentation In my experience, over 30 years of using REXX on first VM, then VSE and now z/OS, I can't tell you how many times I have had to help people with the EXECIO syntax as it relates to "what is a keyword" and "what is a variable". I would put it at the top of the "common programming errors in REXX" list. I have seen the following error SOOOO many times: ... "STEM" line. Which should be: ... "STEM LINE." I would not consider this "gratuitous" documentation. Tony Thigpen Paul Gilmartin wrote on 6/5/20 11:29 AM: > In: > https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ikja300/dup0037.htm > > I see the verbiage: > When you use EXECIO, you must ensure that you use quotation marks > around any operands, such as DISKW, STEM, FINIS, or LIFO. Using > quotation marks prevents the possibility of the operands being > substituted > as variables. For example, if you assign the variable stem to a value in > the exec and then issue EXECIO with the STEM option, if STEM is not > enclosed in quotation marks, it is substituted with its assigned value. > > Sheesh! A similar caution might be included for any command in the Ref., > but it doesn't belong. > > "must ensure"? Well, not always. > > I infer the etiology: A troublesome user once coded: > STEM=SKIP /* perhaps */ > EXECIO ... > ... got astonishing results; went to SR; got fully proper "REJ; RTFM"; > vindictively submitted RCF. A feckless tech writer acceded and added > the paragraph. > > I strongly suspect the matter is covered properly earlier (citation needed) > in the Ref., which shouldn't be cluttered with such errant rubbish. > > (I was reading that Ref. to see whether EXECIO assembles segments > of V[B]S records. Didn't find it.) > > -- gil > > ---------------------------------------------------------------------- > For IBM-MAIN subscribe / signoff / archive access instructions, > send email to [email protected] with the message: INFO IBM-MAIN > ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN
