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

<html>

<head>
<title>NaturalAccess GR303 and V5 Libraries Developer's Manual: NMS_V5ProvisionStandByVariant </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">
<!--
table.whs1 { 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.whs2 { width:22.083%; }
col.whs3 { width:77.917%; }
td.whs4 { background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
p.whs5 { font-weight:bold; }
td.whs6 { background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
p.whs7 { font-style:italic; font-weight:bold; }
col.whs8 { width:28.105%; }
col.whs9 { width:71.895%; }
table.whs10 {   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.whs11 { width:8.407%; }
col.whs12 { width:91.593%; }
tr.whs13 { background-color:#CCCCCC; x-cell-content-align:top; vertical-align:top; }
td.whs14 { vertical-align:top; padding-left:5px;  padding-right:5px;  }
tr.whs15 { x-cell-content-align:top; vertical-align:top; }
col.whs16 { width:12.171%; }
col.whs17 { width:87.829%; }
col.whs18 { width:27.29%; }
col.whs19 { width:72.71%; }
col.whs20 { width:13.864%; }
col.whs21 { width:86.136%; }
table.whs22 {   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; }
div.whs23 { width:100%; }
p.whs24 { text-align:center; }
p.whs25 { 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.whs25 {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("NMS V5 function reference\nNMS_V5ProvisionStandByVariant");
addAvenueInfo("Untitled","nmsv5provisioninterface.html","nmsv5resetchannelstatistics.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>NMS_V5ProvisionStandByVariant</h1>

<p>Configures (provisions) the HDLC channels and E1 links for a standby 
 variant on the specified interface. </p>

<h4>Prototype</h4>

<p>NMS_V5_RESULT_T <span style="font-weight: bold;"><B>NMS_V5ProvisionStandByVariant</B></span> 
 ( NMS_V5_INTERFACE_ID_T <span style="font-style: italic; font-weight: bold;"><I><B>interfaceId</B></I></span> 
 DWORD <span style="font-style: italic; font-weight: bold;"><I><B>num_e1s</B></I></span> 
 NMS_V5_E1_LOCATION_T *<span style="font-style: italic; font-weight: bold;"><I><B>e1_loc_array</B></I></span> 
 NMS_V5_E1_STATUS_CALLBACK_T <span style="font-style: italic; font-weight: bold;"><I><B>e1_status_callback</B></I></span> 
 DWORD <span style="font-style: italic; font-weight: bold;"><I><B>numchannels</B></I></span> 
 NMS_V5_CHANNEL_LOCATION_T *<span style="font-style: italic; font-weight: bold;"><I><B>channel_loc_array</B></I></span> 
 NMS_V5_CHANNEL_CALLBACK_T *<span style="font-style: italic; font-weight: bold;"><I><B>channel_callback</B></I></span> 
 void <span style="font-style: italic; font-weight: bold;"><I><B>*channel_rx_buffer</B></I></span> 
 DWORD <span style="font-style: italic; font-weight: bold;"><I><B>channel_rx_buffersize</B></I></span>)</p>

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

<tr>
<td bgcolor="#CCCCCC" width="22.083%" class="whs4">
<p class="whs5">Argument</p></td>
<td bgcolor="#CCCCCC" width="77.917%" class="whs4">
<p class="whs5">Description</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">interfaceId</p></td>
<td bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Interface ID. The valid range for interface IDs is 0 - 253.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">num_e1s</p></td>
<td bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Number of E1 links provisioned. The maximum number is 16.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">e1_loc_array</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Pointer to an array of NMS_V5_CHANNEL_LOCATION_T structures that each 
 define an E1 link location. The size of the array is specified by <span 
 style="font-style: italic; font-weight: bold;"><I><B>num_e1s</B></I></span>.</p>
<p class=Example>typedef&nbsp;union&nbsp;_NMS_V5_E1_LOCATION_T<br>
&nbsp;{<br>
&nbsp;struct&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;&nbsp;boardNb;<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;&nbsp;trunkNb;<br>
&nbsp; &nbsp;&nbsp;}&nbsp;CG;<br>
}NMS_V5_E1_LOCATION_T</p>
<p>See the <a href="#Details">Details</a> section for field descriptions.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">e1_status_callback</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Pointer to an application defined E1 status callback function. After 
 the application switches the standby variant to active, the library calls 
 the callback function every time it needs to pass an event to the application 
 for a provisioned E1 link. The application should return from this function 
 as soon as possible.</p>
<p class=Example>typedef&nbsp;void(&nbsp;*NMS_V5_E1_STATUS_CALLBACK_T&nbsp;)<br>
&nbsp;&nbsp;&nbsp;(NMS_V5_INTERFACE_ID_T&nbsp;interfaceId,<br>
&nbsp;&nbsp;&nbsp;&nbsp;NMS_V5_E1_LOCATION_T&nbsp;e1_loc,&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;NMS_V5_E1_STATUSMASK_T&nbsp;e1_status)&nbsp;;</p>
<p>See the <a href="#Details">Details</a> section for field descriptions.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">numchannels</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Number of HDLC channels provisioned on an interface. The maximum is 
 48.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">channel_loc_array</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Pointer to an array of NMS_V5_CHANNEL_LOCATION_T structures. The size 
 of the array should be specified by <span style="font-style: italic; font-weight: bold;"><I><B>num_channels</B></I></span>. 
 Each element of the <span style="font-style: italic; font-weight: bold;"><I><B>channel_loc_array</B></I></span> 
 defines an HDLC channel location:</p>
<p class=Example>typedef&nbsp;union&nbsp;_NMS_V5_CHANNEL_LOCATION_T<br>
{<br>
&nbsp;struct&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;&nbsp;boardNb;<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;&nbsp;trunkNb;<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;&nbsp;timeslotNb;<br>
&nbsp; &nbsp;&nbsp;}&nbsp;CG;<br>
}NMS_V5_CHANNEL_LOCATION_T</p>
<p>See the <a href="#Details">Details</a> section for field descriptions.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">channel_callback</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Pointer to an application-provided channel callback function. After 
 the standby variant is switched to active with <a href="nmsv5switchovervariantdata.html"><span 
 style="color: #0000ff;
		font-weight: bold;
		x-text-underline: off;
		/*begin!kadov{{*/ text-decoration: none; /*}}end!kadov*/ "><font color=blue ><B>NMS_V5SwitchOverVariantData</B></font></span></a>, 
 the library must call this callback function whenever it needs to pass 
 an event for a provisioned HDLC channel. The application should return 
 from this function as soon as possible. The callback function is defined 
 as follows:</p>
<p class=Example>typedef&nbsp;void(&nbsp;*NMS_V5_CHANNEL_CALLBACK_T&nbsp;)<br>
(&nbsp;NMS_V5_INTERFACE_ID_T&nbsp;interfaceId,<br>
&nbsp;&nbsp;NMS_V5_CHANNEL_LOCATION_T&nbsp;channel_loc,<br>
&nbsp;&nbsp;NMS_V5_CHANNEL_EVENT_T&nbsp;channel_event,<br>
&nbsp;&nbsp;void&nbsp;*databuffer,<br>
&nbsp;&nbsp;DWORD&nbsp;datasize);</p>
<p>See the <a href="#Details">Details</a> section for field descriptions.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">channel_rx_buffer</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Pointer to the application allocated memory to be used by the library 
 to pass HDLC channel event data to the application.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="22.083%" class="whs6">
<p class="whs7">channel_rx_buffersize</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="77.917%" class="whs6">
<p>Size of the application-allocated buffer specified by <span style="font-style: italic; font-weight: bold;"><I><B>channel_rx_buffer</B></I></span>. 
 The minimum requirement for the <span style="font-style: italic; font-weight: bold;"><I><B>channel_rx_buffersize</B></I></span> 
 is defined by NMS_V5_RX_BUFFER_SIZE.</p></td></tr>
</table><br>

<h4>Return values</h4>

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

<tr>
<td bgcolor="#CCCCCC" width="28.105%" class="whs4">
<p class="whs5">Return value</p></td>
<td bgcolor="#CCCCCC" width="71.895%" class="whs4">
<p class="whs5">Description</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="28.105%" class="whs6">
<p>NMSV5_SUCCESS</p></td>
<td bgcolor="#FFFFFF" width="71.895%" class="whs6">
<p>&nbsp;</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="28.105%" class="whs6">
<p>NMSV5_INVALID_INTERFACE_ID</p></td>
<td bgcolor="#FFFFFF" width="71.895%" class="whs6">
<p>Specified <span style="font-style: italic; font-weight: bold;"><I><B>interfaceId</B></I></span> 
 is not provisioned.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="28.105%" class="whs6">
<p>NMSV5_INVALID_PARMS</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="71.895%" class="whs6">
<p>One or more of the function arguments were invalid.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="28.105%" class="whs6">
<p>NMSV5_NOT_INITIALIZED</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="71.895%" class="whs6">
<p>NMS V5 library was not initialized with <span style="font-weight: bold;"><B><a href="nmsv5initialize.html">NMS_V5Initialize</a></B></span>.</p></td></tr>
</table><br>

<h4><a name=Details></a>Details</h4>

<p><span style="font-weight: bold;"><B>NMS_V5ProvisionStandByVariant</B></span>&nbsp;provisions 
 a standby variant for an existing interface. If a standby variant is already 
 defined for an interface, the initial standby interface is overwritten. 
 </p>

<p><span style="font-weight: bold;"><B>NMS_V5ProvisionStandByVariant</B></span> 
 fills in the internal standby configuration structure for a specified 
 interface. The NMS V5 library does not create HDLC channels and E1 links 
 for the standby variant or validate HDLC channel and E1 link locations 
 at provision time. If the standby configuration is invalid, a failure 
 occurs only when the application invokes <span style="font-weight: bold;"><B>NMS_V5SwitchOverVariantData</B></span>.</p>

<p>It is valid for the same HDLC channels and E1 links to be present in 
 the active and standby variants of the same interface. To change the configuration 
 of the standby variant, the application must call <span style="font-weight: bold;"><B>NMS_V5ProvisionStandByVariant</B></span> 
 again. </p>

<p>Applications must call <span style="font-weight: bold;"><B>NMS_V5ProvisionStandByVariant</B></span> 
 before calling <span style="font-weight: bold;"><B>NMS_V5SwitchOverVariantData</B></span>.</p>

<p>The application can include within the <span style="font-style: italic; font-weight: bold;"><I><B>e1_loc_array</B></I></span> 
 not only the E1 links carrying the HDLC channels, but also E1 links that 
 have voice channels only. E1 events are reported on all links in the list.</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_E1_LOCATION_T</font></span> 
 structure includes the following values: </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs13">
<td width="8.407%" class="whs14">
<p class="whs5">Field</p></td>
<td width="91.593%" class="whs14">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs15">
<td width="8.407%" class="whs14">
<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="91.593%" class="whs14">
<p>Logical board number where the E1 link is located (as defined by NMS 
 OAM).</p></td></tr>

<tr valign="top" class="whs15">
<td width="8.407%" class="whs14">
<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="91.593%" class="whs14">
<p>Logical trunk number associated with the E1 link (as defined by NMS 
 OAM).</p></td></tr>
</table><br>

<p>When defining an E1 status callback function, the application must specify 
 the following arguments: </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs13">
<td width="12.171%" class="whs14">
<p class="whs5">Argument</p></td>
<td width="87.829%" class="whs14">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs15">
<td width="12.171%" class="whs14">
<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 >interfaceId</font></span></p></td>
<td width="87.829%" class="whs14">
<p>Interface ID associated with the E1 link.</p></td></tr>

<tr valign="top" class="whs15">
<td width="12.171%" class="whs14">
<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 >e1_loc</font></span></p></td>
<td width="87.829%" class="whs14">
<p>E1 link location structure.</p></td></tr>

<tr valign="top" class="whs15">
<td width="12.171%" class="whs14">
<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 >status_event</font></span></p></td>
<td width="87.829%" class="whs14">
<p>E1 link event bit mask, which can combine <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 >status_event 
 </font></span>event masks.</p></td></tr>
</table><br>

<p>The status_event field returned by <span style="font-style: italic; font-weight: bold;"><I><B>e1_status_callback 
 </B></I></span>can combine any of the following values (which applications can 
 extract with the &amp; operator):</p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs13">
<td width="27.29%" class="whs14">
<p class="whs5">Value</p></td>
<td width="72.71%" class="whs14">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_LOS</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Loss of signal.</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_LOF</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Loss of frame.</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_AIS</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Alarm indication signal.</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_RAI</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Remote alarm indication signal.</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_CRC_BLOCK_ERR</font></span></p></td>
<td width="72.71%" class="whs14">
<p>CRC error.</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_CRC_BLOCK_INFO</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Remote CRC error (FEBE).</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_NORMAL_FRAMES_0</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Normal E1 frames (remote SA7 = 0).</p></td></tr>

<tr valign="top" class="whs15">
<td width="27.29%" class="whs14">
<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 >NMSV5_E1_NORMAL_FRAMES_1</font></span></p></td>
<td width="72.71%" class="whs14">
<p>Normal E1 frames (remote SA7 = 1).</p></td></tr>
</table><br>

<p>The NMS_V5_CHANNEL_LOCATION_T structure includes the following values: 
 </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs13">
<td width="13.864%" class="whs14">
<p class="whs5">Field</p></td>
<td width="86.136%" class="whs14">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs15">
<td width="13.864%" class="whs14">
<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="86.136%" class="whs14">
<p>Logical board number where an HDLC instance is located (as defined by 
 NMS OAM).</p></td></tr>

<tr valign="top" class="whs15">
<td width="13.864%" class="whs14">
<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="86.136%" class="whs14">
<p>Logical trunk number associated with the HDLC channel (as defined by 
 NMS OAM).</p></td></tr>

<tr valign="top" class="whs15">
<td width="13.864%" class="whs14">
<p>timeslotNb</p></td>
<td width="86.136%" class="whs14">
<p>Physical timeslot associated with the HDLC channel.</p></td></tr>
</table><br>

<p>When defining a <span style="font-style: italic; font-weight: bold;"><I><B>channel_callback</B></I></span> 
 function, the application must specify the following arguments: </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs13">
<td class="whs14">
<p class="whs5">Argument</p></td>
<td class="whs14">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >interfaceId</font></span></p></td>
<td class="whs14">
<p>Interface ID associated with the HDLC channel.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >channel_loc</font></span></p></td>
<td class="whs14">
<p>HDLC location structure.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >channel_event</font></span></p></td>
<td class="whs14">
<p>HDLC channel event value, as defined in the table that follows.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >databuffer</font></span></p></td>
<td class="whs14">
<p>A pointer to the buffer attached to the event. When the channel callback 
 function returns, the library assumes that the application finished processing 
 the <span style="font-weight: bold; font-style: italic;"><I><B>channel_rx_buffer</B></I></span>, 
 and the application can overwrite the buffer.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >datasize</font></span></p></td>
<td class="whs14">
<p>Size of the data saved in the buffer (0 if no data).</p></td></tr>
</table><br>

<p>The channel_event field of the <span style="font-style: italic; font-weight: bold;"><I><B>channel_callback</B></I></span> 
 function can contain the following values: </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs13">
<td class="whs14">
<p class="whs5">Value</p></td>
<td class="whs14">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_ABORT</font></span></p></td>
<td class="whs14">
<p>The HDLC interface received an ABORT sequence. No data is available 
 and no buffer is returned.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_BUFFER_OVERFLOW</font></span></p></td>
<td class="whs14">
<p>An internal HDLC receive buffer overflow occurred. The HDLC received 
 a frame of invalid length, and no data is available. No buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_CRC_ERROR</font></span></p></td>
<td class="whs14">
<p>The HDLC interface detected a bad CRC for the received frame. No data 
 is available and no buffer is returned.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_ERROR</font></span></p></td>
<td class="whs14">
<p>An internal HDLC receive error occurred. No data is available and no 
 buffer is returned.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_FIFO_OVERRUN</font></span></p></td>
<td class="whs14">
<p>The HDLC interface received a FIFO overrun. No data is available and 
 no buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_MAX_LENGTH_<br>
VIOLATION</font></span></p></td>
<td class="whs14">
<p>Not supported.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_NON_ALIGNED_OCTET</font></span></p></td>
<td class="whs14">
<p>The HDLC interface received an incomplete frame. No data is available 
 and no buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_RX_SUCCESS</font></span></p></td>
<td class="whs14">
<p>A new HDLC frame was received and is available inside <span style="font-style: italic; font-weight: bold;"><I><B>databuffer</B></I></span>. 
 <span style="font-style: italic; font-weight: bold;"><I><B>datasize</B></I></span> is 
 set to the frame size.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_TX_ERROR</font></span></p></td>
<td class="whs14">
<p>An internal HDLC transmit error occurred. No data is available and no 
 buffer is returned.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_TX_FIFO_OVERRUN</font></span></p></td>
<td class="whs14">
<p>An HDLC channel FIFO overrun occurred. No buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_TX_FIFO_UNDERRUN</font></span></p></td>
<td class="whs14">
<p>An HDLC transmit FIFO underrun occurred. No buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs15">
<td class="whs14">
<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 >NMSV5_EVENT_TX_QUEUE_FULL</font></span></p></td>
<td class="whs14">
<p>The HDLC transmit send queue is full. Under normal conditions this should 
 never occur. No buffer is returned.</p></td></tr>
</table><br>

<h4>See also</h4>

<p><a href="nmsv5destroystandbyvariant.html"><span style="color: #0000ff;
															font-style: normal;
															font-weight: bold;
															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=blue ><B>NMS_V5DestroyStandByVariant</B></font></span></a>, 
 <a href="nmsv5provisioninterface.html"><span style="color: #0000ff;
														font-style: normal;
														font-weight: bold;
														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=blue ><B>NMS_V5ProvisionInterface</B></font></span></a></p>

<h4>Example</h4>

<p class=Example>void&nbsp;&nbsp;ProvisionStandbyVariant(&nbsp;void&nbsp;)<br>
{<br>
&nbsp;&nbsp;&nbsp;&nbsp;NMS_V5_RESULT_T&nbsp;&nbsp;&nbsp;&nbsp;NmsResult;<br>
&nbsp;&nbsp;&nbsp;&nbsp;NMS_V5_INTERFACE&nbsp;&nbsp;&nbsp;NewInterface&nbsp;=&nbsp;{0};<br>
&nbsp;&nbsp;&nbsp;&nbsp;char&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Selection;<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;printf(&quot;NMS_V5ProvisionStandbyVariant:\n&quot;);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;/*&nbsp;Set&nbsp;parameters&nbsp;*/<br>
&nbsp;&nbsp;&nbsp;&nbsp;promptdw_nodft(&quot;Enter&nbsp;InterfaceId&quot;,&nbsp;&amp;NewInterface.InterfaceId);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.ChannelRxBufferSize&nbsp;=&nbsp;NMS_V5_RX_BUFFER_SIZE;<br>
&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.ChannelRxBuffer&nbsp;=&nbsp;calloc(&nbsp;&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.ChannelRxBufferSize,&nbsp;1&nbsp;);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;/*&nbsp;Add&nbsp;E1&nbsp;location&nbsp;parameters&nbsp;*/<br>
&nbsp;&nbsp;&nbsp; do<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;Selection&nbsp;=&nbsp;'y';<br>
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;promptchar(&quot;Add&nbsp;a&nbsp;new&nbsp;E1?&nbsp;(y/n)&quot;,&nbsp;&amp;Selection&nbsp;);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if(Selection&nbsp;==&nbsp;'y')<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;GetE1LocationNMS(&amp;NewInterface.NMS_E1s[NewInterface.NumE1s++]&nbsp;);&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br>
&nbsp;&nbsp; &nbsp;&nbsp;}<br>
&nbsp;&nbsp; &nbsp;&nbsp;while&nbsp;(Selection&nbsp;!=&nbsp;'n'&nbsp;&amp;&amp;&nbsp;NewInterface.NumE1s&nbsp;&lt;&nbsp;NMS_V5_E1_LOCATIONS);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp; /*&nbsp;Add&nbsp;channel&nbsp;parameters&nbsp;*/<br>
&nbsp;&nbsp;&nbsp;&nbsp; do<br>
&nbsp;&nbsp; &nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;Selection&nbsp;=&nbsp;'y';<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;promptchar(&quot;Add&nbsp;a&nbsp;new&nbsp;channel&nbsp;?&nbsp;(y/n)&quot;,&nbsp;&amp;Selection&nbsp;);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;if(Selection&nbsp;==&nbsp;'y')<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;GetChannelLocationNMS(<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&amp;NewInterface.NMS_Channels[NewInterface.NumChannels++]);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;}<br>
&nbsp;&nbsp; &nbsp;&nbsp;}<br>
&nbsp;&nbsp; &nbsp;&nbsp;while&nbsp;(Selection&nbsp;!=&nbsp;'n'&nbsp;&amp;&amp;&nbsp;NewInterface.NumChannels&nbsp;&lt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NMS_V5_CHANNEL_LOCATIONS);<br>
<br>
&nbsp;&nbsp;&nbsp; &nbsp;NmsResult&nbsp;=&nbsp;<span style="font-weight: bold;"><B>NMS_V5ProvisionStandbyVariant</B></span>&nbsp;(<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.InterfaceId,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.NumE1s,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.NMS_E1s,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;E1StatusCallBackFunction,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.NumChannels,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.NMS_Channels,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ChannelCallBackFunction,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.ChannelRxBuffer,&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NewInterface.ChannelRxBufferSize);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp; printf&nbsp;(&quot;NMS_V5ProvisionStandbyVariant:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Result=%s\n&quot;,PRINT_RESULT(NmsResult));<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp; if(&nbsp;NMSV5_SUCCESS&nbsp;!=&nbsp;NmsResult&nbsp;)<br>
&nbsp;&nbsp;&nbsp;&nbsp; {<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/*&nbsp;Discard&nbsp;bad&nbsp;interface&nbsp;configuration&nbsp;*/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;free(NewInterface.ChannelRxBuffer);&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp; }<br>
&nbsp;&nbsp;}</p>

<div placeholder id="footer" class="whs23">
 <p align="center" class="whs24">&nbsp;</p>
 <p align="center" class="whs24"><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="whs25">&#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>

