Package cnrg.itx.gtwy.pbx

This is stripped-down JTapi code for controlling a PBX, allowing outgoing calls.

See:
          Description

Class Summary
Dialer This class handles placing one call in the PBX, from a line in the Gateway to some telephone number specified by a caller
JtapiHandler This is the service class used to dial and hangup.
MyCallObserver Class that observes a Call.
PBXSignalDelete  
PBXSignaling The Signaling Component that controls the PBX.
PBXSignalingServer This is the main program class for PBXSignaling.
 

Exception Summary
DialingException This class is the exception thrown by Dialer
PBXSignalingException  
 

Package cnrg.itx.gtwy.pbx Description

This is stripped-down JTapi code for controlling a PBX, allowing outgoing calls.

The cnrg.itx.gtwy.pbx package uses the javax.telephony to place and monitor outgoing calls. Outgoing calls are those where a computer-based application (such as CUPS) wishes to place a call to an actual telephone. (The gateway handles all incoming calls, which must be for a computer-based telephony application.)

Use of a PBX is optional. At Cornell we have a Lucent PBX and use Lucent's JTapi implementation, ljtapia.jav. Different PBX vendors supply their own JTapi implementations.

In order to run the PBX Server, you need to have a CLASSPATH environment variable that contains the pathname of a directory containing ljtapia.jar.

Be in the cnrg.itx.gtwy.pbx directory. That directory contains PBSXignalingServer.class (after compilation). The directory should also contain a tsapi.pro file which contains the address of the PBX's TServer (this is for the Lucent case; other vendors may have different configuration setups). Finally, the directory must also contain a resolv.conffile saying where the ITX directory server is running.

A copy of tsapi.pro can be found in itx\gtwy\pbx. It contains the internet addresses of the computer that manages the PBX database for the ITX project.

The PBX server is launched as follows:

       jview cnrg.itx.gtwy.pbx.PBXSignalingServer [ log ]
If the logging option is specified, the PBX server will print status messages to the terminal as it runs.

There is a compilation option on PBX Server that determines whether or not the PBX returns to the gateway as soon as a call is placed (i.e. the destination telephone is ringing) or only after the call has been picked up or timed out after a certain number of rings. This option is WAIT in Dialer.java. Default value is false, which means that the PBX returns to the Gateway as soon as the call is placed.

The other compile time options are userids and passwords for the PBX server. There are two sets: