List Patch Candidates

The List Patch Candidates tool enables you to list the possible targets in BMC Database Automation against which the specified patch can be applied.

To use the tool, type the following command:

patch_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
`4`	Specified patch was not found
`50`	Authentication failed: incorrect username/password
`51`	Authorization failed: insufficient capability to perform operation

User example

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

patch_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 applied, the tool will exit successfully but return an empty list.