cc/td/doc/product/access/sc/rel7
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Adding System Components with MML

Adding System Components with MML

This chapter describes how to add system components, describes how to verify the addition of the components, and gives tips that can help you solve problems. It provides information about:

Before starting an actual configuration, please refer to "Planning for Provisioning" for instructions and worksheets for configuring your system.

"Planning for Provisioning" describes the system components that need to be configured on the MGC. Each component has a specified type, name, and description, and may have additional configuration parameters.

Adding SS7 Signaling Route Components

Your first task is to configure SS7 signaling routes that link the MGC to the SS7 network nodes (signaling points). You typically do this by:

To add a system component, do the following:


Step 1   Start MML as described in the "To repeat the last MML command you entered, press the Up Arrow key. To scroll through all the previous MML commands, continue to press the up arrow after pressing the Shift Starting an MML Session" section.

Step 2   Start a provisioning session as described in the"Starting a Provisioning Session" section. The source configuration that you chose during startup determines the configuration to which you can add components.

Step 3   Enter the following command:

prov-add:componentType:name="name", desc="description", paramName=value

Replace the componentType parameter with the type of component you want to create. To define more than one parameter, enter the additional paramName=value descriptions on the command line.

Provide a description. The description can be as many as 128 alphanumeric characters in length.

Replace the name parameter with the name you want to give to the component. The name can be as many as 10 characters (or 20 characters for Release 7.4) long and can only be number and letter symbols, and the dash (-) symbol.

SS7 System Component Hierarchy

When adding SS7 system components, there is an order in which components should be created. Certain components must be created before other components. As an example before you add a point code, you must define the external nodes.

Adding a Point Code

A point code is an SS7 network address that identifies an SS7 network node, such as a switch, SCP, STP, or SSP. Its MML name is PTCODE. This can be the MGC's originating point code (OPC), or the destination point code (DPC) of a remote node with which the MGC communicates.

For information on point code parameters, refer to Table 2-1.

Procedure

Step
Command
Purpose

1

mml>prov-add:ptcode:name="OPC",netaddr="214.1
10.80", netind=2,desc="Own Pointcode"

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: ptcode

NAME: OPC

NETADDR:214.110.80

NETIND: 2

DESCRIPTION: Own Pointcode

2

mml>prov-add:ptcode:name="dpc1",netaddr="214.
110.90", netind=2,desc="Dest Switch 1"

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: ptcode

NAME: dpc1

NETADDR: 214.110.90

NETIND: 2

DESCRIPTION: Dest Switch 1

Verify

Use the PROV-RTRV command to verify.


Tips Point codes provide the addressing scheme for the SS7 network. ITU point codes are 14 bits long, and ANSI point codes are 24 bits long.

Adding an Adjacent Point Code

An adjacent point code (APC) defines an SS7 STP through the MGC that it connects to. The APC is the SS7 network address of the STP. Its MML name is APC.

For information on point code parameters, refer to Table 2-1.

Procedure

Command
Purpose
mml>prov-add:apc:name="STP-A",netaddr="214.11
1.0",desc="STP A pointcode",netind=2

 

Use the PROV-ADD command to add the component and required parameters:

COMPONENT: apc

NAME: STP-A

NETADDR: 214.111.0

NETIND: 2

DESCRIPTION: STP A pointcode

Verify

Use the PROV-RTRV command to verify.

Adding a Linkset

A linkset is the group of all signaling links between two point codes. Its MML name is LNKSET.

For information on linkset parameters, refer to Table 2-4.

Procedure

Step
Command
Purpose

1

mml>prov-add:lnkset:name="linkset1",desc="lin
kset 1 to STP-A",apc="STP-A",type="IP", 
proto="SS7-ANSI"

Uses the PROV-ADD command to add the component and required parameters:

Component: lnkset

APC: STP-A

PROTO: SS7-ANSI

TYPE: IP

Name: linkset 1

Description: 1 linkset 1 to STP-A

2

mml>prov-add:lnkset:name="linkset2",desc="lin
kset 2 to STP-B",apc="STP-B",type="IP", 
proto="SS7-ANSI"

Uses the PROV-ADD command to add the component and required parameters:

Component: lnkset

APC: STP-B

PROTO: SS7-ANSI

TYPE: IP

Name: linkset 2

Description: linkset 2 to STP-B

Verify

Use the PROV-RTRV command to verify.


Tips Setting up linksets is a two-step process that consists of first adding the linkset and then adding links to the linkset.

Adding an SS7 Subsystem

The SS7 subsystem is a logical entity that mates two STPs. When two STPs are defined as mates within the MGC, the controller can use either STP for communications to a destination device. Its MML name is SS7SUBSYS.

For information on SS7 subsystem parameters, refer to Table 2-7.

Procedure

Step
Command
Purpose

1

mml>prov-add:ss7subsys:name="mate1",svc="STP-
A",matedapc="STP-B",proto="SS7-ANSI",pri=1,de
sc="mate STP-A to STP-B"

 

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: ss7subsys

NAME: mate1

SVC: STP-A

PROTO: SS7-ANSI

MATEDAPC: STP-B

PRI: 1

SSN: 0 (default)

TRANSPROTO: SCCP (default)

DESC: mate STP-A to STP-B

2

mml>prov-add:ss7subsys:name="mate2",apc="STP-
B",matedapc="STP-A",proto="SS7-ANSI",pri=2,de
sc="mate STP-B to STP-A"

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: ss7subsys

NAME: mate2

SVC: STP-B

PROTO: SS7-ANSI

MATEDAPC: STP-A

PRI: 2

SSN: 0 (default)

TRANSPROTO: SCCP (default)

DESC: mate STP-B to STP-A

Verify

Use the PROV-RTRV command to verify.


Tips Protocol families must be the same for mated subsystems. If one pair of STPs handles both ITU and ANSI variants, you must configure two pairs of STPs: one for ITU and the other for ANSI.

Adding Subsystem Numbers

You can also use the SS7 subsystem to define an SCP using TCAP. For TCAP applications, TRANSPROTO is set to TCPIP and the subsystem number is set to a a value greater than 0 to support AIN. You also must set STPSCPIND to route to the appropriate SCP. For information on SS7 subsystem parameters including STPSCPIND, refer to Table 2-7.

Procedure

Step
Command
Purpose

1

mml>prov-add:ss7subsys:name="LNP-1",svc="stpa
",transproto="SCCP",proto="SS7-ANSI",pri=1,ss
n=231,desc="LNP231 for STP A"

 
 

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: ss7subsys

NAME: LNP-1

SVC: stpa

transproto: SCCP

proto: SS7-ANSI

pri: 1

SSN: 231

DESC: LNP231 for STP A

2

mml>prov-add:ss7subsys:name="AIN-1",svc="stpb
",transproto="SCCP",proto="SS7-ANSI",pri=1,ss
n=241,desc="AIN8xx for STP B"

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: ss7subsys

NAME: AIN-1

SVC: stpb

transproto: SCCP

proto: SS7-ANSI

pri: 1

SSN: 241

DESC: AIN8xx for STP B

Verify

Use the PROV-RTRV command to verify.

Adding an SS7 Route

An SS7 route is a path from the MGC to another MGC or SSP switch. Its MML name is SS7ROUTE.

For information on SS7 route parameters, refer to Table 2-9.

Procedure

Step
Command
Purpose

1

mml>prov-add:ss7route:name="rte1DPC1",opc="OP
C", dpc="DestSW1PC", lnkset="linkset1", 
pri=1,desc= "route 1 to DestSW1 thru STP-A"

Use the PROV-ADD command to add the component and required parameters:

Component: ss7route

Name: rte1DPC1

OPC: OPC

DPC: DestSW1PC

LNKSET: linkset1

PRI:1

Description: route 1 to DestSW1 thru STP-A

2

mml>prov-add:ss7route:name="rte2DPC1",opc="OP
C",  dpc="DestSW1PC", lnkset="linkset2", 
pri=1,desc= "route 2 to DestSW1 thru STP-B"

Uses the PROV-ADD command to add the component and required parameters:

Component: ss7route

Name: rte2DPC1

OPC: OPC

DPC: DestSW1PC

LNKSET: linkset2

PRI:1

Description: route 2 to DestSW1 thru STP-B

Verify

Use the PROV-RTRV command to verify.


Tips You must create a route for each DPC-OPC combination.

Adding an SS7 Signaling Service

An SS7 signaling service specifies the protocol variant and the path that the MGC uses to communicate with a remote switch (SSP) sending bearer traffic to the MGWs. Its MML name is SS7PATH.

For information on signaling service parameters, refer to Table 2-11.

Procedure

Command
Purpose
mml>prov-add:ss7path:name="ss7svc1",mdo="ANSI
SS7_STANDARD",dpc="dpc1",desc="SS7 svc to 
dpc1"

Use the PROV-ADD command to add the component and required parameters:

COMPONENT: ss7path

NAME: ss7svc1

SIDE: default (network)

MDO: ANSI SS7_STANDARD

DPC: dpc1

CUSTGRPID: default (0000)

CUSTGRPTBL: default (0101)

ASPPART: default (N)

DESCRIPTION: SS7 service to dpc1

Verify

Use the PROV-RTRV command to verify.


Tips Do not change the default values for CUSTGRPID and CUSTGRTBL; they are used for DPNSS feature transparency.

CUSTGRPID also associates variants and dial plans. Use rtrv-variants to see valid variants.

Adding a TCAP over IP Signaling Service

This is the TCAP over IP signaling service path to an STP/SCP. Its MML name is TCAPIPPATH.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Command
Purpose
mml>prov-add:TCAPIPPATH:name="tcapipsrv1",ext
node="scp2",desc="TCAPIP Service to SCP 2"

Use the PROV-ADD command to add the component and required parameters:

Component: tcapippath

Name: tcapipsrv1

EXTNODE: scp2

Description: TCAPIP Service to SCP 2

Verify

Use the PROV-RTRV command to verify.


Tips When defining a new ITU service for SCCP/TCAP, you must first enter a "dummy" DPC. This DPC is not used for routing calls, but is used internally by the software.

To define a dummy DPC, refer to the ""Adding a Point Code" section and add a DPC with the following parameters:

You will also select this dummy DPC when provisioning the SS7 route for the ITU service. Refer to the "Adding an SS7 Route" section.

Adding a FAS Signaling Service

This is the FAS (facility associated signaling) service or signaling path to a particular destination using either ISDN-PRI or DPNSS. Its MML name is FASPATH.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Step
Command
Purpose

1

mml>PROV-ADD:FASPATH:NAME="FASPATH1",SIDE="ne
twork",MDO="ETSI_300_102",ASPPART="N",DESC="F
ASPATH 	1",ABFLAG="a",CRLEN=1

Uses the PROV-ADD command to add the component and required parameters:

Component: faspath

Name: FASPATH1

Side: network

MDO: ETSI_300_102

CUSTGRPID:

CUSTGRPTBL:

ABFLAG: a

CRLEN: 1

ASPPART: N

Description: Destination Switch 1 - Jane

Verify

Use the PROV-RTRV command to verify.

Adding Signaling Link Components

After configuring the SS7 signaling routes, you need to configure the signaling link components. These components link the MGC, to the STPs, and to the MGWs. You will typically do this by:

Adding a Card

This is a network card or adapter that is operating in the MGC. Its MML name is CARD.

For information on card parameters, refer to Table 2-15.

Procedure

Step
Command
Purpose

1

mml>prov-add:card:name="Ethernet1",type="EN",
slot=0, desc="Ethernet Card 1".

Uses the PROV-ADD command to add the component and required parameters:

  • COMPONENT: card

  • NAME: Ethernet 1

  • TYPE: EN

  • SLOT: 0

  • DESCRIPTION: Ethernet Card 1

2

mml>prov-add:card:name="Ethernet2",type="EN",
slot=1, desc="Ethernet Card 2"

Uses the PROV-ADD command to add the component and required parameters:

DESCRIPTION: Ethernet Card 2

Verify

Use the PROV-RTRV command to verify.


Tips You must configure the adapter card before you configure its corresponding interface.

Adding an Ethernet Interface

The Ethernet interface provides the physical line interface between a MGC Ethernet network card/adapter and the physical Ethernet network. You configure parameters that control communications between the network card/adapter and the Ethernet. Its MML name is ENETIF.

For information on Ethernet interface parameters, refer to the Table 2-17.

Procedure

Step
Command
Purpose

1

mml>prov-add:enetif:name="EtherIF1", 
desc="Ethernet IF 1",card="Ethernet1"

Uses the PROV-ADD command to add the component and required parameters:

  • COMPONENT: enetif

  • NAME: EtherIF1

  • DESCRIPTION: Ethernet IF 1

  • CARD: Ethernet 1

2

mml>prov-add:enetif:name="EtherIF2", 
desc="Ethernet IF 2",card="Ethernet2"

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: enetif

NAME: EtherIF2

DESCRIPTION: Ethernet IF 2

CARD: Ethernet 2

Verify

Use the PROV-RTRV command to verify.


Tips You must configure the adapter/card before configuring the interface.

Adding a C7 IP Link

A C7 IP link component identifies a link between a Cisco SLT IP address and port and the SS7 network (SSP or STP). Its MML name is C7IPLNK.

For information on C7 IP link parameters, refer to Table 2-21.

Procedure

Command
Purpose
mml>prov-add:c7iplnk:name="lkset1SLC0",if="Et
herIF1", ipaddr="IP_Addr1",port=7000, 
peeraddr="10.15.4.23", 
peerport=32767,pri=1,slc=0, 
lnkset="linkset1",desc= "linkset1 SLC 0 thru 
SLT-23 ser0/0",timeslot=0

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: c7Iplink

NAME: lkset1SLC0

IF: EtherIF1

PORT: 7000

PRI: 1

PEERADDR: 10.15.4.23

PEERPORT: 32767

IPADDR: IP_Addr1

SLC: 0

LNKSET: linkset1

TIMESLOT: 0

DESC: linkset1 SLC 0 thru SLT-23 ser0/0

Verify

Use the PROV-RTRV command to verify.


Tips Use this component only when the MGC uses Cisco SLTs to communicate SS7 messages over IP.

The peerport must be set to 32767. The peerport value is contained in the XECfgParm field stPort. For more information, refer to the Cisco Media Gateway Controller Software Release 7 Installation and Configuration Guide.

Adding a TDM Interface

The TDM interface provides the physical line interface between a MGC TDM network card/adapter and the physical TDM network. Its MML name is TDMIF.

For information on TDM interface parameters, refer to Table 2-32.

Procedure

Command
Purpose
mml>prov-add:tdmif:name="card1lif1",desc="V35 
LIF 1", card="card1", lifnum=2, 
sigtype="V.35", datarate=64

Uses the PROV-ADD command to add the component and required parameters:

Component: tdmif

Name: card1lif1

CARD: card1

LIFNUM: 2

RESIST: default (0)

DATARATE: default (64)

CLOCK: default (EXT)

DTEDCE: default (DTE)

CODING: default (NA)

FORMAT: default (NA)

SIGTYPE: V.35

HDLC:(DEFAULT)

DESC: V35LIF1

Verify

Use the PROV-RTRV command to verify.


Tips Table 6-1 shows typical parameters based on card type.


Table 6-1: Line Interfaces
Card Type LIFNUM RESIST Data Rate/
Clock
DTEDCE Line Coding Format/
Framing
Signal Type I/HDLC

ITK (T1)

1

75

 

NA

B8ZS

ESF

T1

IHDLC

ITK (E1)

1

120

 

NA

HDB3

CRC4

CEPT

IHDLC

V.35

2

0

64/EXT

DTE

NA

NA

V.35

DEFAULT

Adding a TDM Link

A TDM link is a communications link between a TDM interface card on the MGC and TDM hardware element. For each link, you need to specify the card interface to which the link connects. Its MML name is TDMLNK.

For information on TDM link parameters, refer to Table 2-23.

Procedure

Command
Purpose
mml>prov-add:tdmlnk:name="tdmlink1",if="card1
lif1",pri=2,slc=2,svc="ls-1",desc="signal 
link 1"

Uses the PROV-ADD command to add the component and required parameters:

Component: tdmlnk

Name: tdmlink1

IF: card1lif1

PRI: 2

SLC: 2

SVC: ls-1

Description: signal link 1

Verify

Use the PROV-RTRV command to verify.

Adding MGW Control Links

Now you need to configure MGW control links. The MGC uses these links to control the bearer traffic that passes between each MGW. You typically do this by:

Adding an External Node

An external node is a MGW with which the MGC communicates. Its MML name is EXTNODE.

For information on external node parameters, refer to Table 2-25.

Procedure

Command
Purpose
mml>prov-add:extnode:name="DestSW1",desc="Des
tination Switch 1 - Jane"

Use the PROV-ADD command to add the component and required parameters:

Component: extnode

Name: DestSW1

Description: Destination Switch 1 - Jane

Verify

Use the PROV-RTRV command to verify.


Tips You must create an external node for each media gateway.

Adding a Card

This is a network card or adapter that is operating in the MGC. Its MML name is CARD.

Adding an Ethernet Interface

The Ethernet interface provides the physical line interface between an MGC Ethernet network card/adapter and the physical Ethernet network. You configure parameters that control communications between the network card/adapter and the Ethernet. Its MML name is ENETIF.

Each SS7 link in the node must be associated with an Ethernet interface component, which must be associated with a network card. The Ethernet interface represents a physical network connection on the network card.


Note   In the MGC, the same cards and interfaces can be used for communication with Cisco SLTs and media gateways. When configured this way, separate links are assigned for Cisco SLT and media gateway communications.

Adding an EISUP Signaling Service

This is the EISUP signaling service or signaling path to an externally located MGC (destination). Its MML name is EISUPPATH.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Command
Purpose
mml>prov-add:eisuppath:name="eisupsrv1",extno
de="extseq1",desc="EISUP Service to Ext Seq 
Node1"

Use the PROV-ADD command to add the component and required parameters:

Component: eisuppath

Name:eisupsrv1

EXTNODE: extseq1

Description: EISUP Service to Ext Seq Node1

Verify

Use the PROV-RTRV command to verify.


Note   To ensure correct failover operation in a configuration with two local MGCs (one active and one standby) and a remote MGC, a minimum of two EISUP links are required from the remote VSC to each MGC redundant pair.

Adding an SGCP Signaling Service

This is the SGCP protocol path between the MGC and the MGW. Its MML name is SGCPPATH.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Command
Purpose
mml>prov-add:SGCPPATH:name="sgcppsrv1",extnod
e="mgw2",desc="SGCP Service to mgw 2"

 

Uses the PROV-ADD command to add the component and required parameters:

Component: sgcppath

Name: sgcppsrv1

EXTNODE: mgw2

Description: SGCP Service to mgw 2

Verify

Use the PROV-RTRV command to verify.



For SGCP 1.0 only.

Adding an IPFAS Transport Service

This is the FAS over IP transport service or signaling path from a Gateway to an MGC. Its MML name is IPFASPath.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Command
Purpose
mml>prov-add:ipfaspath:name="ipfassvc1",extno
de="nas1",desc="PRI Backhaul Service to 
NAS1", mdo="ETSI_300_172", custgrpid="1111", 
custgrptbl="0101", asppart="Y", abflag="a", 
crlen=1

Uses the PROV-ADD command to add the component and required parameters:

Component: ipfaspath

Name: ipfassvc1

EXTNODE: nas1

SIDE: network (default)

MDO: ETSI_300_172

CUSTGRPID: 1111

CUSTGRPTBL: 0101 (default)

ABFLAG: a

CRLEN: 1

ASSPART: Y

Description: PRI Backhaul Service to NAS1

Verify

Use the PROV-RTRV command to verify.

Adding an MGCP Signaling Service

This is the MGCP signaling service or signaling path to a trunking gateway. Its MML name is MGCPPATH.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Command
Purpose
mml>prov-add:mgcppath:name="mgcpsrv1",extnode
="cu1",desc="MGCP Service to CU 1"

Uses the PROV-ADD command to add the component and required parameters:

Component: mgcppath

Name: mgcpsrv1

EXTNODE: cu1

Description: MGCP Service to CU 1

Verify

Use the PROV-RTRV command to verify.

Adding a NAS Signaling Service

This is the Q.931 protocol path between the MGC and the MGW. Its MML name is NASPATH.

For information on signaling service parameters, refer to Table 2-27.

Procedure

Command
Purpose
mml>prov-add:naspath:name="nassrv1",extnod="n
as1",desc="Service to 
NAS1",mdo="BELL_1268_C3"

Uses the PROV-ADD command to add the component and required parameters:

Component: naspath

Name: nassrv1

EXTNODE: nas1

MDO: BELL_1268_C3

Description: Service to NAS1

Verify

Use the PROV-RTRV command to verify.


Tips For the NASPATH component, there is only one protocol: Bell_1268_C3.

Adding an IP Link

This is an IP connection between an MGC's Ethernet interface and an MGW. Its MML name is IPLNK.

For information on IP link parameters, refer to Table 2-35.

Procedure

Command
Purpose
mml>prov-add:iplnk:name=
"Iplink1",if="en-1lif1",ipaddr="IP_Addr1",por
t=3001,

peeraddr="192.12.214.10",peerport=3001,svc="i
pfassvc1",sigslot=1,sigport=1,desc="IP link 
for IPFAS service to NAS1"

 

Uses the PROV-ADD command to add the component and required parameters:

Component: iplnk

Name: Iplink1

IF: en-1lif1

PORT: 3001

PRI: 1 (default)

PEERADDR: 192.12.214.10

PEERPORT: 3001

IPADDR: IP_Addr1

SIGSLOT: 1

SIGPORT: 1

SVC: pfassvc1

Description: IP link for IPFAS service to NAS1

Verify

Use the PROV-RTRV command to verify.


Tips When configuring two IP links to the same NAS, you need to configure two different Ethernet IP addresses on both the MGC and the NAS.

Adding Multiple FAS Signaling Services and IP Links (Release 7.4)

To configure the D channels on a Cisco MGX8260, you have to provision one IPFAS path and two IP links for each D channel. The MML component for provisioning multiple IPFAS paths and associated IP links on the Cisco MGX8260 is MLTIPFAS.

For information on signaling service parameters, refer to Table 2-27.

The procedure adds two IPFAS paths using FAS type signaling and four IP links (two per IPFAS path).

Procedure

Step
Command
Purpose

1

mml>PROV-ADD:MLTIPFAS:NAME="BSC1",PATHSIZE=2,
MDO="BELL_1268",EXTNODE="MGX-BH",PORT=7007,PE
ERPORT=7007,SIGPORT=1,SIGSLOT=10,IF1="ENIF1",
IF2="ENIF2",IPADDR1="IP_Addr1",IPADDR2="IP_Ad
dr2",PEERADDR1="10.15.26.20",PEERADDR2="10.15
.27.20",SIDE="network",CUSTGRPID="V123"

Uses the PROV-ADD command to add the component and required parameters:

Component: mltipfas

Name: bsc1

pathsize: 2

mdo: bell_1268

extnode: mgx-bh

port: 7007

peerport: 7007

sigport: 1

sigslot: 10

if1:enif1

if2: enif2

ipaddr1: ip_addr1

ipaddr2: ip_addr2

perraddr1: 10.15.26.20

peeradr2: 10.15.27.20

side: network

custgrpid: v123

Side: network

Verify

Use the PROV-RTRV command to verify.



MLTIPFAS supports add and delete operations only.

Removing Multiple FAS Signaling Services and IP Links (Release 7.4)

You must specify only the NAME and PATHSIZE parameters to remove several IPFAS paths and associated IP links. The following example deletes two IPFAS paths and associated IP links.

Procedure

Command
Purpose
mml>prov-add:mltipfas:name="bh531",pathsize="
2" 

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: mltipfas

NAME:bh531

PATHSIZE: 2

Verify

Use the PROV-RTRV command to verify.

Adding Trunks, Trunk Groups, and Routing

You now need to configure trunks, trunk groups, and routing. The MGC uses this information for determining the call traffic on each trunk between the switches and the MGWs. You typically do this using the following.

Adding Files

The FILES component consists of customer-specific flat files that you can use to provision trunk groups, routing, trunks, and dial plans. The MML name is FILES.

For information on routing parameters, refer to the "Provisioning Trunk Groups and Trunks" section.

Procedure

Command
Purpose
mml>prov-add:files:name="BCFile",file="trunkC
ust.dat",action="import"

Uses the PROV-ADD command to add the component and required parameters:

Component: files

Name: BCFile (a bearer channel file type)

File: trunkCust.dat

Action: import


Note   When importing screening files, for example AWhite list or BBlack list, the import file name must be one of the following: <custGrpId>.awhite, <custGrpId>.bwhite, <custGrpId>.ablack, or <custGrpId>.bblack.

Verify

Use the PROV-RTRV command to verify.

Adding a Nailed Trunk (Bearer Channel)

This is the nailed trunk component for provisioning individual nailed bearer channels in a Dial Access configuration. Its MML name is NAILEDRNK.

For information on routing parameters, refer to the "Provisioning Trunk Groups and Trunks" section.

Procedure

Command
Purpose
mml>prov-add:nailedtrnk:name="101",srcsvc="ss
7svc1", srctimeslot=101,dstsvc="nassrv1", 
dstspan=3, dsttimeslot=1

Uses the PROV-ADD command to add the component and required parameters:

Component: nailedtrnk

Name: 101 (ID)

SRCSVC: ss7svc1

DSTSVC: nassrv1

SRCSPAN: default (0)

DSTSPAN: 3

SRCTIMESLOT: 101

DSTTIMESLOT: 1

Verify

Use the PROV-RTRV command to verify.


Tips Use the FILES component with flat files to provision trunks; use the NAILEDTRNK component with an individual trunk.

Adding a Trunk Group (Release 7.4)

This is the trunk group component for provisioning individual trunk groups. Its MML name is TRNKGRP.

For information on TRNKGRP parameters, refer to Table 2-38.

Procedure

Command
Purpose
mml>prov-add:trnkgrp:name="1000",clli="tttt-s
s-bb-xxx", svc="ss7svc1", type="tdm_gen", 
selseq="lidl", qable="n"

   Virtual Switch Controller 1999-11-10 
15:32:25
M  COMPLD
   "TRNKGRP"

Uses the PROV-ADD command to add the component and required parameters:

Component: trnkgrp

Name: 1000

CLLI: tttt

SERVICE: ss7svc1

TYPE: tdm_gen

SELSEQ:l1d1 (select sequence)

QABLE: n (timeslot)

Verify

Use the PROV-RTRV command to verify.

Routing

This section is used to configure the routing file. Three components are necessary to configure routing. Their MML names are RTLIST, RTTRNK, and RTTRNKGRPT.

For information on routing parameters, refer to the Table 2-41.

Procedure

Step
Command
Purpose

1

mml>prov-add:rtlist:listindex=1,name="rtlist5
01910",rtname="rt501910",carrierid=333

Uses the PROV-ADD command to add the component and required parameters:

Component: rtlist

LISTINDEX: 1

NAME: rtlist501910

RTNAME: rt501910

CARRIERID: 333

2

mml>prov-add:rttrnk:name="rt513913",trnkgrpnu
m=513913

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: rttrnk

NAME: rt513913

TRNKGRPNUM:513913

NEXTTIME: need info on this

3

mml>prov-add:rttrnkgrp:name="501910",type=7,r
eattempts=1,queuing=0,cutthrough=2

Uses the PROV-ADD command to add the component and required parameters:

COMPONENT: rttrnkgrp

NAME: 501910

TYPE: 7

REATTEMPTS: 1

QUEUING: 0

CUTTHROUGH: 2

Verify

Use the PROV-RTRV command to verify.


Tips All the route lists, route trunks, and route trunk groups information can be retrieved by using the prov:rtrv :rtlist:"ALL" command. The ALL option cannot be used with other parameters.

Overriding the Trunk Group Property (Release 7.4)

This is the trunk group component for provisioning trunk group properties. Its MML name is TRNKGRPPROP. The following command overrides the trunk group property NPA for trunk group number 1000.

For information on TRNKGRPPROP properties, refer to Table 2-39.

Procedure

Command
Purpose
mml>prov-add:TRNKGRPPROP:NAME="1000",NPA="703" 
Virtual Switch Controller 1999-11-10 15:32:25
M  COMPLD
   "TRNKGRPPROP"
 

Uses the PROV-ADD command to add the component and required parameters:

Component: trnkgrp

Name: 1000

NPA: 703

Verify

Use the PROV-RTRV command to verify.

Adding A Switched Trunk (Multiple switched trunks) (Release 7.4)

This is the trunk (switched bearer channel) component for provisioning multiple switched trunks. Its MML name is SWITCHTRNK.

For information on SWITCHTRNK parameters, refer to the "Creating the Trunk Group" section.

The following command adds the six switched trunks shown in Table 6-2.

Procedure

Command
Purpose
mml>prov-add:switchtrnk:name="1",trnkgrpnu="1
000",span="ffff",cic="25",cu="gw1",spansize=6
,endpoint="S0/DS1-1/6@li-5300-3"

Virtual Switch Controller 1999-11-30 08:54:50
M  COMPLD
   Virtual Switch Controller 1999-11-10 
15:32:25
M  COMPLD
   "switchtrnk"

Uses the PROV-ADD command to add the component and required parameters:

Component: switchtrnk

Name: 1

TRUNKGRPNU: 1000 (trunk group number)

SPAN: ffff

CIC: 25 (circuit identifier code)

CU: gw1 (coding unit)

ENDPOINT: S0/DS1-1/6@li-5300-3


Table 6-2: Result of Adding a Switched Trunk Command
Trunk Group Number Trunk Group Member Span CIC Endpoint CLI

1000

1

ffff

25

S0/DS1-1/7@li-5300-3

gw1

1000

2

ffff

26

S0/DS1-1/8@li-5300-3

gw1

1000

3

ffff

27

S0/DS1-1/9@li-5300-3

gw1

1000

4

ffff

28

S0/DS1-1/10@li-5300-3

gw1

1000

5

ffff

29

S0/DS1-1/11@li-5300-3

gw1

1000

6

ffff

30

S0/DS1-1/12@li-5300-3

gw1

Verify

Use the PROV-RTRV command to verify.

Retrieving Multiple Switched Trunks (Release 7.4)

To retrieve multiple switched trunks based on the trunk group number, span, or CU name, use the PROV-RTRV command as follows.

Procedure

Command
Purpose
mml> prov-rtrv:switchtrnk:trnkgrpnum="1000"

   Virtual Switch Controller 1999-11-29 10:13:10
M  RTRV
   "session=cujo:switchtrnk"
   /* 
NAME SPAN CIC TRNKGRPNUM CU ENDPOINT
25 --ffff--25---1000----gw1-S0/DS1-1/1@li5300-3
26 --ffff--26---1000----gw1-S0/DS1-1/2@li5300-3 
27 --ffff--27---1000----gw1-S0/DS1-1/3@li5300-326 

Retrieves all the components associated with the trunk group 1000.

Verify

Use the PROV-RTRV command to verify.

Adding Multiple Nailed Trunks (Release 7.4)

To add multiple nailed trunks based on source svc, source span, dest-svc, and dest-span, use the PROV-ADD command as follows:

Procedure

Command
Purpose
mml>prov-add:nailedtrnk:name="100",srcsvc="SC-1", 
dstsvc="PC-7-200-7",srcspan="0",dstspan="ffff", 
srctimeslot="1",dsttimeslot="4065", spansize=6

Virtual Switch Controller 1999-11-30 08:54:50
M  COMPLD
   "nailedtrnk"

Adds six nailed trunks.

The previous command adds the six nailed trunks shown in Table 6-3.


Table 6-3: Result of Adding a Nailed Trunk Command
Name SRCSVC SRCSPAN SRCTIMESLOT DSTSVC DSTSPAN DSTTIMESLOT

1

SC-1

0

1

PC-7-200-7

ffff

4065

2

SC-1

0

2

PC-7-200-7

ffff

4066

3

SC-1

0

3

PC-7-200-7

ffff

4067

4

SC-1

0

4

PC-7-200-7

ffff

4068

5

SC-1

0

5

PC-7-200-7

ffff

4069

6

SC-1

0

6

PC-7-200-7

ffff

4070

Verify

Use the PROV-RTRV:nailedtrnk:srcsvc="sc-1" command to verify.

Retrieving Multiple Nailed Trunks (Release 7.4)

To retrieve multiple nailed trunks, use the PROV-RTRV command as follows:

Procedure

Command
Purpose
mml>prov-rtrv:nailedtrnk:srcsvc="SC-1"

   Virtual Switch Controller 1999-11-29 12:47:41
M  RTRV
   "session=xxx:nailedtrnk"

Retrieves all nailed trunks associated with the source service SC-1.

Verify

Observe the screen to verify the command.



Only one of source service or destination service or source span or destination span is allowed at a time.

Adding Multiple Trunk Groups and Bearer Channels (Release 7.4)

This is the component for provisioning multiple PRI trunk groups and bearer channels. Its MML name is MLTTRNKGRP.

Procedure

Command
Purpose
mml>prov-add:mlttrnkgrp:name="1000",svc="bsc1", 
clli="5300E4011",numtrnkgrp=2,spansize=4,trnkmemum=
1,span=0,cic=1,endpoint="S10/DS1-0/1@mgx-826,cu="mg
x-east"

Uses the PROV-ADD command to add the component and required parameters:

Component: mlttrnkgrp

Name: 1000

Svc: bsc1

Clli: 5300E4011

NUMTRNKGRP: 2

SPANSIZE: 4

TRNKMEMUM: 1

SPAN: 0

CIC: 1

ENDPOINT: S10/DS1-0/1@mmx-8260

CU: mgx-east

Verify

Use the PROV-RTRV:mlttrnkgrp:name="1000",nextrttrnkgrp=2 command to verify.



You cannot provision other trunk group types (for example, TDM or IP) with MLTTRNKGRP.

Removing Multiple Trunk Groups and Bearer Channels (Release 7.4)

You only need to specify the NAME and NUMTRNKGRP parameters to remove several multiple trunk groups and associated bearer channels.

Procedure

Command
Purpose
mml>prov-dlt:mlttrnkgrp:name="1000",numtrnkgrp=2

Uses the PROV-ADD command to delete the component and required parameters:

Component: mlttrnkgrp

Name: 1000

NUMTRNKGRP: 2

Verify

Use the PROV-RTRV command to verify.

Adding Dial Plan Components

You now need to configure the dial plan components. The MGC uses this information to perform different types of number analysis. You typically do this using the following:


Note   Configure any dial plan components in the order shown above.

All dial plan components are tables that have a name parameter, which is the MML name, and a description, which is a text description. The parameter's values are either an integer or a string. The dial plan provisioning is contained in the file customer group ID.dialPlan where the customer group ID is four alphanumeric characters.

For information on dial plan component parameters, refer to the "Release 7.4(x) Dial Plan Parameter Descriptions" section.

Adding a Dial Plan Using NUMAN-ADD

This is the dial plan component. Its MML name is DIALPLAN.

To add a dial plan, use the NUMAN-ADD command as follows:

Procedure

Command
Purpose
mml> numan-add:dialplan:custgrpid="t778"

 

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: dialplan

CUSTGRPID: t778

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding to a DIGMODSTRING Table

The digit modification table is accessed by the RESULTTABLE to yield a string of numbers to apply to an A-number or B-number. Its MML name is DIGMODSTRING.

To add appropriate values to a DIGMODSTRING table in a dial plan, use the NUMAN-ADD command as follows.

Procedure

Command
Purpose
mml>numan-add:digmodstring:custgrpid="t778",i
ndex="2", digstring="1045"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: digmodstring

CUSTGRPID: t778

INDEX: 2

DIGSTRING: 1045

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)


Tips The DIGMODSTRING table is accessed by an implied index that contains a single string of numbers to be applied to calling or called number.

Adding to a SERVICE Table

The service table contains user-defined services for screening. Its MML name is SERVICE.

To build a service table, use the NUMAN-ADD file as follows:

Procedure

Command
Purpose
mml>numan-add:service:custgrpid="t778",index=
1,svcname=TollLine"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: service

CUSTGRPID: t778

INDEX: 1

SVCNAME: TollLine

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)


Tips The service table acts as a slave to the result table.

Adding to a RESULTTABLE

The results table contains the results of number analysis. It could, for example, point to screening or to an SCP/STP index. Its MML name is RESULTTABLE.

To build a results table in a dial plan based on the result type and data word parameters entered, use the NUMAN-ADD command as follows:

Procedure

Step
Command
Purpose

1

mml>numan-add:resulttable:custgrpid="t778", 
index="1",resulttype="1",dw1="5". dw2="0", 
dw3="0",dw4="0", nextresult="0"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: resulttable

CUSTGRPID: t778

INDEX: 1

resulttype: 1

dw1: 5

dw2: 0

dw3: 0

dw4: 0

NEXTRESULT: "0"

2

mml>numan-add:resulttable:custgrpid="t778", 
index="1",resulttype="2",dw1="1". dw2="0", 
dw3="0",dw4="0", nextresult="0"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: resulttable

CUSTGRPID: t778

INDEX: 1

resulttype: 2

DW1: 1

DW2: 0

DW3: 0

DW4: 0

NEXTRESULT: "0"

3

mml>numan-add:resulttable:custgrpid="t778", 
index="1",resulttype="3",dw1="1". dw2="1", 
dw3="10",dw4="0", nextresult="0"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: resulttable

CUSTGRPID: t778

INDEX: 1

resulttype: 3

DW1: 1

DW2: 1

DW3: 10

DW4: 0

NEXTRESULT: "0"


Note   The example would continue until the table is complete.

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding to a ADIGTREE Table

The A-digit tree table contains entries, in blocks of ten, for each calling (A-) number. Its output is an index to the result table or an indication that no further action is necessary. Its MML name is ADIGTREE.

Procedure

Command
Purpose
mml> numan-add:adigittree:custgrpid="t778", 
index="1",resultindex="1"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: adigittree

CUSTGRPID: t778

INDEX: 1

PARAM_NAME: resultindex="1"

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding to a BDIGTREE Table

The B-digit tree table contains entries, in blocks of ten, for each called (B-) number. Its output is an index to the result table or an indication that no further action is necessary. Its MML name is BDIGTREE.

Procedure

Command
Purpose
mml> numan-add:bdigittree:custgrpid="t778", 
index="1",nextnode="1"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: bdigittree

CUSTGRPID: t778

INDEX: 1

PARAM_NAME: nextnode="1"

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding to the NPI Table

The NPI (numbering plan indicator) table provides an index into the RESULTTABLE. It provides the capability to carry out early or pre-analysis before formal A-number and B-number analysis are requested. Its MML name is NPI.

Command
Purpose
mml> numan-add:npi:custgrpid="t778", 
index="1",blockvalue="1"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: npi

CUSTGRPID: t778

INDEX: 1

BLOCKVALUE: 1

Adding to the NOA Table

The NOA (nature of address) table provides an index into the NPI table. It provides the capability to carry out early or pre-analysis before formal A-number and B-number analysis are requested. Its MML name is NOA.

Procedure

Command
Purpose
mml> numan-add:noa:custgrpid="t778", 
index="1",npiindex="1", resultindex="2"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: noa

CUSTGRPID: t778

INDEX: 1

NPIINDEX: 1

RESULTINDEX: 2

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding to the LOCATION Table

The location table identifies the type of network that originates a call. The MGC uses values from the CAUSE and LOCATION tables to determine result actions. Its MML name is LOCATION.

Command
Purpose
mml> numan-add:location:custgrpid="t778", 
index="1",resultindex="1"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: location

CUSTGRPID: t778

INDEX: 1

RESULTINDEX: 1

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)


Tips The LOCATION table contains 16 groups.

Adding to the CAUSE Table

The cause table provides an index into the location table to provide cause analysis. The MGC uses values from the cause and location tables to determine result actions. Its MML name is CAUSE.

Command
Purpose
mml> numan-add:cause:custgrpid="t778", 
index="1",locationindex="1",resultindex="2"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: cause

CUSTGRPID: t778

INDEX: 1

LOCATIONINDEX: 1

RESULTINDEX: 2

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4).

Adding a Calling Number to the AWHITE Table

The AWhite list contains calling numbers that will be processed. If the presented A-number is not found in the database, then the screening is deemed to have failed and the call is released. Its MML name is AWHITE.

Command
Purpose
mml>numan-add:awhite:custgrpid="t778",cli="91
9472123"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: awhite

CUSTGRPID: t778

CLI: 9194721234

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding a Calling Number to the ABLACK Table

The ABlack list table contains calling numbers that will not be processed. If the presented A-number is found in the database, then the call is released. Its MML name is ABLACK.

Command
Purpose
mml>numan-add:ablack:custgrpid="t778",cli="91
9472432"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: ablack

CUSTGRPID: t778

CLI: 9194724321

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding a Called Number to the BWHITE Table

The BWhite list table contains calling numbers that will be processed. If the presented B-number is not found in the database, the screening is deemed to have failed and the call is released. Its MML name is BWHITE.

Command
Purpose
mml>numan-add:bwhite:custgrpid="t778",cli="91
94721234",svcname="FreePhone"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: bwhite

CUSTGRPID: t778

CLI: 9194721234

SVCNAME: FreePhone

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4)

Adding a Called Number to the BBLACK Table

The BBlack list table contains calling numbers that will not be processed. If the presented B-number is found in the database, the call is released. Its MML name is BBLACK.

Command
Purpose
mml>numan-add:bblack:custgrpid="t778",cli="91
94724321",svcname="FreePhone"

Uses the NUMAN-ADD command to add the component and required parameters:

COMPONENT: bblack

CUSTGRPID: t778

CLI: 9194724321

SVCNAME: FreePhone

Verify

To verify the change, use the NUMAN-RTRV command. (VALID ONLY for Release 7.4).


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Sep 27 12:55:42 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.