NAME

xisdn − ISDN telephone for X Window System Ver.11

SYNOPSIS

xisdn [−toolkit options] [−e] [−bell {on|off}] [−nodisc] [−dial_to timeout]

DESCRIPTION

xisdn is an ISDN telephone user interface for X Window System.  It can be controlled using the mouse or from the keyboard. 

To make a call, first input the phone number, when click on the Call button.  The asterisk character “∗” is used as the subaddress delimiter.  The Correct and Erase buttons can be used to edit the telephone number being entered. 

Pressing a number button after the Call button allows the user to append additional diallig information (not supported by all ISDNs) or multifrequency tones. 

The F1 through F4 buttons function as one-touchdial keys.  Phone number assignments can be recorded in the file .isdn_no.  Up to 10 numbers can be stored by holding down the Ctrl key and pressing the F1 through F10 keys.  Each number should be entered as shown in the example below.  All characters following a space or tab are interpreted as comments.  If the first character is “#” the entire line is treated as a comment.  To record numbers beginning with the “#” character, such as message dial codes, the line must begin with a “−” (hyphen).  The file .isdn_no is searched for first in the home directory, then in the current directory. 

.isdn_no example entry

        # One-touch Dial
        #
        3123-4567# my home
        −#8300# Dengon Dial
        5678-5678∗17# subaddr = 17
        012-345-6789# office
        001-1-700-1234567# US office

When a call is incoming, the Call button changes to an Answer button. 
 

The Answer button is used to accept calls. 

There is also a Disconnect button for terminating calls and refusing incoming calls. 

After the Suspend button is pressed during a call, it starts the flash on and off.  Pressing a Dial button (one column) at this time causes the call to be suspended.  In order to resume the call later the number displayed on the Dial button is necessary, so make a note of it. 

When a call has been suspended, pressing the Resume button followed by the Dial button (the number when the call was suspended) will cause it to be resumed. 

The Redial button is used to call the last number dialed again.  In order to prevent errors, however, the redial function’s memory is erased automatically once ten minutes have elapsed since the last call.  The redial function’s memory can also be erased by pressing the Erase button when no call is connected. 

Pressing on the PhoneDir button pops up a phone book window based on the .isdn_phone_book database file.  .isdn_phone_book is searched for first in the home directory and then in the current directory.  Phone book entries are displayed one Group at a time.  The list on the left shows the available group names, and the one on the right displays the names belonging to the currently selected list.  When a group is selected from the list on the left, a list of the names belonging to it immediately appears on the right.  Selecting a name from this list causes the corresponding telephone number to appear at the bottom and enables the Call button.  It is also possible to initiate a call by double clicking directly on a name. 

The file format of .isdn_phone_book uses the “,” (comma) character as a delimiter and requires that the first item be the name and the second the telephone number.  All additional items from the third on are ignored.  Lines beginning with a “#” are treated as comment lines unless the second character is a “!”.  Lines beginning with “#!” indicate group names.  The lines listing groups also use the “,” (comma) character as a delimiter.  The first item is the group name and all subsequent items are ignored.  All telephone numbers listed from one group name to the line preceding the next group name line are considered to below to the first group. 

.isdn_phone_book example entries:

        # Telephone database
        #
        #!Acquaintances,# Group name
        Bill Smith, 06-123-4567# Friend
        Jane Jones, 3987-6543, age 23, single, blood type AB  # Cute chick
        #!Relatives,# Group name
        Fred Green, 03-5678-1234∗12# Has subaddress
        Joe Black, 3123-4567# Uncle
        #!Work,# Group name
        Sony, 03-3448-2111, 6-7-35 Shinagawa-ku, Kitashinagawa  # Company

In this example, Bill Smith and Jane Jones belong to the group “Acquaintances” and Fred Green and Joe Black belong to the group “Relatives”. 
It is possible to edit the contents of the phone book from within xisdn. To delete a group from within xisdn, delete all of the telephone numbers that belong to it at the same time.  The phone book can hold up to 500 entries. 

OPTIONS

−e This option forces English language displays regardless of the locale setting.  In the English language mode, letters of the alphabet are displayed on the dial buttons, and alphabetic input from the keyboard is converted into numbers, except that the subaddress portion is not converted. 

−bell This option controls the bell that rings when the dial button is pressed and a call is incoming.  The flags “on” and “off” can be appended as parameters.  The “on” flag is the system default.  The “off” flag causes the bell not to ring. 

−nodisc
If xisdn is ended while a call is still connected, the connection is terminated.  If this option is specified, a warning message appears if the Exit button is pressed while a call is connected. 

−dial_to
Normally, xisdn makes a call when the Call button is pressed, but it is possible to make a call automatically after a certain amount of time has elapsed while inputting the telephone number without a Dial button being pressed.  This option accepts a time (in seconds) as a parameter.  If 0 is specified it makes no call automatically.  The default setting is 0. 

RESOURCES

bell (class Bell)
Specifies whether a bell should sound when a dial button is pressed or a call is incoming. The default is “true”.

nodisc (class Nodisc)
Specifies whether the line should be disconnected when xisdn is terminated.  If set to “true” a warning message is displayed, if set to “false” the call is terminated.  The default is “false”. 

dialTimeout (class DialTimeout)
Specifies the timeout duration (in seconds) during dialing. it makes no call automatically when set to 0. The default is 0.

FILES

$HOME/.isdn_nospeed dial numbers
$HOME/.isdn_phone_booktelephone directory
/usr/lib/locale/LC_MESSAGES/$LANG/isdn.causes diagnostics messages

SEE ALSO

telcall(1), telans(1), teldisc(1), telstat(1)

NOTES

On some ISDNs when calling a toll-free number, that the protocol provides no indication of the call status to Connected.  This can result in a connection being established while Calling is still being displayed on the screen. 

A number of special keys to accommodate OSF/Motif are planned.  Consequently, key assignments differ to a certain extent from those in previous versions of xisdn.  (The setup has been changed so that the cursor keys can be used to select the Call button, etc.) 

NEWS-OSRelease 4.2.1R