Make External Handler Call

This System tool makes an external handler call by firing the External Handler Call initiator on another Notifier server. This allows for a Notifier server to initiate a handler on another Notifier server running its own IP processor and handlers, and to get results from that handler. This allows for the two IP processors to execute tasks and handlers in a synchronous manner.

When executing on the local Notifier server, this tool as the same effect as calling the C++ ExternalHandler function.

Inputs

Server

The ID of the Notifier server on which the external handler is published.

Login

The login ID required for accessing the Notifier server.

Password

The password associated with the login being used.

Operation

The name of the handler operation that will be fired. This is passed to the External Handler Call initiator on the remote IP processor.

Data

A list of strings containing information from the handler that is passed as an input parameter to the External Handler Call initiator on the remote IP processor.

Timeout

The amount of time, in milliseconds, that this tool will wait for a response from the external server. If there is no response from the server in the allotted time, this tool will take the "Failure" exit path.

Note: This timeout does not include the time required to connect to the remote server. It applies only to the time it takes for the remote server to execute a handler and return a result once the connection is established.

Outputs

Data

The list of strings containing output information from the handler executed on the remote IP processor.

Result

The result of execution of the handler on the remote IP processor.

Diagnostic

This output is used in determining the cause for failure when the result of the external handler is False. This string contains information to help diagnose the failure that occurred on the remote IP processor when executing the external handler.

Exit Paths

Success

This path is taken if the external handler is successfully called.

Failure

This path is taken of the operation fails. This could occur if the remote server name is incorrect or if the login and/or password used are invalid.