KEDS gate, CREATE_TCB function
The CREATE_TCB function of the KEDS gate creates the default task for a new MVS TCB, and MVS posts the TCB to start execution. The default task is the task, associated with the TCB, that executes the dispatcher loop which chooses the next CICS task (system or non-system) to be dispatched, or if no CICS task is to be dispatched, issues an MVS WAIT.
Input Parameters
- ATTACH_TOKEN
- is the 31-bit token that uniquely identifies the request. This token is returned on the corresponding TASK_REPLY to identify the request.
- ESSENTIAL_TCB
- indicates whether CICS is to be terminated if a TCB in this mode has its ESTAE exit driven for a non recoverable error.
- Values for the parameter are:
- ESSENTIAL_NO
- ESSENTIAL_YES
- EXEC_CAPABLE
- indicates whether support should be provided under the new TCB for CICS API commands.
- Values for the parameter are:
- EXEC_NO
- EXEC_YES
- INHERIT_SUBSPACE
- indicates whether TCBs in this mode are to inherit the subspace of the attaching TCB.
- Values for the parameter are:
- INHERIT_NO
- INHERIT_YES
- LE_ENVIRONMENT
- indicates whether CICS should tell Language Environment that it is running in a CICS environment under this TCB. If LE_CICS is specified, Language Environment will issue CICS API commands.
- Values for the parameter are:
- LE_CICS
- LE_MVS
- MODENAME
- specifies the mode of the new TCB.
- PARENT_MODENAME
- identifies the mode of the TCB that is to ATTACH the new TCB.
- PRTY_RELATIVE_TO_QR
- gives the priority of this TCB relative to QR.
- TCB_KEY
- specifies the key to be specified on the ATTACH of TCBs in this mode. The value ends up in TCBPKF.
- Values for the parameter are:
- KEY8
- KEY9
- DEPENDENT_ON
- Optional Parameter
- specifies that the TCB is dependent on the named parent TCB mode.
- PTHREAD
- Optional Parameter
- A binary value that indicates if a pthread is to be created.
- Values for the parameter are:
- NO
- YES
- SZERO
- Optional Parameter
- gives the value (YES or NO) of the SZERO parameter for the ATTACH request. If TCB_KEY(USERKEY) is specified, SZERO(NO) is assumed.
- Values for the parameter are:
- SZERO_NO
- SZERO_YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- INQUIRE_ERROR
- VECTOR_FULL
- The following values are returned when RESPONSE is EXCEPTION:
- ADD_KTCB_ERROR
- ADD_TASK_ERROR
- ATTACH_KTCB_ERROR
- INVALID_CALLING_MODE
- MVS_TCB_ADDRESS
- The address of the newly created MVS TCB.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- TASK_TOKEN
- is the 31-bit token that uniquely identifies the newly created task.