JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Java CAPS Email Binding Component User's Guide     Java CAPS Documentation
search filter icon
search icon

Document Information

Using the eMail Binding Component

About the eMail Binding Component

eMail Binding Component Features

eMail Binding Component Protocols

eMail Binding Component Property Configuration

eMail BC Sample Projects

Working With the eMail Binding Component WSDL Document

Creating the eMail BC WSDL Document

To Create a WSDL Document to Read email (IMAP or POP3)

To Create a WSDL Document to Send email (SMTP)

New WSDL Wizard Properties for the eMail BC

Configuring eMail BC WSDL Attributes

To Configure eMail BC WSDL Attributes

To Send email Messages with Attachments

eMail Binding and Service Level WSDL Attributes

Receiving eMail BC Attributes

Sending eMail BC Attributes

Configuring the eMail Binding Component Runtime Properties

To Configure eMail Binding Component Runtime Properties

eMail Binding Component Runtime Property Descriptions

Creating Application Configurations for Connectivity Parameters

To Create Application Configurations

To Add the Application Configuration to the Endpoint

To Change Application Configuration Values

Using Application Variables

To Create an Application Variable

To Change an Application Variable Value When the Application is Running

To Use an Application Variable for Password Protection

Using eMail BC Normalized Message Properties in a Business Process

Using Predefined Normalized Message Properties

To Define Normalized Message Properties in Mapper View

To Define Normalized Message Properties in Source View

Normalized Message Properties for the eMail Binding Component

General Normalized Message Properties

eMail Binding Component Normalized Message Properties

Configuring the eMail Binding Component Runtime Properties

The eMail Binding Component's runtime properties apply to all instances of the binding component in a domain, including all provider and consumer endpoints. The properties can be configured from the NetBeans IDE, GlassFish Admin Console, or from a command prompt during a command line installation. This section describes how to configure the properties in NetBeans.

To Configure eMail Binding Component Runtime Properties

  1. From the Services window of the NetBeans IDE, expand the Servers node.
  2. If the application server is not already started, right-click the server and then select Start.
  3. Under the application server, expand JBI and expand Binding Components.
  4. If the eMail Binding Component is not started, right-click sun-email-binding and select Start.
  5. Right-click sun-email-binding and select Properties.

    The Properties Editor appears.


    image:Figure shows the eMail BC Runtime Properties Editor.
  6. Modify any of the properties listed in eMail Binding Component Runtime Property Descriptions.

    Note - General, identification, and statistic properties are automatically updated by the eMail BC. You do not need to modify these properties.


  7. To apply the changes, stop and restart the eMail BC.

eMail Binding Component Runtime Property Descriptions

The eMail Binding Component properties specify the number of threads and reference descriptive information for the Binding Component. You can also use these properties to set application variables and configure application properties. The following tables list and describe each eMail Binding Component runtime property.

Table 8 eMail Binding Component General Runtime Properties

Property
Description
Description
A general description of the JBI component.
Name
A unique name for the eMail BC in the JBI environment. If you install more than one eMail Binding Component in a JBI environment, make sure that each has a unique name. When the service unit deploys the component, it is matched with target component name defined in its descriptor file, jbi.xml, which can be modified as needed.
State
The current state of the JBI component. This value can be either Started, Stopped, or Shutdown.
Type
The type of JBI component (service-engine or binding-component).

Table 9 eMail Binding Component Identification Runtime Properties

Property
Description
Version
The version number of the installed binding component.
Build Number
The build number of the installed binding component.

Table 10 eMail Binding Component Configuration Runtime Properties

Property
Description
Thread Count
The number of threads listening on the Normalized Message Router (NMR) for message exchanges.

The default value is 10.

Application Configuration
A list of values for a Composite Application's endpoint connectivity parameters, which are normally defined in the WSDL service extensibility elements. The values are applied to a user-named endpoint Config Extension Property. The values defined in an application configuration override the values defined in the WSDL document.

For more information, see Creating Application Configurations for Connectivity Parameters.

Application Variables
A list of name and value pairs for a given type. The application variable name can be used as a token for a WSDL extensibility element attribute in a corresponding binding.

For more information, see Using Application Variables.

Table 11 eMail Binding Component Runtime Statistics

Property
Description
Activated Endpoints
The number of activated endpoints.
Active Exchanges
The number of active exchanges.
Avg. Component Time
The average message exchange component time in milliseconds.
Avg. D.C. Time
The average message exchange delivery channel time in milliseconds.
Avg. Msg. Service Time
The average message exchange message service time in milliseconds.
Avg. Response Time
The average message exchange response time in milliseconds.
Completed Exchanges
The total number of completed exchanges.
Error Exchanges
The total number of error exchanges.
Received Dones
The total number of received dones.
Received Errors
The total number of received errors.
Received Faults
The total number of received faults.
Received Replies
The total number of received replies.
Received Requests
The total number of received requests.
Sent Dones
The total number of sent dones.
Sent Errors
The total number of sent errors.
Sent Faults
The total number of sent faults.
Sent Replies
The total number of sent replies.
Sent Requests
The total number of sent requests.
Up Time
The up time of this component in milliseconds.

The Loggers properties specify the level of logging for each event. You can set the logging level for each logger to any of the following levels:

By default, these are all set to the INFO level.

Table 12 eMail Binding Component Logger Runtime Properties

Property
eMail BC Component
sun-email-binding
com.sun.jbi.binding.email
EmailBC Component Manager
com.sun.jbi.binding.email.EmailBCComponentManager
EmailBC Configuration
com.sun.jbi.binding.email.EmailBCConfiguration
EmailBC Endpoint Manager
com.sun.jbi.binding.email.EmailBCEndpointManager
EmailBC Exchange Handler
com.sun.jbi.binding.email.EmailBCExchangeHandler
Deployment Lookup (QoS)
com.sun.jbi.common.qos.descriptor.DeploymentLookup
Messaging Channel (QoS)
com.sun.jbi.common.qos.messaging.MessagingChannel
EndpointLifeCycle
com.sun.jbi.component.toolkit.endpoint.EndpointLifeCycle
AcceptPoller
com.sun.jbi.component.toolkit.lifecycle.impl.AcceptPoller
DefaultServiceUnitManager
com.sun.jbi.component.toolkit.lifecycle.impl.DefaultServiceUnitManager
PollerConfig
ccom.sun.jbi.component.toolkit.lifecycle.impl.PollerConfig
EmailBC Message Receiver (IMAP)
com.sun.jbi.binding.email.protocol.receive.imap.IMAPMessageReceiver
EmailBC Message Receiver (POP3)
com.sun.jbi.binding.email.protocol.receive.pop3.POP3MessageReceiver
EmailBC Message Sender (SMTP)
com.sun.jbi.binding.email.protocol.send.smtp.SMTPMessageSender