On Wed, 4 Aug 2010 07:10:14 -0600, Steve Comstock wrote: >Tom Marchant wrote: >> On Tue, 3 Aug 2010 12:02:29 -0600, Steve Comstock wrote: >> >>> Peter Relson wrote: >>>> As to your point >>>> about >>>> allocating using space based on a format shown in a book, that is not >>>> using best programming practices when a symbol is provided in a macro. >>> I disagree. I use the docs as reference, trusting they reflect >>> the macros (which can be difficult to read in some cases, eh?) >> >> But the example in the book shows: >> GETMAIN RU,LV=SAVF5SA_LEN Get my reentrant savearea >> >> That will allocate a 216 byte save area. > >Umm, how can I tell from the example that this will be >a 216-byte save area? There are no comments in the code >nor discussion around the example to inform the reader >of the generated size; my essential point is the whole >section is not clear enough for the reader to properly >code save area linkages.
"no comments in the code nor discussion around the example to inform the reader of the generated size" Are you kidding? The example that I quoted from is on page 13 and on page 12 it reads <quote> 2. Creates its own 216-byte save area (if using F5SA) or 288-byte save area (if using F8SA), taking care to preserve the values of the high halves of any of the calling program's GPRs </quote> > >I will be re-writing the section in my course on save >area linkages so students who subsequently visit the >doc can relate to what's there. Right now, it just >doesn't tell the story clearly, in my opinion. Good luck to your students then. How can you teach what you seem not to understand? -- Tom Marchant ---------------------------------------------------------------------- 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
