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

DESTROYMETHOD Command

The DESTROYMETHOD command destroys an existing method. However, you cannot destroy a method if it has associated data, such as time blocks, method level parameters, or parameter overrides, at either the entity level or the time block level. Delete the associated data in this order:

1. All parameter overrides
2. Method level parameters
3. All time blocks

Note: For more information, see the descriptions of the DESTROYPARM and DESTROYTIME commands.

This command has the following format:

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

KEY

Specifies the key of the method to be deleted.

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 method, all associated parameters and time blocks are deleted. If you specify CASCADE(NO) for a method that has associated parameters and time blocks, the command fails.

Return Information:

After DESTROYMETHOD 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 about obtaining associated data, see the following REXX programs located in the CA Automation Point installation directory \sample\nm:

• listparm.rex
• listtime.rex

Example:

The following example removes the entry method with key 200002222 from the database:

ADDRESS VOX "DestroyMethod KEY(200002222)"