Skip Navigation Links | |
Exit Print View | |
Configuring Environment Components for Oracle Java CAPS Communications Adapters Java CAPS Documentation |
Configuring Java CAPS Environment Components for Communications Adapters
Configuring Adapter Environment Properties
To Add an External System to the Environment
To Configure the Environment Properties
TCP/IP Adapter Environment Properties
TCPIP Server (Inbound) Adapter - General Inbound Settings
TCPIP Server (Inbound) Adapter - TCPIP Inbound Settings
TCPIP Server (Inbound) Adapter - MDB Pool Settings
TCPIP Client (Outbound) Adapter - General Outbound Settings
TCPIP Client (Outbound) Adapter - TCPIP Outbound Settings
TCPIP Client (Outbound) Adapter - Connection Pool Settings
EMail Adapter Environment Properties
Inbound Email Adapter => Connection Settings
Inbound Email Adapter => SSL => CACerts
Inbound Email Adapter => MDB Settings
Outbound Email Adapter => Connection Settings => Send SMTP
Outbound Email Adapter => Connection Settings => Receive POP3
Outbound Email Adapter => SSL => CACerts
File Adapter Environment Properties
Inbound File Adapter - Parameter Settings
Inbound File Adapter - MDB Settings
Outbound File Adapter - Parameter Settings
MSMQ Adapter Environment Properties
Inbound MSMQ Adapter -- MSMQ Environment
Inbound MSMQ Adapter -- MDB Settings
Inbound MSMQ Adapter -- Connection Retry Settings
Outbound MSMQ Adapter -- MSMQ Environment
Outbound MSMQ Adapter -- Connection Retry Settings
CICS Adapter Environment Properties
Oracle Java CAPS CICS Listener
COM/DCOM Adapter Environment Properties
HTTPS Adapter Environment Properties
Property Categories Configured in the Application Server Environment
HTTPS Adapter Proxy Configuration
To Edit the Property Permission Utility of the server.policy File
IMS Adapter Environment Properties
IMS Adapter TCP/IP Configuration
Configuring the Client ID for the IMS Adapter
IMS Adapter Serial Mode Settings
IMS Adapter Connection Retry Settings
IMS Adapter Connection Pool Settings
LDAP Adapter Connection Properties
LDAP Adapter Security/SSL Properties
LDAP Adapter Connection Retry Settings
LDAP Adapter Connection Pool Settings
Configuring the SNA Adapter Environment Properties
Property Categories Configured in the Application Server Environment
SNALU62 Inbound Adapter Properties
Adapter External System properties must be configured from within the Environment. Until you have successfully configured all Adapters for your Java CAPS project, your project cannot be properly executed or deployed. The following list identifies the HTTPS Adapter properties. There are four Environment Configuration categories that the HTTPS Adapter implements.
HTTP Settings includes the configuration parameters listed in the following table.
Caution - Calling the clear() method in the Collaboration Editor (Java) clears all properties in this HTTP Settings section. Once the properties have been cleared, you must manually rebuild the header and payload sections of the Request message in the Transformation Designer. |
Table 29 Environment Configuration—HTTP Settings
|
The properties in this section specify the information required for the Adapter to access the external systems through a proxy server.
Use the Proxy Configuration settings in the client HTTPS Environment properties, when setting the desired URL dynamically within a Collaboration (Java) or Business Process.
Note - It is a known behavior of the Java Virtual Machine (JVM) to bypass an invalid proxy server through a local connection. As a result, you may still get a response, even if the proxy setting is invalid. This false response only happens with an HTTP connection. An HTTPS connection ensures authenticated handshaking from the proxy.
The HTTPS Adapter client bypasses the proxy server when accessing local addresses. This contrasts a web browser’s behavior where all requests are sent to a proxy even if they are local.
Proxy Configuration includes the configuration parameters listed in the following table.
Table 30 Environment Configuration—Proxy Configuration
|
An additional task to properly configure the Proxy properties is to edit the PropertyPermission utility of the server.policy file in the application server:
JavaCAPS_Home\appserver\is\lib\install\templates\
where, JavaCAPS_Home is the location of your installation.
permission java.util.PropertyPermission “*”, “read,write”;
See Creating and Starting the Domain to create a new domain.
The Environment Configuration Security properties are used to perform HTTP authentication and SSL connections. They include the following configuration sections:
Details for the Authentication settings used for HTTP authentication are detailed in the following table.
Table 31 Environment Configuration — Security, Authentication
|
Details for the SSL settings used for SSL connections are detailed in the following table.
Table 32 Environment Configuration — Security, SSL
|
Following are additional notes related to the properties in the SSL section.
Description
Determines whether the host name verification is done on the server certificate during the SSL handshake.
You can use this property to enforce strict checking of the server host name in the request URL and the host name in the received server certificate.
Required Values.
Select True or False.
The default is False.
Additional information
Under some circumstances, you can get different Java exceptions, depending on whether you set this property to True or False. This section explains what causes these exceptions.
For example, suppose the host name in the URL is localhost, and the host name in the server certificate is localhost.stc.com. Then, the following conditions apply:
If Verify hostname is set to False:
Host name checking between the requested URL and the server certificate is turned off.
You can use an incomplete domain host name, for example, https://localhost:444, or a complete domain host name, for example, https://localhost.stc.com:444, and get a positive response in each case.
If Verify hostname is set to True:
Host name checking between the requested URL and the server certificate is turned on.
Note - If you use an incomplete domain host name, for example, https://localhost:444, you can get the exception java.io.IOException: HTTPS hostname wrong.
You must use a complete domain host name, for example, https://localhost.stc.com:444.
Connection Pool Settings include the configuration parameters listed in the following table.
Table 33 Environment Configuration — Connection Pool Settings
|