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.
|