z/OS MVS Programming: Assembler Services Reference ABE-HSP
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


GETMAIN—Execute form

z/OS MVS Programming: Assembler Services Reference ABE-HSP
SA23-1369-00

A remote control program parameter list is used in, and can be modified by, the execute form of the GETMAIN macro. The parameter list can be generated by the list form of either a GETMAIN or a FREEMAIN. The execute form of the GETMAIN macro cannot be used to allocate virtual storage with addresses greater than 16 megabytes.

The execute form of the GETMAIN macro is written as follows:

Syntax Description
   
   name name: symbol. Begin name in column 1.
   
One or more blanks must precede GETMAIN.
   
GETMAIN  
   
One or more blanks must follow GETMAIN.
   
   LC  
   LU  
   VC  
   VU  
   EC  
   EU  
   
   ,LA=length addr length addr: RX-type address or register (2) - (12).
   ,LV=length value length value: symbol, decimal number, or register (2) - (12).
Note:
  1. LA may not be specified with EC or EU above.
  2. LV may not be specified with LC, LU, VC, or VU above.
   
   ,A=addr addr: RX-type address, or register (2) - (12).
   
   ,SP=subpool nmbr subpool nmbr: symbol; decimal number 0-127, 131, 132; or register (2) - (12).

Default: SP=0

Note: Specify the subpool as follows:
  • Use the SP parameter for LC, LU, VC, VU, EC, EU, RC, RU, VRC, and VRU requests, and for R requests where LV does not indicate register 0.
  • Use register 0 for R requests with LV=(0); do not code the SP parameter. The low-order three bytes of register 0 must contain the length of the requested storage, and the high-order byte must contain the subpool number.
   
   ,BNDRY=DBLWD Default: BNDRY=DBLWD
   ,BNDRY=PAGE  
   
   ,RELATED=value value: any valid assembler character string.
   
,MF=(E,list addr) ctrl prog: RX-type address, or register (1) or (2) - (12).
   

The parameters are explained under the standard form of the GETMAIN macro, with the following exception:

,MF=(E,list addr)
Specifies the execute form of the GETMAIN macro using a remote control program parameter list.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014