Physical DS1 Port

The Physical DS1 Port object defines a DS1 connector on an AM or SG series card, or on a PB3000 or PB3100 adaptor.

Each Physical DS1 Port object is a child of an Adaptor object with adaptor type AM1000 Audio/MF Adaptor, AM1100 Audio/MF Adaptor, AM1200 Audio/MF Adaptor, AM1300 Audio/MF Adaptor, SG1200, SG1100, SG1000, PB3000, or PB3100.

In the EMS System Explorer, the name shown for each Physical DS1 Port indicates

For example, Physical DS1 Port (Controller B, Slot 3, Port 11) "DS1/2/03/11".

In general, you will add Physical DS1 Port objects using the "create all ports" action on the parent Adaptor object, and should not need to create them individually.

To start using DS1 ports, you need to do the following:


For a Physical DS1 port on an Audio/MF Adaptor, you need to activate the port before you activate the parent object. If a port is inactive when the parent is activated, you will not be able to activate it later without first deactivating the parent.


For a Physical DS1 port on an Audio/MF Adaptor, you cannot change the physical encoding, line length, or line framing while the parent object is active. In addition, you cannot disable the port if an IDT Interface is associated with it and is enabled.



If you attempt to quiesce deactivate the object when it is using a DS0 for MTP2 links or ISDN D-channels , it will not deactivate until you deactivate the signaling cross connect or ISDN PRI .

Object-Specific Actions
Start local line loopback This action applies only for a DS1 port on a PB3100 adaptor. It puts the DS1 port into line loopback mode. You cannot use this action if the port is already in loopback mode, if the far end is in loopback mode (or a far-end loopback request is outstanding), or if an out-of-service Bit Error Rate Test is running.
Stop local line loopback This action applies only for a DS1 port on a PB3100 adaptor. It takes the DS1 port out of line loopback mode into normal operation. You can use this action only when the port is already in local line loopback mode.
Start far-end line loopback This action applies only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. It requests the remote equipment to operate in line loopback mode. You cannot use this action if the local port is already in loopback mode, if a far-end loopback request is outstanding, or if an out-of-service Bit Error Rate Test is running. Loopback signaling uses the facility data link channel.
Stop far-end line loopback This action applies only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. It requests the remote equipment to move out of line loopback mode into normal operation. Loopback signaling uses the facility data link channel.
Start BERT This action applies only for a DS1 port on a PB3100 adaptor. It starts out-of-service Bit Error Rate Testing on the port. (This is independent of the in-service Bit Error Rate monitoring reported by the Bit Error Rate field.) You cannot use this action if the port is already in local line loopback mode, if a far-end loopback request is outstanding, or if an out-of-service Bit Error Rate Test is already running.
Stop BERT This action applies only for a DS1 port on a PB3100 adaptor. It stops out-of-service Bit Error Rate testing on the port. You can use this action only when the port is already running an out-of-service Bit Error Rate Test.

Parameter

Access

Description
Port name Read only A unique identifier for this device among all other devices on the Media Gateway. This identifier is used by other objects that need to reference this device.
Port number Create An identifier for this Physical DS1 Port. The valid port numbers depend on the parent adaptor type, as follows.
  • An AM1000 or AM1100 adaptor has four child DS1 ports, with port numbers 1 - 4 (corresponding to the physical ports on the adaptor card).
  • An AM1200, AM1300, or PB3000 adaptor has sixteen child DS1 ports, with port numbers 1 - 16 (corresponding to the physical ports on the adaptor card).
  • A PB3100 adaptor has sixteen child DS1 ports, with port numbers 1 - 16.
  • An SG1000, SG1100 or SG1200 adaptor has eight child DS1 ports, with port numbers 1 - 8 (corresponding to the physical ports on the adaptor card).
Additional information Change A text field that can be used to store information about the Physical DS1 Port. This field is optional; you can supply up to 64 characters of free-form text. The text wraps to the width of the field on screen, or you can use the Enter key to force linebreaks.
Description Read only Information about the controller, chassis slot number and port number associated with this port.
DS1 type Read only Specifies the type of DS1 link. Values:
  • Unknown
    This status is an error. To clear this status, you can perform a hot-swap on the owning adaptor.
  • T1
  • E1
Physical encoding Change Inactive Specifies the physical encoding used on this DS1 port. This setting must match the encoding of the incoming DS1 line; check with the provider of the line if necessary. Values:
  • B8ZS (T1 only)
    This value is required for T1s on a PB3000 Adaptor that are configured to have an ISDN D-channel running on timeslot 24, and is recommended for other T1s that are to be used for ISDN.
  • AMI
  • HDB3 (E1 only)
Line framing Change Inactive Specifies the framing used on this DS1 port. This setting must match the framing on the incoming DS1 line; check with the provider of the line if necessary. Values:
  • D4 (T1 only)
    AT&T D4 format DS1 (T1.107)
  • ESF (T1 only)
    Extended SuperFrame DS1 (T1.107)
  • E1 (E1 only)
    ITU-T Recommendation G.704 (Table 4a)
  • E1 CRC (E1 only)
    ITU-T Recommendation G.704 (Table 4b)
The following values are valid only for an AM* or PB* adaptor:
  • D4 MF (T1 only)
    D4 with CAS support enabled
  • ESF MF (T1 only)
    ESF with CAS support enabled
T1s for use with GR-303 or MF must be ESF MF or D4 MF.
  • For GR-303 this means that the whole DS1 is used for GR-303; for MF it can be shared with ISUP, or with ISDN B-channels (as part of an NFAS PRI), but it cannot carry an ISDN D-channel.
  • On an AM* adaptor card, note that DS0s used for ISUP or ISDN on a DS1 shared with MF will have CAS signaling enabled. This results in a minor degradation in voice quality, and also means that fax/modem and ISDN data calls may not operate correctly.
T1s for use as ISDN or ISUP trunks (not shared with GR-303 or MF) may be any of the other values. PB3000 T1s with an ISDN D-channel on timeslot 24 must be ESF (T1 only).
Direct T1 CAS Change Inactive This field appears only for a PB3100 adaptor in a VP2510 or MG2510 NE with Line framing set to D4 MF or ESF MF. Direct T1 CAS connection is not supported for VP3500 or MG3500 NEs. Specifies whether this port is used by devices (typically PBXs) that connect directly over T1 CAS, or only by devices using IADs or GR-303 IDTs. Values:
  • True
    This port is used by devices connecting directly over T1 CAS. It cannot be used by devices using IADs or GR-303 IDTs. If you select this option, Clock reference must not be set to BITS.
  • False (default)
    This port is used by devices using IADs or GR-303 IDTs. It cannot be used by devices that connect directly over T1 CAS.
Line length Change Inactive Specifies the approximate length of the DS1 cable connected to this port. This is used to control the transceivers to ensure adequate signal strength on the line. This field is not valid if Line framing is set to E1 or E1 CRC. Values:
  • Up to 133ft (40m)
  • 133 - 266ft (40 - 80m)
  • 266 - 399ft (80-120m)
  • 399 - 533ft (120-160m)
  • Over 533ft (160m)
    This value must be used for PB3000 T1s with an ISDN D-channel on timeslot 24.
Line status Read only Specifies the line status of the DS1 interface. One or more of the following values may be set:
  • AIS
    Alarm indication signal: a remote fault is affecting data that would otherwise be received at this port.
  • RAI
    Remote alarm indication: a remote system is not receiving the data that the local port is sending.
  • LOF
    Loss of framing: the local port is receiving a signal but is unable to synchronize with it to recover the data.
  • LOS
    Loss of signal: no receive signal can be detected.
  • BER
    Bit error rate: a high bit error rate (in the region of 1 x 10^-3 or above) has been detected.
If the interface has one or more of these defects in an elapsed second (a Severely Errored Second) for 5 consecutive seconds, it will be marked as "unavailable"; it will be returned to service when 5 consecutive seconds elapse with no defects.
Bit Error Rate Read only This field appears only for a DS1 port on a PB3100 adaptor. It gives an indication of the current rate at which bit errors are being detected on the DS1 interface. BER is calculated continuously, regardless of whether an out-of-service Bit Error Rate Test is being run. Values:
  • Not Applicable (line out of service)
  • BER being calculated (figure available shortly)
  • BER > 3.2 x 10^-3
  • 3.2 x 10^-4 < BER < 3.2 x 10^-3
  • BER < 3.2 x 10^-4, more accuracy not yet available
  • 3.2 x 10^-5 < BER < 3.2 x 10^-4
  • BER < 3.2 x 10^-5, more accuracy not yet available
  • 3.2 x 10^-6 < BER < 3.2 x 10^-5
  • BER < 3.2 x 10^-6, more accuracy not yet available
  • 3.2 x 10^-7 < BER < 3.2 x 10^-6
  • BER < 3.2 x 10^-7, more accuracy not yet available
  • 3.2 x 10^-8 < BER < 3.2 x 10^-7
  • BER < 3.2 x 10^-8
In normal operation, the BER should be lower than 3.2 x 10^-7 (one of the last three values in this list). If the BER is low, it requires a longer measurement period to obtain an accurate estimate. An increased BER is reported quickly, and then as the BER drops the "more accuracy not yet available" values are used to provide the best information available as quickly as possible.
Clock reference Change Inactive Specifies whether the clocking on this link is used as a general clock reference. For a PB card, a value of Yes or BITS only applies on a PB card in slot 4 or 5 on a VP2510 or MG2510. It does not apply to a PB card on a VP3500 or MG3500. A DS1 source on an SG* card provides a more reliable clock source than one on a PB card. Values:
  • No (default)
    The DS1 link's clocking is not used as a general clock reference.
  • Yes
    The DS1 link's clocking is used as a general clock reference.
  • BITS
    Building Integrated Timing Supply: this DS1 link is used only as a general clock reference, and does not carry data. In the supplied configuration files, port 8 on an SG1100 or SG1200 adaptor is normally configured for use with a BITS source.
    You cannot select this value if Direct T1 CAS is set to True; a port used for direct T1 CAS connections cannot act as a BITS source.
Qualified as usable reference Read only This field appears only for a Physical DS1 Port on a PB3100 Adaptor. Specifies whether this Physical DS1 Port is able to provide a network reference for the clock masters. To qualify, the network reference signal must
  • have a frequency of 8,000 pulses per second (+/- 5%)
  • not have slipped more than 0.25 frames per second (one frame every four seconds) over the previous 30 seconds
  • have a bit error rate of less than 10^-5.
Values:
  • True
  • False
When the system is first activated, this value will be False because the system has not been running long enough to qualify the NETREF signal.
Supported terminations Read only Specifies which termination protocols this port supports. If Direct T1 CAS is set to True, none of these will be selected. Values:
  • ISUP
  • MF (North America only)
  • MTP2
  • GR-303 (North America only)
  • ISDN (North America only)
MF Protocol Profile Change Inactive The MF Protocol Profile used by this port. Select from the displayed list of MF Protocol Profiles.
Deactivation mode Change Specifies how child objects should be deactivated when deactivating this object. Values:
  • Normal (default)
    Shut down child objects normally before deactivating the object.
  • Quiesce
    Deactivating the Physical DS1 Port in quiesce mode will wait for all existing child objects using the port to be completed before deactivation. No new child objects using this port will be accepted during this deactivation period.
  • Abort
    Deactivate the object and all its child objects immediately. (This may result in errors at remote systems.)
Available uses Read only Indicates whether this port is able to carry an ISDN D-channel. If either of the two values ISDN D-channel (network-side) or ISDN D-channel (user-side) is set, this port is able to carry an ISDN D-channel. For a port on a PB3000 adaptor, this option is specified using the NE CRAFT interface; allowing the port to carry a D-channel means that timeslot 24 on the port is unavailable for media.
Loopback - local loopback status Read only This field appears only for a DS1 port on a PB3100 adaptor. Specifies whether the port is currently operating in local loopback mode. This means that all data sent to the port is sent back unchanged to the remote equipment, for use in test procedures such as Bit Error Rate Testing (BERT). Values:
  • No loopback
  • Local line loopback
  • Local line loopback set by the far-end
Loopback - far-end loopback request status Read only This field appears only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. Specifies whether the MetaSwitch NE has requested the remote equipment to operate in loopback mode. This means that all data sent from the port is sent back unchanged by the remote equipment, for use in test procedures such as Bit Error Rate Testing (BERT). Values:
  • No request
  • Requesting line loopback
  • Request for line loopback succeeded
  • Request for line loopback failed
  • Requesting line loopback deactivation
  • Request for line loopback deactivation failed
Loopback - allow automatic loopback activation Change Inactive This field appears only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. Specifies whether this port should automatically accept loopback activation requests from the remote equipment. Values:
  • True
    The port automatically goes into local loopback mode when the remote equipment requests it.
  • False (default)
    The port ignores loopback activation requests from the remote equipment; instead, local loopback must be requested manually using the Start local line loopback pushbutton.
Bit Error Rate Test (BERT) results - test running Read only This field and the following Bit Error Rate Test fields appear only for a DS1 port on a PB3100 adaptor. They relate to out-of-service Bit Error Rate Testing started using the action pushbuttons, which is independent of the in-service monitoring indicated by the Bit Error Rate field. Specifies whether a Bit Error Rate Test is currently running on this port. Values:
  • True
  • False
Bit Error Rate Test (BERT) results - test pattern synchronized Read only This field appears only if Bit Error Rate Test (BERT) results - test running is True. Specifies whether the test pattern used in BERT is currently synchronized (and hence whether the error rate can be measured). Values:
  • True
  • False
Bit Error Rate Test (BERT) results - total test time Read only The length of time in seconds for which the current BERT has been running, or the duration of the most recent BERT if it is not currently running. This field is updated once every minute.
Bit Error Rate Test (BERT) results - loss of synchronization seconds Read only The total length of time in seconds for which synchronization has been lost during the current BERT, or during the most recent BERT if it is not currently running. This field is updated once every minute.
Bit Error Rate Test (BERT) results - loss of signal (LOS) seconds Read only The total length of time in seconds for which there has been a Loss Of Signal condition during the current BERT, or during the most recent BERT if it is not currently running. This field is updated once every minute.
Bit Error Rate Test (BERT) results - Bit Error Rate Read only The Bit Error Rate as measured by the current BERT, or by the most recent BERT if it is not currently running. If the test runs with loss of synchronization conditions, this field shows the measured BER while the test was synchronized. This is displayed as a floating-point number with three significant figures:
  • If no errors are detected, this is displayed as 0.00e+00.
  • If the Bit Error Rate cannot be determined because of loss of signal or loss of test pattern synchronization, this is displayed as 1.00e+00.
  • Otherwise it is displayed in the format N.NNe-MM, where N.NN represents the significant figures and -MM represents the power of 10; for example, 1.23e-05 represents 1.23x10-5.
This field is updated once every minute. The accuracy that can be obtained for a BERT depends on the test duration: 90 seconds: accuracy to order 10-7
15 minutes: accuracy to order 10-8
2.5 hours: accuracy to order 10-9
1 day: accuracy to order 10-10
Bit Error Rate Test (BERT) results - maximum interval Bit Error Rate Read only The highest Bit Error Rate measured during any five-second interval by the current BERT, or by the most recent BERT if it is not currently running. This is displayed as a floating-point number with three significant figures, in the same format as for Bit Error Rate Test (BERT) results - Bit Error Rate.
Alarm state Read only Specifies whether any alarms are currently raised for this object. 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 for the event that caused the last Attention Required alarm state for this object. This field is reset when the Attention Required alarm events field is 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.
Alarm state changed timestamp Read only The time at which the Alarm state last changed.
Alarm events reset timestamp Read only The time at which the Attention Required alarm events was last reset to zero.
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.
Requested status Read only Specifies whether an administrator has attempted to activate the port. Values:
  • Active
    The object has been activated.
  • Inactive
    The object has not been activated or has been deactivated.
  • Disabled
    The object has been disabled.
Actual status Read only Specifies the current status of the port. Values:
  • Active
    The object is active.
  • Activating
    Activation is in progress.
  • Deactivating
    Deactivation is in progress.
  • Inactive
    The object is inactive.
  • Disabled
    The object has been disabled.
  • Activation Failed
    The object is inactive because an activation attempt has failed.
  • Failed
    The object was active but has failed.
  • Quiescing
    The object is preparing for normal deactivation. It is operating normally but will not accept any new users.
  • Waiting For Parent
    The object cannot be used because its parent object is not yet active.
  • Parent Failed
    The object cannot be used because its parent object has failed.