شركة التطبيقات المتكاملة لتصميم النظم البرمجية الخاصة

Integrated Applications Programming Company

Skip Navigation LinksHome » Code Library » Administration

Public general use code classes and xml files that we've compiled and used over the years:

Administration support class for Next Generation Network (NGN) ui model.

   1:  using System;
   2:  using System.Collections.Generic;
   3:  using System.Data;
   4:  using System.Linq;
   5:  using System.Text;
   6:   
   7:  namespace Ia.Ngn.Cl.Model.Ui
   8:  {
   9:      ////////////////////////////////////////////////////////////////////////////
  10:   
  11:      /// <summary publish="true">
  12:      /// Administration support class for Next Generation Network (NGN) ui model.
  13:      /// </summary>
  14:      /// 
  15:      /// <remarks> 
  16:      /// Copyright © 2006-2017 Jasem Y. Al-Shamlan (info@ia.com.kw), Internet Applications - Kuwait. All Rights Reserved.
  17:      ///
  18:      /// This library is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
  19:      /// the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  20:      ///
  21:      /// This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
  22:      /// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  23:      /// 
  24:      /// You should have received a copy of the GNU General Public License along with this library. If not, see http://www.gnu.org/licenses.
  25:      /// 
  26:      /// Copyright notice: This notice may not be removed or altered from any source distribution.
  27:      /// </remarks> 
  28:      public class Administration
  29:      {
  30:          ////////////////////////////////////////////////////////////////////////////
  31:   
  32:          /// <summary>
  33:          ///
  34:          /// </summary>
  35:          public Administration() { }
  36:   
  37:          /////////////////////////////////////////////////////////////////////////////////
  38:   
  39:          /// <summary>
  40:          ///
  41:          /// </summary>
  42:          public static void EmailDailyOfnStatusReport(string name, string email, out Ia.Cl.Model.Result result)
  43:          {
  44:              //bool b;
  45:              string content, subject;
  46:              DateTime now;
  47:   
  48:              now = DateTime.UtcNow.AddHours(3);
  49:   
  50:              // subject can't have \r\n
  51:              subject = "Daily Optical Fiber Network (OFN) Status Report (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
  52:   
  53:              content = "Daily Optical Fiber Network (OFN) Status Report: " + now.ToString("yyyy-MM-dd HH:mm") + "\r\n"
  54:                  + "Status: undefined.\r\n"
  55:                  + @"For help send ""help"" in an email." + "\r\n";
  56:   
  57:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, content, out result);
  58:          }
  59:   
  60:          /////////////////////////////////////////////////////////////////////////////////
  61:   
  62:          /// <summary>
  63:          ///
  64:          /// </summary>
  65:          public static void EmailListWithOntListProvisionedAndReadyButDoNotExistInCustomerDepartmentDatabase(string name, string email, out Ia.Cl.Model.Result result)
  66:          {
  67:              //bool b;
  68:              string content, subject;
  69:              DataTable accessDataTable;
  70:              DateTime now;
  71:   
  72:              now = DateTime.UtcNow.AddHours(3);
  73:   
  74:              subject = "Table of latest 100 ONTs that are provisioned and ready within NGN access network but do not exist in the Customer Department's database (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
  75:   
  76:              accessDataTable = Ia.Ngn.Cl.Model.Ui.Access.ReadListWithOntListProvisionedAndReadyButDoNotExistInCustomerDepartmentDatabaseDataTable(100);
  77:   
  78:              content = "Table of latest 100 ONTs that are provisioned and ready within NGN access network but do not exist in the Customer Department's database (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
  79:   
  80:              content += "\r\n";
  81:              content += "\r\n";
  82:   
  83:              content += Ia.Cl.Model.Default.GenerateTabSeparatedTextFromDataTable(accessDataTable);
  84:   
  85:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, content, out result);
  86:          }
  87:   
  88:          /////////////////////////////////////////////////////////////////////////////////
  89:   
  90:          /// <summary>
  91:          ///
  92:          /// </summary>
  93:          public static void EmailStatistic(string name, string email, out Ia.Cl.Model.Result result)
  94:          {
  95:              //bool b;
  96:              string subject;
  97:              StringBuilder stringBuilder;
  98:              DateTime now;
  99:              List<Ia.Ngn.Cl.Model.Business.Administration.Statistic.Site> siteList;
 100:              List<Ia.Ngn.Cl.Model.Business.Administration.Statistic.KuwaitArea> serviceList;
 101:   
 102:              now = DateTime.UtcNow.AddHours(3);
 103:              stringBuilder = new StringBuilder();
 104:   
 105:              subject = "Statistics of Site, Access, and Service usage within the Optical Fiber Network (OFN) (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 106:   
 107:              siteList = Ia.Ngn.Cl.Model.Data.Administration.SiteStatistic;
 108:              serviceList = Ia.Ngn.Cl.Model.Data.Administration.ServiceAccessStatisticWithinKuwaitNgnArea;
 109:   
 110:              stringBuilder.AppendLine("Statistics of Site, Access, and Service usage within the Optical Fiber Network (OFN) (" + now.ToString("yyyy-MM-dd HH:mm") + ")");
 111:   
 112:              stringBuilder.AppendLine();
 113:              stringBuilder.AppendLine();
 114:   
 115:              foreach (var s in siteList)
 116:              {
 117:                  stringBuilder.AppendLine();
 118:                  stringBuilder.AppendLine(s.ToSimpleTextString());
 119:              }
 120:   
 121:              stringBuilder.AppendLine();
 122:              stringBuilder.AppendLine();
 123:   
 124:              foreach (var s in serviceList)
 125:              {
 126:                  stringBuilder.AppendLine();
 127:                  stringBuilder.AppendLine(s.ToSimpleTextString());
 128:              }
 129:   
 130:              stringBuilder.AppendLine();
 131:              stringBuilder.AppendLine();
 132:   
 133:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, stringBuilder.ToString(), out result);
 134:          }
 135:   
 136:          /////////////////////////////////////////////////////////////////////////////////
 137:   
 138:          /// <summary>
 139:          ///
 140:          /// </summary>
 141:          public static void EmailListOfNumberOfAgcfGatewayRecordInGroupOfMgcIp(string name, string email, out Ia.Cl.Model.Result result)
 142:          {
 143:              string content, subject;
 144:              Dictionary<string, int> dictionary;
 145:              DateTime now;
 146:   
 147:              now = DateTime.UtcNow.AddHours(3);
 148:   
 149:              subject = "List of the number of AGCF gateway records in groups of MGC IP (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 150:   
 151:              dictionary = Ia.Ngn.Cl.Model.Business.Nokia.Ims.NumberOfAgcfGatewayRecordInGroupOfMgcIpDictionary.OrderBy(u => u.Key).ToDictionary(u => u.Key, u => u.Value);
 152:   
 153:              content = "List of the number of AGCF gateway records in groups of MGC IP  (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 154:   
 155:              content += "\r\n";
 156:              content += "\r\n";
 157:   
 158:              content += Ia.Cl.Model.Default.GenerateTabSeparatedTextFromDictionary(dictionary);
 159:   
 160:              content += "\r\n";
 161:              content += "Total number of AGCF gateway records: " + dictionary.Sum(u => u.Value) + ". ";
 162:   
 163:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, content, out result);
 164:          }
 165:   
 166:          /////////////////////////////////////////////////////////////////////////////////
 167:   
 168:          /// <summary>
 169:          ///
 170:          /// </summary>
 171:          public static void EmailWeeklyOfnNokiaReport(string name, string email, out Ia.Cl.Model.Result result)
 172:          {
 173:              string content, subject;
 174:              DateTime now;
 175:              List<string> list;
 176:              SortedDictionary<string, int> sortedDictionary;
 177:   
 178:              now = DateTime.UtcNow.AddHours(3);
 179:   
 180:              // subject can't have \r\n
 181:              subject = "Weekly Optical Fiber Network (OFN) Nokia Report (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 182:   
 183:              content = "Weekly Optical Fiber Network (OFN) Nokia Report: " + now.ToString("yyyy-MM-dd HH:mm") + "\r\n"
 184:                  + "Status: Normal\r\n"
 185:                  + @"Please contact Jasem for any specific data that you may need on a weekly bases." + "\r\n";
 186:   
 187:              content += "\r\n";
 188:              content += "\r\n";
 189:   
 190:   
 191:              content += "List of the number of AGCF gateway records in groups of MGC IP: ";
 192:   
 193:              content += "\r\n";
 194:              content += "\r\n";
 195:   
 196:              sortedDictionary = new SortedDictionary<string, int>(Ia.Ngn.Cl.Model.Business.Nokia.Ims.NumberOfAgcfGatewayRecordInGroupOfMgcIpDictionary);
 197:   
 198:              content += Ia.Cl.Model.Default.GenerateTabSeparatedTextFromDictionary(sortedDictionary);
 199:   
 200:              content += "\r\n";
 201:              content += "\r\n";
 202:   
 203:   
 204:              content += "List of the number of AGCF gateway records in IMS pairs of MGC IP: ";
 205:   
 206:              content += "\r\n";
 207:              content += "\r\n";
 208:   
 209:              foreach (Ia.Ngn.Cl.Model.Business.Nokia.Ims.ImsBasicService imsBasicService in Ia.Ngn.Cl.Model.Business.Nokia.Ims.ImsBasicServiceList)
 210:              {
 211:                  content += imsBasicService.MgcIp + ", " + imsBasicService.MgcSecondaryIp + "\t" + (sortedDictionary[imsBasicService.MgcIp] + sortedDictionary[imsBasicService.MgcSecondaryIp]);
 212:                  content += "\r\n";
 213:              }
 214:   
 215:              content += "\r\n";
 216:              content += "\r\n";
 217:   
 218:   
 219:              content += "Number of Nokia subscribers per FSDB: ";
 220:   
 221:              content += "\r\n";
 222:              content += "\r\n";
 223:   
 224:              list = Ia.Ngn.Cl.Model.Business.Nokia.Ims.NumberOfNokiaSubsribersPerFsdb();
 225:   
 226:              content += string.Join("\r\n", list.ToArray());
 227:              content += "\r\n";
 228:   
 229:              content += "\r\n";
 230:              content += "\r\n";
 231:   
 232:   
 233:              content += "Service and access name list where subscriber's AlternateOtasRealm group number is not equal to subparties AssocOtasRealm group number: ";
 234:   
 235:              content += "\r\n";
 236:              content += "\r\n";
 237:   
 238:              list.Clear();
 239:   
 240:              foreach (var w in Ia.Ngn.Cl.Model.Data.Nokia.Ims.ServiceWhereSubscriberAlternateOtasRealmGroupNumberDoesNotEqualSubPartyAssocOtasRealmGroupNumberList())
 241:              {
 242:                  if (w.Access != null)
 243:                  {
 244:                      list.Add(w.Service + ": " + w.Access.Name);
 245:                  }
 246:                  else list.Add(w.Service + ": ");
 247:              }
 248:   
 249:              if (list.Count > 0)
 250:              {
 251:                  content += string.Join("\r\n", list.ToArray());
 252:              }
 253:              else content += "None";
 254:   
 255:              content += "\r\n";
 256:   
 257:              content += "\r\n";
 258:              content += "\r\n";
 259:   
 260:   
 261:              content += "AGCF gateway records within NDD ONT list with wrong secondary IP: ";
 262:   
 263:              content += "\r\n";
 264:              content += "\r\n";
 265:   
 266:              list.Clear();
 267:   
 268:              foreach (var w in Ia.Ngn.Cl.Model.Data.Nokia.Ims.AgcfGatewayRecordsWithinNddOntListWithWrongSecondaryIpList())
 269:              {
 270:                  list.Add(w.GwId.ToString());
 271:              }
 272:   
 273:              content += string.Join(", ", list.ToArray());
 274:   
 275:              content += "\r\n";
 276:              content += "\r\n";
 277:              content += "\r\n";
 278:   
 279:   
 280:              content += "SubParties' PrimaryPUIDCPEProfileNumber count distribution: ";
 281:   
 282:              content += "\r\n";
 283:              content += "\r\n";
 284:   
 285:              list.Clear();
 286:   
 287:              foreach (KeyValuePair<int, int> w in Ia.Ngn.Cl.Model.Data.Nokia.SubParty.PrimaryPuidCpeProfileNumberCountDistributionDictionary)
 288:              {
 289:                  list.Add(w.Key + "\t" + w.Value);
 290:              }
 291:   
 292:              content += string.Join("\r\n", list.ToArray());
 293:   
 294:              content += "\r\n";
 295:              content += "\r\n";
 296:   
 297:   
 298:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, content, out result);
 299:          }
 300:   
 301:          /////////////////////////////////////////////////////////////////////////////////
 302:   
 303:          /// <summary>
 304:          ///
 305:          /// </summary>
 306:          public static void EmailWeeklyOfnHuaweiReport(string name, string email, out Ia.Cl.Model.Result result)
 307:          {
 308:              string content, subject;
 309:              DateTime now;
 310:   
 311:              now = DateTime.UtcNow.AddHours(3);
 312:   
 313:              // subject can't have \r\n
 314:              subject = "Weekly Optical Fiber Network (OFN) Huawei Report (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 315:   
 316:              content = "Weekly Optical Fiber Network (OFN) Huawei Report: " + now.ToString("yyyy-MM-dd HH:mm") + "\r\n"
 317:                  + "Status:.\r\n"
 318:                  + @"Please contact Jasem for any specific data that you may need on a weekly bases." + "\r\n";
 319:   
 320:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, content, out result);
 321:          }
 322:   
 323:          /////////////////////////////////////////////////////////////////////////////////
 324:   
 325:          /// <summary>
 326:          ///
 327:          /// </summary>
 328:          public static void EmailListOfPstnToGponMigratedAndProvisionedServiceInAllowedToBeMigratedOlt(string name, string email, out Ia.Cl.Model.Result result)
 329:          {
 330:              string content, subject;
 331:              StringBuilder stringBuilder;
 332:              DateTime now;
 333:   
 334:              now = DateTime.UtcNow.AddHours(3);
 335:   
 336:              subject = "List of PSTN to GPON migrated and newly provisioned services in allowed to be migrated OLTs (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 337:   
 338:              content = "List of PSTN to GPON migrated and newly provisioned services in allowed to be migrated OLTs (" + now.ToString("yyyy-MM-dd HH:mm") + ")";
 339:   
 340:              content += "\r\n";
 341:              content += "\r\n";
 342:   
 343:              var dictionary = Ia.Ngn.Cl.Model.Data.Service.ServiceToOntRouterVendorInAllowedToBeMigratedOltDictionary;
 344:   
 345:              stringBuilder = new StringBuilder(dictionary.Count * 64);
 346:   
 347:              if (dictionary.Count > 0)
 348:              {
 349:                  stringBuilder.AppendLine("Services: ");
 350:                  stringBuilder.AppendLine(" ");
 351:   
 352:                  foreach (KeyValuePair<string, Ia.Ngn.Cl.Model.Business.NetworkDesignDocument.Vendor> kvp in dictionary)
 353:                  {
 354:                      stringBuilder.Append(kvp.Key + ", ");
 355:                  }
 356:              }
 357:   
 358:              content += stringBuilder.ToString().Trim();
 359:   
 360:              content += "\r\n";
 361:              content += "\r\n";
 362:   
 363:              Ia.Ngn.Cl.Model.Ui.Mail.SendPlainMail(name, email, subject, content, out result);
 364:          }
 365:   
 366:          ////////////////////////////////////////////////////////////////////////////    
 367:          ////////////////////////////////////////////////////////////////////////////    
 368:   
 369:          /// <summary>
 370:          /// 
 371:          /// </summary>
 372:          public static string FrameworkStructureDataTable()
 373:          {
 374:              string htmlTable;
 375:              List<Ia.Ngn.Cl.Model.Business.Administration.Framework> frameworkList;
 376:   
 377:              frameworkList = (from f in Ia.Ngn.Cl.Model.Data.Administration.FrameworkList where f.Type == "ministry" || f.Type == "supplier" select f).ToList();
 378:   
 379:              htmlTable = @"<div id=""framework-structure"">";
 380:   
 381:              foreach (Ia.Ngn.Cl.Model.Business.Administration.Framework framework in frameworkList)
 382:              {
 383:                  htmlTable += FrameworkStructureDataTableIteration(framework);
 384:              }
 385:   
 386:              htmlTable += "</div>";
 387:   
 388:              return htmlTable;
 389:          }
 390:   
 391:          ////////////////////////////////////////////////////////////////////////////    
 392:   
 393:          /// <summary>
 394:          /// 
 395:          /// </summary>
 396:          private static string FrameworkStructureDataTableIteration(Ia.Ngn.Cl.Model.Business.Administration.Framework framework)
 397:          {
 398:              string htmlTable;
 399:              Ia.Ngn.Cl.Model.Staff headStaff;
 400:              List<Ia.Ngn.Cl.Model.Staff> staffList;
 401:   
 402:              htmlTable = null;
 403:   
 404:              if (framework != null)
 405:              {
 406:                  headStaff = (from s in Ia.Ngn.Cl.Model.Data.Staff.List where s.Framework != null && s.Framework.Id == framework.Id && s.IsHead select s).SingleOrDefault();
 407:   
 408:                  htmlTable = "<table>";
 409:   
 410:                  if (framework.Children != null && framework.Children.Count > 0)
 411:                  {
 412:                      htmlTable += "<tr>";
 413:   
 414:                      htmlTable += @"<td class=""" + framework.Type + @""" colspan=""" + framework.Children.Count + @""">" + framework.ArabicName;
 415:                      if (headStaff != null) htmlTable += @"<span class=""head"">" + headStaff.FirstAndMiddleName + "</span>";
 416:                      htmlTable += @"</td>";
 417:   
 418:                      htmlTable += "</tr>";
 419:   
 420:                      htmlTable += "<tr>";
 421:   
 422:                      foreach (Ia.Ngn.Cl.Model.Business.Administration.Framework f in framework.Children)
 423:                      {
 424:                          htmlTable += @"<td class=""" + f.Type + @""">" + FrameworkStructureDataTableIteration(f) + "</td>";
 425:                      }
 426:   
 427:                      htmlTable += "</tr>";
 428:                  }
 429:                  else
 430:                  {
 431:                      staffList = (from s in Ia.Ngn.Cl.Model.Data.Staff.List where s.Framework != null && s.Framework.Id == framework.Id && !s.IsHead select s).ToList();
 432:   
 433:                      htmlTable += "<tr>";
 434:   
 435:                      htmlTable += @"<td class=""" + framework.Type + @""">" + framework.ArabicName;
 436:                      if (headStaff != null) htmlTable += @"<span class=""head"">" + headStaff.FirstAndMiddleName + "</span>";
 437:   
 438:                      foreach (Ia.Ngn.Cl.Model.Staff staff in staffList)
 439:                      {
 440:                          htmlTable += @"<span class=""staff"">" + staff.FirstAndMiddleName + "</span>";
 441:                      }
 442:   
 443:                      htmlTable += @"</td>";
 444:   
 445:                      htmlTable += "</tr>";
 446:                  }
 447:   
 448:                  htmlTable += "</table>";
 449:              }
 450:   
 451:              return htmlTable;
 452:          }
 453:   
 454:          /////////////////////////////////////////////////////////////////////////////////
 455:          /////////////////////////////////////////////////////////////////////////////////
 456:   
 457:          /// <summary>
 458:          ///
 459:          /// </summary>
 460:          public static void StatisticsListForTelegramBotApi(Ia.Ngn.Cl.Model.Business.Administration.Framework framework, string opcode, out string subject, out string content)
 461:          {
 462:              string inputType, horizontalRule;
 463:              StringBuilder stringBuilder;
 464:              DateTime now;
 465:   
 466:              inputType = string.Empty;
 467:              horizontalRule = " ";
 468:   
 469:              now = DateTime.UtcNow.AddHours(3);
 470:   
 471:              // subject can't have \r\n
 472:              subject = string.Empty; // "Optical Fiber Network (OFN) TNMD list: ";
 473:   
 474:              if (Ia.Ngn.Cl.Model.Business.Authority.FrameworkCanReadStatistics(framework))
 475:              {
 476:                  opcode = opcode.ToLower();
 477:   
 478:                  StatisticListForTelegramBotApiAndMailSimpleText(opcode, inputType, horizontalRule, out stringBuilder);
 479:   
 480:                  stringBuilder.AppendLine(horizontalRule);
 481:                  stringBuilder.AppendLine(Ia.Ngn.Cl.Model.Data.Help.Text(Ia.Ngn.Cl.Model.Data.Help.TelegramString.NeedHelpSendCommandSlashHelp));
 482:                  stringBuilder.AppendLine(horizontalRule);
 483:                  stringBuilder.AppendLine();
 484:   
 485:                  content = stringBuilder.ToString();
 486:              }
 487:              else
 488:              {
 489:                  content = "\r\n";
 490:                  content += "You are not authorized to modify this value. ";
 491:                  content += "\r\n";
 492:              }
 493:          }
 494:   
 495:          ////////////////////////////////////////////////////////////////////////////
 496:   
 497:          /// <summary>
 498:          ///
 499:          /// </summary>
 500:          public static void StatisticListForTelegramBotApiAndMailSimpleText(string opcode, string inputType, string horizontalRule, out StringBuilder contentStringBuilder)
 501:          {
 502:              StringBuilder stringBuilder;
 503:              DateTime now;
 504:              List<Ia.Ngn.Cl.Model.Business.Administration.Statistic.KuwaitArea> statisticList;
 505:   
 506:              stringBuilder = new StringBuilder();
 507:              now = DateTime.UtcNow.AddHours(3);
 508:   
 509:              //stringBuilder.AppendLine("Optical Fiber Network (OFN) Find Result: " + now.ToString("yyyy-MM-dd HH:mm"));
 510:   
 511:              //stringBuilder.AppendLine(@"Opcode: """ + opcode + @""".");
 512:              //responseContent += @"Operand: """ + operand + @"""." + "\r\n";
 513:              //stringBuilder.AppendLine();
 514:   
 515:              if (opcode.Contains("statistics"))
 516:              {
 517:                  statisticList = Ia.Ngn.Cl.Model.Data.Administration.ServiceAccessStatisticWithinKuwaitNgnAreaCachedDaily;
 518:   
 519:                  if (statisticList != null && statisticList.Count > 0)
 520:                  {
 521:                      stringBuilder.AppendLine(horizontalRule);
 522:                      stringBuilder.AppendLine("Statistics:");
 523:                      stringBuilder.AppendLine();
 524:                      foreach (var s in statisticList) stringBuilder.AppendLine(s.ToSimpleTextString());
 525:                      stringBuilder.AppendLine(horizontalRule);
 526:                      stringBuilder.AppendLine();
 527:                  }
 528:                  else
 529:                  {
 530:                      stringBuilder.AppendLine(horizontalRule);
 531:                      stringBuilder.AppendLine();
 532:                  }
 533:              }
 534:              else
 535:              {
 536:                  stringBuilder.AppendLine(horizontalRule);
 537:                  stringBuilder.AppendLine("Error: opcode: [" + opcode + "] is unrecognized. ");
 538:                  stringBuilder.AppendLine(horizontalRule);
 539:                  stringBuilder.AppendLine();
 540:              }
 541:   
 542:              contentStringBuilder = stringBuilder.Replace(Environment.NewLine + horizontalRule, horizontalRule);
 543:          }
 544:   
 545:          ////////////////////////////////////////////////////////////////////////////
 546:          ////////////////////////////////////////////////////////////////////////////    
 547:      }
 548:   
 549:      ////////////////////////////////////////////////////////////////////////////
 550:      ////////////////////////////////////////////////////////////////////////////   
 551:  }