success when

<success-when> element

An async-command must contain a single <success-when> element to determine if the command has been successful.

XML Attribute	Description	Allowed Values
expect	The string to wait for before sending the command	A valid value declaration
timeout	The amount of time to wait for the expected text to appear	An integer value greater than zero

Value declarations are supported for some operation types. See value declarations for details. If the timeout period elapses without the expected text appearing, the operation fails and an error is reported back to FIM for the object.

Example

<success-when expect="password successfully changed for {dn:$1}" timeout="5"/>

The example above considers the operation successful when the message above appears on the standard output.