Documentation

Save a connection's tspec to disk.

Writes out the tspec file that is associated with a connection. You only need to do this if you have changed a tspec file entry or if you are creating a new dataset (write mode) and no tspec file currently exists, e.g.

1. changing an entry: do a tspec = (Pyramid *) tsmGet( c, TSM_DATASET_TSPEC ) call, change something in tspec, then call this function.
2. creating new tspec: associate a Pyramid structure with the connection with either tsmSetTspecField or tsmCopyTspecField, then call this function.

If you are writing the tspec to a DPSS, then currently we only write the file to a block on the DPSS itself. We don't update any metadata URL files. This also means that you should only use this function to write tspecs to a DPSS for sets that were written using the tsmApi (because it will always allocate an extra block for the tspec).

N.B. the tsmConnect call will automatically read in a tspec for a dataset if it exists.