Caution using TioLoad in 5.6

A word of caution to anyone calling the “unsupported” TioLoad from a Tcl proc…

The TioLoad proc has been updated in 5.6 to recognize the master site, but not by default.  The calling format for the proc is:

  TioLoad recordID Tablename [SearchOption]

where the values for SearchOption are:

  Y – search only the root Tables directory

  M – search only the master site Tables directory

  B – search BOTH the site and root directories

  Anything else – search only the site Tables directory

The default is B.  Up until 5.6 that was great because it always found a table when the engine would find that same table.  Now you must use multiple calls (one with B or no option, and one with M) to be sure you find the table of interest.

I’m not sure why Cloverleaf chose to implement in this fashion.  We added an A SearchOption to search All (site, master & root) Tables directories.  If you are deep enough into Tcl to need this, it is pretty easy to add into $HCIROOT/tcl/lib/configIO.tlib.