List Patch Removal Candidates

The List Patch Removal Candidates tool enables you to list the targets in BMC Database Automation from which the specified patch can be removed.

To use the tool, type the following command:

patch_removal_candidates.pl <manager_fqn> <exec_id> <patch_name>

Command Line Argument	Description
`manager_fqn`	The DNS name or fully qualified domain name of the BMC Database Automation manager on which to perform the operation.
`exec_id`	A unique identifier provided by the caller which will be used for creation of the logfile. This can be used so that the caller can subsequently locate log files correlated to the instance of the program that called the command.
`patch_name`	The name of the patch to provide candidates for.

Command Line Exit Value	Meaning
`0`	Success
`1`	Unknown error
`2`	Failed to connect to manager
`50`	Authentication failed: incorrect username/password
`51`	Authorization failed: insufficient capability to perform operation

User example

The following command lists the targets on bdamgr.mycompany.com:8087 from which "Oracle Patch xyz" can be removed:

patch_removal_candidates.pl https://bdamgr.mycompany.com:8087 2013-MAY-30 "Oracle Patch xyz"

Note

If there are no targets on which the specified patch can be removed, the tool will exit successfully but return an empty list.