8.13 cepundeployrsc

Name: cepundeployrsc - Development asset undeployment

Format

cepundeployrsc resource [-e engineName] -n resourceID

Function description

This command undeploys a development asset that has been deployed.

Specify the type of development asset (event type definition, rule definition, master definition, or SOAP listener definition) to be undeployed.

When the command is executed, a prompt is displayed - type "y" and press the Enter key, or simply press the Enter key, to execute the undeployment. Execution can be canceled by typing "n" or "q" and pressing the Enter key.

Example

Example of query (for an event type definition):

Are you sure you want to undeploy the event type definition?(default: y) [y,n,q]:

Arguments

resource

Specify the type of development asset.

eventtype: Event type definition

rule: Rule definition

master: Master definition

listener: SOAP listener definition

-e engineName

Specify the name of the CEP engine to which the development asset to be undeployed has been deployed.

If only one CEP engine has been configured, this option can be omitted.

If this option is omitted, and if there are two or more configured CEP engines, an error message will be output and the undeployment will fail.

-n resourceID: Specify the development asset ID to be undeployed.

End status

The following status codes are returned:

0: Normal end

8: Abnormal end

Note

If the CEP engine that is the undeployment target is running, undeployment cannot be performed.

Example

Example of output at normal end

When an event type definition that has been deployed to a CEP engine (CepEngine1) is undeployed:

$ cepundeployrsc eventtype -e CepEngine1 -n EVENT_01 <ENTER>
Are you sure you want to undeploy the event type definition?(default: y) [y,n,q]:y <ENTER>
Command cepundeployrsc executed successfully.

Example of output at abnormal end

When an attempt is made to undeploy an event type definition that has been deployed to a CEP engine (CepEngine2) that is running:

$ cepundeployrsc eventtype -e CepEngine2 -n EVENT_02 <ENTER>
Are you sure you want to undeploy the event type definition?(default: y) [y,n,q]:y <ENTER>
Because the definition is used, it cannot be deleted.  Definition=(instream) Id=(EVENT_02-CepEngine2)
Command cepundeployrsc execution failed.

The following information will be added to the error message in this example:

Id: Development asset ID and target CEP engine name to be undeployed.