PBX Line

The PBX Line object defines one of the group of physical telephone linesor Configured SIP Bindings that connect the PBX to the NE, and specifies how it is used. It is a child of the PBX Lines object.

A PBX line that uses a Configured SIP Binding can support multiple concurrent telephone calls, so you may only need one PBX Line if the PBX uses SIP. You can configure two or more PBX lines if required, but they must use different Configured SIP Bindings, with a different contact IP address / port combination on each binding.

To configure and enable a PBX Line, you need to do the following:


Parameter

Access

Description
Configured SIP Binding Change Inactive This field appears only if the Call Agent signaling type field on the PBX object is set to SIP. Specifies the configured SIP binding that this PBX Line uses to connect to the NE. To specify a configured SIP binding, click on the search button at the end of the field to select from a list of configured SIP bindings for which the Usage field is set to Subscriber. As a short-cut to select the Configured SIP Binding, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, or a range such as CA-FL. For more details, refer to the description of the Details panel in Operations Manual: Overview.
Maximum call appearances Change This field appears, and must be supplied, only if the Call Agent signaling type field on the PBX object is set to SIP. The maximum number of simultaneous call branches in which this PBX Line can participate. The actual maximum number of simultaneous call appearances may be limited by the maximum value specified on the Configured SIP Binding that this PBX Line uses, if this is lower, especially if two or more PBX Lines (on different PBXs) use the same binding. Choose Use default to use the default value specified on the parent PBX (or in its Persistent Profile), or specify a value. The default is 64.
PBX Line usage Change Inactive Specifies which types of incoming calls are accepted on this line. This allows you to allocate one or more lines to the PBX for specific purposes, for example to ensure that a certain number of lines are always available for calls to the switchboard operator or for Direct Inward Dial. This field appears only if the Call Agent signaling type field on the PBX object is set to Analog line/T1 CAS. Values:
  • Listed Direct Number only
    The line can be used only for calls to the switchboard operator.
  • Direct Inward Dial only
    The line can be used only for calls using Direct Inward Dial.
  • Direct Inward System Access only
    The line can be used only for calls using Direct Inward System Access.
  • Listed Direct Number or Direct Inward Dial (default)
    The line can be used either for calls to the switchboard operator or for calls using Direct Inward Dial.
If you specify either of the Direct Inward Dial values, the Signal function code field must be set to a value that supports E and M terminating or LRB terminating (not loop start, ground start, or any of the originating only values).
Gateway Create The Trunk / Access Gateway or Subscriber Gateway that owns the Access Device that this line uses to connect to the NE. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Click on the search button at the end of the field to choose from access devices on Trunk / Access Gateways or access devices on Subscriber Gateways. Then select from the displayed list of gateways of the specified type. As a short-cut to select the gateway, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, or a range such as CA-FL. For more details, refer to the description of the Details panel in Operations Manual: Overview.
Access Device Create The Access Device that this line uses to connect to the NE. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Click on the search button at the end of the field to choose from Access Devices on the gateway specified in the Gateway field. If the gateway contains only one Access Device, this device is selected automatically and there is no need to change it. As a short-cut to select the Access Device, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, or a range such as CA-FL. For more details, refer to the description of the Details panel in Operations Manual: Overview. If you have not selected a gateway in the Gateway field, the match details are used to match against all Access Devices that are children of Trunk / Access Gateways.
Access Line number Create This field appears only if the Number status field on the PBX object is set to Normal, Ported to, or Non-geographic and the Call Agent signaling type field on the PBX object is set to Analog line/T1 CAS. The Access Line number on the specified Access Device that this line uses. Either type in the number (which must not match the access line number used by any other subscriber on this access device), or click on the ellipsis symbol at the end of the field to select from the list of numbers not currently in use. The highest line number that you can specify depends on the access device type: for an IAD it is the number of voice ports configured, and for other devices it is a configured parameter on the access device. If you click on the ellipsis symbol, the dialog box that appears offers 'manual selection' or 'automatic selection'.
  • If you select 'automatic selection', the EMS will assign the subscriber the next free access line number for this device.
  • If you select 'manual selection', the following dialog box presents sub-ranges of access line numbers. Select the sub-range from which the number should be taken and click on Next. In the next dialog box, select a number and click on OK to accept this number. (If no number is shown, this indicates that there are no free numbers in the range; click on Back and select a different number range.)
ISDN Interface Change Inactive This field is valid only in the US.
ISDN default bearer capabilities Change Inactive This field is valid only in the US.
Signal function code Change Inactive This field appears only if the Call Agent signaling type field on the PBX object is set to Analog line/T1 CAS. The subscriber's signal function code which is used for CAS signaling. Values:
  • Loop start
  • Ground start
  • E and M wink start (default)
  • E and M wink start (Originating), delay start (Terminating)
  • E and M wink start (Originating only)
  • E and M immediate start (Originating only)
  • E and M wink start (Terminating only)
  • E and M delay start (Terminating only)
  • LRB wink start
    The abbreviation LRB indicates Loop Reverse Battery.
  • LRB wink start (Originating only)
  • LRB wink start (Terminating only)
  • Reversed LRB wink start (Originating only)
  • LRB delay start (Terminating only)
  • LRB wink start (Originating), delay start (Terminating)
If the PBX Line usage field is set to either of the Direct Inward Dial values, this field must be set to a value that supports E and M terminating or LRB terminating (not loop start, ground start, or any of the originating only values). If the PBX Line uses an Access Device on a Subscriber Gateway that is controlled using MGCP (as specified in its Remote Media Gateway Model), the values Loop start and Ground start are equivalent. All of the E & M and LRB values are also equivalent, except that the Originating only and Terminating only values mean that the line can be used only for outgoing calls or only for incoming calls.
Line usage Change Inactive Specifies whether the subscriber intends to use this line for voice, fax and/or modem calls, or exclusively for fax and modem. This controls the use of data encoding and compression on the line. Note that support for T.38 fax encoding depends on the Remote Media Gateway Model being used, and on the T.38 support setting in the Call Agent. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Values:
  • Voice and fax (default)
    Use this setting if the line can be used for voice calls. The line normally uses 32kbps ADPCM compression (G.726), which is appropriate for voice lines. On detecting a fax tone, it switches automatically to T.38 fax encoding if this is supported, or to uncompressed 64kbps PCM (G.711) otherwise; on detecting a modem tone, it switches to G.711.
  • Fax only
    Use this setting only if the line is used exclusively for fax or modem calls. The line uses uncompressed 64kbps PCM (G.711), but switches to T.38 fax encoding for fax calls if this is supported. Note that G.711 does not provide echo suppression, so there may be problems with echo if the line is used for voice calls.
FSK format Change Inactive The type of FSK tones used to pass Caller ID messages to this line. This field appears only if the Call Agent signaling type field on the PBX object is set to Analog line/T1 CAS, and does not appear if the subscriber uses an access device on a Subscriber Gateway. Values:
  • UK
    Standard UK format
  • Bellcore
    Standard North American format
Line side answer supervision supported Change Inactive Specifies whether Line Side Answer Supervision is supported for this line. This field appears only if the Call Agent signaling type field on the PBX object is set to Analog line/T1 CAS. Values:
  • True (default)
  • False
PBX plays ringback Change Inactive Specifies whether the PBX provides audible ringing tone to the subscriber. Values:
  • True
  • False
The default is False if the grandparent PBX object has a Call Agent signaling type of Analog line/T1 CAS, and this object's Signal function code is set to Loop start or Ground start; otherwise, the default is True.
PBX plays dialtone Change Inactive This field appears only if the grandparent PBX object has a Call Agent signaling type of Analog line/T1 CAS. Specifies whether or not the PBX provides a dialtone to the susbcriber. Values:
  • True
  • False
The default is False if Signal function code is set to Loop start or Ground start; otherwise, the default is True.
Alarm state Read only Specifies whether any alarms are currently raised for this subscriber. Values:
  • Clear
    No alarms are currently raised.
  • Attention Required
    Attention Required - the object is not operating normally, and needs operator intervention.
  • Attend To Dependent
    Attention Required elsewhere - another object on which this object depends is not operating normally.
Alarm log correlator Read only Identifier of the log message that was generated when this subscriber last entered Attention Required or Attend To Dependent alarm state. This field is reset when the Attention Required alarm events and the Attend To Dependent alarm events are reset to zero.
Additional alarm log correlator Read only If available, the identifier of the log message for the original event that caused the last Attention Required or Attend To Dependent alarm state for this object. This field is reset when the Attention Required alarm events and the Attend To Dependent alarm events are reset to zero.
Attention Required alarm events Read only / Reset Number of times (since the alarm count was reset) that this object's alarm state has gone to Attention Required.
Attend To Dependent alarm events Read only / Reset Number of times (since the alarm count was reset) that this object's alarm state has gone to Attend To Dependent.
Alarm state changed timestamp Read only The time at which the Alarm state last changed.
Diagnostics - logging - log level Change Specifies the level of logs recorded for this object. Logs with a priority equal to or greater than the priority specified are recorded. Set to Default level to use the system-wide default level. Values:
  • Level 10 (diagnostics)
  • Level 20 (verbose statistics)
  • Level 30 (verbose operational)
  • Level 40 (statistics)
  • Level 50 (audit)
  • Level 60 (operational)
  • Level 70 (unexpected)
  • Level 80 (error)
  • Level 90 (fatal)
  • Default level (default)
Diagnostics - API trace - enabled Change Specifies whether API tracing is enabled for this object. Values:
  • True
  • False (default)
Diagnostics - API trace - trace tag Change An optional diagnostics tag inserted into API tracing and PD logging for this object. This tag may include any ASCII characters. However, if you want to filter on this tag in the craft interface, do not include spaces or any of the characters ^ \ $ * + ? | ( ) , . ` ' " [ ] { }.
Diagnostics - API trace - trace remote number Change The remote directory number that should be API traced. Outgoing calls made to this number or incoming calls received from this number should be API traced. If a directory number is not specified, all calls made by and received by this subscriber will be API traced.
Requested status Read only Specifies whether an administrator has attempted to enable the PBX Line. Values:
  • Enabled
    The object has been enabled.
  • Disabled
    The object has not been enabled or has been disabled.
Actual status Read only Specifies the current status of the PBX Line. Values:
  • Enabled
    The object has been enabled.
  • Disabled
    The object has not been enabled or has been disabled.