Service Call connector settings

Platform connector settings

Setting	Description
Service Type	• General – select to send data to another StreamServer application. • IDocClient – select to send IDoc data to SAP.
Service name	If Service Type = General The service name of the receiving Service Request input connector. If Service Type = IDocClient The Service name specified on the IDoc Client in the RFC Gateway. On the IDoc client, the Service name setting is found under the StreamServe Connection settings.
Timeout	Timeout can be set to -1, 0 or a value >0 milliseconds. How it affects the Service Call connector depends on the Append and Response place connector settings.
Timeout = -1	Append and Response place connector not enabled Wait “forever” for the response from the receiver before marking the output job as successful or failed. The response includes the status of the job processed by the receiver (successful or failed). Append enabled Timeout is ignored. Response place connector enabled Wait “forever” for the response from the receiver before marking the output job as successful or failed. The response includes output from the receiver and the status of the job processed by the receiver (successful or failed).
Timeout = 0	Append and Response place connector not enabled Do not wait for a response from the receiver. The output job is marked as successful when it is successfully delivered to the input queue of the receiver. Append enabled Timeout is ignored. Response place connector enabled Timeout must be either -1 or >0 if Response place connector is enabled.
Timeout > 0	Append and Response place connector not enabled Wait the specified time (milliseconds) for the response from the receiver before marking the output job as successful or failed. The response includes the status of the job processed by the receiver (successful or failed). If the status is not returned within the time specified, an error is reported and the output job is marked as failed. Append enabled Timeout is ignored. Response place connector enabled Wait the specified time (milliseconds) for the response from the receiver before marking the output job as successful or failed. The response includes output from the receiver and the status of the job processed by the receiver (successful or failed). If the status is not returned within the time specified, an error is reported and the output job is marked as failed.
Service version	The version of the service (StreamServer application) to call. If you leave this empty, the latest version of the service is called.
Append	Select to append the output job to the top job. This enables StreamServer applications to receive the result produced by chained StreamServer applications. See Example 39. Note: Append is ignored if a Response place connector is specified.

Runtime connector settings

Setting	Description
Service Type	See Service Type in Platform connector settings above.
Service name	See Service name in Platform connector settings above.
Timeout	See Timeout in Platform connector settings above.
Service version	See Service version in Platform connector settings above.
Append	See Append in Platform connector settings above.
Response place connector	The name of an input connector. The response to the service call is passed on to this connector for further processing. This connector must be queue enabled. Note: OpenText recommends you to use separate input queues for the Response place connector and the input connector for the original input job.

Example 39

Using Append

This example includes three StreamServer applications:

•	ST1 with a Service Call connector. Append is disabled.

•	ST2 with a Service Request input connector and a Service Call output connector. Append is enabled.

•	ST3 with a Service Request input connector and a File output connector. “Include result in service response” is enabled on the File connector.

ST1 sends output to ST2. ST2 processes the ST1 input and delivers new output to ST3. ST3 processes the ST2 input and returns the result in the response to ST1.