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, MInit, DMRemoveData, DMStoreData