Configuring Java CAPS Project Components for Communication Adapters

TCPIP Inbound Schedules - Listener Schedule — TCP/IP Adapter Inbound

This section configures the scheduler used by the inbound TCP/IP Server. The server waits for a new client connection establishment request. These parameters are used to configure the listener/monitor that listens on the specified port.

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 HL7 inbound adapter Connectivity Map properties contains the top-level parameters is as displayed in the table.

Table 116 Connectivity Map - TCPIP Inbound Schedules - Listener Schedule

Name 

Description 

Required Value 

Scheduler

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

  • Timer Service: The 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

This property configuration, though visible from the Properties Editor, is disabled. The only available schedule type is Repeated, indicating that the task is scheduled for repeated execution at regular intervals defined by the Period property in this section (see Period).

This property is disabled. 

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 before the task is executed, in milliseconds (1000 milliseconds is equal to 1 second). 

Period

Specifies the regular 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 between successive task executions, in milliseconds. 

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.

  • 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 - Service Schedule — TCP/IP Adapter Inbound.

Related Topics