ADDRESS VOX Commands › Voice Commands › VERIFYUSER Command

VERIFYUSER Command

The VERIFYUSER command verifies that the remote party's user ID and password are valid.

This command has the following format:

ADDRESS VOX "VERIFYUSER USERID(userid) PIN(pin) [SYSTEM(sysname)]"

USERID

Specifies the remote party's user identification number. The userid value must contain between four and eight tone digits (valid values are 0000 through 99999999). Valid characters are: 0 1 2 3 4 5 6 7 8 9

PIN

Specifies the remote party's personal identification number (pin) password. The pin value must contain between four and eight tone digits (valid values are 0000 through 99999999). Valid characters are: 0 1 2 3 4 5 6 7 8 9

SYSTEM

(Optional) Specifies the name of the system that is running the notification server to which you want to direct the command.

The sysname value can contain up to eight alphanumeric characters.

Default: The local system name

Return Information:

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

• If the command executes successfully, the RC variable contains a value of zero.
• If the command does not execute successfully, the RC variable contains one of the following values: 5111, 5117, 5155, 5199. (See the Message Reference Guide for further information.) Additionally, the VOX.ERROR variable contains the complete VOX error message, which includes the four-digit return code and complete error message text.

Note: When assigning user IDs and PINs, we recommend that you choose tone digits that spell a name or meaningful code on the telephone keypad. For example, if a user ID is SAMJONES, the remote party with that user ID would enter these corresponding tone digits: 72656637. It is usually much easier for a remote user to remember a mnemonic string (such as a name) than it is to remember an arbitrary string of numeric digits.

Example:

The following REXX code illustrates how to use the VERIFYUSER command to verify a caller's user ID and PIN:

/* Get exclusive access to a specific voice channel. */

address vox 'getchannel channelnum(1) prefix(handle)'

/* Get the caller's user ID. */

address vox 'playgetdigits channel('handle') file(entruid.vox) count(8) singlestring(yes) prefix(userid)'

/* Get the caller's personal identification number (PIN). */

address vox 'playgetdigits channel('handle') file(entrpin.vox) count(8) singlestring(yes) prefix(pin)'
...

/* Verify that the remote user has entered a */
/* valid user-id/pin combination.            */

address vox 'verifyuser userid('userid') pin('pin')'

if RC == 0 then 
do
   /* Processing for valid remote user. */
   ...

end

/* Release the voice channel. */

address vox 'releasechannel('handle')'