Line Class Code

Line Class Codes are provided as an extension to allow you to perform routing that is specific to your deployment and cannot be controlled by other attributes; many deployments may not require them.

The Line Class Code (LCC) object is a child of the Line Class Codes object. It allows you to define a name for a Line Class Code, how it is used, and optionally one or more values that can be used for this code and their meanings.

The MetaSwitch Class 4/5 Softswitch does not assign a specific meaning to any particular Line Class Code or its value. You can define a maximum of 20 codes, each with a meaning specific to your deployment, and assign numeric values as required.

In the configuration of a subscriber (Individual Line, Business Group, Business Group Line, or PBX), or in a Persistent Profile, you can set one or more of the Line Class Codes you have defined to an integer value; you can then match these values during Number Validation and Routing to determine how to route the call. If any of these codes is not set in subscriber configuration, the attribute value defaults to zero.


Parameter

Access

Description
Index Create The EMS's identifier for this Line Class Code object. Specify a number in the range 1 - 20.
Display name Change Optional user-friendly text description identifying the meaning of this Line Class Code. This is used to identify the Line Class Code wherever it appears in subscriber or routing configuration (for example in the field name shown for this Line Class Code in the Individual Line object, or in the attribute name shown for this Line Class Code when you select it as a routing attribute). If you specify a display name, it must not match the display name of any other Line Class Code.
Access Change Specifies whether EMS users can modify the value of this Line Class Code on an active Individual Line, Business Group Line or PBX. Values:
  • Change anytime (default)
    EMS users can modify a subscriber's value of this Line Class Code at any time.
  • Change inactive
    EMS users can modify a subscriber's value of this Line Class Code only when the subscriber is inactive.
The Change inactive value only affects changes made directly to the value of the Line Class Code for an Individual Line, Business Group Line or PBX object in the EMS. Any subscriber who inherits the value of this Line Class Code (using the Use default option) will be affected by any changes in the inherited value. For example, if a Persistent Profile is updated, any subscribers inheriting Line Class Codes from that Profile will receive the new value, regardless of whether or not they are inactive.
Allow inheritance Change Specifies whether the value for this Line Class Code can be inherited as a default (using the Use default option) when configuring an Individual Line, Business Group Line, or PBX. Values:
  • True (default)
    The value can be inherited.
  • False
    The value cannot be inherited and must be specified. The EMS will reject an attempt to select the Use default option.
Variant Change Specifies whether the value of this code in the configuration of an Individual Line, Business Group Line, PBX, or Persistent Profile can be any numeric value, or must be one of the values specified in the Values field below. Values:
  • Validated
    This code must be set to one of the values in the Values field.
  • Non-validated (default)
    This code can be set to any numeric value.
Values Change One or more valid values for this Line Class Code. The values you specify here will be available for selection when you are configuring a value for this code in routing or subscriber configuration. If Variant is set to Validated, you must specify at least one value. This field is a text field in which you can copy, cut, and paste text. To add or edit code values in this field, specify each code on its own line, terminated by a carriage return.
  • The code value must be at the start of the line, and must be a string of numeric digits 0-9. You cannot include two entries with the same value in the same table.
  • You can include an optional text description of the code value on the same line (maximum 64 characters), separated from the value itself by a space character. (This text can include accented / international characters as defined in ISO 8859-1.) If you include a description, it must not match the description of any other code value for this Line Class Code.
When you apply any changes, the EMS will display the code values sorted into numerical order, with one space between each code value and its description. The following is an example of valid code values:
201200 Jersey City, NJ
201201 Elsewhere in NJ
201205

201999 All other states
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.