TISR gate, REQUEST_NOTIFY_TIME_OF_DAY function
The REQUEST_NOTIFY_TIME_OF_DAY function of the TISR gate is used to inform the timer domain that an alarm call is required from the timer domain (that is, a NOTIFY) at the specified time of day. The calling domain can request a NOTIFY on a one-off basis or daily, and the type of NOTIFY to be expected.
Input Parameters
- DOMAIN_TOKEN
- is a token that is to be passed as a parameter on the NOTIFY call.
- NOTIFY_TYPE
- specifies whether the attached task or the timer task is to be used to notify the calling domain after the specified interval of time.
- Values for the parameter are:
- ATTACHED_TASK
- TIMER_TASK
- PERIODIC_NOTIFY
- specifies whether the requested NOTIFY is to be repeated at the specified interval until canceled (YES), or is to be just a one-off NOTIFY (NO).
- Values for the parameter are:
- NO
- YES
- REQUESTED_TIME
- is the time of day at which the NOTIFY function is to be invoked. The value is specified in the form HHMMSS.
- ATTACH_MODE
- Optional Parameter
- is the optional TCB mode in which the attached NOTIFY task is to run.
- Values for the parameter are:
- CO
- FO
- QR
- RO
- ATTACH_PRIORITY
- Optional Parameter
- defines the priority, in the range 0 through 255, at which the requested NOTIFY task is to be attached.
- ATTACH_TASK_TIMEOUT
- Optional Parameter
- defines the value, in seconds, of a wait in the attached task after which the dispatcher causes a timeout.
Output Parameters
- REASON
- The values for the parameter are:
- TOO_LATE
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- TIMER_TOKEN
- is the token that is returned by the timer domain. The timer token may be used to cancel the NOTIFY request.