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

<html>

<head>
<title>NaturalAccess GR303 and V5 Libraries Developer's Manual: NMS_GR303GetDS1Status </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:14.787%; }
col.whs3 { width:85.213%; }
td.whs4 { width:14.787%; background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
p.whs5 { font-weight:bold; }
td.whs6 { width:85.213%; background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
td.whs7 { width:14.787%; background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
p.whs8 { font-style:italic; font-weight:bold; }
td.whs9 { width:85.213%; background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
col.whs10 { width:36.705%; }
col.whs11 { width:63.295%; }
td.whs12 { width:36.705%; background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
td.whs13 { width:63.295%; background-color:#CCCCCC; vertical-align:top;   padding-right:10px; padding-left:10px; }
td.whs14 { width:36.705%; background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
td.whs15 { width:63.295%; background-color:#ffffff; vertical-align:top;   padding-right:10px; padding-left:10px; }
table.whs16 {   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.whs17 { width:14.366%; }
col.whs18 { width:85.634%; }
tr.whs19 { background-color:#CCCCCC; x-cell-content-align:top; vertical-align:top; }
td.whs20 { vertical-align:top; padding-left:5px;  padding-right:5px;  }
tr.whs21 { x-cell-content-align:top; vertical-align:top; }
col.whs22 { width:13.363%; }
col.whs23 { width:86.637%; }
col.whs24 { width:10.874%; }
col.whs25 { width:27.437%; }
col.whs26 { width:61.689%; }
div.whs27 { width:100%; }
p.whs28 { text-align:center; }
p.whs29 { 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.whs29 {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 GR303 function reference\nNMS_GR303GetDS1Status");
addAvenueInfo("Untitled","nmsgr303getchannelstatistics.html","nmsgr303initialize.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_GR303GetDS1Status</h1>

<p>Retrieves DS1 link status information collected for a specified DS1 
 link. </p>

<h4>Prototype</h4>

<p>NMS_GR303_RESULT_T <span style="font-weight: bold;"><B>NMS_GR303GetDS1Status</B></span> 
 ( NMS_GR303_INTERFACE_ID_T <span style="font-style: italic; font-weight: bold;"><I><B>interfaceId</B></I></span>, 
 NMS_GR303_DS1_LOCATION_T <span style="font-style: italic; font-weight: bold;"><I><B>ds1_loc</B></I></span>, 
 NMS_GR303_DS1_STATUS_T <span style="font-style: italic; font-weight: bold;"><I><B>*ds1_status</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="14.787%" class="whs4">
<p class="whs5">Argument</p></td>
<td bgcolor="#CCCCCC" width="85.213%" class="whs6">
<p class="whs5">Description</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="14.787%" class="whs7">
<p class="whs8">interfaceId</p></td>
<td bgcolor="#FFFFFF" width="85.213%" class="whs9">
<p>Interface ID of a provisioned interface.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="14.787%" class="whs7">
<p class="whs8">ds1_loc</p></td>
<td bgcolor="#FFFFFF" width="85.213%" class="whs9">
<p>DS1 link for which the NMS GR303 library returns status information. 
 The DS1 location structure is defined as follows:</p>
<p class=Example>typedef&nbsp;union&nbsp;_NMS_GR303_DS1_LOCATION_T<br>
{<br>
&nbsp;&nbsp;&nbsp;&nbsp;struct&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;boardNb;<br>
&nbsp;&nbsp;&nbsp;&nbsp;DWORD&nbsp;trunkNb;<br>
&nbsp;&nbsp; &nbsp;}&nbsp;CG;<br>
}&nbsp;&nbsp;&nbsp;NMS_GR303_DS1_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="14.787%" class="whs7">
<p class="whs8">ds1_status</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="85.213%" class="whs9">
<p>Pointer to a buffer to receive the following status structure:</p>
<p class=Example>typedef&nbsp;struct&nbsp;{<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;Size;<br>
&nbsp;&nbsp;&nbsp;NMS_GR303_DS1_STATUSMASK_T&nbsp;StatusMask;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;Slips;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;Es;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;Ses;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;Uas;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;LineErrors;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;FrameErrors;<br>
&nbsp;&nbsp;&nbsp;DWORD&nbsp;ElaspedTime;<br>
}&nbsp;&nbsp;NMS_GR303_DS1_STATUS_T;</p>
<p>See the <a href="#Details">Details</a> section for field descriptions.</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="whs10">
<col class="whs11">

<tr>
<td bgcolor="#CCCCCC" width="36.705%" class="whs12">
<p class="whs5">Return value</p></td>
<td bgcolor="#CCCCCC" width="63.295%" class="whs13">
<p class="whs5">Description</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="36.705%" class="whs14">
<p>SUCCESS</p></td>
<td bgcolor="#FFFFFF" width="63.295%" class="whs15">
<p>&nbsp;</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="36.705%" class="whs14">
<p>NMSGR303_INTERNAL_FAILURE</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="63.295%" class="whs15">
<p>Internal failure. Refer to the trace log for more information.</p></td></tr>

<tr>
<td bgcolor="#FFFFFF" width="36.705%" class="whs14">
<p>NMSGR303_INVALID_DS1</p></td>
<td bgcolor="#FFFFFF" width="63.295%" class="whs15">
<p>Specified DS1 link has no HDLC channels provisioned on it.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="36.705%" class="whs14">
<p>NMSGR303_INVALID_INTERFACE_ID</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="63.295%" class="whs15">
<p>Specified interface is not provisioned.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="36.705%" class="whs14">
<p>NMSGR303_INVALID_PARMS</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="63.295%" class="whs15">
<p>Specified <span style="font-style: italic; font-weight: bold;"><I><B>ds1_status</B></I></span> 
 buffer pointer is NULL.</p></td></tr>

<tr>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="36.705%" class="whs14">
<p>NMSGR303_NOT_INITIALIZED</p></td>
<td colspan="1" rowspan="1" bgcolor="#FFFFFF" width="63.295%" class="whs15">
<p>NMS GR303 library was not initialized with <a href="nmsgr303initialize.html"><span 
 style="color: #0000ff;
		font-weight: bold;
		x-text-underline: off;
		/*begin!kadov{{*/ text-decoration: none; /*}}end!kadov*/ "><font color=blue ><B>NMS_GR303Initialize</B></font></span></a>.</p></td></tr>
</table><br>

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

<p><span style="font-weight: bold;"><B>NMS_GR303GetDS1Status</B></span>&nbsp;returns 
 status information associated with a specified DS1 link. For the NMS GR303 
 library to obtain the status information, the interface must be provisioned 
 (with <a href="nmsgr303provisioninterface.html"><span style="color: #0000ff;
	font-weight: bold;
	x-text-underline: off;
	/*begin!kadov{{*/ text-decoration: none; /*}}end!kadov*/ "><font color=blue ><B>NMS_GR303ProvisionInterface</B></font></span></a>) 
 and the DS1 link must contain at least one HDLC channel that was configured 
 on the specified interface. The application provides the following information 
 in the NMS_GR303_DS1_LOCATION_T structure:</p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs19">
<td width="14.366%" class="whs20">
<p class="whs5">Field</p></td>
<td width="85.634%" class="whs20">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs21">
<td width="14.366%" class="whs20">
<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.634%" class="whs20">
<p>Logical board number of the board where the DS1 link is located (as 
 defined by NMS OAM).</p></td></tr>

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

<p>The GR303 library returns link status information in a NMS_GR303_DS1_STATUS_T 
 structure that provides the following information: </p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs19">
<td width="13.363%" class="whs20">
<p class="whs5">Field</p></td>
<td width="86.637%" class="whs20">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<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 >Size</font></span></p></td>
<td width="86.637%" class="whs20">
<p>Size of the structure.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<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 >StatusMask</font></span></p></td>
<td width="86.637%" class="whs20">
<p>Current DS1 status bit mask. This can combine the following values:</p>
<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 >NMSGR303_DS1_LOS</font></span><br>
Loss of signal.</p>
<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 >NMSGR303_DS1_LOF</font></span><br>
Loss of frame.</p>
<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 >NMSGR303_DS1_AIS</font></span><br>
Alarm indication signal.</p>
<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 >NMSGR303_DS1_RAI</font></span><br>
Remote alarm indicator.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<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 >Slips</font></span></p></td>
<td width="86.637%" class="whs20">
<p>Number of slips.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<p>Es</p></td>
<td width="86.637%" class="whs20">
<p>Number of errored seconds.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<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 >Ses</font></span></p></td>
<td width="86.637%" class="whs20">
<p>Number of severely errored seconds.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<p>Uas</p></td>
<td width="86.637%" class="whs20">
<p>Number of unavailable seconds.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<p>LineErrors</p></td>
<td width="86.637%" class="whs20">
<p>Number of line code violations.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<p>FrameErrors</p></td>
<td width="86.637%" class="whs20">
<p>Number of frame bit errors and CRC errors.</p></td></tr>

<tr valign="top" class="whs21">
<td width="13.363%" class="whs20">
<p>ElaspedTime</p></td>
<td width="86.637%" class="whs20">
<p>Seconds since counters started, representing the duration of the observation 
 time (in seconds).</p>
<p class=Note><span style="font-weight: bold;"><B>Note:</B></span> All status 
 fields provide counts of particular events that occur during the ElaspedTime 
 interval.</p></td></tr>
</table><br>

<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 >ElaspedTime</font></span><span 
 style="color: #000000;
		font-style: italic;
		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=black ><I><B></B></I></font></span>parameter in 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_DS1_STATUS_T</font></span> 
 structure specifies the duration of the observation in seconds. All other 
 status information represents counters of particular events. These events 
 occur with an interval specified by <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 >ElaspedTime</font></span><span 
 style="color: #000000;
		font-style: italic;
		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=black ><I><B></B></I></font></span>parameter.</p>

<p>Applications can use the &amp; operator to extract bits in 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 >StatusMask</font></span> 
 parameter (in 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_DS1_STATUS_T</font></span> 
 structure) to find out the current DS1 link condition. The following bit 
 masks are defined:</p>

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

<tr bgcolor="#CCCCCC" valign="top" class="whs19">
<td width="10.874%" class="whs20">
<p class="whs5">Bit mask</p></td>
<td width="27.437%" class="whs20">
<p class="whs5">Definition</p></td>
<td width="61.689%" class="whs20">
<p class="whs5">Description</p></td></tr>

<tr valign="top" class="whs21">
<td width="10.874%" class="whs20">
<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 >0x1</font></span></p></td>
<td width="27.437%" class="whs20">
<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 >NMSGR303_DS1_LOS</font></span></p></td>
<td width="61.689%" class="whs20">
<p>Loss of signal.</p></td></tr>

<tr valign="top" class="whs21">
<td width="10.874%" class="whs20">
<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 >0x2</font></span></p></td>
<td width="27.437%" class="whs20">
<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 >NMSGR303_DS1_LOF</font></span></p></td>
<td width="61.689%" class="whs20">
<p>Loss of frame.</p></td></tr>

<tr valign="top" class="whs21">
<td width="10.874%" class="whs20">
<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 >0x4</font></span></p></td>
<td width="27.437%" class="whs20">
<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 >NMSGR303_DS1_AIS</font></span></p></td>
<td width="61.689%" class="whs20">
<p>Alarm indication signal.</p></td></tr>

<tr valign="top" class="whs21">
<td width="10.874%" class="whs20">
<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 >0x8</font></span></p></td>
<td width="27.437%" class="whs20">
<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 >NMSGR303_DS1_RAI</font></span></p></td>
<td width="61.689%" class="whs20">
<p>Remote alarm indication.</p></td></tr>
</table><br>

<h4>See also</h4>

<p><a href="nmsgr303getchannelstatistics.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_GR303GetChannelStatistics</B></font></span></a>, 
 <a href="nmsgr303resetds1status.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_GR303ResetDS1Status</B></font></span></a></p>

<h4>Example</h4>

<p class=Example>void&nbsp;&nbsp;GetDS1Status(&nbsp;void&nbsp;)<br>
{<br>
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;NMS_GR303_RESULT_T&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NmsResult;<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;DWORD&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;InterfaceId;<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;NMS_GR303_DS1_LOCATION_T&nbsp;&nbsp; DS1Location;<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;NMS_GR303_DS1_STATUS_T&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;DS1Status&nbsp;=&nbsp;{0};<br>
<br>
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; printf(&quot;NMS_GR303GetDS1Status:\n&quot;);<br>
<br>
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;/*&nbsp;Get&nbsp;parameters&nbsp;*/<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;promptdw_nodft(&quot;Enter&nbsp;interfaceId&quot;,&nbsp;&amp;InterfaceId);<br>
<br>
&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;printf(&quot;Enter&nbsp;DS1&nbsp;location:\n&quot;);<br>
<br>
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;GetDS1LocationNMS(&nbsp;&amp;DS1Location&nbsp;);<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;NmsResult&nbsp;=&nbsp;<span style="font-weight: bold;"><B>NMS_GR303GetDS1Status</B></span>(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;&nbsp;&nbsp;&nbsp;&nbsp;DS1Location,<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;&nbsp;&nbsp;&nbsp;&nbsp;&amp;DS1Status);<br>
<br>
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; printf&nbsp;(&quot;NMS_GR303GetDS1Status:<br>
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;Result=%s\n&quot;,PRINT_RESULT(NmsResult));<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;if&nbsp;(NmsResult&nbsp;==&nbsp;NMSGR303_SUCCESS)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;printf(&quot;StatusMask&nbsp;&nbsp;LOS=%i,&nbsp;LOF=%i&nbsp;AIS=%i&nbsp;RAI=%i\n&quot;,&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(DS1Status.StatusMask&nbsp;&amp;&nbsp;NMSGR303_DS1_LOS)&nbsp;?&nbsp;1&nbsp;:&nbsp;0),<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;((DS1Status.StatusMask&nbsp;&amp;&nbsp;NMSGR303_DS1_LOF)&nbsp;?&nbsp;1&nbsp;:&nbsp;0),<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;((DS1Status.StatusMask&nbsp;&amp;&nbsp;NMSGR303_DS1_AIS)&nbsp;?&nbsp;1&nbsp;:&nbsp;0),<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;((DS1Status.StatusMask&nbsp;&amp;&nbsp;NMSGR303_DS1_RAI)&nbsp;?&nbsp;1&nbsp;:&nbsp;0));<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;printf(&quot;Slips&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.Slips);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;printf(&quot;Es&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.Es);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;printf(&quot;Ses&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.Ses);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;printf(&quot;Uas&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.Uas);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;printf(&quot;LineErrors&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.LineErrors);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;printf(&quot;FrameErrors&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.FrameErrors);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;printf(&quot;ElaspedTime&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=%i\n&quot;,&nbsp;&nbsp;&nbsp;DS1Status.ElaspedTime);<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;}<br>
}</p>

<div placeholder id="footer" class="whs27">
 <p align="center" class="whs28">&nbsp;</p>
 <p align="center" class="whs28"><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="whs29">&#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>

