ATTACH and ATTACHX—Execute form

Two parameter lists are used on ATTACH and ATTACHX; a control parameter list and an optional user parameter list to be passed to the attached task. Either or both of these parameter lists can be remote (that is, in an area you specifically obtained); you can use the execute form of ATTACH and ATTACHX to refer to or modify them. If only the user parameter list is remote, parameters that require use of the control parameter list cause that list to be constructed inline as part of the macro expansion.

For programs in AR mode, ATTACHX builds the parameter list so that the addresses passed to the system are in the first half of the parameter list and their corresponding ALETs are in the last half of the list. Therefore, the parameter list for callers in AR mode is twice as long as the parameter list for callers in primary mode for the same number of addresses.

Syntax

The execute form of the ATTACH and ATTACHX is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede ATTACH or ATTACHX.

ATTACH ATTACHX

␢	One or more blanks must follow ATTACH or ATTACHX.

EP=`entry name`	`entry name`: Symbol.
EPLOC=`entry name addr`	`entry name addr`: RX-type address, or register (2) - (12).
DE=`list entry addr`	`list entry addr`: RX-type address, or register (2) - (12).

,DCB=`dcb addr`	`dcb addr:`: RX-type address, or register (2) - (12).

,LPMOD=`limit prior nmbr`	`limit prior nmbr:` Symbol, decimal digit, or register (2) - (12).

,DPMOD=`disp prior nmbr`	`disp prior nmbr:` Symbol, decimal digit, or register (2) - (12).

,PARAM=(`addr`)	`addr`: RX-type address
,PARAM=(`addr`),VL=1	Note: `addr` is one or more addresses, separated by commas. For example, PARAM=(`addr,addr,addr`)

,PLIST4=YES	PLIST4 is valid only with ATTACHX.
,PLIST4=NO	Default: None.

,PLIST8=YES	PLIST8 is valid only with ATTACHX.
,PLIST8=NO	Default: None.

,PLIST8ARALETS=NO	Default: PLIST8ARALETS=NO
,PLIST8ARALETS=YES	Note: PLIST8ARALETS is valid only with ATTACHX.

,ECB=`ecb addr`	`ecb addr`: RX-type address, or register (2) - (12).

,ETXR=`exit rtn addr`	`exit rtn addr`: RX-type address, or register (2) - (12).

,GSPV=`subpool nmbr`	`subpool nmbr`: Symbol, decimal digit, or register (2) - (12).
,GSPL=`subpool list addr`	`subpool list addr`: RX-type address, or register (2) - (12).

,SHSPV=`subpool nmbr`	`subpool nmbr`: Symbol, decimal digit, or register (2) - (12).
,SHSPL=`subpool list addr`	`subpool list addr`: RX-type address, or register (2) - (12).

,SZERO=YES ,SZERO=NO

,TASKLIB=`dcb addr`	`dcb addr`: RX-type address, or register (2) - (12).

,STAI=(`exit addr`)	`exit addr`: RX-type address, or register (2) - (12).
,STAI=(`exit addr,parm addr`)	`parm addr`: RX-type address, or register (2) - (12).
,ESTAI=(`exit addr`)	Note: AR mode callers and 31-bit callers must not use STA.
,ESTAI=(`exit addr,parm addr`)
SDWALOC31=NO	Note: SDWALOC31 is valid only when using ATTACHX AND when ESTAI is specified.
SDWALOC31=YES	Default: SDWALOC31=NO

,PURGE=QUIESCE	Note: PURGE may be specified only if STAI or ESTAI is specified.
,PURGE=NONE
,PURGE=HALT

,ASYNCH=NO ,ASYNCH=YES	Note: ASYNCH may be specified only if STAI or ESTAI is specified.

,TERM=NO	Note: TERM may be specified only if ESTAI is specified.
,TERM=YES

,ALCOPY=NO	Default: ALCOPY=NO
,ALCOPY=YES

,RELATED=`value`	`value`: Any valid macro keyword specification.

,KEY=PROP	Default: KEY=PROP
,KEY=NINE	Note:KEY=NINE is valid only when using ATTACHX

,PKM=SYSTEM_RULES	Default: PKM=SYSTEM_RULES
,PKM=REPLACE	Note:PKM is valid only when using ATTACHX.


,MF=(E,`prob addr`)	`prob addr`: RX-type address, or register (1) or (2) - (12).
,SF=(E,`ctrl addr`) ,MF=(E,`prob addr`),SF=(E,`ctrl addr`)	`ctrl addr`: RX-type address, or register (2) - (12) or (15).

,ADDRENV=SAME ,ADDRENV=SUBSP	Default: ADDRENV=SAME

Parameters

Some parameters in the syntax diagram are only available on the ATTACHX macro. If you are using the ATTACH macro, check the standard form to ensure that the parameters that you want to use are supported by that macro.

The parameters are explained under the standard form of the ATTACH or ATTACHX, with the following exceptions:

,MF=(E,prob addr)
,SF=(E,ctrl addr)
,MF=(E,prob addr),SF=(E,ctrl addr): Specifies the execute form of ATTACH or ATTACHX using either a remote user parameter list or a remote control parameter list.
For a caller in AR mode who specifies MF=E, the parameter list that ATTACH or ATTACHX generates for the PARAM parameter is twice as long as the parameter list generated for primary mode callers.

Note:

If STAI is specified on the execute form, the following fields are overlaid in the control parameter list: exit addr, parm addr, PURGE, and ASYNCH. If parm addr is not specified, zero is used; if PURGE or ASYNCH are not specified, defaults are used.
If ESTAI is specified on the execute form, then the following fields are overlaid in the control parameter list: exit addr, parm addr, PURGE, ASYNCH, and TERM. If parm addr is not specified, zero is used; if PURGE, ASYNCH, or TERM are not specified, defaults are used.
If the STAI or ESTAI is to be specified, it must be completely specified on either the list or execute form, but not on both forms.
If SZERO is not specified on the list or execute form, the default is SZERO=YES. If SZERO=NO is specified on either the list form or a previous execute form using the same SF=L, then SZERO=YES is ignored for any following execute forms of the macro. Once SZERO=NO is specified, it is in effect for all users of that list.