Configuring Java CAPS Project Components for Communication Adapters

TCPIP Inbound Settings - Service Schedule — TCP/IP Adapter Inbound

This section configures the scheduler used by the TCP/IP Server that executes the business tasks (Collaboration Rules) over the existing connection. This scheduler affects the actual Business Rules defined by the user.

Two J2EE schedulers are available (see Scheduler):

Both schedulers provide the functionality required by the inbound TCP/IP Server.

This section of the TCP/IP inbound adapter Connectivity Map properties contains the top-level parameters as displayed in the table.

Table 117 Connectivity Map - TCPIP Inbound Settings - Server Schedule

Name 

Description 

Required Value 

Scheduler

Specifies the scheduler type for this inbound communication. There are two options: 

  • Timer Service: This scheduler is configured using the At Fixed Rate, Delay, and Period properties.

  • Work Manager: The task is scheduled through the J2EE Work Manager. Work Manager is supported by J2EE (JCA 1.5 and above). This scheduler is configured using the Delay and Period properties.

Select Timer Service or Work Manager.

If your container doesn’t support JCA Work Manager, select Timer Service .

Schedule Type

Applies to both the Timer Service or the Work Manager. Specifies whether the task is scheduled to occur once or be repeated.

  • OneTime: The task will be scheduled for one-time execution.

  • Repeated: The task will be scheduled for repeated execution at regular intervals defined by Period property in this section (see Period).

Select OneTime or Repeated.

Delay

Applies to both the Timer Service or the Work Manager. Specifies, in milliseconds, the length of delay time before the task is executed.

An integer indicating the amount of time, in milliseconds, before the task is executed (1000 milliseconds is equal to 1 second). 

Period

Specifies the wait interval in milliseconds between successive repeated task executions. This is used for the Repeated Schedule Type (see Schedule Type). Applies to both the Timer Service or the Work Manager.

An integer indicating the amount of time, in milliseconds, between successive task executions (1000 milliseconds is equal to 1 second). 

Enter a positive integer. The configured default is 100. Lowering this value may increase the number of transactions per second.

At Fixed Rate

Specific to the Timer Service configuration only. Specifies whether a Fixed-Rate execution or Fixed-Delay execution is used. This is used for the “Repeated” schedule type by the “Timer Service” scheduler.

  • Fixed-Rate: A fixed-rate execution means that each execution is scheduled relative to the scheduled time of the initial execution. If an execution is delayed for any reason (such as garbage collection or other background activity), two or more executions will occur in rapid succession to catch up. In the long run, the frequency of execution will be exactly the reciprocal of the specified period (assuming the system clock underlying Object.wait(long) is accurate).

  • Fixed-Delay: A fixed-delay execution means that each execution is scheduled relative to the actual time of the previous execution. If an execution is delayed for any reason (such as garbage collection or other background activity), subsequent executions will be delayed as well. As a result, the frequency of execution will generally be slightly lower than the reciprocal of the specified period (assuming the system clock underlying Object.wait(long) is accurate).

Select True or False.

True indicates that a fixed-rate execution is used. False indicates that a fixed-delay execution is used.

Where to Go Next

TCPIP Inbound Settings - Envelope Message — TCP/IP Adapter Inbound.

Related Topics