Configuring Java CAPS Project Components for Communication Adapters

TCPIP Inbound Schedules - Service Schedule — TCP/IP HL7 V3 Inbound Adapter

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 the Table 68).

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

This section of the TCP/IP HL7 V3 inbound adapter Connectivity Map properties contains the top-level parameters displayed in this table:

Table 94 Connectivity Map - TCPIP Inbound Schedules - Service Schedule

Name 

Description 

Required Value 

Scheduler

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

  • Timer Service: The task is scheduled through the J2EE Timer Service. Timer Service is supported by J2EE.

  • Work Manager: The task is scheduled through the J2EE Work Manager. Work Manager is supported by J2EE (JCA 1.5 and above).

Select Timer Service or Work Manager. I

f 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.

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 length of time, in milliseconds, before the task is executed. 

The configured default is 0.

Period

Applies to both the Timer Service or the Work Manager. Specifies the regular interval, in milliseconds, between successive task executions. This is used for the Repeated schedule type (see the Schedule Type property in the Table 68)

An integer indicating the length of time, in milliseconds, between successive task executions. 

The configured default is 1.

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

HL7 Acknowledgment — TCP/IP HL7 V3 Inbound Adapter.

Related Topics