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

DESTROYTIME Command

The DESTROYTIME command destroys an existing time block. However, you cannot destroy a time block if it has a parameter override. First you must delete the parameter override at the time block level.

This command has the following format:

ADDRESS VOX "DESTROYTIME KEY(key) [CASCADE(YES|NO)]"

KEY

Specifies the key of the time entry to be removed.

CASCADE

(Optional) Values are:

YES

Destroy all other items in the database that refer to this item.

NO

Do not destroy any other items in the database that refer to this item.

Default: NO

For example, if you specify CASCADE(YES) when deleting a time block, all of the time block-specific parameter overrides are deleted. If you specify CASCADE(NO) for a time block that has time block- specific parameter overrides, the command fails.

Return Information:

After DESTROYTIME 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 a nonzero value. Additionally, the VOX.ERROR variable contains the complete VOX error message, which includes the four digit return code and error message text.

Usage Notes:

For more information on obtaining associated data, see the listtime.rex REXX program.

Example:

The following example removes the entry for the time with key 400002267 from the database:

ADDRESS VOX "DestroyTime KEY(400002267)"