+

Search Tips   |   Advanced Search

sib: URL syntax

The sib: URL has the following syntax:

sib:/[destination|path]?property_1=value_1&property_2=value_2&...
where:


Required properties

The following properties are required. They are used to specify the destination for the request.

All destination names must be fully-qualified. That is, they must include the name of the service integration bus as well as the destination name itself. Use the syntax bus:destination. If a bus or destination name contains a colon or comma, wrap the name in double quotation marks (""). If it contains a double quotation mark, repeat the quotation mark.

destinationName

The destination name.

path

The forward routing path, in the form of a sequence of destination names separated by commas.

replyDestinationName

The name of the destination to be used for the reply.

inboundService

The name of the inbound service that identifies the specific attachment that the requester application uses. We can omit this value if the destination is a service destination with an associated outbound service configuration, because in that case the requester is attaching to the outbound service through the service destination.

timeout

The time the requester waits for a response. The default is 60 seconds. A zero value indicates an unlimited wait.


Service integration technologies-related properties

The following properties are optional. If we do not specify a value for a property, then the default value is used. For more information regarding the permitted values for these properties, see the generated API information for the SIMessage interface.

reliability

The reliability of the request message.

timeToLive

The amount of time (in milliseconds) before the request times out. A zero value indicates that the request never times out.

The timeout property (see the required properties) is the time delay after which the requester application blocks the application thread that is waiting for a response to a request and response operation. The time to live and replyTimeToLive optional properties indicate how long the request and reply messages should be processed by the messaging engines. This does not include the processing time at the service implementation. We would therefore usually set the timeout to be the sum of the request and response times to live, plus some amount for the service processing time.

priority

The priority of the request message.

user

The user ID required to access the request destination.

password

The password required to access the request destination.

replyReliability

The reliability of the reply message.

replyTimeToLive

The amount of time (in milliseconds) before the reply times out. A zero value indicates that the reply never times out.

replyPriority

The priority of the reply message.


Other properties

We can also include user-defined properties in the URL. These properties must be named with a user. prefix. For example:

sib:/destination?destinationName=myBus:myDestination & reliability=assured & user.customData=XYZ

After the request is sent, the URL itself is available within the message properties, named inbound.url.