Overview | Package | Class | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## 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.conf`file 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:

- In `PBXSignalingServer.java`, LOGIN and PASWD are for authenticating with the TServer. At Cornell, these are "cs519" and "cs519".
- In `PBXSignalingServer.java`, myUID and myPIN are the username and password under which the PBXServer is registered in the ITX database. The PBX Server, when launched, registers itself with the ITX database so that it can be found by the Gateway.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES