Parameters
- SIZE=
- Specifies the number of bytes of storage to obtain. If the address
form is specified, it must be the address of a fullword containing
a number that specifies the number of bytes required. If you use register
0, the number of bytes must be in the low-order three bytes of the
register.
The SIZE and SP parameters can not specify the same register.
For storage obtained in virtual storage above 16 megabytes, the size value specified may be greater than 16 megabytes. The amount available is determined by the REGION parameter on the JCL used to start JES3 or by the default set by the IEFUSI exit.
Note: Do not use registers 4 or 7 for SIZE=. - LOC=
- Defines the residence requirements of the storage being obtained,
using the same manner as LOC= on the MVS™ GETMAIN
macro. This is as follows:
- BELOW
- Obtain storage in virtual storage from below 16 megabytes. Pages are backed below 16 megabytes central when fixed.
- (BELOW,ANY)
- The same as BELOW except that pages may be backed anywhere in central when fixed.
- ANY
- Obtain storage from anywhere in virtual storage (normally above 16 megabytes). Pages may be backed anywhere when fixed.
- (ANY,ANY)
- The same as ANY.
- RES
- Obtain storage from the same residence as the calling program. If the calling program resides in storage below 16 megabytes, the storage is obtained below 16 megabytes virtual, and central storage is backed below 16 megabytes central when fixed. If the calling program resides in virtual storage above 16 megabytes, the storage is obtained from anywhere in virtual storage and is backed anywhere in central storage when fixed.
- (RES,ANY)
- The same as RES except storage may be backed anywhere in central storage when fixed regardless of the residence of the calling program.
- SP=
- Specifies the number of the subpool from which to get the storage.
If SP= is omitted, subpool 13 is assumed. If
SP= is specified as a register, the subpool number must be in the
low-order byte of the register. The other bytes may contain any values.
If in register 1, the other bytes will be changed by the macro expansion.
The SP and SIZE parameters can not specify the same register. Do not use registers 4 or 7 for SP=.
- MODE=
- Specifies whether the caller can be running in DSP, IRB, or
SRB modes. This parameter generates code that determines the mode
at run time. You may specify one value, two values, or three values,
and in any order. But you may use an individual value only one time.
If you specify more than one value for this parameter, you must enclose
the values in parentheses. If you specify only one value, you may
omit the parentheses.
An example of MODE= is: MODE=(IRB,SRB,DSP)
- BNDRY=
- DBLWD
- Specifies that the obtained storage is to be on a doubleword boundary.
- PAGE
- Specifies that the obtained storage is to be on a page boundary.