Library: Net, Web Services Broker (OMWSB) Import: omwsb.xmd

Declaration

  export external function dispatch-request
                              value request request
    using                     value server  server
    to                        value stream  program

Argument definitions

request

A wsb.request OMX variable that was returned from a call to wsb.wait-for-request

server

A wsb.server OMX variable that was returned from a call to wsb.create-server, and the server from which the request was received

program

The path of a compiled OmniMark program which will service the specified request

The dispatch-request function call is used by the server program to transfer the processing of a request to a service program. This function is typically used when the server is handling an unknown request and wants the processing to be done in a separate thread as opposed to processing the request itself. The program must be a WSB service program just like the service programs that are added via the add-service call.

Note that it is much more efficient to have a registered service handle a particular request than to manually recognize and dispatch them in the server loop.

Related Syntax    wsb.create-server    wsb.wait-for-request

Other Library Functions    wsb.add-service    wsb.clear-all-services    wsb.create-server    wsb.dispatch-request    wsb.has-known-request-type    wsb.reader    wsb.remove-service    wsb.request    wsb.request-header    wsb.request-name    wsb.request-type    wsb.server    wsb.service-exists    wsb.start-servicing-requests    wsb.wait-for-request    wsb.writer

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]