ATTACH or ATTACHX macro - is type 2, gets
LOCAL lock.
Calls module IEAVEAT0.
GTF data is:
- R15
- Address of the parameter list being passed to the SVC routine
(SUPRVLIST).
- R0
- No applicable data.
- R1
- Address of the parameter list being passed to the called program,
or zeros (no parameter list being passed).
- SUPRVLIST -
- The parameter list passed to the SVC routine is 72 or 100 bytes
long. Format is:
- Bytes
- Contents
- 0-3
- Entry Address.
- 4-7
- DCB address.
- 8-11
- ECB address.
- 1... ....
- Indicates new format; else old format.
- 12-15
- Give subpool value or list address.
- 16-19
- Share subpool value or list address.
- 20-23
- ETXR address.
- 24-25
- Dispatching priority.
- 26
- Limit priority.
- 27
- Option flags.
- 1... ....
- "DISP=NO" KEYWORD GIVEN
- .1.. ....
- "JSCB" ADDRESS GIVEN
- ..1. ....
- "GIVEJPQ=YES" GIVEN
- ...1 ....
- "KEY=ZERO" KEYWORD
- .... 1...
- "SZERO=NO" KEYWORD
- .... .1..
- "SVAREA=NO" KEYWORD
- .... ..1.
- "JSTCB=YES" KEYWORD
- .... ...1
- "SM=SUPV" KEYWORD
- 28-35
- Program name.
- 36-39
- JSCB address.
- 40-43
- STAI/ESTAI parameter list address.
- 44-47
- STAI/ESTAI exit routine address.
- 48-51
- Tasklib DCB address.
- 52
- Flag byte.
- 1... ....
- ATTNSHLV field indicator.
- .1.. ....
- RSAPF indication.
- ..1. ....
- Reserved.
- ...1 ....
- Term indication.
- .... 1...
- ESTAI present indication.
- .... .1..
- ASYNCH indication.
- .... ..11
- PURGE parameter values.
- 53
- Task ID.
- 54-55
- Length of parameter list.
- 56-59
- NSHSPV or NSHSPL parameter list.
- 60
- Flag byte
- 1... ....
- Directory entry indication.
- .1.. ....
- Give subpool list indication.
- ..1. ....
- Share subpool list indication.
- ...1 ....
- Module from APF library indication.
- .... 1...
- Reserved.
- .... .1..
- Reserved.
- .... ..1.
- Tasklib DCB present.
- .... ...1
- STAI/ESTAI exit address present.
- 61
- Format number, 1 indicates a parameter list for MVS™; 2 indicates a parameter list from ATTACHX.
- 62-63
- Reserved.
- 64-67
- EP/DE ALET.
- 68-71
- DCB ALET.
- 72-75
- ECB ALET.
- 76-79
- GSPL ALET.
- 80-83
- SHSPL ALET.
- 84-87
- JSCB ALET.
- 88-91
- STAI ALET.
- 92-95
- TASKLIB ALET.
- 96-100
- NSLSPL ALET.
- Length of PLIST (1 byte):
-
- PLIST
- PLIST up to 40 bytes of parameter list passed to a program. The
parameter list is a series of 4-byte entries. Each entry has its high-order
byte reserved and an address in the low-order three bytes.
- Register contents on return:
-
- R1
- Address of TCB for the new task (for any return code other than
zero, R1 is set to zero upon return).
- R15
- 00 -
- Successful completion (subtask might not have been successfully
created).
- 04 -
- ATTACH issued in a STAE exit; processing not completed.
- 08 -
- Insufficient storage available for control block for STAI/ESTAI
request; processing not completed.
- 0C -
- Invalid address of exit routine or parameter list specified with
STAI parameter; processing not completed.