MEMory:STATe:NAME
MEMory:STATe:NAME
Syntax
MEMory:STATe:NAME <location>[,<name>]
MEMory:STATe:NAME? <location>
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 a number (0 through 5).
Parameters
Name Type Range of Values Default Value <location> Numeric An integer from 0 to 5 This is a required parameter. <name> Unquoted ASCII String A unquoted 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 "STATE1", "STATE2", and so on.
-
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.
-
The instrument generates an error 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 ("STATE1", "STATE2", 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 reads the name assigned to the specified storage location and returns a quoted ASCII string. If the specified location has no custom assigned, the default name is returned ("STATE1", "STATE2", etc.).
Examples
The following command assigns the name TEST_RACK_1 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"
See Also