perform() - Administrative Aktionen starten

Funktion:

BcAdminRA.perform()

startet für den Resource Adapter die angegebene Aktion.

Parameter:

bc_object
(BcObject vom Typ BcObjectType.RESOURCE_ADAPTER).

Resource Adapter, für den die Aktion gestartet werden soll.

action (String)

Aktion, die für den angegebenen Resource Adapter gestartet werden soll. Mögliche Werte sind (siehe BcDef.ACTION_xxx)

check-avail	überprüft den Lauf-Status des Resource Adapters.
update-ra-xml	bringt die gesicherten Änderungen in die Konfiguration des Resource Adapter ein.

params (kw) (Dictionary)

Dictionary mit den key-value-Paaren der Parameter, die der angegebenen Aktion mitgegeben werden sollen.
Bei action="update-ra-xml", muss im Dictionary params folgendes key-value-Paar angegeben werden:
key="rar-file-patd"
value= Name der Resource Adapter-rar-Datei, in die die Konfigurationsänderungen eingebracht werden sollen.

Rückgabe:

Bei action="update-ra-xml":
True (boolean), wenn update angestoßen wurde, sonst BcToolException.
Bei action="check-avail":
bcaction (BcObject mit Typ BcObjectType.ACTION)
mit allen Informationen über die gestartete Aktion und sämtliche Teilaktionen. Um genauere Informationen zu erhalten, kann eine Funktion des Moduls BcAdminAction mit diesem Objekt als Parameter aufgerufen werden.

Exceptions:

BcObjectException, BcParameterException, BcToolException

Beispiel:

...
import BcAdminRA
import BcAdminProxy
...
proxy_obj=BcAdminProxy.getObject("BCProxy")
ra_obj=BcAdminRA.getObject("test-RA", proxy_obj)
bcaction=BcAdminRA.perform(ra_obj,"check-avail")
...