TDM Port

The TDM Port object is a child of the TDM Ports object. It identifies a connection to the telephone network.

In general, the TDM Port objects for MetaSwitch gateways are included as part of the delivered configuration. If you modify the configuration of TDM Ports below the Media Gateway, you will need to update the equivalent configuration below the corresponding Trunk / Access Gateway, but you may find it easier to use the "shadow object" actions on the Trunk / Access Gateway to make this update rather than changing the objects explicitly.

To create the TDM Port child objects for a third-party gateway, you can use MetaSwitch-supplied configuration files, which are available from the MetaSwitch Customer Portal (http://support.metaswitch.com), and you can use the EMS's Import function on the parent Trunk / Access Gateway object to import them into your configuration. A user name and password are required to access the portal; contact your MetaSwitch account representative to obtain these if necessary.


If any of the TDM ports on a third-party gateway are used for subscriber access instead of trunking, they should be represented in the EMS by Access Device objects instead of TDM Port objects. After importing the Trunk / Access Gateway's child object configuration, you should delete each port that is used for subscriber access and add an Access Device child object to the Trunk / Access Gateway instead.



If the DS1 port associated with this TDM Port is using a DS0 for MTP2 links or ISDN D-channels , it will not quiesce deactivate until you deactivate the signaling cross connect or ISDN PRI .


Parameter

Access

Description
Type Read only Specifies the type of connection to the telephone network. Values:
  • Unknown
    This status is an error. To clear this status, you can perform a hot-swap on the owning adaptor.
  • T1
  • E1
Port name Change An identifier for the DS1 port associated with this TDM Port, unique among all other devices on the Call Agent. This identifier is used by other objects that need to reference this device. If the TDM Port is a child of a MetaSwitch Trunk / Access Gateway, this field must match the name of the equivalent TDM Port that is a child of the corresponding Media Gateway. If it is a child of a third-party gateway, you can use any text string that does not match the port name of another object on the same gateway. This string must not contain spaces or the characters @ or *.
Description Change This field appears only if the TDM Port is a child of a MetaSwitch Trunk / Access Gateway (not a third-party gateway). A text string used in the EMS System Explorer to identify this port. Specify a string of up to 40 characters.
Profiles supported Change Inactive Specifies the protocol used to communicate with the telephone network. Values:
  • ISUP
  • MF (North America only)
  • ISDN (North America only)
Provider status Read only The availability status of the port. Values:
  • Unavailable
  • Available
  • Inactive
  • Active
  • Out of service
  • Quiescing
  • Unconfigured
  • Pending available
Deactivation mode Change Specifies how child objects should be deactivated when deactivating this object. Values:
  • Normal
    Shut down child objects normally before deactivating the object.
  • Quiesce
    Deactivating the TDM port object 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.)
Network-side ISDN D-channel available Read only Indicates whether this port is able to carry a network-side ISDN D-channel. This option applies only to ports on PB3000 adaptors (for which it is specified using the NE CRAFT interface) and PB3100, PB4000, PB4500, or PB5000 adaptors (for which it is always set to True). Values:
  • True
    This port is able to carry an ISDN D-channel.
  • False
    This port is not able to carry an ISDN D-channel.
If a TDM Port on a PB3000 is configured for ISDN using the NE craft scripts, timeslot 24 is unavailable for media even if the TDM Port is not used for ISDN signaling. On PB3100, PB4000, PB4500, or PB5000 adaptors, timeslot 24 is available for media unless the TDM Port is used for ISDN signaling.
User-side ISDN D-channel available Read only Indicates whether this port is able to carry a user-side ISDN D-channel. This option applies only to ports on PB3000 adaptors (for which it is specified using the NE CRAFT interface) and PB3100, PB4000, PB4500, or PB5000 adaptors (for which it is always set to True). Values:
  • True
    This port is able to carry an ISDN D-channel.
  • False
    This port is not able to carry an ISDN D-channel.
If a TDM Port on a PB3000 is configured for ISDN using the NE craft scripts, timeslot 24 is unavailable for media even if the TDM Port is not used for ISDN signaling. On PB3100, PB4000, PB4500, or PB5000 adaptors, timeslot 24 is available for media unless the TDM Port is used for ISDN signaling.
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 - Attention Required 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.
Attention Required alarm events reset timestamp Read only The time at which the Attention Required alarm events was last reset to zero.
Alarm log correlator - Attend To Dependent Read only Identifier of the log message for the event that caused the last Attend To Dependent alarm state for this object. This field is reset when the Attend To Dependent alarm events field is reset to zero.
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.
Attend To Dependent alarm events reset timestamp Read only The time at which the Attend To Dependent alarm events was last reset to zero.
Alarm state changed timestamp Read only The time at which the Alarm state last changed.
Requested status Read only Specifies whether an administrator has attempted to enable the TDM Port. Values:
  • Active
    The object has been activated.
  • Inactive
    The object has not been activated or has been deactivated.
  • Disabled
    The object has not been enabled or has been disabled.
Actual status Read only Specifies the current status of the TDM 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.