Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Web Service: Configuration: Ports

Configuration Options     Related Tasks     

This page lists message buffering, reliable messaging, atomic transaction, and persistence configuration that are associated with the endpoints and operations of this Web service. The operations are listed below the endpoints; click on the + sign to view them.

Configuration Options

Name Description
Ports and Operations

Name of the Web service endpoint (port) or operation for which you can edit buffering, reliable messaging, atomic transaction, and persistence configuration.

Reliable Message Configuration Customized

Flag that specifies whether Web service reliable messaging is configured on this endpoint in the Web service descriptor or deployment plan. If not enabled, the Web service reliable messaging configuration on the server will be used.

Note that this flag does not reflect other forms of reliable message configuration such as WS-RM policy directly specified in WSDL.

If you are using the SOAP over JMS Transport connection protocol, you cannot configure reliable messaging for the Web service endpoint.

Reliable Message Base Retransmission Interval

String value in Duration format. The interval of time that must pass before a message will be retransmitted to the RM destination (in the event a prior transmission failed). Defaults to P0DT8S (8 seconds). Applies to RM source.

Reliable Message Enable Retransmission Exponential Backoff

A boolean flag indicating that the retransmission interval will be adjusted using the exponential backoff algorithm [Tanenbaum]. Defaults to false. Applies to RM source.

Reliable Message Non-buffered Source

A boolean flag indicating that any RM source hosted within the current service will send non-buffered. Defaults to false.

Reliable Message Non-buffered Destination

A boolean flag indicating that the RM destination represented by the current service will receive non-buffered. Defaults to false.

Reliable Message Acknowledgement Interval

String value in Duration format. Defaults to P0DT0.2S' (200 milliseconds). Applies to RM source and RM destination.

Reliable Message Inactivity Timeout

String value in Duration format. If during this duration, an endpoint (RM source or RM destination) has received no application or control messages, the endpoint MAY consider the RM Sequence to have been terminated due to inactivity. Defaults to P0DT600S (600 seconds). Implementations of RM source and RM destination are free to manage resources associated with the sequence as they please, but in general, there are no guarantees that the sequence will be useable by either party after the inactivity timeout expires. Applies to RM source and RM destination.

Reliable Message Sequence Expiration

Duration expression (String), defaults to P1D (1 day). This is the expiration time for a sequence regardless of activity. Applies to RM source and RM destination.

Reliable Message Buffer Retry Count

Used only for JAX-RPC services. JAX-WS services should set this on BufferingConfigBean instead.

Number of times the service will attempt to retry processing of a reliable request. Note that this processing refers to the incoming request for a service operation, and not any outgoing request to an RM destination (as is the case with BaseRetransmissionInterval, etc.). Defaults to 3. Applies to RM destination.

Minimum value: 0

Reliable Message Buffer Retry Delay

Used only for JAX-RPC services. JAX-WS services should set this on BufferingConfigBean instead.

String value in Duration format defining an amount of time to wait between retries of an incoming reliable request. Defaults to P0DT5S (5 seconds). Applies to RM destination.

Buffering Configuration Customized

Flag that specifies whether message buffering is configured on this endpoint in the Web service descriptor or deployment plan. If not enabled, the Web service message buffering configuration on the server will be used.

Buffering Retry Count

The number of times a buffered request or response can be retried before it is abandoned (and moved to any error queue defined for the buffer queue)

Minimum value: 0

Buffering Retry Delay

The amount time between retries of a buffered request and response. Note, this value is only applicable when RetryCount > 0. String value in Duration format. Defaults to P0DT30S (30 seconds).

Buffering Request Queue Enabled

A boolean flag indicating whether buffering is enabled (request buffering if this is the request queue, or response buffering if this is the response queue). Defaults to false.

Buffering Request Queue JNDI Name

Get the name of this buffering queue. This name is the JNDI name for the queue.

Buffering Request Queue Connection Factory JNDI Name

The JNDI name of the connection factory to use when buffering messages onto this queue. Defaults to the 'default' JMS connection factory.

Buffering Request Queue Transaction Enabled

A boolean flag indicating whether transactions should be used when buffering a message onto or consuming a message off of this queue. Defaults to false.

Buffering Response Queue Enabled

A boolean flag indicating whether buffering is enabled (request buffering if this is the request queue, or response buffering if this is the response queue). Defaults to false.

Buffering Response Queue JNDI Name

Get the name of this buffering queue. This name is the JNDI name for the queue.

Buffering Response Queue Connection Factory JNDI Name

The JNDI name of the connection factory to use when buffering messages onto this queue. Defaults to the 'default' JMS connection factory.

Buffering Response Queue Transaction Enabled

A boolean flag indicating whether transactions should be used when buffering a message onto or consuming a message off of this queue. Defaults to false.

Atomic Transaction Customized

Flag that specifies whether Web service atomic transactions is configured on this endpoint in the Web service descriptor or deployment plan. If not enabled, the Web service atomic transaction configuration on the server will be used.

Atomic Transaction Enabled

A boolean flag that specifies whether WS-AT is enabled. Defaults to true.

MBean Attribute (Does not apply to application modules) :
WSATConfigBean.Enabled

Changes take effect after you redeploy the module or restart the server.

Atomic Transaction Flow Type

Transaction flow type supported. Valid values include: MANDATORY, SUPPORTS, or NEVER. Defaults to SUPPORTS.

MBean Attribute (Does not apply to application modules) :
WSATConfigBean.FlowType

Changes take effect after you redeploy the module or restart the server.

Atomic Transaction Version

Version of WS-AT that is supported. Valid values include: WSAT10, WSAT11, WSAT12, or DEFAULT. Defaults to DEFAULT, which specifies WSAT1.0 support on the client side, and WSAT10, WSAT11, and WSAT12 support on the server side.

MBean Attribute (Does not apply to application modules) :
WSATConfigBean.Version

Changes take effect after you redeploy the module or restart the server.

Default Logical Store Name

Name of the logical store to use, by default, for persistence within this service.

Use SOAP Over JMS Transport

Flag that specifies whether SOAP over JMS Transport is configured as the connection protocol on this endpoint in the Web service descriptor or deployment plan. If not enabled, the SOAP over JMS Transport configuration on the server will be used.

SOAP Over JMS Transport Activation Configuration

String value. Specify activation configuration properties passed to the JMS provider. Each property is specified using name-value pairs, separated by semicolons (;). For example: name1=value1;...;nameN=valueN

SOAP Over JMS Transport Binding Version

String value. SOAP/JMS Binding Version.

SOAP Over JMS Transport Delivery Mode

String value. The delivery mode indicates whether the request message is persistent. Valid values are PERSISTENT or NON_PERSISTENT.

SOAP Over JMS Transport Destination Name

String value. destinationName, specifying the jndi name of the destination queue or topic.

SOAP Over JMS Transport Destination Type

String value. Destination Type, specifying the destination type. Valid values include QUEUE(default) and TOPIC.

SOAP Over JMS Transport Enable HTTP WSDL Access

Boolean value. enable the HTTP WSDL accessibility.

SOAP Over JMS Transport JNDI Connection Factory Name

String value that specifies the JNDI name of the connection factory that is used for establishing a JMS connection.

SOAP Over JMS Transport JNDI Context Parameter

String value. jndiContextParameter, specifying additional JNDI properties. Each property is specified using name-value pairs, separated by semicolons (;). For example: name1=value1;...;nameN=valueN. The properties are added to the java.util.Hashtable sent to the InitialContext constructor for the JNDI provider.

SOAP Over JMS Transport JNDI Initial Context Factory Class Name

String value. JNDI InitialContextFactory, specifying the name of the initial context factory class used for JNDI lookup. This value maps to the java.naming.factory.initial property.

SOAP Over JMS Transport JNDI URL

String value. The JNDI provider URL.

SOAP Over JMS Transport Lookup Variant

String value that specifies the method used for looking up the specified destination name. This value must be set to jndi to support JMS transport in this implementation.

SOAP Over JMS Transport MDB Per Destination

Boolean value. One MDB instance for each destination - true One MDB instance for each destination - false One MDB instance for each service.

SOAP Over JMS Transport Message Type

String value. Specify the message type to use with the request message. Valid values are BYTES and TEXT.

SOAP Over JMS Transport Priority

Integer value. JMS priority associated with the request and response message. Specify this value as a positive Integer from 0, the lowest priority, to 9, the highest priority.

Minimum value: 0

Maximum value: 9

SOAP Over JMS Transport Reply To Name

String value. Specify the JNDI name of the JMS destination to which the response message is sent. For a two-way operation, a temporary response queue is generated by default. Using the default temporary response queue minimizes the configuration that is required. However, in the event of a server failure, the response message may be lost. This preoperty enables the client to use a previously defined, "permanent" queue or topic rather than use the default temporary queue or topic, for receiving replies. The value maps to the JMSReplyTo JMS header in the request message.

SOAP Over JMS Transport Run As Principal

String value. Specify the principal to run the listening MDB.

SOAP Over JMS Transport Run As Role

String value. Specify the role to run the listening MDB.

SOAP Over JMS Transport Target Service

String value. Specify the port component name of the Web service. This value is used by the service implementation to dispatch the service request. If not specified, the service name from the WSDL or @javax.jms.WebService annotation is used. This value maps to the SOAPJMS_targetService JMS message property.

SOAP Over JMS Transport Time To Live (milliseconds)

String value. Specify the lifetime, in milliseconds, of the request message. A value of 0 indicates an infinite lifetime. On the service side, timeToLive also specifies the expiration time for each MDB transaction.

Related Tasks


Back to Top