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.


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