> Some problems solved by looking at the V1R12.0 PDF online. LINKAGE=SYSTEM is > documented, but BRANCH=SVC is still there, and no discussion of LINKAGE for > STORAGE RELEASE. > > Charles > > -----Original Message----- > From: IBM Mainframe Discussion List [mailto:ibm-m...@bama.ua.edu] On Behalf > Of Charles Mills > Sent: Tuesday, August 31, 2010 6:11 PM > To: IBM-MAIN@bama.ua.edu > Subject: Where doc for STORAGE LINKAGE=SYSTEM? > > I'm looking at page 119 of z/OS V1R10.0 MVS Assembler Services SET-WTO, the > STORAGE macro. There is a very brief mention of LINKAGE=SYSTEM. However, at > the beginning of the chapter, where it discusses register usage, there is > only a description of LINKAGE=SVC and LINKAGE=BRANCH. What am I not seeing? > > FWIW, the whole beginning of the chapter seems a little garbled. There are > introductory sections called Input and Output Register Information that > appear to be correct only for LINKAGE=SVC, and under "Input Register > Information for LINKAGE=SVC" there is a reference to something called > BRANCH=SVC (which is contradictory and not supported by the macro). > > Further, there is no documentation for LINKAGE= with STORAGE RELEASE. Is it > not supported or is the documentation wrong?
LINKAGE= is supported for STORAGE RELEASE in the same way it is supported for STORAGE OBTAIN. The LINKAGE keyword has always been present on the STORAGE macro since its creation in MVS/ESA SP3.1.0, However, the only supported value was the default of LINKAGE=SYSTEM. The other LINKAGE values (SVC, BRANCH, GLOBALBRANCH) were added in z/OS 1.6 (although not documented in the manuals until z/OS 1.7) to be equivalent to GETMAIN/FREEMAIN RC/RU/VRC/VRU, so that we would no longer need to add new functions to the GETMAIN/FREEMAIN macros. If you think the beginning of the chapter seems a little garbled, try understanding and enhancing the source code for GETMAIN/FREEMAIN. As always, we recommend sending a note to mhvr...@us.ibm.com describing any problems you find in the manuals. Jim Mulder z/OS System Test IBM Corp. Poughkeepsie, NY ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to lists...@bama.ua.edu with the message: GET IBM-MAIN INFO Search the archives at http://bama.ua.edu/archives/ibm-main.html