[This is preliminary documentation and subject to change.]
An RSM operator request is a request for a human operator to perform a task. Operator requests can be issued by RSM or by RSM applications. RSM generates operator requests in the following situations:
Operator requests are displayed in the RSM MMC snap-in. Operators can satisfy or cancel operator requests. When an operator satisfies an operator request, the operator must acknowledge the request in the RSM MMC snap-in. When an operator cancels an operator request, RSM notifies the application that generated the request. RSM saves operator requests for less than one hour after they have been satisfied or canceled.
The RSM API includes the following functions to manage operator requests.
This function submits an operator request and returns the status of the request (Satisfied or Cancelled) or times out (if the operator does not act upon the request). The dwRequest parameter of this function specifies the request type. Use the NTMS_OPREQ_MESSAGE type for your application messages.
Typically, applications use the SubmitNtmsOperatorRequest function to submit operator requests and use the WaitForNtmsOperatorRequest function to wait for their resolution.
This function cancels an existing operator request.
If an application detects that the operator did not acknowledge a satisfied operator request, the application can use this function to remove the request.