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

NMILISTANSWERS Command

This command lists the answers that are specified using the NMFIND ASK parameter (if any) for the specified notification request.

This command has the following format:

ADDRESS VOX "NMILISTANSWERS 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.

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.

Default: VOX.NMILISTANSWERS

Usage Note:

For more information on this command, see the sample REXX program listanswers.rex in the CA Automation Point installation folder \sample\nm.

Return Information:

After the NMILISTANSWERS 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.nmilistanswers.0 variable contains the number of lines of information returned. Each variable from VOX.nmilistanswers.1 to VOX.nmilistanswers.n contains a line of information. n represents the last line of return information.
• 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 list of all answers that are specified for notification request item number 1234:

ADDRESS VOX “NMILISTANSWERS ITEM(1234)”