Task 4: Update IMS Enterprise Suite SOAP Gateway properties

This task allows you to set or view SOAP Gateway properties.

  1. From the SOAP Gateway deployment utility menu, type 4 and press Enter.
  2. You can modify and view the SOAP Gateway properties.
  3. Restart the SOAP Gateway server after changing the properties for them to take effect.
    Tip: Changing the trace level does not require restarting SOAP Gateway. It is the only property that does not require restarting the SOAP Gateway server after a change.

Properties

Use the following parameters to modify the SOAP Gateway properties.
SOAP Gateway port number (non-HTTPS)
Specify the port number for the SOAP Gateway server. SOAP Gateway is configured to run and listen on the SOAP request over the HTTP communication protocol using port 8080 by default. Valid port numbers are from 1 to 65536.
z/OS® requires a listening shutdown port number to be changed for each running instance of SOAP Gateway. The default is set to 8005.
Trace level
Specify the trace level. The trace level controls the amount of logging and tracing with SOAP Gateway. The trace level can be one of the following values:
Table 1. Trace level settings for the SOAP Gateway server log file
Trace level value Trace level Description
0

Off

The SOAP Gateway server log file and console appenders are disabled. Messages are not written to the SOAP Gateway server log file or job log. Error and fatal messages are still sent to WTO.
1 Fatal Only errors that result in an immediate server shutdown are logged.
2 Error
  • In addition to logging errors that result in an immediate server shutdown, other errors and exceptions are also logged.
  • NACK responses for synchronous callout applications that use the send-only with acknowledgment protocol are logged.
  • This is the default trace level.
3 Warn In addition to what is logged at the error level, warning messages are also logged.
4 Information
  • In addition to what is logged at the warning level, the entry and exit of important events and functions are also logged.
  • All ACK and NACK messages for synchronous callout applications that use the send-only with acknowledgment protocol are logged.
5 Debug In addition to what is logged at the information level, the contents of buffers sent to and received from IMS Connect and SOAP Gateway are also logged.
Log file name
Specify the location and the file name for the log file that contains the logging and tracing messages. The default is SOAP_Gateway_install_directory/server/logs/imssoap.log.
HTTPS port number
Specify the HTTPS port number. The default HTTPS port number is 8443. Valid port numbers are from 1 to 65535.
HTTPS keystore name
Specify the keystore name with the fully qualified path for use with the HTTPS connection. This name can be the same as the SSL keystore if it has all the required key information.
HTTPS keystore password
Specify the HTTPS keystore password. This must be between 6 and 20 characters in length.