<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">

<html>

<head>
<title>NaturalAccess GR303 and V5 Libraries Developer's Manual: Integrating NMS V5 and Aztek AV5 </title>
<meta http-equiv="content-type" content="text/html; charset=windows-1252">
<meta name=NMSConversion content="4.0.8">
<meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">
<link rel="stylesheet" href="dialogic_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">
<!--
if (navigator.appName !="Netscape")
{   document.write("<link rel='stylesheet' href='dialogic.css'>");}
//-->
</script>
<style type="text/css">
<!--
ul.whs1 { list-style:disc; }
table.whs2 {   x-border-left:1px table-solid; x-border-top:1px table-solid; x-border-right:1px table-solid; x-border-bottom:1px table-solid; border-collapse:separate; border-spacing:0px; }
col.whs3 { width:233px; }
col.whs4 { width:212px; }
tr.whs5 { background-color:#CCCCCC; x-cell-content-align:top; vertical-align:top; }
td.whs6 { width:233px; vertical-align:top; padding-left:5px;  padding-right:5px;  }
p.whs7 { font-weight:bold; }
td.whs8 { width:212px; vertical-align:top; padding-left:5px;  padding-right:5px;  }
td.whs9 { vertical-align:top; padding-left:5px;  padding-right:5px;  }
tr.whs10 { x-cell-content-align:top; vertical-align:top; }
p.whs11 { margin-left:40px; }
table.whs12 {   margin-left:40px; x-border-left:1px table-solid; x-border-top:1px table-solid; x-border-right:1px table-solid; x-border-bottom:1px table-solid; border-collapse:separate; border-spacing:0px; width:100%; }
col.whs13 { width:11.292%; }
col.whs14 { width:88.708%; }
table.whs15 { width:100%;   x-border-left:1px table-solid; x-border-top:1px table-solid; x-border-right:1px table-solid; x-border-bottom:1px table-solid; border-collapse:separate; border-spacing:0px; }
col.whs16 { width:6.65%; }
col.whs17 { width:93.35%; }
td.whs18 { background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
td.whs19 { background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
p.whs20 { margin-left:0px; }
div.whs21 { width:100%; }
p.whs22 { text-align:center; }
p.whs23 { text-align:center; font-size:xx-small; }
-->
</style><script type="text/javascript" language="JavaScript">
<!--
if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
{
  var strNSS = "<style type='text/css'>";
  strNSS += "p.whs20 {margin-left:1pt; }";
  strNSS += "p.whs23 {font-size:x-small; }";
  strNSS +="</style>";
  document.write(strNSS);
}
//-->
</script>
<script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
<!--
function reDo() {
  if (innerWidth != origWidth || innerHeight != origHeight)
     location.reload();
}
if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
	origWidth = innerWidth;
	origHeight = innerHeight;
	onresize = reDo;
}
onerror = null; 
//-->
</script>
<style type="text/css">
<!--
div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
-->
</style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
<script type="text/javascript" language="javascript" src="whver.js"></script>
<script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
<script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
<script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
</head>
<body><script type="text/javascript" language="javascript1.2">
<!--
if (window.gbWhTopic)
{
	if (window.addTocInfo)
	{
	addTocInfo("Integrating the system\nIntegrating NMS V5 and Aztek AV5");
addAvenueInfo("Untitled","integrating_nms_gr303_and_aztek_protocol_software_.htm","developing_gr303_applications_.htm");
addButton("show",BTN_TEXT,"Show table of contents for this manual","","","","",0,0,"","","");

	}
	if (window.writeBtnStyle)
		writeBtnStyle();

	if (window.writeIntopicBar)
		writeIntopicBar(1);

	if (window.setRelStartPage)
	{
	setRelStartPage("default.htm");

		autoSync(1);
		sendSyncInfo();
		sendAveInfoOut();
	}
}
else
	if (window.gbIE4)
		document.location.reload();
//-->
</script>
<h1>Integrating 
 NMS V5 and Aztek AV5</h1>

<p>This topic describes the steps for building an integrated AN application 
 that uses the Aztek AV5 protocol stack library and the NMS V5 library.</p>

<ul type="disc" class="whs1">
	
	<li class=kadov-p><p><a href="#Specifying E1 link and HDLC channel locations">Specifying 
 E1 link and HDLC channel locations</a></p></li>
	
	<li class=kadov-p><p><a href="#Verifying E1 Connections">Verifying 
 E1 connections</a></p></li>
	
	<li class=kadov-p><p><a href="#Testing the Integration">Testing the 
 integration</a></p></li>
	
	<li class=kadov-p><p><a href="#Building a Complete AN Application">Building 
 a complete AN application</a></p></li>
</ul>

<p>Before integrating the various parts of the AN system, create a mapping 
 between the V5.2 protocol structures and the data types defined by the 
 layers of the AV5 protocol stack and by the NMS V5 library. The following 
 table shows m<span style="color: #000000;
							font-style: normal;
							font-weight: normal;
							x-text-underline: off;
							x-text-overline: off;
							x-text-line-through: off;
							text-transform: none;
							vertical-align: baseline;
							/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >appings 
 for data structures that are common for different functions within the 
 AV5 and NMS V5 libraries:</font></span> </p>

<table cellpadding="5" x-use-null-cells cellspacing="0" border="1" class="whs2">
<col class="whs3">
<col class="whs4">
<col>

<tr bgcolor="#CCCCCC" valign="top" class="whs5">
<td width="233px" class="whs6">
<p class="whs7">V5.2 protocol data</p></td>
<td width="212px" class="whs8">
<p class="whs7">NMS V5 data types</p></td>
<td class="whs9">
<p class="whs7">Aztek AV5 data types</p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Interface ID</p></td>
<td width="212px" class="whs8">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >NMS_V5_INTERFACE_ID_T</font></span></p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_INTERFACE_ID_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>E1 link ID</p></td>
<td width="212px" class="whs8">
<p>N/A</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_LE_LINK_ID_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>E1 location</p></td>
<td width="212px" class="whs8">
<p>NMS_V5_E1_LOCATION_T</p>
<p>E1 trunk location on the CG board.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_E1_T</font></span> 
 (AV5 local ID)</p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Communication path (C-path) for Control, Link Control, PSTN, BCC, and 
 Protection protocols</p></td>
<td width="212px" class="whs8">
<p>N/A</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_C_PATH_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Communication channel (C-channel) to carry a group of one or more C-paths</p></td>
<td width="212px" class="whs8">
<p>N/A</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_LOGICAL_C_CHANNEL_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Number of logical C-channels</p></td>
<td width="212px" class="whs8">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >num_channels</font></span> 
 function parameter when provisioning a variant.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_PROVISION_DATA_T</font></span> 
 (<span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >numLogCchan</font></span><span 
 style="color: #000000;
		font-style: italic;
		font-weight: normal;
		x-text-underline: off;
		x-text-overline: off;
		x-text-line-through: off;
		text-transform: none;
		vertical-align: baseline;
		/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "> 
 <font color=black ><I></I></font></span>parameter)</p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Protection group number</p></td>
<td width="212px" class="whs8">
<p>N/A</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_PROTECTION_GRP_NUM_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Protection group standby channels</p></td>
<td width="212px" class="whs8">
<p>N/A</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_PROTECT_STNDBY_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>&nbsp;</p></td>
<td width="212px" class="whs8">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >NMS_V5_CHANNEL_LOCATION_T</font></span> 
 </p>
<p>HDLC channel location with respect to the hardware.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_PHYSICAL_C_CHANNEL_T</font></span> 
 for each standby</p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>Provisioned variant</p></td>
<td width="212px" class="whs8">
<p>Capable of provisioning and destroying a standby variant.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_VARIANT_ID_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>PSTN or ISDN port on AN side</p></td>
<td width="212px" class="whs8">
<p>N/A</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_AN_PORT_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>BCC protocol: Bearer-channel timeslot on E1</p></td>
<td width="212px" class="whs8">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >NMS_V5_E1_LOCATION_T</font></span> 
 and hardware-mapped logical timeslot number.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_E1_T</font></span> 
 and <span style="color: #000000;
					font-style: normal;
					font-weight: normal;
					x-text-underline: off;
					x-text-overline: off;
					x-text-line-through: off;
					text-transform: none;
					vertical-align: baseline;
					/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_TIME_SLOT_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>C-channels send/receive data</p></td>
<td width="212px" class="whs8">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >NMS_V5_CHANNEL_LOCATION_T</font></span></p>
<p>HDLC channel location with respect to the hardware.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_E1_T</font></span> 
 and <span style="color: #000000;
					font-style: normal;
					font-weight: normal;
					x-text-underline: off;
					x-text-overline: off;
					x-text-line-through: off;
					text-transform: none;
					vertical-align: baseline;
					/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_C_CHANNEL_T</font></span></p></td></tr>

<tr valign="top" class="whs10">
<td width="233px" class="whs6">
<p>BCC protocol: Bearer-channel port location on AN side</p></td>
<td width="212px" class="whs8">
<p>Hardware-mapped logical timeslot number on an E1 trunk on an CG board.</p></td>
<td class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >V5_AN_PORT_T</font></span></p></td></tr>
</table><br>

<h2><a name="Specifying E1 link and HDLC channel locations"></a>Specifying 
 E1 link and HDLC channel locations</h2>

<p>To configure the NMS V5 library software to work with CG boards, applications 
 must define a pair of data types to reference common location information 
 for boards, trunks, and HDLC channels.</p>

<ul>
	
	<li class=kadov-p><p>The <span style="color: #000000;
											font-style: normal;
											font-weight: normal;
											x-text-underline: off;
											x-text-overline: off;
											x-text-line-through: off;
											text-transform: none;
											vertical-align: baseline;
											/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >NMS_V5_INTERFACE_ID_T</font></span> 
 data type specifies the ID associated with a particular lower level interface.</p></li>
	
	<li class=kadov-p><p>The NMS_V5_E1_LOCATION_T data type provides information 
 about the specific location of E1 links. Applications use the following 
 structure to specify the location of particular E1 trunks on a CG board:</p></li>
</ul>

<p class=Example
	style="margin-left: 40px;"><span class=ExampleChar>struct {<br>
DWORD boardNb;<br>
DWORD trunkNb;<br>
} CG;</span></p>

<p class="whs11">where the data type specifies the following 
 information: </p>

<table cellpadding="5" x-use-null-cells width="100%" cellspacing="0" border="1" class="whs12">
<col class="whs13">
<col class="whs14">

<tr bgcolor="#CCCCCC" valign="top" class="whs5">
<td width="11.292%" class="whs9">
<p class="whs7">Parameters</p></td>
<td width="88.708%" class="whs9">
<p class="whs7">Description</p></td></tr>

<tr valign="top" class="whs10">
<td width="11.292%" class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >boardNb</font></span></p></td>
<td width="88.708%" class="whs9">
<p>Logical board number of the board where the E1 link resides.</p></td></tr>

<tr valign="top" class="whs10">
<td width="11.292%" class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >trunkNb</font></span></p></td>
<td width="88.708%" class="whs9">
<p>Logical trunk number associated with the E1 link.</p></td></tr>
</table><br>

<ul>
	
	<li class=kadov-p><p>The NMS_V5_CHANNEL_LOCATION_T data type provides 
 information about the specific locations of HDLC channels. Applications 
 use the following structure to specify the location of particular HDLC 
 channels on a CG board:</p></li>
</ul>

<p class=Example
	style="margin-left: 40px;"><span class=ExampleChar>struct {<br>
DWORD boardNb;<br>
DWORD trunkNb;<br>
DWORD timeslotNb;<br>
} CG;</span></p>

<p class="whs11">where the data type specifies the following 
 information: </p>

<table cellpadding="5" x-use-null-cells width="100%" cellspacing="0" border="1" class="whs12">
<col class="whs13">
<col class="whs14">

<tr bgcolor="#CCCCCC" valign="top" class="whs5">
<td width="11.292%" class="whs9">
<p class="whs7">Parameters</p></td>
<td width="88.708%" class="whs9">
<p class="whs7">Description</p></td></tr>

<tr valign="top" class="whs10">
<td width="11.292%" class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >boardNb</font></span></p></td>
<td width="88.708%" class="whs9">
<p>Logical board number of the associated board.</p></td></tr>

<tr valign="top" class="whs10">
<td width="11.292%" class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >trunkNb</font></span></p></td>
<td width="88.708%" class="whs9">
<p>Logical trunk number on which the HDLC channel is located.</p></td></tr>

<tr valign="top" class="whs10">
<td width="11.292%" class="whs9">
<p><span style="color: #000000;
				font-style: normal;
				font-weight: normal;
				x-text-underline: off;
				x-text-overline: off;
				x-text-line-through: off;
				text-transform: none;
				vertical-align: baseline;
				/*begin!kadov{{*/ text-decoration: none none none; /*}}end!kadov*/ "><font color=black >timeslotNb</font></span></p></td>
<td width="88.708%" class="whs9">
<p>Physical timeslot number to associate with the HDLC channel. Specify 
 timeslots 15, 16, and 31 as needed in accordance with the V5 protocol.</p></td></tr>
</table><br>

<h2><a name="Verifying E1 connections"></a>Verifying E1 connections</h2>

<p>You can use Aztek AV5 library and NMS V5 library software to develop 
 applications on the AN side of the V5.2 protocol. However, before you 
 can run the application, connect the AN side of the system to the local 
 exchange (LE) end of the V5.2 protocol through an E1 cable. After you 
 connect the E1 cable to the CG board, boot the CG board, and start the 
 LE side of the system. Follow these steps to verify that the E1 links 
 are synchronized:</p>

<table cellpadding="5" x-use-null-cells cellspacing="0" width="100%" border="1" class="whs15">
<col class="whs16">
<col class="whs17">

<tr>
<td bgcolor="#CCCCCC" width="6.65%" class="whs18">
<p class="whs7">Step</p></td>
<td bgcolor="#CCCCCC" width="93.35%" class="whs18">
<p class="whs7">Action</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>1</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Set up appropriate CT bus clocking for the system. </p>
<p>In a single board system with E1 network connectivity, configure the 
 board clocks to slave to a network interface. In a typical multiple-board 
 system, configure one board to derive its clocking from the network and 
 act as the clock master for the other boards on the system. Configure 
 the remaining boards to slave to the CT bus clock for inter-board synchronization. 
 Refer to the <span style="font-style: italic;"><I>NMS OAM System User's Manual</I></span> 
 or the appropriate board installation manual for more information about 
 setting up CT bus clocking.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>2</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Boot the board and observe the trunk LEDs on the board's front panel. 
 The LEDs remain briefly in an alarm condition after the board is booted, 
 until frame synchronization is acquired. When the trunks leave the alarm 
 state and are synchronized, the green LED remains lit for each trunk.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>3</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Run the <span style="font-style: italic;"><I>trunkmon </I></span>utility with 
 the -b (board number) argument to monitor alarms and gather performance 
 statistics for the E1 trunks. When all trunks are synchronized, <span 
 style="font-style: italic;"><I>trunkmon</I></span> displays the alarm status 
 for the board as NONE.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>4</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>If the trunks connected to the external E1 link stay in an alarm state, 
 connect a cross-over cable between any two trunks of the CG board. If 
 the LEDs show that the trunks are in frame synchronization, this indicates 
 that there is a problem with the E1 link rather than the board.</p></td></tr>
</table><br>

<p>For more information about CG board LEDs, the <span style="font-style: italic;"><I>trunkmon</I></span> 
 utility, and using cross-over cables with CG boards, refer to the CG board 
 documentation.</p>

<h2><span style="font-style: italic;"><I><a name="Testing the integration"></a></I></span>Testing 
 the integration</h2>

<p>Use the <span style="font-style: italic;"><I>nmsv5tool</I></span> and <span 
 style="font-style: italic;"><I>aimv5</I></span> programs to test the integration.</p>

<p>To use the <span style="font-style: italic;"><I>nmsv5tool</I></span> demonstration 
 program:</p>

<table cellpadding="5" x-use-null-cells cellspacing="0" width="100%" border="1" class="whs15">
<col class="whs16">
<col class="whs17">

<tr>
<td bgcolor="#CCCCCC" width="6.65%" class="whs18">
<p class="whs7">Step</p></td>
<td bgcolor="#CCCCCC" width="93.35%" class="whs18">
<p class="whs7">Action</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>1</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Compile the program as an executable from the DLCP software source code.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>2</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Start <span style="font-style: italic;"><I>nmsv5tool</I></span>.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>3</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Start the <span style="font-style: italic;"><I>aimv5</I></span> utility (the 
 AIM V5 task must be running).</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>4</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Enter commands as needed from the <span style="font-style: italic;"><I>nmsv5tool</I></span> 
 or <span style="font-style: italic;"><I>aimv5</I></span> command line.</p></td></tr>
</table><br>

<p>For more information about using <span style="font-style: italic;"><I>nmsv5tool</I></span>, 
 refer to <a href="using_the_demonstration_programs_.htm">Using the demonstration 
 programs</a>.</p>

<p>To use the <span style="font-style: italic;"><I>aimv5</I></span> utility:</p>

<table cellpadding="5" x-use-null-cells cellspacing="0" width="100%" border="1" class="whs15">
<col class="whs16">
<col class="whs17">

<tr>
<td bgcolor="#CCCCCC" width="6.65%" class="whs18">
<p class="whs7">Step</p></td>
<td bgcolor="#CCCCCC" width="93.35%" class="whs18">
<p class="whs7">Action</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>1</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Compile the program as an executable from the source code provided with 
 the AV5 software.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>2</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Initialize the AV5 software (by running <span style="font-style: italic;"><I>nmsv5tool</I></span>) 
 and make sure that the AV5 library AIM task is listening on the appropriate 
 socket for the AIM messages.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>3</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Start <span style="font-style: italic;"><I>aimv5</I></span> by entering the 
 following at the command line:</p>
<p class=Example
	style="margin-left: 0px;"><span class=ExampleChar>aimv5 &lt;</span><span style="font-style: italic; font-weight: bold;"><I><B>hostname</B></I></span><span class=ExampleChar>&gt;</span></p>
<p class="whs20">where <span style="font-style: italic; font-weight: bold;"><I><B>hostname</B></I></span> 
 is the name of the machine running the AN application.</p>
<p class="whs20">The <span style="font-style: italic;"><I>aimv5</I></span> 
 program reports when the connection is established and displays a menu 
 of available commands.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs19">
<p>4</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs19">
<p>Enter commands as needed.</p></td></tr>
</table><br>

<p>For more information about using <span style="font-style: italic;"><I>aimv5</I></span>, 
 refer to the Aztek documentation.</p>

<p>After you start the <span style="font-style: italic;"><I>nmsv5tool</I></span> 
 and <span style="font-style: italic;"><I>aimv5</I></span> programs, you can enter 
 commands at the command line of either utility to perform operations on 
 V5.2 interfaces. These programs allow you to perform a variety of tasks, 
 such as executing API functions, toggling task tracing, verifying the 
 integration status, and displaying status information. </p>

<h2><a name="Building a complete AN application"></a>Building a complete 
 AN application</h2>

<p>After completing the basic tasks to integrate and verify the AV5 and 
 NMS V5 libraries, you can build an enhanced application by modifying the 
 <span style="font-style: italic;"><I>nmsv5tool</I></span> source code to provide 
 additional functionality or by creating a new application using functions 
 from the NMS V5 library.</p>

<p>You can use the NMS Switching service to connect ports associated with 
 a V5.2 interface to specific CT bus timeslots. Depending on the AN system 
 requirements, you can also use other NMS software and hardware to provide 
 access to PSTN or IP networks, or to provide digital loop carrier (DLC), 
 hybrid fiber coax (HFC), or wireless local loop (WLL) support.</p>

<p>For more information about the association between Aztek AV5 library 
 functions and NMS V5 library functions when performing typical tasks, 
 refer to <a href="developing_an_applications_.htm">Developing AN applications</a>.</p>

<div placeholder id="footer" class="whs21">
 <p align="center" class="whs22">&nbsp;</p>
 <p align="center" class="whs22"><script type="text/javascript" language="JavaScript1.2">var mailSubject = 'Documentation link: ' + document.title;
var mailBody = 'Link to reference this topic:%0A %0A' + location.href;
var mailDisplay = '<img src="send_link.gif" border="0" alt="Send link to this topic">'; 
document.write( 
'<a href="mailto:Enter recipient email address' 
+ '?subject=' + escape(mailSubject) 
+ '&body=' + (mailBody) 
+ '">' + mailDisplay + '</a>' 
);</script></p>
 <p align="center" class="whs23">&#169; 
 Copyright 2009 Dialogic Corporation. All rights reserved.</p>
</div>
<script type="text/javascript" language="javascript1.2">
<!--
if (window.writeIntopicBar)
	writeIntopicBar(0);
//-->
</script>
</body>
</html>

