IBM Tivoli Monitoring, Version 6.3

tacmd clearDeployStatus

Description

Use the tacmd clearDeployStatus command to remove entries from the table that stores the status of the asynchronous agent deployment operations. The command allows you to clear all the entries in the status table. This command also provides the option of filtering the table entries which deletes specific entries from the status table entries down to a specific deployment operation. You must log in by using the tacmd login command before running the tacmd clearDeployStatus command.

Note: Remote Deployment is not supported in environments with a z/OS Tivoli Enterprise Monitoring Server. This restriction includes this command.

CLI syntax

Clear all the entries in the status table, except in-progress entries:

tacmd clearDeployStatus {-a|--all}

Clear all the entries in the status table, including in-progress entries:

tacmd clearDeployStatus {-a|--all} {-i|–inprogress}

Clear specific deployment operation in the status table:

tacmd clearDeployStatus
                      [{-g|--transactionID}TRANSID ...]
                      [{-c|--command} COMMAND]
                      [{-h|--hostname} HOSTNAME]
                      [{-p|--platform} PLATFORM...]
                      [{-v|--version} VERSION]
                      [{-t|--product}]
                      [{-f|--failed}]
                      [{-s|--successful}]
                      [{-q|--queued}]
                      [{-r|--retryable}]
                      [{-i|--inprogress}]
                      [{-y|--yes}]
                      [{-a|--all}]

where:

--g|--transactionID: Specifies global transaction ID.
c|--command: Specifies the type of the deployment operation. Acceptable operations are: START, RESTART, STOP, INSTALL, REMOVE, CONFIGURE, UPDATE, CHECKPREREQ, or SETAGENTCONN.
-h|--hostname: Specifies the hostname of the deployment operation that is deleted from the status table.
-p|--platform: Specifies the platform of the deployment operation that is deleted from the status table.
-v|--version: Specifies the version of the deployment operation that is deleted from the status table.
-t|--product: Specifies the product type of the deployment operation that is deleted from the status table.
-f|--failed: The flag to filter the result by the failed transaction.
-s|--successful: The flag to filter the result by the successful transaction.
-q|--queued: The flag to filter the result by the queued transaction.
-r|--retryable: The flag to filter the result by the retryable transaction.
-i|--inprogress: The flag to allow the clearing of an i-progress transaction.
Note: This flag cannot be used on its own and the user must confirm the action of clearing an in-progress transaction (unless the -y|--yes option in specified).
-y|--yes: The flag specifying the performing of actions without requesting confirmation.
-a|--all: This option clears all the entries in the Remote Deploy status table, except for the in-progress entries (unless the -i|--inprogress option is specified).

CLI example

The following command clears the deployment status for the transaction ID "121730470371900000015724" on the Tivoli® Enterprise Monitoring Server you are logged on to:

tacmd cleardeploystatus -g 121730470371900000015724

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback