MEMory:STATe:NAME
Syntax
MEMory:STATe:NAME {1|2|3|4|5} [,<name>]
MEMory:STATe:NAME? {1|2|3|4|5}
Description
This command assigns a name to the specified storage location. You can name a location from the front panel or over the remote interface but you can recall a named state only from the front panel. From the remote interface, you can only recall a stored state using the *RCL command with number (1 through 5).
Parameters
|
Name |
Type |
Range of Values |
Default Value |
|
<name> |
ASCII String |
A string of up to 12 characters. The first character must be a letter (A-Z), but the remaining 11 characters can be letters, numbers (0-9), or the underscore character ("_"). Blank spaces are not allowed. |
If omitted, the default name is used for the specified storage location. |
Remarks
When shipped from the factory, default names are assigned to storage locations 1 through 5. The default names are "STATE_1", "STATE_2", etc.
If you omit the <name> parameter, the default name is assigned to the specified storage location. This provides an easy way to reset the associated name to its factory default; however, the stored state is not deleted.
An error is generated if you specify a name with more than 12 characters.
Deleting the contents of a storage location (see MEMory:STATe:DELete command) will reset the associated name to its factory default ("STATE_1", "STATE_2", etc.).
A Factory Reset (*RST command) does not affect the configurations stored in memory. Once a state is stored, it remains until it is overwritten or specifically deleted.
Return Format
The query command reads the name assigned to the specified storage location and returns an ASCII string. If the specified location has no custom assigned, the default name is returned ("STATE_1", "STATE_2", etc.).
Examples
The following command assigns a name to storage location 1.
MEM:STAT:NAME 1,TEST_RACK_1
The following query returns the name assigned to storage location 1.
MEM:STAT:NAME? 1
Typical Response: TEST_RACK_1