Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
User parameters z/OS MVS Programming: Assembler Services Reference ABE-HSP SA23-1369-00 |
||||||||||
Some macros that you can issue in AR mode include control parameters,
user parameters, or both. Control parameters refer to the macro parameter
list, and the parameters whose addresses are in the parameter list.
Control parameters control the operation of the macro itself. User
parameters are parameters that a user provides to be passed through
to a user routine. For example, the PARAM parameter on the ATTACHX
macro defines user parameters. The ATTACHX macro passes these parameters
to the routine that it attaches. All other parameters on the ATTACHX
macro are control parameters that control the operation of the ATTACHX
macro.
Note:
The macros shown in Table 1 allow a caller in AR mode to pass information in the form of a parameter list (or parameter lists) to another routine. This table identifies the parameter that receives the ALET-qualified address of the parameter list and tells you where the target routine finds the ALET-qualified address.
When an AR mode caller who is using a 4-bytes-per-entry parameter
list passes ALET-qualified addresses to the called program through
PARAM,VL=1 on the ATTACH/ATTACHX, CALL, LINK/LINKX,
or XCTL/XCTLX macros, the system builds a list formatted as shown
in Figure 1. The addresses passed to the called program
are at the beginning of the list, and their associated ALETs follow
the addresses. The last address in the list has the high-order bit
on to indicate the end of the list. For example, Figure 1 shows the format of a list where an AR mode issuer
of ATTACHX who is using a 4-bytes-per-entry parameter list has
coded the PARAM parameter as follows:
When an AR mode caller who is using an 8-bytes-per-entry parameter list specifies PLIST8ARALETS=YES, the system builds a parameter list with the 8-byte addresses at the beginning of the list and their associated 4-byte ALETs following the addresses. Figure 1. Sample User Parameter
List for Callers in AR Mode
For information about linkage conventions, see the chapter in z/OS MVS Programming: Assembler Services Guide. |
Copyright IBM Corporation 1990, 2014
|