Busy Lamp Field Configuration Parameters

The maximum number of BLF entries for phones is 50.

In the following table, x in a parameter is the number of the BLF entry in the list. If you are using static BLF, you need to configure the number of each entry.

Table 1. Busy Lamp Field Parameters

Template

Parameter

Permitted Values

Change Causes

Restart or Reboot

features.cfg

attendant.behaviors.automata.pickupOnBusy

Set to allow an automata resource (static BLF) pickup on a busy BLF Resource.

1 (default) - Allows pick up on a Busy Lamp Field resource.

0 - Doesn’t allow pick up on a Busy Lamp Field resource.

No

features.cfg

attendant.behaviors.display.remoteCallerID.automata

These parameters depend on the value set for the parameter attendant.resourceList.x.type . If the parameter attendant.resourceList.x.type is set to automata, use the parameter attendant.behaviors.display.remoteCallerID.automata .

1 (default) - Automata remote party caller ID information is presented to the attendant.

0 - The string unknown is substituted for both name and number information.

No

features.cfg

attendant.behaviors.display.remoteCallerID.normal

These parameters depend on the value set for the parameter attendant.resourceList.x.type . If the parameter attendant.resourceList.x.type is set to normal, use the parameter attendant.behaviors.display.remoteCallerID.normal .

1 (default) - Normal remote party caller ID information is presented to the attendant.

0 - The string unknown is substituted for both name and number information.

No

features.cfg

attendant.behaviors.display.spontaneousCallAppearances.automata

0 (default) - The call appearance is not spontaneously presented to the attendant. The information displayed after a press and hold of a resource's line key is unchanged by this parameter. Note that the values of these call appearance parameters depend on the values applied to attendant.resourceList.x.type .

When this parameter is set to 0, the ringtone ‘Ring Splash' does not play when attendant.ringType=ringer14 .

1 - The normal or automatic call appearance is spontaneously presented to the attendant when calls are alerting on a monitored resource (and a ring tone is played).

No

features.cfg

attendant.behaviors.display.spontaneousCallAppearances.normal

1 (default) - The normal or automatic call appearance is spontaneously presented to the attendant when calls are alerting on a monitored resource (and a ring tone is played).

0 - The call appearance is not spontaneously presented to the attendant. The information displayed after a press and hold of a resource's line key is unchanged by this parameter. Note that the values of these call appearance parameters depend on the values applied to attendant.resourceList.x.type .

When this parameter is set to 0, the ringtone ‘Ring Splash' does not play when attendant.ringType=ringer14 .

No

features.cfg

attendant.behaviours.display.spontaneousCallAppearances.automata

Specifies how call appearances display on the attendant phone.

0 (default) - The call appearance is not spontaneously presented to the attendant. The information displayed after a press and hold of a resource's line key is unchanged by this parameter.

1 - The automata call appearance is spontaneously presented to the attendant when calls are alerting on a monitored resource (and a ring tone is played). Note that the values of these call appearance parameters depend on the values applied to attendant.resourceList.x.type .

No

features.cfg

attendant.behaviours.display.spontaneousCallAppearances.normal

Specifies how call appearances display on the attendant phone.

1 (default) - The normal call appearance is spontaneously presented to the attendant when calls are alerting on a monitored resource (and a ring tone is played).

0 - The call appearance is not spontaneously presented to the attendant. The information displayed after a press and hold of a resource's line key is unchanged by this parameter. Note that the values of these call appearance parameters depend on the values applied to attendant.resourceList.x.type .

No

features.cfg attendant.NUM_REPLACE_1. display.spontaneousCallAppearances

Specifies spontaneous call appearance property for any BLF incoming call.

This parameter will override the phone level configuration parameters attendant.behaviors.display.spontaneousCallAppearances.normal and attendant.behaviors.display.spontaneousCallAppearances.automata to show or hide the call appearance for any BLF incoming call.

Auto (default) – This value will use phone-level configuration depending on the BLF value set of parameters.

Show – This value will override phone-level configuration and will show the call appearance.

Hide – This value will override phone-level configuration and will hide the call appearance.

No

features.cfg

attendant.callWaiting.enable

0 (default) - The phone does not generate acoustic indication of call waiting for attendant calls monitored by BLF.

1 - The phone generates an acoustic indication of call waiting for attendant calls monitored by BLF.

No

features.cfg

attendant.callWaiting.ring

This parameter is valid only if attendant.callWaiting.enable is set to 1. Specifies the ring type to be used for notifying an attendant call if there is an active call already present on the phone.

Silent - No acoustic indication is provided.

beep - Beep tone is played when there is an active call on the phone and an attendant call is received.

ring - Ring tone configured in attendant.ringType is used to alert the user when there is an active call on the phone and an attendant call is received.

No

features.cfg

attendant.reg

Specifies an index number for the BLF resource. The index of the registration is used to send a SUBSCRIBE to the list SIP URI specified in attendant.uri . For example, attendant.reg = 2 means the second registration is used.

1 (default)

Permitted value is any positive integer.

No

features.cfg

attendant.resourceList.x.address

The user referenced by attendant.reg="" subscribes to this URI for dialog. If a user part is present, the phone subscribes to a sip URI constructed from the user part and domain of the user referenced by attendant.reg . Transport for BLF subscriptions may be modified by including a transport parameter into the subscription address. For example: sip: blf12345@domain.com;transport=tcp

Permitted value is a string that constitutes a valid SIP URI (sip: 6416@polycom.com) or contains the user part of a SIP URI (6416).

Null (default)

No

features.cfg

attendant.resourceList.x.bargeInMode

Enable or disable barge-in and choose the default barge-in mode. This parameter applies to the Alcatel-Lucent CTS only.

Null (default) - If no value is entered, the Barge In feature is disabled.

All - Press and hold the BLF line to display all barge-in options.

Quick press to barge-in as Normal.

Normal - Barge-in plays an audio tone to indicate the arrival of a

new participant to the call and all call participants can interact.

Listen - The user barging in can listen on the call only. Their

outbound audio is not transmitted to either party.

Whisper - The user barging in can hear all parties but their audio is

only transmitted to the user they are monitoring.

No

features.cfg

attendant.resourceList.x.callAddress

Use this parameter when the call signaling address for the BLF line is different than the address set by attendant.resourceList.x.address.

Null (default)

Maximum 255 characters

No

features.cfg

attendant.resourceList.x.label

The text label displays adjacent to the associated line key. If set to Null, the label is derived from the user part of attendant.resourceList.x.address .

Null (default)

Permitted value is a UTF-8 encoded string.

No

features.cfg

attendant.resourceList.x.proceedingIsRecipient

A flag to determine if pressing the associated line key for the monitored user picks up the call.

1 - If the call server does not support inclusion of the direction attribute in its dialog XML.

0 (default)

No

features.cfg

attendant.resourceList.x.requestSilentBargeIn

0 (default) - A tone plays when a contact barges in on a call.

1 - No tone is played when a contact barges in on a call.

No

features.cfg

attendant.resourceList.x.type

The type of resource being monitored and the default action to perform when pressing the line key adjacent to monitored user x.

normal (default) -The default action is to initiate a call if the user is idle or busy and to perform a directed call pickup if the user is ringing. Any active calls are first placed on hold. Note that the value normal applies the call appearance setting attendant.behaviors.display.*.normal .

automata -The default action is to perform a park/blind transfer of any currently active call. If there is no active call and the monitored user is ringing/busy, an attempt to perform a directed call pickup/park retrieval is made. Note that the value automata applies the call appearance setting attendant.behaviors.display.*.automata=0 .

No

features.cfg

attendant.restrictPickup

0 (default) - The attendant can pick up calls to monitored users while they show as ringing.

1 - The attendant cannot pick up the monitored call.

No

features.cfg

attendant.ringType

The ringtone that plays when a BLF dialog is in the offering state.

ringer1 (default)

ringer1 - ringer 24

No

features.cfg

attendant.uri

The list SIP URI on the server. If this is just a user part, the URI is constructed with the server hostname/IP.

Note: If this parameter is set, then the individually addressed users configured by attendant.resourceList and attendant.behaviors are ignored.

Null (default)

Strings are permitted.

No

sip-interop.cfg

call.directedCallPickupMethod

Specifies how the phone performs a directed call pick-up from a BLF contact.

legacy (default) - Indicates that the phone uses the method specified in call.directedCallPickupString .

native - Indicates that the phone uses a native protocol method (in this case SIP INVITE with the Replaces header.

No

sip-interop.cfg, site.cfg

call.directedCallPickupString

The star code to initiate a directed call pickup.

*97 (default)

Note: The default value supports the BroadWorks calls server only. You must change the value if your organization uses a different call server.

No

sip-interop.cfg

call.parkedCallRetrieveMethod

The method the phone uses to retrieve a BLF resource's call which has dialog state confirmed.

legacy (default) - Indicates that the phone uses the method specified in call.parkedCallRetrieveString .

native - Indicates that the phone uses a native protocol method (in this case SIP INVITE with the Replaces header).

No

sip-interop.cfg, site.cfg

call.parkedCallRetrieveString

The star code that initiates retrieval of a parked call.

Null (default)

Permitted values are star codes.

No

sip-interop.cfg

voipPort.SIP.useCompleteUriForRetrieve

1 (default) - The target URI in BLF signaling uses the complete address as provided in the XML dialog document.

0 - Only the user portion of the target URI in the XML dialog document is used and the current registrar's domain is appended to create the address for retrieval.

No

sip-interop.cfg

voIpProt.SIP.strictReplacesHeader

This parameter applies only to directed call pick-up attempts initiated against monitored BLF resources.

1 (default) - The phone requires call-id, to-tag, and from-tag to perform a directed call-pickup when call.directedCallPickupMethod is configured as native.

0 - Call pick-up requires a call id only.

No

sip-interop.cfg

voIpProt.SIP.useLocalTargetUriforLegacyPickup

1 (default) - The target URI in BLF signaling uses the complete address as provided in the XML dialog document.

0 - Only the user portion of the target URI in the XML dialog document is used and the current registrar's domain is appended to create the address for pickup or retrieval.

No

features.cfg attendant.callAction

Specify the call action behavior for an Active call.

Dial-Pick up (default) – An active call goes on hold and dials to monitor line or picks the incoming call on monitor line when you short press the monitored line keys.

Blind – Blind transfer an active call on the monitored line keys.

Park – Parks an active call on the monitored line keys. If there is already a parked call on a monitored line then it will retrieve the parked call.

No
features.cfg attendant.callActionMenu.enabled

This parameter is configured to get the Attendant Call Action menu on the phone when you configure dynamic BLF on the phone.

0 (default) – Attendant Call Action menu will not appear on the phone.

1 - Attendant Call Action menu will appear on the phone.

No
features.cfg attendant.displayHoldState.enable=1

Specifies the control of the display on the phone for BLF hold state.

0 (default) –The phone displays a busy state.

1 – The phone displays a hold state.

Note : This parameter is only applicable to static BLF

No
features.cfg attendant.resourceList.NUM_REPLACE_1.hold.ringer

The ringtone that plays on the phone when BLF is in a hold state.

The parameter depends on the value set for the parameter attendant.displayHoldState.enabled . If the parameter attendant.displayHoldState.enable is set to 1, use the parameter attendant.resourceList.NUM_REPLACE_1.hold.ringer

Triplet (default) – Specifies the ringtone name for the parameter ringer11.

Ringtone for BLF Hold should play for only 10 sec.

No
features.cfg attendant.resourceList.NUM_REPLACE_1. display.spontaneousCallAppearances

This parameter is applicable to Static BLF.

Specifies spontaneous call appearance property for an incoming call.

This parameter will override the phone level configuration parameters attendant.behaviors.display.spontaneousCallAppearances.normal and attendant.behaviors.display.spontaneousCallAppearances.automata to show or hide the call appearance property for BLF incoming call based on the resource type.

Auto (default) – This value will use phone-level configuration depending on the BLF resource type.

Show – This value will override phone-level configuration and show the call appearance.

Hide – This value will override phone-level configuration and hide the call appearance.

Note: Existing BLF ringtone will not stop, if new BLF call comes.

No
features.cfg attendant.resourceList.NUM_REPLACE_1.ringType

This parameter is applicable to Static BLF.

Specifies incoming ringtone for each static BLF line

defaultAll (default) – Specifies the ringtone type ring for the ringtone name.

ringer1 - ringer 24.

If no ringtone is configured for any static BLF line, then phone level incoming ringtone defined with attendant.ringType parameter will be played.

No