Data Manipulation Language Statements › #ATTACH—instructs the system to initiate a new task › #ATTACH Status Codes

#ATTACH Status Codes

By default, the attach request is unconditional. Error conditions that can occur are described below:

• A maximum-task condition will result in a delay until another task terminates. The maximum number of active tasks is set during system generation.
• Any abnormal condition will result in an abend. Conditions in this category include:
  • Invalid task code specified
  • The user signed on to the issuing task is denied access to the requested new task because of a security violation

The issuing program can request return of control to avoid a delay or an abend by using the COND parameter.

After completion of the #ATTACH request, the value returned to register 15 indicates the outcome of the operation. The following is a list of the Register 15 values and the corresponding meaning:

X'00'

The request has been serviced successfully.

X'04'

The request cannot be serviced because the maximum number of tasks have already been attached; no new tasks can currently be attached.

X'08'

The request cannot be serviced due to an invalid task code.

X'0C'

The request cannot be serviced due to a task security violation.

X'14'

The task cannot be attached because the maximum concurrent task limit (for that task code) has been exceeded.

Additionally, the values in two user-defined registers or fullwords contain information:

• Register n contains the address of the ECB of the initiated task is found in the register or fullword assigned by the ECB= parameter. If the task has been set ready-to-run, as described above for the ECB parameter, this register is not set.
• Register m contains the address of the TCE of the initiated task is placed in the register or fullword assigned by the TCEADDR parameter.