JWAVE User Guide > JWAVE Wrapper API > DMRenameData Procedure
  

DMRenameData Procedure
Renames a dataset stored in the current PV‑WAVE session.
Usage
DMRenameData, data_name, new_var_name
Input Parameters
data_name—A scalar string containing a data name (in the default domain, $GLOBAL) or a 2-element string array containing a domain name and data name of the data you wish to rename.
new_var_name—A string containing a new variable name.
Discussion
This function cannot be used to move data to a new domain. Only the name of the data can be changed.
The original data_name data no longer exists after this function is called.
Storage for the domain and data are automatically created if they do not already exist. If data with the new_var_name already exists, it is overwritten. The data name and domain name are used to uniquely identify a dataset stored on the JWAVE server. Normally, these names are set in the JWAVE client application.
To be valid, the data_name input parameter name must begin with a letter. The name is not case-sensitive, and may contain letters, underscores, and numbers.
Examples
This command renames (moves) the data named STUFF from the default domain ($GLOBAL) and gives it a new name of NEW_STUFF (in the same domain).
DMRenameData,  ['$GLOBAL', 'STUFF' ], 'NEW_STUFF'
See Also
DMCopyData, DMDataExists, DMEnumerateData, DMGetData, DMInit, DMRemoveData, DMStoreData

Version 3.6
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.