wsb.read-service-arguments

function

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


Purpose

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 Topics