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

Declaration

export external function read-service-arguments
        into write-only string arguments

      

Argument definitions

arguments

A variable shelf into which any service arguments are copied, as well as any WSB-provided arguments

The read-service-arguments function enables a service to retrieve a copy of the contents of the args parameter to wsb.add-service or wsb.dispatch-request. Note that the copies are not shared between service instances, so modifying the shelf in one instance does not affect the shelf in another instance.

In addition, the WSB can add entries to the shelf for each service instance. To avoid any collisions, do not pass any arguments which have a key beginning with "_OM_".

Currently, the only entry added is "_OM_UniqueDirectory" which contains the path to the unique directory created for that service instance. This entry is only added if the unique-dirs parameter was passed to wsb.create-server, wsb.add-service or wsb.dispatch-request for this service. That path should be used for any files or directories created by the service instance while working, and they will be deleted when the service instance exits.

Related Syntax    wsb.add-service

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

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