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

NMICHECKCALLER Command

This command checks to see whether an entity has been permitted to listen to or answer this item by a call to NMIADDCALLER. This sets the return code to 0 if the entity is authorized.

This command has the following format:

ADDRESS VOX "NMICHECKCALLER ENTITY(key) ITEM(item)"

ENTITY

Specifies the key of the entity.

ITEM

Specifies the item number.

Return Information:

After the NMICHECKCALLER 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 entity is permitted to answer this 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 tests whether the entity with key 100001000 is permitted to call in on item 1234:

ADDRESS VOX "NMICHECKCALLER ENTITY(100001000) ITEM(1234)"
IF rc=0 THEN SAY "Congratulations, you are authorized."