SOAP Gateway management utility reference

The SOAP Gateway management utility provides a command line interface to manage the SOAP Gateway server runtime, configure server properties, and work with web service artifacts.

The following table shows the support and restrictions of the SOAP Gateway management utility for each scenario.
Table 1. Features supported by the management utility
Scenario Administrative tasks supported by the SOAP Gateway management utility (iogmgmt)
Web service provider
  • Full support for administrative tasks.
  • Changes to web service artifacts are immediately reflected in the runtime configuration.
Callout application (web service consumer)
  • Full support for administrative tasks.
  • Changes to callout application artifacts are immediately reflected in the runtime configuration.
  • Changes to callout properties are made to the runtime configuration, but the callout threads and callout worker thread pool must be restarted.
Restriction: Changes to active connection bundle entries are not reflected until the next time the SOAP Gateway server starts. All valid connection bundle entries are made active when the SOAP Gateway server starts.

iogmgmt commands

To use the SOAP Gateway management utility, from the installation directory where the SOAP Gateway is installed (SOAP_Gateway_install_directory\imsserver\deploy), type ./iogmgmt.

An iogmgmt command consists of the iogmgmt statement followed by arguments to specify the command and associated options.

Issuing a command with more than one instance of a parameter will override all but the last instance of the parameter. For example, issuing the command iogmgmt -corr -u -r MyCorr.xml -p MyService -i MyOperation -n NewBundleName1 -n NewBundleName2 will set the connection bundle name for the specified correlator entry to NewBundleName2.

SOAP Gateway management utility commands are case sensitive and must be entered in all lower case or as shown in the command reference topic.

The SOAP Gateway management utility must run on the same LPAR as the target server.