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

NMIGETITEM Command

This command retrieves the ask text and tell text for an item from the Notification Manager database.

This command has the following format:

ADDRESS VOX "NMIGETITEM ITEM(item) [CMDRESP(destination)] [PREFIX(varname)]"

ITEM

Specifies the item number.

CMDRESP

(Optional) Directs return information, if any, to a specific destination. For a list of valid destination values, see ADDRESS VOX Return Information in this chapter.

Default: REXX

PREFIX

(Optional) Specifies the name of the REXX stem variable (other than the default name) that contains the return information for the command.

For information about changing the default variable name, see ADDRESS VOX Return Information in this chapter.

Default: VOX.NMIGETITEM

Return Information:

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

• If the command executes successfully, the RC variable contains a value of zero. The VOX.NMIGETITEM variable contains the tell and ask information for the specified item.
• If the command does not execute successfully, the RC variable contains a nonzero value. The VOX.ERROR variable contains the complete VOX error message, which includes the four digit return code and error message text.

Example:

The following example retrieves the values of the TELL and ASK parameters for item 1234:

ADDRESS VOX "NMIGETITEM ITEM(1234)"
PARSE VAR vox.nmigetitem y 2 tellmsg (y) askmsgs (y).
Say "The TELL text for this item is" tellmsg 
Say "The ASK text for this item is" askmsgs