beautypg.com

Memory:state:name – RIGOL DG1000Z Series User Manual

Page 56

background image

RIGOL

Chapter 2 Command System

2-44

DG1000Z Programming Guide

:MEMory:STATe:NAME

Syntax

:MEMory:STATe:NAME {0|1|2|3|4|5|6|7|8|9}[,]

:MEMory:STATe:NAME? {0|1|2|3|4|5|6|7|8|9}

Description

Modify the filename of the state file stored in the specified storage location of the

internal non-volatile memory of the instrument.
Query the filename of the state file stored in the specified storage location of the

internal non-volatile memory of the instrument.

Parameter

Name

Type

Range

Default

{0|1|2|3|4|5|6|7|8|9}

Discrete

0|1|2|3|4|5|6|7|8|9

None

ASCII string

Refer to the

“Explanation”

NULL

Explanation

 The internal non-volatile memory of the instrument provides 10 state file storage

locations. The parameters 0 to 9 represent the state files in storage locations 1 to

10 respectively.

is the specified filename and cannot exceed 9 characters. It can

contain Chinese characters, English uppercase characters and numbers;

wherein, a Chinese character occupies 2 characters. If the parameter is omitted,

the filename is empty.

 This command is valid only when the specified storage location contains a state

file (

:MEMory:STATe:VALid?

).

Return Format

The query returns a string enclosed in double quotation marks, for example,

"123.RSF"; wherein, 123 is the filename and .RSF is the filename suffix of the state

file.

Example

:MEM:STAT:VAL? USER2 /*Query whether storage location 2 in the internal

non-volatile memory of the instrument contains a

state file and the query returns 1*/

:MEM:STAT:NAME 1,123 /* Modify the filename of the state file stored in storage

location 2 of the internal non-volatile memory of the

instrument to 123.RSF*/

:MEM:STAT:NAME? 1 /*Query the filename of the state file stored in storage

location 2 of the internal non-volatile memory of the

instrument and the query returns "123.RSF"*/

Related

Command

:MEMory:STATe:VALid?