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.


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