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 subtask. 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 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 address in register (2) - (12).

DE=`list entry addr`	`list entry addr`: RX-type address, or address in register (2) - (12).

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

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

,DPMOD=`disp prior nmbr`	`disp prior nmbr`: Symbol, decimal digit, or address in 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 address in register (2) - (12).

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

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

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

,SZERO=YES
,SZERO=NO

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

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

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

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

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

,SM=PROB	Default: SM=PROB
,SM=SUPV

,SVAREA=YES	Default: SVAREA=YES
,SVAREA=NO

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

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

,DISP=YES	Default: DISP=YES
,DISP=NO
,DISP=RESET,TCB=`tcb addr`	`tcb addr`: RX-type address or address in register (2) - (12)

,TID=`task id`	`task id`: Decimal digits 0-255, or address in register (2) - (12).
	Default: TID=0
	Note: IBM® recommends that you specify a value less than 200.

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

,RSAPF=NO	Default: RSAPF=NO
,RSAPF=YES

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

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

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

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

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 macro, with these exceptions:

,MF=(E,prob addr)
,SF=(E,ctrl addr)
,MF=(E,prob addr),SF=(E,ctrl addr): Specifies the execute form of the ATTACH or ATTACHX macro. It uses a remote user parameter list, a remote control parameter list, or both.

Note:

When STAI is specified on the execute form, these fields are overlaid in the control parameter list: exit addr, parm addr, PURGE, and ASYNCH. When parm addr is not specified, zero is used. When PURGE or ASYNCH are not specified, defaults are used.
When ESTAI is specified on the execute form, these fields are overlaid in the control parameter list: exit addr, parm addr, PURGE, ASYNCH, and TERM. When parm addr is not specified, zero is used. When PURGE, ASYNCH, or TERM are not specified, defaults are used.
The STAI or ESTAI must be completely specified on either the list or execute form, but not on both forms.
When SZERO is not specified on the list or execute form, the default is SZERO=YES. When SZERO=NO is specified on either the list form or a previous execute form using the same SF=list, SZERO=YES is ignored for any subsequent execute forms of the macro. Once SZERO=NO is specified, it is in effect for all users of that list and cannot be overridden.
When RSAPF is not specified on the list or execute form, the default is RSAPF=NO. When RSAPF=YES is specified on either the list form or a previous execute form using the same SF=list, RSAPF=NO is ignored for any subsequent execute forms of the macro. Once RSAPF=YES is specified, it is in effect for all users of that list and cannot be overridden.
You cannot specify DISP=RESET,TCB=tcb addr on the List Form. However, you can build a list by using only the SF=L parameter, and use that list for the execute form that specifies DISP=RESET,TCB=tcb addr.