IMPORTANT

Running the DM/PM rules is CPU- and memory-intensive because each rule is issued for every sub-rule linearly. If you do not use DM/PM rules sparingly, it becomes difficult to manage the number of DM/PM rules or sub-rules applied to a call. Ribbon recommends issuing no more than 80-100 sub-rules per call.

In this section:

DM/PM Rule

Command Syntax

% set profiles digitParameterHandling dmPmRule <dmPmRule_name> 
	criteria
	digitManipulation 
	ruleType

Command Parameters

The DM/PM Rule parameters are listed in the table below.

DM/PM Rule Parameters


Parameter

 Description

dmPmRule <name>

The name of this DM/PM (digit manipulation/parameter manipulation) rule (Length: 1-23 characters).

The default DM/PM rules are listed below. You can also create your own DM/PM rules.

  • PAI_AND_FROM_HEADER*
  • PAI_DISPLAY_NAMES_1_NTL*
  • PAI_SIP_DSPNAME_CLG_NAM
  • PAI_TEL_DSPNAME_GN_CPN
  • PRFX_TO_HEADER_CDPN_NTL*
  • PRFX_TO_HEADER_GDPN_NTL*
  • PRFX_TO_HEADER_OCN_NTL*
  • SIP_ADD_PLUS
  • SIP_REMOVE_CLG81
  • SIP_REMOVE_PLUS1
  • SIP_REMOVE_PLUS39
  • SIP_REMOVE_PLUS44
  • SIP_REMOVE_PLUS49
  • SIP_REMOVE_PLUS52
  • SIP_REMOVE_PLUS81
  • SIP_REMOVE_PLUS86
  • SIP_REMOVE_PLUS9


    * Uses seeded DM/PM criteria groups (see Tables 2 and 3 below for details).
criteriaDM/PM Criteria. See Criteria Options table below for a list of criteria.

digitManipulation

The type of digit manipulation to perform. See Digit Manipulation Parameters table below for details.

ruleType

See Rule Type Options table below for a listing of sub-parameters.


Criteria Options

CALLED_NOA_NATIONAL

CALLING_!SEND

CALLING_ALLOWED

CALLING_EXISTS

CALLING_NOA_NATIONAL

CALLING_NOT_EXISTS

CALLING_RESTRICTED

CLG_NAME_EXISTS

GN_CALLING_ALLOWED

GN_CALLING_EXISTS

GN_CALLING_NOA_NATIONAL

GN_CALLING_NOT_EXISTS

GN_CALLING_RESTRICTED

GN_DIALED_NOA_NATIONAL

OCN_NOA_NATIONAL

PAI_TEL_DISPLAY_NAME

SIP_MATCH_INTL_CD

SIP_MATCH_INTL_CG

SIP_MATCH_INTL_GNACG

SIP_MATCH_INTL_GNOCLD

SIP_MATCH_INTL_ORIGIN

SIP_MATCH_INTL_PORTED

SIP_MATCH_INTL_RDRCTG

SIP_MATCH_INTL_RDRCTN

SIP_MATCH_NOINTL_CD

SIP_MATCH_NOINTL_CG

SIP_MATCH_NOINTL_GNACG

SIP_MATCH_NOINTL_GNOCLD

SIP_MATCH_NOINTL_ORIGIN

SIP_MATCH_NOINTL_PORTED

SIP_MATCH_NOINTL_RDRCTG

SIP_MATCH_NOINTL_RDRCTN

SIP_MATCH_PLUS_CLG

SIP_MATCH_PLUS_GNACG

SIP_MATCH_PLUS_GNOCLD

SIP_MATCH_PLUS_ORIGIN

SIP_MATCH_PLUS_PORTED

SIP_MATCH_PLUS_RDRCTG

SIP_MATCH_PLUS_RDRCTN

SIP_MATCH_PLUS1_GNACG

SIP_MATCH_PLUS1_GNOCLD

SIP_MATCH_PLUS1_ORIGIN

SIP_MATCH_PLUS1_PORTED

SIP_MATCH_PLUS1_RDRCTG

SIP_MATCH_PLUS1_RDRCTN

SIP_MATCH_PLUS39_GNACG

SIP_MATCH_PLUS39_GNOCLD

SIP_MATCH_PLUS39_ORIGIN

SIP_MATCH_PLUS39_PORTED

SIP_MATCH_PLUS39_RDRCTG

SIP_MATCH_PLUS39_RDRCTN

SIP_MATCH_PLUS44_GNACG

SIP_MATCH_PLUS44_GNOCLD

SIP_MATCH_PLUS44_ORIGIN

SIP_MATCH_PLUS44_PORTED

SIP_MATCH_PLUS44_RDRCTG

SIP_MATCH_PLUS44_RDRCTN

SIP_MATCH_PLUS49_GNACG

SIP_MATCH_PLUS49_GNOCLD

SIP_MATCH_PLUS49_ORIGIN

SIP_MATCH_PLUS49_PORTED

SIP_MATCH_PLUS49_RDRCTG

SIP_MATCH_PLUS49_RDRCTN

SIP_MATCH_PLUS52_GNACG

SIP_MATCH_PLUS52_GNOCLD

SIP_MATCH_PLUS52_ORIGIN

SIP_MATCH_PLUS52_PORTED

SIP_MATCH_PLUS52_RDRCTG

SIP_MATCH_PLUS52_RDRCTN

SIP_MATCH_PLUS81_CLG

SIP_MATCH_PLUS81_GNACG

SIP_MATCH_PLUS81_GNOCLD

SIP_MATCH_PLUS81_ORIGIN

SIP_MATCH_PLUS81_PORTED

SIP_MATCH_PLUS81_RDRCTG

SIP_MATCH_PLUS81_RDRCTN

SIP_MATCH_PLUS86_GNACG

SIP_MATCH_PLUS86_GNOCLD

SIP_MATCH_PLUS86_ORIGIN

SIP_MATCH_PLUS86_PORTED

SIP_MATCH_PLUS86_RDRCTG

SIP_MATCH_PLUS86_RDRCTN

SIP_MATCH_PLUS91_GNACG

SIP_MATCH_PLUS91_GNOCLD

SIP_MATCH_PLUS91_ORIGIN

SIP_MATCH_PLUS91_PORTED

SIP_MATCH_PLUS91_RDRCTG

SIP_MATCH_PLUS91_RDRCTN

TO_HEADER_EXISTS


Rule Type Options

Parameter

 Description

digit digitManipulation

Digit manipulation rules.

  • digitStringManipulation
    • action <addDestinationCountry | addIngressTrunkGroupCountry | addOriginatingCountry | none>
    • numberOfDigits (range: 0-30 / default = 0)
    • replacement
      • digitString <digit string>
      • numberOfDigits (range: 0-30 / default = 0)
      • startDigitPosition (range: 0-29 / default = 0)
      • type <constant | variable>
      • value (max. 64 characters)
  • numberParameterManipulation
    • includeInEgress <discardInEgress | includeInEgress | none>
    • natureOfAddress <NOA>
    • numberLength (0-30, or 'noInput')
    • numberingPlanIndicator <NPA>
    • presentation <allowed | none | numberUnavailable | restricted | spare>
    • screening
      • networkProvidedNotScreened
      • none
      • userProvidedFailedNetworkScreening
      • userProvidedNotScreened
      • userProvidedPassedNetworkScreening
  • numberType <type>

parameter

Parameter rule type (default).

  • criteria (see subRule description in "DM/PM Rules Parameters" table above)
  • parameterManipulation
    • additionalCategory
      • informationMobile1 <any | [auto] | inflight | maritime | pager>
      • userName <[mobile1] | mobile2 | pstn1>
  • parameterType <type>

uri

URI rule type.

  • criteria (see subRule description in "DM/PM Rules Parameters" table above)
  • uriParameterManipulation
    • uriType
    • uriParameterManipulation
    • userInfoManipulation
    • hostPortManipulation
      • numberOfCharacters (range: 0-64 / default = 0)
      • portNumber (range: 0-65535, or 'noChange')
      • replacement
        • characterString <calledUri | callingUri | fromUri | none | paiSipUri | toUri>
        • startCharacterPosition – The character starting point (range: 0-63 / default = 0).
        • type
        • value 
      • startCharacterPosition – The character starting point (range: 0-63 / default = 0).

 



Parameter Types

additionalCategory

callingName

carrierCode

carrierSelectionParameter

causeOfNoId

chargeRateInfoIndicator

cliBlockingIndicator

cpc

dpcIndicator

forwardCallIndicator

jurisdiction

olip

originatingCarrier

originatingChargeArea

paiSipDisplayName

paiTelDisplayName

sipFromDisplayName

transitNetworkSelection

zzCode


 


Digit Manipulation

Command Syntax

% set profiles digitParameterHandling dmPmRule <dmPmRule_name> digitManipulation 
	digitStringManipulation 
		action <addDestinationCountry | addIngressTrunkGroupCountry | addOriginatingCountry | none> 
		numberOfDigits <0-30> 
		replacement 
			digitString <252 | 253 | 254 | billingNumber | calledDirectoryNumber | calledInNumber | calledNumber | 
				calledUri | callingName | callingNumber | callingUri | causeOfNoId | contractorNumberdialedNumber | 
				fromUri | gnAdditionalCalled | gnAdditionalCalling | gnAdditionalConnected | gnAdditionalOriginalCalled | 
				gnAdditionalRedirecting | gnAdditionalRedirection | gnCalledCesId | gnCollectCallNumber | gnDestination | 
				gnDialedDigits | gnLocalAni | gnNetworkProvidedNumber | gnPortedDialed | gnRedirectingTerminating | 
				gnThirdPartyNumber | gnUserCallingNotScreened | gnUserCallingScreened | location | none | 
				originalCalledNumber | outpulseNumber | paiSipDisplayName | paiSipUri | paiTelDisplayName | 
				presentationNumber | pretranslated | redirecting | redirection | sipFromDisplayName | toUri | twoStageCollected> 
			numberOfDigits <0-30> 
			startDigitPosition <0-29> 
			type <constant | variable> 
			value <0-64 chars> 
		startDigitPosition <0-29> 
	numberParameterManipulation 
		includeInEgress <discardInEgress | includeInEgress | none> 
		natureOfAddress <noa_name> 
		numberLength <0-30, noInput> 
		numberingPlanIndicator 
			<data | ignore | isdn | none | offsetUnused | private | spare0Unknown | spare1 | spare2 | spare3 | spare4 | 
			spare5 | spare6 | spare7 | telephony | telex> 
		presentation <allowed | none | numberUnavailable | restricted | spare> 
		screening <networkProvidedNotScreened | 
			none | userProvidedFailedNetworkScreening | userProvidedNotScreened | userProvidedPassedNetworkScreening> 
	numberType <billingNumber | calledDirectoryNumber | 
			calledNumber | callingNumber | contractorNumber | gnAdditionalCalled | gnAdditionalCalling | gnAdditionalConnected | 
			gnAdditionalOriginalCalled | gnAdditionalRedirecting | gnAdditionalRedirection | gnCalledCesId | gnDestination | 
			gnDialedDigits | gnNQI-252 |  | gnNQI-253 | gnNQI-254 | gnNetworkProvidedNumber | gnPortedDialed | gnRedirectingTerminating | 
			gnUserCallingNotScreened | gnUserCallingScreened | location | originalCalledNumber | outpulseNumber | pretranslated | redirecting | 
			redirection | twoStageCollected>

Command Parameters


Digit Manipulation Parameters



ParameterLength/RangeDescription
digitStringManipulationN/A
  • action – The action to take when the matching criteria is met (used for international gateway support involving setting NOA to ‘International’ and adding country code)
    • addDestinationCountry
    • addIngressTrunkGroupCountry
    • addOriginatingCountry
    • none (default)
  • numberOfDigits – Number of digits (range: 0-30 / default = 0)
  • replacement – Use when this is a replacement DM rule.
  • startDigitPosition – The start digit position (range: 0-29 / default = 0).
 
numberParameterManipulation N/A

Options for manipulating number parameter.

  • includeInEgress – Specify whether to include in egress, discard in egress or take no action:
    • discardInEgress
    • includeInEgress
    • none (default)
  • natureOfAddress – Nature Of Address options. See NOA Options table below for a list of NOA options.
  • numberLength – Enter either "noInput" or a number.
    • noInput (default)
    • <number> – The number length. (range: 0-31)


 

  • numberingPlanIndicator – Numbering Plan Indicator types:

data | ignore | isdn | none |
offsetUnused | private | spare0Unknown |
spare1 | spare2 | spare3 | spare4 |
spare5 | spare6 | spare7 | telephony |
telex

  • presentation – Presentation options include:
    • allowed
    • none (default)
    • numberUnavailable
    • restricted
    • spare
  • screening – Network screening indicator of calling party number. Options include:
    • networkProvidedNotScreened – Network-provided screening, not screened.
    • none (default)
    • userProvidedFailedNetworkScreening – User-provided screening, failed network screening.
    • userProvidedNotScreened – User-provided screening, not screened.
    • userProvidedPassedNetworkScreening – User-provided screening, passed network screening.
  • numberType – Specify the number type:
    • billingNumber (default)
    • calledDirectoryNumber
    • calledNumber
    • callingNumber
    • contractorNumber
    • gnAdditionalCalled
    • gnAdditionalCalling
    • gnAdditionalConnected
    • gnAdditionalOriginalCalled
    • gnAdditionalRedirecting
    • gnAdditionalRedirection
    • gnCalledCesId
    • gnDestination
    • gnDialedDigits
    • gnNQI-252
    • gnNQI-253 
    • gnNQI-254
    • gnNetworkProvidedNumber
    • gnPortedDialed
    • gnRedirectingTerminating
    • gnUserCallingNotScreened
    • gnUserCallingScreened
    • location
    • originalCalledNumber
    • outpulseNumber
    • pretranslated
    • redirecting
    • redirection
    • twoStageCollected


NOA Options


NOA Options

950 (default)

aniNotAvailableOrNotProvided

aniOfCalledPartyNationalNumber

aniOfCalledPartyNoNumberPresent

aniOfCalledPartySubscriberNumber

aniOfCallingPartyNationalNumber

aniOfCallingPartySubscriberNumber

any

apnNumberingPlan

ignore

international

internationalNotRestricted

internationalOperator

internationalRestricted

national

nationalNotRestricted

nationalOperator

nationalRestricted

networkSpecific

noNumberCutThrough

noNumberOperatorRequested

none

partialCallingLineId

passThrough

spare00...spare26


 



The following DM/PM rules include assigned criteria groups.

Criteria groups are not visible to the operator and cannot be modified.

DM/PM Rules with Assigned Criteria Groups


DM/PM Rule IDDM/PM Criteria Group ID
PAI_AND_FROM_HEADER
  • CPN_!SEND_RES_!EXST
  • GN_CPN_!EXST_CPN_ALLOW
  • GN_CPN_!EXST_CPN_EXST
  • GN_CPN_!EXST_CPN_RESTRC
  • GN_CPN_ALLOW_CPN_EXST
  • GN_CPN_EXSTS_CPN_!EXSTS
  • GN_CPN_EXSTS_CPN_EXSTS
  • GN_CPN_RES_CPN_EXISTS
PRFX_TO_HEADER_CDPN_NTL

TOHD_EXST_CALLED_NTL

PRFX_TO_HEADER_GDPN_NTL

TOHD_EXST_GN_DIALED_NTL

PRFX_TO_HEADER_OCN_NTL    

TOHD_EXST_OCN_NTL

PAI_DISPLAY_NAMES_1_NTL
  • GN_CPN!EXST_CPN_NTL_TEL
  • GN_CPN_!EXST_CPN_ALLOW
  • GN_CPN_!EXST_CPN_EXST
  • GN_CPN_!EXST_CPN_RESTRC
  • GN_CPN_ALLOW_CPN_!EXST
  • GN_CPN_ALLOW_CPN_EXST
  • GN_CPN_EXSTS_CPN_EXSTS
  • GN_CPN_NTL_TEL
  • GN_CPN_RES_CPN_!EXST
  • GN_CPN_RES_CPN_EXISTS

The following table shows the criteria sub-rule sequence for each Criteria Group executed against the DM/PM rules. The logical operator defines the logic used when processing the criteria.

How DM/PM Criteria Groups are Processed


DM/PM Criteria Group ID

Criteria ID Sequence

Logical
Operator

CPN_!SEND_RES_!EXST

  1. CALLING_!SEND
  2. CALLING_RESTRICTED
  3. CALLING_NOT_EXISTS

OR

GN_CPN!EXST_CPN_NTL_TEL

  1. GN_CALLING_NOT_EXISTS
  2. CALLING_NOA_NATIONAL
  3. PAI_TEL_DISPLAY_NAME

AND

GN_CPN_!EXST_CPN_ALLOW

  1. GN_CALLING_NOT_EXISTS
  2. CALLING_ALLOWED

AND

GN_CPN_!EXST_CPN_EXST

  1. GN_CALLING_NOT_EXISTS
  2. CALLING_EXISTS

AND

GN_CPN_!EXST_CPN_RESTRC

  1. GN_CALLING_NOT_EXISTS
  2. CALLING_RESTRICTED

AND

GN_CPN_ALLOW_CPN_!EXST

  1. GN_CALLING_ALLOWED
  2. CALLING_NOT_EXISTS

AND

GN_CPN_ALLOW_CPN_EXST

  1. GN_CALLING_ALLOWED
  2. CALLING_EXISTS

AND

GN_CPN_EXSTS_CPN_!EXSTS

  1. GN_CALLING_EXISTS
  2. CALLING_NOT_EXISTS

AND

GN_CPN_EXSTS_CPN_EXSTS

  1. GN_CALLING_EXISTS
  2. CALLING_EXISTS

AND

GN_CPN_NTL_TEL

  1. GN_CALLING_NOA_NATIONAL
  2. PAI_TEL_DISPLAY_NAME

AND

GN_CPN_RES_CPN_!EXST

  1. GN_CALLING_RESTRICTED
  2. CALLING_NOT_EXISTS

AND

GN_CPN_RES_CPN_EXISTS

  1. GN_CALLING_RESTRICTED
  2. CALLING_EXISTS

AND

TOHD_EXST_CALLED_NTL

  1. TO_HEADER_EXISTS
  2. CALLED_NOA_NATIONAL

AND

TOHD_EXST_GN_DIALED_NTL

  1. TO_HEADER_EXISTS
  2. GN_DIALED_NOA_NATIONAL

AND

TOHD_EXST_OCN_NTL

  1. TO_HEADER_EXISTS
  2. OCN_NOA_NATIONAL

AND


  • No labels