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

<html>

<head>
<title>NaturalAccess GR303 and V5 Libraries Developer's Manual: Integrating NMS GR303 and Aztek protocol software </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; }
tr.whs3 { background-color:#CCCCCC; x-cell-content-align:top; vertical-align:top; }
td.whs4 { vertical-align:top; padding-left:5px;  padding-right:5px;  }
p.whs5 { font-weight:bold; }
tr.whs6 { x-cell-content-align:top; vertical-align:top; }
p.whs7 { margin-left:40px; }
table.whs8 {   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.whs9 { width:11.982%; }
col.whs10 { width:88.018%; }
col.whs11 { width:14.743%; }
col.whs12 { width:85.257%; }
table.whs13 {   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.whs14 { width:6.65%; }
col.whs15 { width:93.35%; }
td.whs16 { background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
td.whs17 { background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
p.whs18 { margin-left:0px; }
div.whs19 { width:100%; }
p.whs20 { text-align:center; }
p.whs21 { 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.whs18 {margin-left:1pt; }";
  strNSS += "p.whs21 {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 GR303 and Aztek protocol software");
addAvenueInfo("Untitled","integration_overview.htm","integrating_nms_v5_and_aztek_av5.html");
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 GR303 and Aztek protocol software</h1>

<p>This topic describes the steps for building integrated RDT or IDT applications 
 that use the Aztek Access303 or Exchange303 protocol stack library and 
 the NMS GR303 library.</p>

<ul type="disc" class="whs1">
	
	<li class=kadov-p><p><a href="#Specifying T1 Link and HDLC channel locations">Specifying 
 T1 link and HDLC channel locations</a></p></li>
	
	<li class=kadov-p><p><a href="#Verifying T1 connections">Verifying 
 T1 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 GR-303 application">Building 
 a complete GR303 application</a></p></li>
</ul>

<p>Before integrating the various parts of the RDT or IDT system, create 
 a mapping between the GR303 protocol structures and the data types defined 
 by the layers of the Aztek GR303 stack and the NMS GR303 library. The 
 following table shows mappings for data structures that are common for 
 different functions within the Access303 and Exchange303 libraries and 
 the NMS GR303 libraries<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 >:</font></span> 
 </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs3">
<td class="whs4">
<p class="whs5">GR303 protocol data</p></td>
<td class="whs4">
<p class="whs5">NMS GR303 data types</p></td>
<td class="whs4">
<p class="whs5">Access303 data types</p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>Interface ID</p></td>
<td class="whs4">
<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_GR303_INTERFACE_ID_T</font></span></p></td>
<td class="whs4">
<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 >AR303_INTERFACE_ID_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>Primary and standby DS1 locations</p></td>
<td class="whs4">
<p>N/A</p></td>
<td class="whs4">
<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 >AR303_PATH_LOCATION_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>EOC or TMC protocol channel</p></td>
<td class="whs4">
<p>N/A</p></td>
<td class="whs4">
<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 >AR303_PROTOCOL_CHANNEL_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>Primary and standby DS1 locations for an EOC or TMC protocol channel</p></td>
<td class="whs4">
<p>N/A</p></td>
<td class="whs4">
<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 >AR303_CHANNEL_LOCATION_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>TMC and EOC channels for LAPD protocol to send and receive data</p></td>
<td class="whs4">
<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_GR303_CHANNEL_LOCATION_T</font></span> 
 </p>
<p>HDLC channel location with respect to hardware.</p></td>
<td class="whs4">
<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 >AR303_CHANNEL_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>TMC protocol: bearer-channel timeslot assignment for ports to make connections 
 and process CAS signaling.</p></td>
<td class="whs4">
<p>Logical timeslot number of a T1 trunk on a CG board.</p></td>
<td class="whs4">
<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 >AR303_CHANNEL_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>DS1 link</p></td>
<td class="whs4">
<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_GR303_DS1_LOCATION_T</font></span></p></td>
<td class="whs4">
<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 >AR303_DS1_T</font></span></p></td></tr>

<tr valign="top" class="whs6">
<td class="whs4">
<p>DS0 timeslot</p></td>
<td class="whs4">
<p>Logical timeslot number of a trunk on a CG board.</p></td>
<td class="whs4">
<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 >AR303_DS0_T</font></span></p></td></tr>
</table><br>

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

<p>To configure the GR303 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_GR303_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_GR303_DS1_LOCATION_T data type provides 
 information about the specific location of DS1 links. Applications use 
 the following structure to specify the location of a particular DS1 link 
 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="whs7">where the data type specifies the following 
 information: </p>

<table cellpadding="5" x-use-null-cells width="100%" cellspacing="0" border="1" class="whs8">
<col class="whs9">
<col class="whs10">

<tr bgcolor="#CCCCCC" valign="top" class="whs3">
<td width="11.982%" class="whs4">
<p class="whs5">Parameters</p></td>
<td width="88.018%" class="whs4">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs6">
<td width="11.982%" class="whs4">
<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.018%" class="whs4">
<p>Logical board number of the board where the DS1 link resides (as defined 
 by OAM).</p></td></tr>

<tr valign="top" class="whs6">
<td width="11.982%" class="whs4">
<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.018%" class="whs4">
<p>Logical trunk number associated with the DS1 link (as defined by OAM).</p></td></tr>
</table><br>

<ul>
	
	<li class=kadov-p><p>The NMS_GR303_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="whs7">where the data type specifies the following 
 information: </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs3">
<td width="14.743%" class="whs4">
<p class="whs5">Parameters</p></td>
<td width="85.257%" class="whs4">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs6">
<td width="14.743%" class="whs4">
<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="85.257%" class="whs4">
<p>Logical board number of the associated board.</p></td></tr>

<tr valign="top" class="whs6">
<td width="14.743%" class="whs4">
<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="85.257%" class="whs4">
<p>Logical trunk number on which the HDLC channel is located.</p></td></tr>

<tr valign="top" class="whs6">
<td width="14.743%" class="whs4">
<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="85.257%" class="whs4">
<p>Physical timeslot number to associate with the HDLC channel in the range 
 1 to 24.</p>
<ul>
	
	<li class=kadov-p-CCellBodyBullet1><p class=CellBodyBullet1>Set the 
 timeslot number to 12 for EOC data links </p></li>
	
	<li class=kadov-p-CCellBodyBullet1><p class=CellBodyBullet1>Set the 
 timeslot number to 24 for TMC data links</p></li>
</ul></p></td></tr>
</table><br>

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

<p>You can use Aztek Access303 or Exchange303 software with NMS GR303 library 
 software to develop GR303 compliant RDT-side applications. However, before 
 you can run the application, connect the RDT side of the system to the 
 IDT side of the GR303 protocol with a T1 cable. After you connect the 
 T1 cable to the CG board, boot the CG board and start the application. 
 Follow these steps to verify that the T1 links are synchronized:</p>

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

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

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs17">
<p>1</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>Set up appropriate CT bus clocking for the system. </p>
<p>In a single board system with T1 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 
 to 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="whs17">
<p>2</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<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 became synchronized, the green LED remains lit for each trunk.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs17">
<p>3</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<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 T1 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="whs17">
<p>4</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>If the trunks connected to the external T1 cable 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 T1 link rather than with 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><a name="Testing the integration"></a>Testing the integration</h2>

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

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

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

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

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs17">
<p>1</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>Compile the program from the source code provided with the NMS DLCP 
 software. </p></td></tr>

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

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

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

<p>Refer to <a href="using_the_demonstration_programs_.htm">Using the demonstration 
 programs</a> for more information about running <span style="font-style: italic;"><I>nms303tool.</I></span></p>

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

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

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

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs17">
<p>1</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>Compile the program from the source code provided with the Access 303 
 software. </p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs17">
<p>2</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>Start the Access303 or Exchange303 software (by running <span style="font-style: italic;"><I>nms303tool</I></span>) 
 and make sure that the Aztek library AIM task is set to listen on the 
 appropriate socket for <span style="font-style: italic;"><I>aim303</I></span> 
 messages.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="6.65%" class="whs17">
<p>3</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>Start the <span style="font-style: italic;"><I>aim303</I></span> utility by 
 entering the following at the command line:</p>
<p class=Example
	style="margin-left: 0px;"><span class=ExampleChar>aim303 &lt;</span><span style="font-style: italic; font-weight: bold;"><I><B>hostname</B></I></span><span class=ExampleChar>&gt;</span></p>
<p class="whs18">where <span style="font-style: italic; font-weight: bold;"><I><B>hostname</B></I></span> 
 is the name of the machine running the GR303 application.</p>
<p class="whs18">The <span style="font-style: italic;"><I>aim303</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="whs17">
<p>4</p></td>
<td bgcolor="#FFFFFF" width="93.35%" class="whs17">
<p>Enter commands as needed.</p></td></tr>
</table><br>

<p>Refer to the <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>Aztek 
 Integration Menu AIM-303 User Guide</I></font></span> for more information about 
 using the <span style="font-style: italic;"><I>aim303</I></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>utility<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></p>

<p>After you start the <span style="font-style: italic;"><I>nms303tool</I></span> 
 and <span style="font-style: italic;"><I>aim303</I></span> programs, you can 
 enter the commands at the command line of either program to perform operations 
 on GR303 interfaces. These programs allow you to perform a variety of 
 tasks, such as executing NMS GR303 or Aztek GR303 library functions, configuring 
 and tracking task tracing information, verifying system status integration, 
 and displaying status information about NMS GR303 interfaces. </p>

<h2><a name="Building a complete GR-303 application"></a>Building a complete 
 GR303 application</h2>

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

<p>Depending on the GR303 application's system requirements, you can use 
 other NMS hardware and software to support specific functionality. For 
 example, you can use the NMS Switching service to connect ports associated 
 with a GR303 interface to specific CT bus timeslots, or use other NMS 
 software to control robbed-bit signaling or media processing on connected 
 ports. </p>

<p>For more information about the association between Aztek Access303 or 
 Exchange303 library functions and NMS GR303 library functions when performing 
 typical tasks, refer to <a href="developing_gr303_applications_.htm">Developing 
 GR303 applications</a>.</p>

<div placeholder id="footer" class="whs19">
 <p align="center" class="whs20">&nbsp;</p>
 <p align="center" class="whs20"><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="whs21">&#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>

