The problem comes in when a user has to update code that isn't laid out the way that the author describes. He'll spend a lot of time scratching his head instead of saying "Oh, this is an expression. How does it expand?"
Give examples, and refer the reader to the proper place for the actual rules. -- 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: Friday, June 5, 2020 1:33 PM To: IBM-MAIN@LISTSERV.UA.EDU Subject: Re: Gratuitous EXECIO Documentation On Fri, 5 Jun 2020 17:11:37 +0000, Seymour J Metz wrote: >As a guy who has had to support users who acted based on incorrect material in >manuals, I would prefer that the writer refer the reader to another section >orto another manual rather than introducing garbled versions of what they say. >In particular, there is adequate coverage of issuing commands in Chapter 2. >REXX general concepts, > I strongly agree. >Commands to external environments. If they must issue excess verbiage then >they should get it right. > >The verbiage he quoted is defective; they should drop or reword it. > I don't see the error, unless you mean that the example: "EXECIO * DISKR MYINDD (FINIS STEM MYVAR" might be replaced by: Larry = "EXECIO" Moe = "*" Curly = "DISKR" Larry Moe Curly "DISKR MYINDD (FINIS STEM MYVAR" I'd expect "MYVAR.", but it works without the period, and I've used it that way with ISPF LM Services which prohibit the period. >-----Original Message----- >From: Paul Gilmartin >Sent: Friday, June 5, 2020 8:30 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. -- 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
