Description

The STORAGE macro requests that the system obtain or release an area of virtual storage in the primary address space. The two functions of the macro are:

STORAGE OBTAIN, which obtains virtual storage in an address space
STORAGE RELEASE, which releases virtual storage in an address space.

If you use STORAGE OBTAIN to request real storage backing above 2 gigabytes, but your system does not support 64-bit storage, your request will be treated as a request for backing above 16 megabytes, even on earlier releases of z/OS® that do not support backing above 2 gigabytes. However, boundary requirements indicated by the CONTBDY and STARTBDY parameters will be ignored by earlier releases of z/OS.

Environment

The requirements on the caller are:

Environmental factor	Requirement
Minimum authorization:	For subpools 0-127: problem state and PSW key 8-15. For subpools 131 and 132: a PSW key mask (PKM) that allows the calling program to switch its PSW key to match the key of the storage to be obtained or released.
Dispatchable unit mode:	Task
Cross memory mode:	Any PASN, any HASN, any SASN
AMODE:	24- or 31- or 64-bit
ASC mode:	For LINKAGE=SYSTEM: Primary or AR For LINKAGE=SVC: Primary
Interrupt status:	Enabled for I/O and external interrupts
Locks:	No locks held.
Control parameters:	No requirement.

Programming requirements

None.

Restrictions

None.

Register information

Register usage varies depending on the type of STORAGE request. For specific information, see the descriptions of STORAGE OBTAIN and STORAGE RELEASE.

Performance implications

None.