You can specify or set a property in the administrative console, the wsadmin tool, Application Server commands, the scripts that run from a command-line interface, or a custom Java administrative client program that you write. You can also set SOAP connector properties in the soap.client.props file.
A Java Management Extensions (JMX) connector can either be a Remote Method Invocation (RMI) connector or a Simple Object Access Protocol (SOAP) connector.
For specific information on how to code the JMX connector properties for the wsadmin tool, the Application Server commands, or scripts, see the particular tool or command. For specific information on how to code the JMX connector properties for a custom Java administrative client program, see the Java API documentation for Application Server.
For the administrative console, this topic specifies the coding of the particular setting or property. Coding of properties in the soap.client.props file that are specific to JMX connectors is specified. These properties begin with com.ibm.SOAP. Other properties in the soap.client.props file that contain information that can be set elsewhere in the Application Server are not documented here. The coding for the com.ibm.ssl.contextProvider property, which can be set only in the soap.client.props file, is specified.
Each profile has a property file at installation root/profiles/profile name/properties/soap.client.props. These property files allows you to set different properties, including security and timeout properties. These properties are the default for all the administrative connections that use the SOAP JMX connector between processes that run in a particular profile. For instance, the wsadmin program running under a particular profile uses the property values from that file for the SOAP connector behavior unless the properties are overridden by some other programmatic means.
To view the JMX connector custom properties administrative console panel that goes with this article, click Servers > Application servers >server name > Server Infrastructure > Administration > Administration Services > Additional properties > JMX Connectors>connector type > Additional Properties > Custom properties.
This section discusses JMX connector properties that pertain to SOAP connectors.
SOAP request timeout
The value that you choose depends on a number of factors, such as the size and the number of the applications that are installed on the server, the speed of your machine, and the usage of your machine.
The program default value for the request timeout is 600 seconds. However, other components that connect to the SOAP client can override the default. Components that use the soap.client.props file have a default value of 180 seconds.
Property | com.ibm.SOAP.requestTimeout |
Data type | Integer |
Range in seconds | 0 to n If the property is zero (0), the request never times out. |
Default | 180 |
Property | requestTimeout |
Data type | Integer |
Range in seconds | 0 to n If the property is zero (0), the request never times out. |
Default | 600 |
Configuration URL
Property | ConfigURL |
Data type | String |
Valid Value | http://Path/soap.client.props |
Default | None |
Security context provider
This property indicates the Secure Sockets Layer (SSL) implementation to use between the Application Server and the SOAP client. You can specify either IBM Java Secure Sockets Extension (IBMJSSE) or IBM Java Secure Sockets Extension that has undergone Federal Information Processing Standards certification (IBMJSSEFIPS).
Property | com.ibm.ssl.contextProvider |
Data type | String |
Valid Values | IBMJSSE IBMJSSEFIPS IBMJSSE2 |
Default | IBMJSSE2 |
Secure Sockets Layer (SSL) security
Property | com.ibm.SOAP.securityEnabled |
Data type | Boolean |
Default | False |
Property | securityEnabled |
Data type | Boolean |
Default | False |
This section discusses JMX connector properties that pertain to both SOAP connectors and RMI connectors.
Connector type
Property | Type |
Data type | String |
Valid values | SOAPConnector RMIConnector |
Default | SOAPConnector |
Host
Property | host |
Data type | String |
Valid values | Host name or IP address |
Default | None |
Port
Property | port |
Data type | Integer |
Valid value | Port number |
Default | None |
User name
Property | com.ibm.SOAP.loginUserid |
Data type | String |
Valid value | The value must match the global SSL settings for SOAP or RMI. |
Default | None |
Property | username |
Data type | String |
Valid value | The value must match the global SSL settings for SOAP or RMI. |
Default | None |
Password
Property | com.ibm.SOAP.loginPassword |
Data type | String |
Valid values | The value must match the global SSL settings for SOAP or RMI. |
Default | None |
Property | password |
Data type | String |
Valid values | The value must match the global SSL settings for SOAP or RMI. |
Default | None |