src/surf/storage_n11.cpp

   1 #include "storage_n11.hpp"
   2 #include "surf_private.h"
   3
   4 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(surf_storage);
   5
   6 static int storage_selective_update = 0;
   7 static xbt_swag_t storage_running_action_set_that_does_not_need_being_checked = NULL;
   8
   9 /*************
  10  * CallBacks *
  11  *************/
  12
  13 static XBT_INLINE void routing_storage_type_free(void *r)
  14 {
  15   storage_type_t stype = (storage_type_t) r;
  16   free(stype->model);
  17   free(stype->type_id);
  18   free(stype->content);
  19   free(stype->content_type);
  20   xbt_dict_free(&(stype->properties));
  21   xbt_dict_free(&(stype->properties));
  22   free(stype);
  23 }
  24
  25 static XBT_INLINE void surf_storage_resource_free(void *r)
  26 {
  27   // specific to storage
  28   StoragePtr storage = dynamic_cast<StoragePtr>(static_cast<ResourcePtr>(r));
  29   // generic resource
  30   delete storage;
  31 }
  32
  33 static XBT_INLINE void routing_storage_host_free(void *r)
  34 {
  35   xbt_dynar_t dyn = (xbt_dynar_t) r;
  36   xbt_dynar_free(&dyn);
  37 }
  38
  39 static void parse_storage_init(sg_platf_storage_cbarg_t storage)
  40 {
  41   void* stype = xbt_lib_get_or_null(storage_type_lib,
  42                                     storage->type_id,
  43                                     ROUTING_STORAGE_TYPE_LEVEL);
  44   if(!stype) xbt_die("No storage type '%s'",storage->type_id);
  45
  46   // if storage content is not specified use the content of storage_type if exist
  47   if(!strcmp(storage->content,"") && strcmp(((storage_type_t) stype)->content,"")){
  48     storage->content = ((storage_type_t) stype)->content;
  49     storage->content_type = ((storage_type_t) stype)->content_type;
  50     XBT_DEBUG("For disk '%s' content is empty, inherit the content (of type %s) from storage type '%s' ",
  51         storage->id,((storage_type_t) stype)->content_type,
  52         ((storage_type_t) stype)->type_id);
  53   }
  54
  55   XBT_DEBUG("SURF storage create resource\n\t\tid '%s'\n\t\ttype '%s' "
  56       "\n\t\tmodel '%s' \n\t\tcontent '%s'\n\t\tcontent_type '%s' "
  57       "\n\t\tproperties '%p'\n",
  58       storage->id,
  59       ((storage_type_t) stype)->model,
  60       ((storage_type_t) stype)->type_id,
  61       storage->content,
  62       storage->content_type,
  63       ((storage_type_t) stype)->properties);
  64
  65   surf_storage_model->createResource(storage->id,
  66                                      ((storage_type_t) stype)->type_id,
  67                                      storage->content,
  68                                      storage->content_type,
  69                                      storage->properties);
  70 }
  71
  72 static void parse_mstorage_init(sg_platf_mstorage_cbarg_t /*mstorage*/)
  73 {
  74   XBT_DEBUG("parse_mstorage_init");
  75 }
  76
  77 static void parse_storage_type_init(sg_platf_storage_type_cbarg_t /*storagetype_*/)
  78 {
  79   XBT_DEBUG("parse_storage_type_init");
  80 }
  81
  82 static void parse_mount_init(sg_platf_mount_cbarg_t /*mount*/)
  83 {
  84   XBT_DEBUG("parse_mount_init");
  85 }
  86
  87 static void storage_parse_storage(sg_platf_storage_cbarg_t storage)
  88 {
  89   xbt_assert(!xbt_lib_get_or_null(storage_lib, storage->id,ROUTING_STORAGE_LEVEL),
  90                "Reading a storage, processing unit \"%s\" already exists", storage->id);
  91
  92   // Verification of an existing type_id
  93 #ifndef NDEBUG
  94   void* storage_type = xbt_lib_get_or_null(storage_type_lib, storage->type_id,ROUTING_STORAGE_TYPE_LEVEL);
  95 #endif
  96   xbt_assert(storage_type,"Reading a storage, type id \"%s\" does not exists", storage->type_id);
  97
  98   XBT_DEBUG("ROUTING Create a storage name '%s' with type_id '%s' and content '%s'",
  99       storage->id,
 100       storage->type_id,
 101       storage->content);
 102
 103   xbt_lib_set(storage_lib,
 104       storage->id,
 105       ROUTING_STORAGE_LEVEL,
 106       (void *) xbt_strdup(storage->type_id));
 107 }
 108
 109 static void storage_parse_storage_type(sg_platf_storage_type_cbarg_t storage_type)
 110 {
 111   xbt_assert(!xbt_lib_get_or_null(storage_type_lib, storage_type->id,ROUTING_STORAGE_TYPE_LEVEL),
 112                "Reading a storage type, processing unit \"%s\" already exists", storage_type->id);
 113
 114   storage_type_t stype = xbt_new0(s_storage_type_t, 1);
 115   stype->model = xbt_strdup(storage_type->model);
 116   stype->properties = storage_type->properties;
 117   stype->content = xbt_strdup(storage_type->content);
 118   stype->content_type = xbt_strdup(storage_type->content_type);
 119   stype->type_id = xbt_strdup(storage_type->id);
 120   stype->size = storage_type->size;
 121
 122   XBT_DEBUG("ROUTING Create a storage type id '%s' with model '%s', "
 123       "content '%s', and content_type '%s'",
 124       stype->type_id,
 125       stype->model,
 126       storage_type->content,
 127       storage_type->content_type);
 128
 129   xbt_lib_set(storage_type_lib,
 130       stype->type_id,
 131       ROUTING_STORAGE_TYPE_LEVEL,
 132       (void *) stype);
 133 }
 134
 135 static void storage_parse_mstorage(sg_platf_mstorage_cbarg_t /*mstorage*/)
 136 {
 137   THROW_UNIMPLEMENTED;
 138 //  mount_t mnt = xbt_new0(s_mount_t, 1);
 139 //  mnt->id = xbt_strdup(mstorage->type_id);
 140 //  mnt->name = xbt_strdup(mstorage->name);
 141 //
 142 //  if(!mount_list){
 143 //    XBT_DEBUG("Creata a Mount list for %s",A_surfxml_host_id);
 144 //    mount_list = xbt_dynar_new(sizeof(char *), NULL);
 145 //  }
 146 //  xbt_dynar_push(mount_list,(void *) mnt);
 147 //  free(mnt->id);
 148 //  free(mnt->name);
 149 //  xbt_free(mnt);
 150 //  XBT_DEBUG("ROUTING Mount a storage name '%s' with type_id '%s'",mstorage->name, mstorage->id);
 151 }
 152
 153 static void mount_free(void *p)
 154 {
 155   mount_t mnt = (mount_t) p;
 156   xbt_free(mnt->name);
 157 }
 158
 159 static void storage_parse_mount(sg_platf_mount_cbarg_t mount)
 160 {
 161   // Verification of an existing storage
 162 #ifndef NDEBUG
 163   void* storage = xbt_lib_get_or_null(storage_lib, mount->storageId, ROUTING_STORAGE_LEVEL);
 164 #endif
 165   xbt_assert(storage,"Disk id \"%s\" does not exists", mount->storageId);
 166
 167   XBT_DEBUG("ROUTING Mount '%s' on '%s'",mount->storageId, mount->name);
 168
 169   s_mount_t mnt;
 170   mnt.storage = surf_storage_resource_priv(surf_storage_resource_by_name(mount->storageId));
 171   mnt.name = xbt_strdup(mount->name);
 172
 173   if(!mount_list){
 174     XBT_DEBUG("Create a Mount list for %s",A_surfxml_host_id);
 175     mount_list = xbt_dynar_new(sizeof(s_mount_t), mount_free);
 176   }
 177   xbt_dynar_push(mount_list, &mnt);
 178 }
 179
 180 static void storage_define_callbacks()
 181 {
 182   sg_platf_storage_add_cb(parse_storage_init);
 183   sg_platf_storage_type_add_cb(parse_storage_type_init);
 184   sg_platf_mstorage_add_cb(parse_mstorage_init);
 185   sg_platf_mount_add_cb(parse_mount_init);
 186 }
 187
 188 void storage_register_callbacks() {
 189
 190   ROUTING_STORAGE_LEVEL = xbt_lib_add_level(storage_lib,xbt_free);
 191   ROUTING_STORAGE_HOST_LEVEL = xbt_lib_add_level(storage_lib, routing_storage_host_free);
 192   ROUTING_STORAGE_TYPE_LEVEL = xbt_lib_add_level(storage_type_lib, routing_storage_type_free);
 193   SURF_STORAGE_LEVEL = xbt_lib_add_level(storage_lib, surf_storage_resource_free);
 194
 195   sg_platf_storage_add_cb(storage_parse_storage);
 196   sg_platf_mstorage_add_cb(storage_parse_mstorage);
 197   sg_platf_storage_type_add_cb(storage_parse_storage_type);
 198   sg_platf_mount_add_cb(storage_parse_mount);
 199 }
 200
 201 /*********
 202  * Model *
 203  *********/
 204
 205 void surf_storage_model_init_default(void)
 206 {
 207   surf_storage_model = new StorageN11Model();
 208   storage_define_callbacks();
 209   xbt_dynar_push(model_list, &surf_storage_model);
 210 }
 211
 212 StorageN11Model::StorageN11Model() : StorageModel() {
 213   ActionPtr action = NULL;
 214
 215   XBT_DEBUG("surf_storage_model_init_internal");
 216
 217   storage_running_action_set_that_does_not_need_being_checked =
 218       xbt_swag_new(xbt_swag_offset(*action, p_stateHookup));
 219   if (!p_maxminSystem) {
 220     p_maxminSystem = lmm_system_new(storage_selective_update);
 221   }
 222 }
 223
 224 StorageN11Model::~StorageN11Model(){
 225   xbt_swag_free(storage_running_action_set_that_does_not_need_being_checked);
 226   storage_running_action_set_that_does_not_need_being_checked = NULL;
 227 }
 228
 229 StoragePtr StorageN11Model::createResource(const char* id, const char* type_id,
 230                 const char* content_name, const char* content_type, xbt_dict_t properties)
 231 {
 232
 233   xbt_assert(!surf_storage_resource_priv(surf_storage_resource_by_name(id)),
 234               "Storage '%s' declared several times in the platform file",
 235               id);
 236
 237   storage_type_t storage_type = (storage_type_t) xbt_lib_get_or_null(storage_type_lib, type_id,ROUTING_STORAGE_TYPE_LEVEL);
 238
 239   double Bread  = surf_parse_get_bandwidth((char*)xbt_dict_get(storage_type->properties, "Bread"));
 240   double Bwrite = surf_parse_get_bandwidth((char*)xbt_dict_get(storage_type->properties, "Bwrite"));
 241   double Bconnection   = surf_parse_get_bandwidth((char*)xbt_dict_get(storage_type->properties, "Bconnection"));
 242
 243   StoragePtr storage = new StorageN11Lmm(this, id, properties, p_maxminSystem,
 244                   Bread, Bwrite, Bconnection,
 245                   type_id, (char *)content_name, xbt_strdup(content_type), storage_type->size);
 246
 247   xbt_lib_set(storage_lib, id, SURF_STORAGE_LEVEL, static_cast<ResourcePtr>(storage));
 248
 249   XBT_DEBUG("SURF storage create resource\n\t\tid '%s'\n\t\ttype '%s'\n\t\tproperties '%p'\n\t\tBread '%f'\n",
 250       id,
 251       type_id,
 252       storage_type->properties,
 253       Bread);
 254
 255   if(!p_storageList)
 256         p_storageList = xbt_dynar_new(sizeof(char *),NULL);
 257   xbt_dynar_push(p_storageList, &storage);
 258
 259   return storage;
 260 }
 261
 262 double StorageN11Model::shareResources(double now)
 263 {
 264   XBT_DEBUG("storage_share_resources %f", now);
 265   unsigned int i, j;
 266   StoragePtr storage;
 267   void *_write_action;
 268   StorageActionLmmPtr write_action;
 269
 270   double min_completion = shareResourcesMaxMin(getRunningActionSet(),
 271       p_maxminSystem, lmm_solve);
 272
 273   double rate;
 274   // Foreach disk
 275   xbt_dynar_foreach(p_storageList,i,storage)
 276   {
 277     rate = 0;
 278     // Foreach write action on disk
 279     xbt_dynar_foreach(storage->p_writeActions, j, _write_action)
 280     {
 281       write_action = dynamic_cast<StorageActionLmmPtr>(static_cast<ActionPtr>(_write_action));
 282       rate += lmm_variable_getvalue(write_action->getVariable());
 283     }
 284     if(rate > 0)
 285       min_completion = MIN(min_completion, (storage->m_size-storage->m_usedSize)/rate);
 286   }
 287
 288   return min_completion;
 289 }
 290
 291 void StorageN11Model::updateActionsState(double /*now*/, double delta)
 292 {
 293   void *_action, *_next_action;
 294   StorageActionLmmPtr action = NULL;
 295
 296   xbt_swag_t actionSet = getRunningActionSet();
 297   xbt_swag_foreach_safe(_action, _next_action, actionSet) {
 298         action = dynamic_cast<StorageActionLmmPtr>(static_cast<ActionPtr>(_action));
 299     if(action->m_type == WRITE)
 300     {
 301       // Update the disk usage
 302      // Update the file size
 303      // For each action of type write
 304       double rate = lmm_variable_getvalue(action->getVariable());
 305       /* Hack to avoid rounding differences between x86 and x86_64
 306        * (note that the next sizes are of type sg_size_t). */
 307       long incr = delta * rate + MAXMIN_PRECISION;
 308       action->p_storage->m_usedSize += (incr - action->p_file->size); // disk usage
 309       action->p_file->size = incr; // file size
 310
 311       sg_size_t *psize = xbt_new(sg_size_t,1);
 312       *psize = action->p_file->size;
 313
 314       xbt_dict_t content_dict = action->p_storage->p_content;
 315       xbt_dict_set(content_dict, action->p_file->name, psize, NULL);
 316     }
 317
 318     action->updateRemains(lmm_variable_getvalue(action->getVariable()) * delta);
 319
 320     if (action->getMaxDuration() != NO_MAX_DURATION)
 321       action->updateMaxDuration(delta);
 322
 323     if(action->getRemains() > 0 &&
 324         lmm_get_variable_weight(action->getVariable()) > 0 &&
 325         action->p_storage->m_usedSize == action->p_storage->m_size)
 326     {
 327       action->finish();
 328       action->setState(SURF_ACTION_FAILED);
 329     } else if ((action->getRemains() <= 0) &&
 330         (lmm_get_variable_weight(action->getVariable()) > 0))
 331     {
 332       action->finish();
 333       action->setState(SURF_ACTION_DONE);
 334     } else if ((action->getMaxDuration() != NO_MAX_DURATION) &&
 335                (action->getMaxDuration() <= 0))
 336     {
 337       action->finish();
 338       action->setState(SURF_ACTION_DONE);
 339     }
 340   }
 341
 342   return;
 343 }
 344
 345 /************
 346  * Resource *
 347  ************/
 348
 349 StorageN11Lmm::StorageN11Lmm(StorageModelPtr model, const char* name, xbt_dict_t properties,
 350              lmm_system_t maxminSystem, double bread, double bwrite, double bconnection,
 351              const char* type_id, char *content_name, char *content_type, sg_size_t size)
 352  :  Resource(model, name, properties),
 353     StorageLmm(maxminSystem, bread, bwrite, bconnection, type_id, content_name, content_type, size) {
 354   XBT_DEBUG("Create resource with Bconnection '%f' Bread '%f' Bwrite '%f' and Size '%llu'", bconnection, bread, bwrite, size);
 355 }
 356
 357 StorageActionPtr StorageN11Lmm::ls(const char* path)
 358 {
 359   StorageActionLmmPtr action = new StorageN11ActionLmm(getModel(), 0, m_stateCurrent != SURF_RESOURCE_ON, this, LS);
 360
 361   action->p_lsDict = NULL;
 362   xbt_dict_t ls_dict = xbt_dict_new_homogeneous(xbt_free);
 363
 364   char* key;
 365   sg_size_t size = 0;
 366   xbt_dict_cursor_t cursor = NULL;
 367
 368   xbt_dynar_t dyn = NULL;
 369   char* file = NULL;
 370
 371   // for each file in the storage content
 372   xbt_dict_foreach(p_content,cursor,key,size){
 373     // Search if file start with the prefix 'path'
 374     if(xbt_str_start_with(key,path)){
 375       file = &key[strlen(path)];
 376
 377       // Split file with '/'
 378       dyn = xbt_str_split(file,"/");
 379       file = xbt_dynar_get_as(dyn,0,char*);
 380
 381       // file
 382       if(xbt_dynar_length(dyn) == 1){
 383         sg_size_t *psize = xbt_new(sg_size_t, 1);
 384         *psize=size;
 385         xbt_dict_set(ls_dict, file, psize, NULL);
 386       }
 387       // Directory
 388       else
 389       {
 390         // if directory does not exist yet in the dictionary
 391         if(!xbt_dict_get_or_null(ls_dict,file))
 392           xbt_dict_set(ls_dict,file,NULL,NULL);
 393       }
 394       xbt_dynar_free(&dyn);
 395     }
 396   }
 397
 398   action->p_lsDict = ls_dict;
 399   return action;
 400 }
 401
 402 StorageActionPtr StorageN11Lmm::open(const char* mount, const char* path)
 403 {
 404   XBT_DEBUG("\tOpen file '%s'",path);
 405   sg_size_t size, *psize;
 406   psize = (sg_size_t*) xbt_dict_get_or_null(p_content, path);
 407   // if file does not exist create an empty file
 408   if(psize)
 409     size = *psize;
 410   else {
 411         psize = xbt_new(sg_size_t,1);
 412     size = 0;
 413     *psize = size;
 414     xbt_dict_set(p_content, path, psize, NULL);
 415     XBT_DEBUG("File '%s' was not found, file created.",path);
 416   }
 417   surf_file_t file = xbt_new0(s_surf_file_t,1);
 418   file->name = xbt_strdup(path);
 419   file->size = size;
 420   file->mount = xbt_strdup(mount);
 421   file->current_position = 0;
 422
 423   StorageActionLmmPtr action = new StorageN11ActionLmm(getModel(), 0, m_stateCurrent != SURF_RESOURCE_ON, this, OPEN);
 424   action->p_file = file;
 425   return action;
 426 }
 427
 428 StorageActionPtr StorageN11Lmm::close(surf_file_t fd)
 429 {
 430   char *filename = fd->name;
 431   XBT_DEBUG("\tClose file '%s' size '%llu'", filename, fd->size);
 432   // unref write actions from storage
 433   void *_write_action;
 434   StorageActionLmmPtr write_action;
 435   unsigned int i;
 436   xbt_dynar_foreach(p_writeActions, i, _write_action) {
 437         write_action = dynamic_cast<StorageActionLmmPtr>(static_cast<ActionPtr>(_write_action));
 438     if ((write_action->p_file) == fd) {
 439       xbt_dynar_cursor_rm(p_writeActions, &i);
 440       write_action->unref();
 441     }
 442   }
 443   free(fd->name);
 444   free(fd->mount);
 445   xbt_free(fd);
 446   StorageActionLmmPtr action = new StorageN11ActionLmm(getModel(), 0, m_stateCurrent != SURF_RESOURCE_ON, this, CLOSE);
 447   return action;
 448 }
 449
 450 StorageActionPtr StorageN11Lmm::read(surf_file_t fd, sg_size_t size)
 451 {
 452   if(size > fd->size){
 453     size = fd->size;
 454     fd->current_position = fd->size;
 455   }
 456   else
 457         fd->current_position += size;
 458
 459   StorageActionLmmPtr action = new StorageN11ActionLmm(getModel(), size, m_stateCurrent != SURF_RESOURCE_ON, this, READ);
 460   return action;
 461 }
 462
 463 StorageActionPtr StorageN11Lmm::write(surf_file_t fd, sg_size_t size)
 464 {
 465   char *filename = fd->name;
 466   XBT_DEBUG("\tWrite file '%s' size '%llu/%llu'",filename,size,fd->size);
 467
 468   StorageActionLmmPtr action = new StorageN11ActionLmm(getModel(), size, m_stateCurrent != SURF_RESOURCE_ON, this, WRITE);
 469   action->p_file = fd;
 470   fd->current_position += size;
 471   // If the storage is full
 472   if(m_usedSize==m_size) {
 473     action->setState(SURF_ACTION_FAILED);
 474   }
 475   return action;
 476 }
 477
 478 void StorageN11Lmm::rename(const char *src, const char *dest)
 479 {
 480   sg_size_t *psize, *new_psize;
 481   psize = (sg_size_t*) xbt_dict_get_or_null(p_content,src);
 482   new_psize = xbt_new(sg_size_t, 1);
 483   *new_psize = *psize;
 484   if (psize){// src file exists
 485     xbt_dict_remove(p_content, src);
 486     xbt_dict_set(p_content, dest, new_psize,NULL);
 487     XBT_DEBUG("Change file name from %s to %s, size '%llu'",src, dest, *psize);
 488   }
 489   else
 490     XBT_DEBUG("File %s doesn't exist",src);
 491 }
 492
 493 xbt_dict_t StorageN11Lmm::getContent()
 494 {
 495   /* For the moment this action has no cost, but in the future we could take in account access latency of the disk */
 496   /*surf_action_t action = storage_action_execute(storage,0, LS);*/
 497
 498   xbt_dict_t content_dict = xbt_dict_new_homogeneous(NULL);
 499   xbt_dict_cursor_t cursor = NULL;
 500   char *file;
 501   sg_size_t *psize;
 502
 503   xbt_dict_foreach(p_content, cursor, file, psize){
 504     xbt_dict_set(content_dict,file,psize,NULL);
 505   }
 506   return content_dict;
 507 }
 508
 509 sg_size_t StorageN11Lmm::getSize(){
 510   return m_size;
 511 }
 512
 513 /**********
 514  * Action *
 515  **********/
 516
 517 StorageN11ActionLmm::StorageN11ActionLmm(ModelPtr model_, double cost, bool failed, StorageLmmPtr storage, e_surf_action_storage_type_t type)
 518   : Action(model_, cost, failed),
 519     StorageActionLmm(storage, type, lmm_variable_new(getModel()->getMaxminSystem(), this, 1.0, -1.0 , 3)) {
 520   XBT_IN("(%s,%g", storage->getName(), cost);
 521
 522   // Must be less than the max bandwidth for all actions
 523   lmm_expand(getModel()->getMaxminSystem(), storage->constraint(), getVariable(), 1.0);
 524   switch(type) {
 525   case OPEN:
 526   case CLOSE:
 527   case STAT:
 528   case LS:
 529     break;
 530   case READ:
 531     lmm_expand(getModel()->getMaxminSystem(), storage->p_constraintRead,
 532                    getVariable(), 1.0);
 533     break;
 534   case WRITE:
 535     lmm_expand(getModel()->getMaxminSystem(), storage->p_constraintWrite,
 536                    getVariable(), 1.0);
 537     ActionPtr action = this;
 538     xbt_dynar_push(storage->p_writeActions, &action);
 539     ref();
 540     break;
 541   }
 542   XBT_OUT();
 543 }
 544
 545 int StorageN11ActionLmm::unref()
 546 {
 547   m_refcount--;
 548   if (!m_refcount) {
 549     xbt_swag_remove(static_cast<ActionPtr>(this), p_stateSet);
 550     if (getVariable())
 551       lmm_variable_free(getModel()->getMaxminSystem(), getVariable());
 552 #ifdef HAVE_TRACING
 553     xbt_free(getCategory());
 554 #endif
 555     delete this;
 556     return 1;
 557   }
 558   return 0;
 559 }
 560
 561 void StorageN11ActionLmm::cancel()
 562 {
 563   setState(SURF_ACTION_FAILED);
 564   return;
 565 }
 566
 567 void StorageN11ActionLmm::suspend()
 568 {
 569   XBT_IN("(%p)", this);
 570   if (m_suspended != 2) {
 571     lmm_update_variable_weight(getModel()->getMaxminSystem(),
 572                                getVariable(),
 573                                0.0);
 574     m_suspended = 1;
 575   }
 576   XBT_OUT();
 577 }
 578
 579 void StorageN11ActionLmm::resume()
 580 {
 581   THROW_UNIMPLEMENTED;
 582 }
 583
 584 bool StorageN11ActionLmm::isSuspended()
 585 {
 586   return m_suspended == 1;
 587 }
 588
 589 void StorageN11ActionLmm::setMaxDuration(double /*duration*/)
 590 {
 591   THROW_UNIMPLEMENTED;
 592 }
 593
 594 void StorageN11ActionLmm::setPriority(double /*priority*/)
 595 {
 596   THROW_UNIMPLEMENTED;
 597 }
 598