Description

The STORAGE macro requests that the system obtain or release an area of virtual storage in the primary address space (by default), or in the address space defined through the ALET parameter. The two functions of the macro are:

STORAGE OBTAIN, which requests an area of virtual storage.
STORAGE RELEASE, which releases an area of virtual storage.

The STORAGE macro is also described in z/OS MVS Programming: Assembler Services Reference IAR-XCT, with the exception of the ALET, TCBADDR, and OWNER parameters.

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 for the caller are:

Environmental factor	Requirement
Minimum authorization:	For subpools 0-127: problem state and PSW key 8-15. For subpools 131 and 132, one or more of the following: Supervisor state PSW key 0-7 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. APF-authorization. For the ALET parameter and the TCBADDR parameter, either of the following: Supervisor state PSW key 0-7 For LINKAGE=SYSTEM or LINKAGE=SVC: for all other subpools, one or more of the following: Supervisor state PSW key 0-7 APF-authorization. For LINKAGE=BRANCH or LINKAGE=GLOBALBRANCH: Supervisor state and PSW key 0. To issue a subpool release for subpool 0: PSW key 0.
Dispatchable unit mode:	For LINKAGE=SVC: Task For LINKAGE=SYSTEM, LINKAGE=BRANCH, or LINKAGE=GLOBALBRANCH: Task or SRB
Cross memory mode:	For LINKAGE=SVC: PASN=HASN=SASN For LINKAGE=SYSTEM, LINKAGE=BRANCH, or LINKAGE=GLOBALBRANCH: Any PASN, any HASN, any SASN
AMODE:	For LINKAGE=SYSTEM or LINKAGE=SVC: 24- or 31- or 64-bit For LINKAGE=BRANCH or LINKAGE=GLOBALBRANCH: 24- or 31-bit. If in AMODE 64, code SYSSTATE AMODE64=YES before invoking this macro.
ASC mode:	For LINKAGE=SYSTEM, LINKAGE=BRANCH, or LINKAGE=GLOBALBRANCH: Primary or access register (AR). For LINKAGE=SVC: Primary If in AR mode, code SYSSTATE ASCENV=AR before invoking this macro.
Interrupt status:	For LINKAGE=SYSTEM: Enabled for I/O and external interrupts if obtaining or releasing private storage. Enabled or disabled for I/O and external interrupts if obtaining or releasing common storage. For LINKAGE=SVC or LINKAGE=BRANCH: Enabled for I/O and external interrupts. For LINKAGE=GLOBALBRANCH: Disabled for I/O and external interrupts.
Locks:	For LINKAGE=SYSTEM: No requirement. You may hold the local lock for the target address space. If you hold the local lock, you may also hold the CMS lock. You may hold the CPU lock when obtaining or releasing common storage. For LINKAGE=SVC: No locks may be held. For LINKAGE=BRANCH: Your program must hold the local lock for the currently addressable address space. When running in cross-memory mode, this is the CML lock for that address space. The currently addressable address space must be the address space from which the storage is to be obtained. For LINKAGE=GLOBALBRANCH: Your program must be in an MVS-recognized state of disablement, which can be attained by obtaining the CPU lock.
Control parameters:	No requirement.

Environment

Programming requirements

Restrictions

Register information

Performance implications