Previous page Next page

Chapter 7: Administering Telephone Options


Administering Options for the 9600 Series IP Telephones

This chapter explains how to change parameters by means of the DHCP or HTTP servers. In all cases, you are setting a system parameter in the telephone to a desired value. Table 9 lists:

For DHCP, the DHCP Option sets these parameters to the desired values as discussed in DHCP and File Servers. For HTTP, the parameters in Table 9 are set to desired values in the script file. For more information, see Contents of the Settings File. When using a media server, see Table 8:  Media Server Field Names & Corresponding Script File Parameter Names for information on parameters set by the media server application.

Avaya recommends that you administer options on the 9600 Series IP Telephones using script files. Some DHCP applications have limits on the amount of user-specified information. The administration required can exceed those limits for the more full-featured telephone models.

You might choose to completely disable the capability to enter or change option settings from the dialpad. You can set the system value, PROCPSWD, as part of standard DHCP/HTTP administration. Alternately, you can set PROCPSWD on the system-parameters ip-options form, as of Communication Manager Release 4.0. If PROCPSWD is non-null and consists of 1 to 7 digits, a user cannot invoke any local options without first entering the PROCPSWD value on the Craft Access Code Entry screen. For more information on craft options, see the Avaya one-X Deskphone Edition for 9600 IP Telephones Installation and Maintenance Guide.

CAUTION: If you administer PROCPSWD as part of DHCP/HTTP administration, the value is stored and transmitted unencrypted. Therefore, do not consider PROCPSWD as a high-security technique to inhibit a sophisticated user from obtaining access to local procedures unless you administer it using page 3 of the system-parameters IP-options form, as of Avaya Communication Manager Release 4.0.

Administering this password limits access to all local procedures, including
VIEW. VIEW is a read-only Craft option that allows review of the current telephone settings.

Table 9:  9600 Series IP Telephone Customizable System Parameters  
Parameter Name
Default Value
Description and Value Range
AGCHAND
1
Automatic Gain Control status for handset
(0=disabled, 1=enabled).
AGCHEAD
1
Automatic Gain Control status for headset
(0=disabled, 1=enabled).
AGCSPKR
1
Automatic Gain Control status for Speaker
(0=disabled, 1=enabled).
AMADMIN
" " (Null)
WML-Application URI. The URI used to obtain the AvayaMenuAdmin.txt file for WML-applications under the A (AVAYA) Menu. Specify the HTTP server and directory path to the administration file. Do not specify the administration file name. For more information, see Avaya "A" Menu Administration.
APPNAME
" " (Null)
Primary application image file name, as provided in the 9600upgrade.txt file.
APPSTAT
1
Controls whether specific applications are enabled, restricted, or disabled. Values are: 1=all applications enabled, 2=Speed Dial (Contacts) changes and Call Log disabled and Redial last number only, 3=Speed Dial (Contacts) changes disabled, 0=Speed Dial (Contacts) changes, Call Log, and Redial disabled.
AUDASYS
3
Globally controls audible alerting. Possible system settings for audible alerting are "0" through "3" with "3" being the default.
AUDIOENV
0
Audio environment selection index. Valid values are 0 through 107.
AUDIOSTHD
0
Headset sidetone setting. Valid values are:
0=No change to sidetone level
1=6dB below nominal
2 =no sidetone (infinite loss).
AUDIOSTHS
0
Handset sidetone setting. Valid values are:
0=No change to sidetone level
1=6dB below nominal
2 =no sidetone (infinite loss)
AUTH
0
Script file authentication value (0=HTTP is acceptable, 1=HTTPS is required).
BAKLIGHTOFF
120
Number of minutes without display activity to wait before turning off the backlight. The default is 120 minutes (2 hours). Valid values range from zero (never turn off) to 999 minutes (16.65 hours).
BRURI
" " (Null)
URL used for backup and retrieval of user data. Specify HTTP or HTTPS server and directory path and/or port number to backup file. Do not specify backup file name. Value: 0-255 ASCII characters. Null is a valid value and spaces are allowed. A subdirectory can be specified, for example:
SET  BRURI  http://135.8.60.10/backup
 
This puts the user backup/restore files in a subdirectory away from all other files (.bins, .txts, etc.) and permits authentication to be turned on for that subdirectory, without turning it on for the root directory.
CNAPORT
50002
Avaya Converged Network Analyzer (CNA) server registration transport-layer port number (0-65535).
CNASRVR
“ ” (Null)
Text string containing the IP Addresses of one or more Avaya Converged Network Analyzer (CNA) servers to be used for registration. Format is dotted decimal or DNS format, separated by commas, with no spaces (0-255 ASCII characters, including commas).
DHCPSTD
0
DHCP Standard lease violation flag. Indicates whether to keep the IP Address if there is no response to lease renewal. If set to “1” (No) the telephone strictly follows the DHCP standard with respect to giving up IP Addresses when the DHCP lease expires. If set to “0” (Yes) the telephone continues using the IP Address until it detects reset or a conflict (see DHCP Generic Setup).
DNSSRVR
0.0.0.0
Text string containing the IP Address of zero or more DNS servers, in dotted-decimal format, separated by commas with no intervening spaces (0-255 ASCII characters, including commas).
DOMAIN
" " (Null)
Text string containing the domain name to be used when DNS names in system values are resolved into IP Addresses. Valid values are 0-255 ASCII characters. If Null, no spaces allowed.
DOT1X
0
802.1X Supplicant operation mode. Valid values are: 0=With PAE pass-through, 1=with PAE pass-through and proxy Logoff, 2=without PAE pass-through or proxy Logoff.
ENHDIALSTAT
1
Enhanced Dialing Status. If set to “1” the Enhanced Local Dialing feature is turned on for all associated applications. If set to “0” the feature is turned off.
HEADSYS
1
Headset operational mode. One ASCII numeric digit. Valid values are:
0 or 2 =General Operation, where a disconnect message returns the telephone to an idle state.
1 or 3 = Call Center Operation, where a disconnect message does not change the state of the telephone.
HTTPDIR
" " (Null)
HTTP server directory path. The path name prepended to all file names used in HTTP and HTTPS get operations during initialization. Value: 0-127 ASCII characters, no spaces. Null is a valid value. Leading or trailing slashes are not required. The command syntax is “SET HTTPDIR myhttpdir” where “myhttpdir” is your HTTP server path. HTTPDIR is the path for all HTTP operations except for BRURI.
HTTPSRVR
" " (Null)
Text list of HTTP server addresses in dotted decimal or DNS format, separated by commas (0-255 ASCII characters, including commas).
ICMPDU
0
Controls whether ICMP Destination Unreachable messages will be processed. Values are: 0=No, 1=Send limited Port Unreachable messages, 2=Send Protocol and Port Unreachable messages.
ICMPRED
0
Controls whether ICMP Redirect messages will be processed. Values are: 0=No, 1=Yes.
L2Q
0
Controls whether Layer 2 frames have IEEE 802.1Q tags (0=auto, 1=enabled, 2=disabled).
L2QVLAN
0
802.1Q VLAN Identifier (0 to 4094). Null (" ") is not a valid value and the value cannot contain spaces. VLAN identifier used by IP telephones. Set this parameter only when IP telephones are to use a VLAN that is separate from the default data VLAN. If the VLAN identifier is to be configured via H.323 signaling based on Avaya Communication Manager administration forms, it should not be set here.
LANG0STAT
1
Controls whether the built-in English language text strings can be selected by the user. Valid values are:
0 = User cannot select English language text strings
1 = User can select English language text strings.
SET LANG0STAT 1
LANGxFILE
" " (Null)
Contains the name of the language file x, where x is 1 through 4. The file name must end in .txt.
Example: SET LANG1FILE “mlf_russian.txt”
LANG1FILE =
LANG2FILE =
LANG3FILE =
LANG4FILE =
LANGLARGEFONT
" " (Null)
Larger text font file name. A string of up to 32 characters specifies the loadable language file on the HTTP server for the Large Text font.
LANGSYS
" " (Null)
System-wide language that contains the name of the default system language file, if any. Value is 0 to 32 ASCII characters. The file name must end in .txt. The default is a null string. Example: SET LANGSYS “mlf_german.txt”
LOGLOCAL
0
Event Log Severity Level (one 0-8 ASCII numeric digit). Controls the level of events logged in the endptRecentLog and endptResetLog objects in the SNMP MIB. Events with the selected level and with a higher severity level will be logged. Valid values are: 0=Disabled, 1=emergencies, 2=alerts, 3=critical, 4=errors, 5=warnings, 6=notices, 7=information, 8=debug.
LOGSRVR
" " (Null)
Voice Monitoring Manager (VMM) Server Address. Zero or one IP Address in dotted-decimal format or DNS Name format (0-15 ASCII characters).
MCIPADD
0.0.0.0
Call Server Address. Zero or more Avaya Communication Manager server IP Addresses. Format is dotted-decimal or DNS name format, separated by commas without intervening spaces (0-255 ASCII characters, including commas). Null is a valid value.
MSGNUM
" " (Null)
Voice mail system telephone/extension number. Specifies the number to be dialed automatically when the telephone user presses the Message button. MSGNUM is only used when the phone is aliased using non-native support. Messaging must be configured for native support. Value: 0-30 ASCII dialable characters (0-9, * and #) and no spaces. Null is a valid value.
OPSTAT
111
Options status flag(s) (1 or 3 ASCII numeric digits) indicate which options are user-selectable. The default of 111 grants access to all options and related applications.
Single digit valid values are:
1=user can access all options, including Logout,
2= user can access only view-oriented applications.

Three-digit valid values are a concatenation of binary values, in the form abc, where each letter represents a 0 (disabled/off) or 1 (enabled/on), interpreted as:
a = base settings for all user options and related applications, except as noted in b or c.
b = setting for view-oriented applications (for example, the Network Information application), as applicable.
c = setting for Logout application, if applicable.
The binary "0" does not allow an end user to see or invoke options and related applications. The binary "1" allows full display and access to all options and related applications.
PHNCC
1
Telephone country code. The administered international country code for the location by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1-3 digits, from “1” to “999.”
PHNDPLENGTH
5
Internal extension telephone number length. Specifies the number of digits associated with internal extension numbers by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1 or 2 digits, from “3” to “13.”
PHNEMERGNUM
" " (Null)
Emergency telephone/extension number. Specifies the number to be dialed automatically when the telephone user presses the Emerg button. Value: 0-30 ASCII dialable characters (0-9, * and #) and no spaces. Null is a valid value.
PHNIC
011
Telephone international access code. The maximum number of digits, if any, dialed to access public network international trunks by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 0-4 digits.
PHNLD
1
Telephone long distance access code. The digit, if any, dialed to access public network long distance trunks by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1 digit or " " (Null).
PHNLDLENGTH
10
Length of national telephone number. The number of digits in the longest possible national telephone number by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1 or 2 digits, from “3” to “10.” Range: 1 or 2 ASCII numeric characters, from “5” to “15.”
PHNOL
9
Outside line access code. The character(s) dialed, including # and *, if any, to access public network local trunks by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 0-2 dialable characters, including " " (Null).
PHY1STAT
1
Ethernet line interface setting (1=auto-negotiate, 2=10Mbps half-duplex, 3=10Mbps full-duplex, 4=100Mbps half-duplex, 5=100Mbps full-duplex, and 6=1000Mbps full-duplex if supported by the hardware).
PHY2PRIO
0
Layer 2 priority value for frames received on or forwarded to the secondary Ethernet interface. Set this parameter only when VLAN separation is "1" (enabled). Values are from 0-7 and correspond to the drop-down menu selection.
PHY2STAT
1
Secondary Ethernet interface setting
(0=Secondary Ethernet interface off/disabled, 1=auto-negotiate, 2=10Mbps half-duplex, 3=10Mbps full-duplex, 4=100Mbps half-duplex, 5=100Mbps full-duplex), and 6=1000Mbps full-duplex if supported by the hardware).
PHY2VLAN
0
VLAN identifier used by frames received on or forwarded to the secondary Ethernet interface. Set this parameter only when VLAN separation is “1” (enabled). Value is 1-4 ASCII numeric digits from “0” to “4094.” Null is not a valid value, nor can the value contain spaces. If this value is set by LLDP using the Port VLAN ID TLV value, it will not change regardless of settings from other sources. For more information, see Parameter Data Precedence.
PROCPSWD
27238
Text string containing the local (dialpad) procedure password (Null or 1-7 ASCII digits). If set, password must be entered immediately after accessing the Craft Access Code Entry screen, either during initialization or when Mute (or Contacts for the 9610) is pressed to access a craft procedure. Intended to facilitate restricted access to local procedures even when command sequences are known. Password is viewable, not hidden.
PROCSTAT
0
Local (dialpad) Administrative Options status (0=all Administrative (Craft) Options are allowed, 1=only VIEW is allowed).
REREGISTER
20
Registration timer in minutes. Controls an H.323 protocol timer that should only be changed under very special circumstances by someone who fully understands the system operation impact. Value is 1-120.
RTCPMON
" " (Null)
Text string containing the 4-octet IP Address of the RTCP monitor currently in use, in dotted decimal or DNS Name format (0-15 ASCII characters, no spaces).
SCREENSAVERON
60
Number of idle time minutes after which the screen saver is turned on. The default is 240 minutes (4 hours). Valid values range from zero (disabled) to 999 minutes (16.65 hours).
SNMPADD
" " (Null)
Text string containing zero or more allowable source IP Addresses for SNMP queries, in dotted decimal or DNS format, separated by commas, with up to 255 total ASCII characters including commas.
Note that as of Avaya Communication Manager Release 4.0, SNMP addresses can also be administered on the system-parameters IP-options form.
SNMPSTRING
" " (Null)
Text string containing the SNMP community name string (up to 32 ASCII characters, no spaces).
Note that as of Avaya Communication Manager Release 4.0, the SNMP community string can also be administered on the system-parameters IP-options form.
STATIC
0
Static programming override flag. If set to “0” static programming never overrides call server (DHCP) or call server administered data. If set to “1” static programming overrides only file server administered data. If set to “2” static programming overrides only call server administered data. If set to “3” static programming overrides both file server- and call server-administered data. Allows a call server IP Address that has been manually programmed into a telephone to override any value received via DHCP or via this configuration file. A manually programmed IP Address will only be used if it is not 0.0.0.0, so this parameter may be used to allow only specific telephones to use a different value than otherwise provided by this configuration file. If STATIC is to be used to select a manual override of file server IP Address(es), STATIC must be set via DHCP, not via this configuration file.
SUBSCRIBELIST
" " (Null)
One or more Push application server subscription URLs, separated by commas without any intervening spaces (0-255 ASCII characters, including commas).
TPSLIST
" " (Null)
One or more trusted domain/path strings, separated by commas without any intervening spaces (0-255 ASCII characters, including commas). A URL pushed to a telephone must contain one of these strings if it is to be used to obtain content to be rendered by the telephone.
UNNAMEDSTAT
1
Unnamed Registration Status. Specifies whether unnamed registration is initiated if the user fails to enter a value at the Extension: prompt or Login screen. Unnamed registration provides the telephone with a TTI-level service, enabling a user, for example, to dial emergency services like 911. Value 1=Yes, 0=No.
VLANSEP
1
VLAN separation. Controls whether frames to/from the secondary Ethernet interface receive IEEE 802.1Q tagging treatment. The tagging treatment enables frames to be forwarded based on their tags in a manner separate from telephone frames. If tags are not changed, no tag-based forwarding is employed. Values are: 1=On/Enabled, 2= Off/Disabled. This parameter is used with several related parameters. For more information, see VLAN Separation.
VLANTEST
60
Number of seconds to wait for a DHCPOFFER when using a non-zero VLAN ID (1-3 ASCII digits, from “0” to “999”).
WMLEXCEPT
" " (Null)
One or more HTTP proxy server exception domains that do not require the use of the proxy server (0-127 ASCII characters, including commas, without any intervening spaces). Set this parameter only if a proxy server is used and if there are exception domains.
WMLHOME
" " (Null)
URL that specifies the home page for Web browsers that use WML, except the 9610. Zero or one URL (0-255 ASCII characters, including spaces, if any). If Null, the Web application will not be displayed.
WMLIDLETIME
10
Idle time before displaying Web page. The number of minutes of inactivity after which the Web browser will be displayed if WMLIDLEURI is not null. The default is 10 minutes. Valid values range from 1 to 999 minutes (16.65 hours).
WMLIDLEURI
" " (Null)
Idle time Web page URI. URI that specifies the Web page the browser displays after an idle interval. Value: Zero or one URI (0-255 ASCII characters, no spaces). Null is valid but if Null, no page displays. Avaya recommends that WMLIDLEURI be specified for telephones in public areas through the use of a GROUP parameter. The idle timer is only reset if WMLIDLEURI is non-null such that an HTTP GET can be sent.
WMLPORT
8000
TCP port number for the HTTP proxy server, if applicable (1-5 ASCII numeric characters from “0” to “65535.” Null is not a valid value.
WMLPROXY
" " (Null)
One HTTP proxy server IP Address in dotted decimal or DNS Name format (0-255 ASCII characters). Set this parameter only if Web pages requiring a proxy server will be supported.
WMLSMALL

Idle screen for the 9610 WML browser (only). Zero (0) to 255 ASCII characters. Zero or one URL. Other 9600 Series telephones use WMLHOME instead.

NOTE: Table 9 applies to all 9600 Series IP Telephones. Certain 9600 IP Telephones might have additional, optional information that you can administer. For more information, see Chapter 8: Administering Applications and Options.


Previous page Next page