DSIT gate, ACTIVATE_MODE function
The ACTIVATE_MODE function creates a mode to which TCBs can be added (by ADD_TCB) so that tasks can CHANGE_MODE to the TCBs.
Input Parameters
- ESSENTIAL_TCB
- indicates whether CICS® is to be brought down if a TCB in this mode suffers a non recoverable abend.
- Values for the parameter are:
- ESSENTIAL_NO
- ESSENTIAL_YES
- EXEC_CAPABLE
- indicates whether TCBs in this mode are to be set up to support the use of EXEC CICS commands by code running on them.
- Values for the parameter are:
- EXEC_NO
- EXEC_YES
- IDENTITY
- is the name of the mode to be activated. It is a two byte character string.
- INHERIT_SUBSPACE
- indicates whether TCBs in this mode will be able to run application code in a subspace.
- Values for the parameter are:
- INHERIT_NO
- INHERIT_YES
- LE_ENVIRONMENT
- indicates whether Language Environment® is to run in native MVS™ mode or in CICS mode on TCBs in this mode.
- Values for the parameter are:
- LE_CICS
- LE_MVS
- MODE
- specifies the mode in which the task is to run.
- MODENAME
- 2-character mode name.
- MULTIPLE_TCBS
- indicates whether this mode allows more than one TCB.
- Values for the parameter are:
- MULTIPLE_NO
- MULTIPLE_YES
- OPEN
- indicates whether TCBs in this mode are to be managed by the Dispatcher domain as "Open TCBs".
- Values for the parameter are:
- OPEN_NO
- OPEN_YES
- PARENT_MODENAME
- the mode of the TCB that issued the request.
- PRTY_RELATIVE_TO_QR
- allows TCBs in this mode to have a different priority to that of the QR TCB.
- TCB_KEY
- indicates the key to be specified on ATTACHes of TCBs in this mode.
- Values for the parameter are:
- KEY8
- KEY9
- DEPENDENT_ON
- Optional Parameter
- indicates that TCBs of the mode being activated depend on the existence of TCBs of another mode.
- NOTIFY_DELETE
- Optional Parameter
- indicates which domain, if any, to notify when a DELETE_TCB is issued. It is the binary domain index for the domain.
- OPEN_POOL_NUMBER
- Optional Parameter
- is the number of the open TCB pool which is to contain TCBs of the newly-activated mode.
- PTHREAD
- Optional Parameter
- indicates whether to create a protected thread.
- Values for the parameter are:
- PTHREAD_NO
- PTHREAD_YES
- SZERO
- Optional Parameter
- indicates whether TCBs of the new mode should be attached with SZERO(YES) or SZERO(NO).
- Values for the parameter are:
- SZERO_NO
- SZERO_YES
- WAIT_FOR_MATCH
- Optional Parameter
- indicates if a CHANGE_MODE should consider waiting for a suitable TCB rather than using a free TCB.
- Values for the parameter are:
- NEVER
- NO_MODE
- NO_PRIMARY
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- INSUFFICIENT_STORAGE
- MODE_ALREADY_ACTIVE
- MODE_LIMIT_REACHED
- MODENAME_ALREADY_ACTIVE
- RESERVED_MODENAME
- TOO_MANY_MULTI
- The following values are returned when RESPONSE is INVALID:
- INVALID_MODE
- INVALID_POOL_NUMBER
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- MODENAME_TOKEN
- Optional Parameter
- is a token that identifies this modename.