NMIANSWER Command

ADDRESS VOX Commands › Notification Manager Database Maintenance Commands › NMIANSWER Command

NMIANSWER Command

This command sets or retrieves the answer for an item in the Notification Manager database.

This command has the following format:

ADDRESS VOX "NMIANSWER ITEM(item) ANSWER(ansnum) [ANSENTITY(key)]"

ITEM: Specifies the item number.
ANSWER: Specifies a number that is the answer to the item, from 0 to 9. To set the answer for the item, specify a value from 1 to 9. To retrieve the answer for the item, specify the value 0. The answer for the problem is returned in the return code. If the problem has not been answered, the answer is 0. If the problem has already been answered, the new answer is rejected and the value of the existing answer is returned.
ANSENTITY: (Optional) Specifies the key of the answering entity. This key is used to record the entity that provided the answer to the notification request.

Return Information:

After the NMIANSWER command executes, it sets the special REXX return code variable RC.

If the command executes successfully, the RC variable contains the answer to the specified item (a numeric digit from 1 to 9). If RC=0, the specified item has not been answered.
If the command does not execute successfully, the VOX.ERROR variable contains the complete VOX error message. This message includes the four-digit return code and error message text

Example:

The following example answers item 1234, and then checks to see whether it receives the same answer on its second call. (If the SAY statement runs, there is a problem).

ADDRESS VOX "NMIANSWER ITEM(1234) ANSWER(5) ANSENTITY(100001001)"
answer = rc
ADDRESS VOX "NMIANSWER ITEM(1234) ANSWER(0)"
IF answer<>rc THEN SAY "Expected" answer "received" rc