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.


dfhs3_KEDScreate_tcb.html | Timestamp icon Last updated: Monday, 5 June 2017