Access Device

The Access Device object describes a connection to the NE from a BLES IAD, GR-303 IDT, or VoIP IAD, or a direct connection over T1 CAS, which can be used by one or more subscribers to access the NE. It is a child of either the Access Devices object (below a Trunk / Access Gateway) or the Subscriber Gateway object.

You need to create an Access Device object corresponding to each physical IAD or IDT device, each device that connects to the NE using direct T1 CAS, or (if the parent Subscriber Gateway corresponds to a Broadband Loop Carrier) each block of access lines on the Broadband Loop Carrier. This object corresponds to the Call Agent's view of the access device, rather than the physical device itself.


If any of the TDM ports on a Trunk / Access 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.



You cannot enable or activate an Access Device unless the associated IAD or IDT device is enabled or activated. You cannot delete an Access Device if one or more subscriber lines are configured to use it.


Parameter

Access

Description
Media Gateway type Change Inactive The type of gateway through which the device connects to the NE. This field is filled in automatically from the parent gateway, but you can change it in order to move the object to a different parent gateway. Values:
  • Trunk / Access
  • Subscriber
Trunk / Access Gateway Change The Trunk / Access Gateway through which the device connects to the NE. This field appears only if Media Gateway type is set to Trunk / Access. Select from the displayed list of gateways.
Subscriber Gateway Change Inactive The Subscriber Gateway through which the device connects to the NE. This field appears only if Media Gateway type is set to Subscriber. It is filled in automatically from the parent Gateway, but you can change it in order to move the object to a different gateway. Select from the displayed list of gateways.
Access Hardware Change This field appears only if Media Gateway type is set to Trunk / Access and the Trunk / Access Gateway field specifies a MetaSwitch Media Gateway. Click on the button to select whether this Access Device represents an IAD, an IDT, or a device connecting over direct T1 CAS. Then select the device from a list of configured devices, or select the adaptor that owns the DS1 port and then the port itself. You cannot select a DS1 port that is already in use by another Access Device or by a TDM Port. The EMS then updates the values of the Port name, Access protocol, Description and Maximum line number fields to match the selected device.
Port name Change Inactive / Read only A unique identifier for this device.
  • If Media Gateway type is set to Trunk / Access and the Trunk / Access Gateway field specifies a MetaSwitch Media Gateway, the description is taken from the selected IAD, IDT or DS1 port and is read only.
  • Otherwise, this field is optional. If you do not specify a name, the EMS generates a default name based on the Access device number field and the prefix field configured in the Media Gateway Model for the owning gateway. To return to the default port name, simply delete the contents of this field.
Access protocol Read only The protocol used to access the NE. This field appears only if Media Gateway type is set to Trunk / Access and the Trunk / Access Gateway field specifies a MetaSwitch Media Gateway. Values:
  • BLES
  • GR-303
  • Direct T1 CAS (North America only)
Description Change A text string used in the EMS System Explorer to identify this Access Device. Specify a string of up to 64 characters, which must not match the description of any other Access Device.
Connection type Change Inactive This field does not appear if Media Gateway type is set to Trunk / Access and the Trunk / Access Gateway field specifies a MetaSwitch Media Gateway. Specifies the type of connection from this Access Device to its parent gateway. Values:
  • Analog (default)
  • Digital
The value that you select must be supported by the parent gateway's Remote Media Gateway Model (in the Supported connection types field). If you change this value, you will need to specify a new value in the Access Device Number field.
Access Device number Change Inactive This field does not appear if Media Gateway type is set to Trunk / Access and the Trunk / Access Gateway field specifies a MetaSwitch Media Gateway. A unique number to identify this Access Device among other devices with the same connection type on its parent gateway. For a Subscriber Gateway, there is normally only one access device child object, so this value can be set to 1. If there are two or more access devices as children of the same parent, using the same connection type, either type in a different number for each one, or click on the ellipsis symbol at the right-hand end of the field to select the next free value.
Maximum line number Change Inactive / Read only Maximum line number usable on this port (the maximum number of subscriber lines that this port supports). If Media Gateway type is set to Trunk / Access and the Trunk / Access Gateway field specifies a MetaSwitch Media Gateway, the value is taken from the selected IAD or IDT (or, for a Direct T1 CAS port, is set to 24) and is read-only.
Receive gain Change This field appears only if Access protocol is visible and set to GR-303 or Direct T1 CAS. Specifies the gain that should be applied to the audio (including voice-band data calls) received on this access device. (The receive gain is not applied if the call is signaled as a data call.) This gain is applied only to calls that use PB* adaptors, and not those on AM*, TD* or SG* adaptors. It does not alter the gain on TDM calls on a PB3000 Adaptor. Note that changing this value will not apply the gain to existing calls, but will be applied to new calls that are set up after the change. Range: -12 to 12 dB. The default is zero (no gain is applied). Values outside of the range -6 to 3 dB can detrimentally affect voice quality, and prevent DTMF tone relay from functioning correctly. You will normally only apply negative gains, for example when configuring your system to comply with the loss plan The loss plan is described by SR2275 and T1.506-1997 (R2001).
Transmit gain Change This field appears only if Access protocol is visible and set to GR-303 or Direct T1 CAS. Specifies the gain that should be applied to the audio (including voice-band data calls) sent on this access device. (The transmit gain is not applied if the call is signaled as a data call.) This gain is applied only to calls that use PB* adaptors, and not those on AM*, TD* or SG* adaptors. It does not alter the gain on TDM calls on a PB3000 Adaptor. Note that changing this value will not apply the gain to existing calls, but will be applied to new calls that are set up after the change. Range: -12 to 12 dB. The default is zero (no gain is applied). Values outside of the range -6 to 3 dB can detrimentally affect voice quality, and prevent DTMF tone relay from functioning correctly. You will normally only apply negative gains, for example when configuring your system to comply with the loss plan. The loss plan is described by SR2275 and T1.506-1997 (R2001).
Provider status Read only The availability status of the Access Device. 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 (default)
    Shut down child objects normally before deactivating the object.
  • Quiesce
    Deactivating the Access Device object in quiesce mode will wait for all existing child objects using the Access Device to be completed before deactivation. No new child objects using this Access Device object 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.)
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 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 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.
Export - number of objects exported Read only The total number of objects (including child objects) written to the export file so far in the current or most recent export operation.
Export - status Read only The status of the current or most recent export operation, if any. Values:
  • None
    No export has been attempted. Use the export pushbutton to start it.
  • In progress
    Export is in progress. Do not attempt to access the export file until the status has changed to Succeeded.
  • Succeeded
    Export completed successfully.
  • Failed
    Export failed. Check the Export - log correlator field for more details.
  • Partially failed
    A field in the configuration of the exported object or one of its child objects was not valid. Typically this is because a referenced object has been deleted. Either check and correct the configuration before retrying the export, or correct the error in the exported file before attempting to re-import it.
Export - file Change The name of the text file (in the EMS User's home directory on the EMS Server) to which configuration information for this object will be exported. The maximum length of the filename is 32 characters.
Export - log correlator Read only If the export status is Failed, this field contains a correlator for the log message that contains details of the failure. Click on the 'go to log' button next to this field to jump to this message in the EMS log viewer window.
Export - correlator metaswitch Read only If the export status is Failed, this field contains the name of the EMS Server or MetaSwitch Network Element that generated the failure log. You may need this information to find the log in the EMS log viewer window.
Requested status Read only Specifies whether an administrator has attempted to activate the Access Device. 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 Access Device. 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.