Physical DS1 Port

The Physical DS1 Port object defines a DS1 connector on an AM or SG series card, or on a PB3000 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, TD1000, TD1100, or PB3000.

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 cannot change the physical encoding, line length, or line framing while the parent object is active.



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


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, TD1000, TD1100, or PB3000 adaptor has sixteen child DS1 ports, with port numbers 1 - 16 (corresponding to the physical ports on the adaptor card).
  • 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.
  • Not set
    The DS1 has not yet been activated. This value should change to T1 or E1 when the DS1 is activated.
  • 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)
  • 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
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)
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 port is sending.
  • LOF
    Loss of framing: the 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.
Clock reference Change Inactive Specifies whether the clocking on this link is used as a general clock reference. You should leave this value set to No. 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.
Supported terminations Read only Specifies which termination protocols this port supports. Values:
  • ISUP
  • MF (North America only)
  • MTP2
  • GR-303 (North America only)
  • ISDN (North America only)
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.)
If a Normal or Quiesce deactivation is already in progress, you can force a faster deactivation by changing the value from Normal to Quiesce or from Quiesce to Abort.
Available uses Read only This field applies only in the US.
Fault monitoring level Change / Read only Specifies whether to suppress alarms raised on this port, so that the EMS does not display them or send them to SNMP alarm notification destinations. You may want to do this if you expect alarms from this port (for example if it is currently being provisioned or undergoing maintenance), so that it is easier to see unexpected alarms from other objects. Values:
  • Normal (level 10) (default)
    Alarms for this port appear in the EMS and are sent to SNMP alarm notification destinations as usual.
  • Suppress alarms (level 5)
    Alarms for this port do not appear in the EMS and are not sent to SNMP alarm notification destinations.
Changing this field also updates the fault monitoring level on the TDM port associated with this DS1 port. If there is no associated TDM port, or if the Media Gateway cannot contact the Call Agent, this field is read only and set to Normal (level 10).
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.
DS0 Attention Required alarms Read only The total number of Attention Required alarms for child DS0 Termination objects of this Physical DS1 Port object.
Summary child alarm state Read only Summarizes the alarm status for all children of this object. Values:
  • Clear
    No alarms are currently raised.
  • Attention Required
    Attention Required - one or more child objects are not operating normally, and need operator intervention.
  • Attend To Dependent
    Attention Required elsewhere - another object on which one or more child objects depend is not operating normally.
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 text string inserted into API tracing and PD logging for this object. (This string can include accented / international characters as defined in ISO 8859-1.) If you want to filter on this tag in the craft interface, do not include spaces or any of the 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.