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

<html>

<head>
<title>NaturalAccess GR303 and V5 Libraries Developer's Manual: NMS V5 library channel callback events </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 {   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.whs2 { background-color:#CCCCCC; x-cell-content-align:top; vertical-align:top; }
td.whs3 { vertical-align:top; padding-left:5px;  padding-right:5px;  }
p.whs4 { font-weight:bold; }
tr.whs5 { x-cell-content-align:top; vertical-align:top; }
table.whs6 {   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.whs7 { width:11.481%; }
col.whs8 { width:18.256%; }
col.whs9 { width:70.263%; }
div.whs10 { width:100%; }
p.whs11 { text-align:center; }
p.whs12 { 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.whs12 {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("Errors and events\nNMS V5 library channel callback events");
addAvenueInfo("Untitled","nms_v5_library_errors_.htm","nms_gr303_library_structures_.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>NMS 
 V5 library channel callback events</h1>

<p>This topic provides an <a href="#Alphabetical_channel_callback_event_summary">alphabetical</a> 
 and <a href="#Numerical_channel_callback_event_summary">numerical</a> 
 summary of the event messages that can be returned by NMS V5 library callback 
 functions.</p>

<h2><a name=Alphabetical_channel_callback_event_summary></a>Alphabetical 
 channel callback event summary</h2>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs2">
<td class="whs3">
<p class="whs4">Callback event</p></td>
<td class="whs3">
<p class="whs4">Hex</p></td>
<td class="whs3">
<p class="whs4">Decimal</p></td>
<td class="whs3">
<p class="whs4">Description</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x4</p></td>
<td class="whs3">
<p>4</p></td>
<td class="whs3">
<p>HDLC receive ABORT sequence. No data is available and no buffer is returned.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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_<br>
OVERFLOW</font></span></p></td>
<td class="whs3">
<p>0x7</p></td>
<td class="whs3">
<p>7</p></td>
<td class="whs3">
<p>An internal HDLC receive buffer overflow occurred. 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="whs5">
<td class="whs3">
<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="whs3">
<p>0x5</p></td>
<td class="whs3">
<p>5</p></td>
<td class="whs3">
<p>HDLC detected a bad CRC for a frame. No data is available and no buffer 
 is returned.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x2</p></td>
<td class="whs3">
<p>2</p></td>
<td class="whs3">
<p>An internal HDLC receive error occurred. No data is available and no 
 buffer is returned.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x3</p></td>
<td class="whs3">
<p>3</p></td>
<td class="whs3">
<p>HDLC receive 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="whs5">
<td class="whs3">
<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_<br>
OCTET</font></span></p></td>
<td class="whs3">
<p>0x6</p></td>
<td class="whs3">
<p>6</p></td>
<td class="whs3">
<p>The HDLC channel received a non-aligned 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="whs5">
<td class="whs3">
<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_NO_7E_FLAG</font></span></p></td>
<td class="whs3">
<p>0x8</p></td>
<td class="whs3">
<p>8</p></td>
<td class="whs3">
<p>Not supported.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x1</p></td>
<td class="whs3">
<p>1</p></td>
<td class="whs3">
<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<span 
 style="font-style: italic; font-weight: bold;"> <I><B></B></I></span>set to the frame 
 size.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x09</p></td>
<td class="whs3">
<p>9</p></td>
<td class="whs3">
<p>Internal HDLC transmit error occurred. No buffer is returned.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x0B</p></td>
<td class="whs3">
<p>11</p></td>
<td class="whs3">
<p>HDLC transmit FIFO overrun. No buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x0A</p></td>
<td class="whs3">
<p>10</p></td>
<td class="whs3">
<p>HDLC transmit FIFO underrun. No buffer is returned.</p>
<p>Not supported for CG 6100C or CG 6500C boards.</p></td></tr>

<tr valign="top" class="whs5">
<td class="whs3">
<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="whs3">
<p>0x0C</p></td>
<td class="whs3">
<p>12</p></td>
<td class="whs3">
<p>HDLC transmit send queue is full. Under normal conditions this should 
 never occur. No buffer is returned.</p></td></tr>
</table><br>

<h2><a name=Numerical_channel_callback_event_summary></a>Numerical channel 
 callback event summary</h2>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs2">
<td width="11.481%" class="whs3">
<p class="whs4">Hex</p></td>
<td width="18.256%" class="whs3">
<p class="whs4">Decimal</p></td>
<td width="70.263%" class="whs3">
<p class="whs4">Callback event</p></td></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x1</p></td>
<td width="18.256%" class="whs3">
<p>1</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x2</p></td>
<td width="18.256%" class="whs3">
<p>2</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x3</p></td>
<td width="18.256%" class="whs3">
<p>3</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x4</p></td>
<td width="18.256%" class="whs3">
<p>4</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x5</p></td>
<td width="18.256%" class="whs3">
<p>5</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x6</p></td>
<td width="18.256%" class="whs3">
<p>6</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x7</p></td>
<td width="18.256%" class="whs3">
<p>7</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0x9</p></td>
<td width="18.256%" class="whs3">
<p>8</p></td>
<td width="70.263%" class="whs3">
<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_NO_7E_FLAG</font></span></p></td></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0xB</p></td>
<td width="18.256%" class="whs3">
<p>9</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0xC</p></td>
<td width="18.256%" class="whs3">
<p>10</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0xD</p></td>
<td width="18.256%" class="whs3">
<p>11</p></td>
<td width="70.263%" class="whs3">
<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></tr>

<tr valign="top" class="whs5">
<td width="11.481%" class="whs3">
<p>0xE</p></td>
<td width="18.256%" class="whs3">
<p>12</p></td>
<td width="70.263%" class="whs3">
<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></tr>
</table><br>

<div placeholder id="footer" class="whs10">
 <p align="center" class="whs11">&nbsp;</p>
 <p align="center" class="whs11"><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="whs12">&#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>

