MMEMory Subsystem - General Purpose File Management

The MMEMory subsystem's general purpose file management commands are listed below. The MMEMory subsystem also includes two other types of commands:

Commands and Queries

Folder and file formats

Many MMEMory commands refer to folders and files. These have specific structures, described below.

Format for a <folder>

The format for <folder> is "[[<drive>:]<path>]", where <drive> can be INTernal or USB, and <path> is a folder path, and <filespec> specifies a subset of files.
INTernal specifies the internal flash file system. USB specifies a front panel USB storage device.
If <drive> is specified, <path> is interpreted as an absolute folder path. Absolute paths begin with "\" or "/" and start at the root folder of <drive>.
If <drive> is omitted, <path> is relative to the folder specified by MMEMory:CDIRectory. Relative paths must NOT begin with \ or /.
Folder and file names cannot contain the following characters: \ / : * ? " < > |
The <folder> parameter cannot exceed 240 characters.
The specified folder must exist and cannot be marked as hidden or system. The exception is MMEMory:MDIRectory, which creates a folder. For MMEMory:MDIRectory, all folder levels above the new one must exist.

Format for a <file>

The format for a file name is "[[<drive>:]<path>]<file_name>", where <drive> can be INTernal or USB, and <path>is a folder path.
INTernal specifies the internal flash file system. USB specifies a front panel USB storage device.
If <drive> is specified, <path> is interpreted as an absolute folder path. Absolute paths begin with "\" or "/" and start at the root folder of <drive>.
If <drive> is omitted, <path> is relative to the folder specified by MMEMory:CDIRectory. Relative paths must NOT begin with \ or /.
Folder and file names cannot contain the following characters: \ / : * ? " < > |
The combination of folder and file name cannot exceed 240 characters.

MMEMory:CATalog[:ALL]? [<folder>[<filespec>]]

Returns a list of files in the specified folder.

Parameter	Typical Return
Any valid folder name; defaults to folder selected by MMEMory:CDIRectory	+1000000000,+327168572, "command.exe,,375808", "MyDCVMeas.sta,STAT,8192",MyData.csv,ASC,11265"
List all files in the folder MyData on the front panel USB storage device: MMEM:CAT? "USB:\MyData" List all state files in the root directory of internal memory: MMEM:CAT? "INT:\*.sta"

Parameter

Typical Return

Any valid folder name; defaults to folder selected by MMEMory:CDIRectory

+1000000000,+327168572,
"command.exe,,375808",
"MyDCVMeas.sta,STAT,8192",MyData.csv,ASC,11265"

List all files in the folder MyData on the front panel USB storage device:

MMEM:CAT? "USB:\MyData"

List all state files in the root directory of internal memory:

MMEM:CAT? "INT:\*.sta"

If <filespec> is omitted or is *.*, the command or query acts on all files. You can also use the * as a generic wildcard: *.sta, abc*.*, and so on.
The catalog takes the following form:

<mem_used>,<mem_free>{,"<file listing>"}

The instrument returns two numbers and a string for each file in the folder. The first number is the number of bytes used on the drive. The second indicates the number of bytes available. Each <file listing> is in the format "<file_name>,<file_type>,<file_size>" (including the quotation marks), where <file_name> is the name of the file including file extension, if any; <file_type> is either STAT for STATe (.sta) files, ASC for DATA (.csv) files, PREF for PREFerence (.prf) files, FOLD for folders, or null for all other file extensions; <file_size> is the file size in bytes.
If no files exist, only <mem_used>,<mem_free> is returned.
Because the instrument uses a small amount of space in the flash file system for internal use, the <mem_used> value is never zero.

MMEMory:CDIRectory <folder>
MMEMory:CDIRectory?
MMEMory:MDIRectory <folder>
MMEMory:RDIRectory <folder>

MMEMory:CDIRectory selects the default folder for MMEMory subsystem commands. This folder must exist and is used when folder or file names do not include a drive and folder name. They query returns the current default folder.

MMEMory:MDIRectory makes a new directory (folder) on the mass storage medium.

MMEMory:RDIRectory removes a directory (folder) on the mass storage medium.

Parameter	Typical Return
Any directory name, including the mass storage unit specifier. Default INT:\.	"INT:\BACKUP"
Make and remove a new directory named "test" on the internal mass memory system: MMEM:MDIR "test" MMEM:RDIR "test" Select the \BACKUP folder on the internal flash file system as the default folder: MMEM:CDIR "INT:\BACKUP" Return the default folder for MMEMory subsystem commands: MMEM:CDIR?

Parameter

Typical Return

Any directory name, including the mass storage unit specifier. Default INT:\.

"INT:\BACKUP"

Make and remove a new directory named "test" on the internal mass memory system:

MMEM:MDIR "test"
MMEM:RDIR "test"

Select the \BACKUP folder on the internal flash file system as the default folder:

MMEM:CDIR "INT:\BACKUP"

Return the default folder for MMEMory subsystem commands:

MMEM:CDIR?

This parameter is set to its default value after a Factory Reset (*RST) or Instrument Preset (SYSTem:PRESet).
You can only remove an empty folder. Otherwise, the instrument generates a "Directory not empty" error.

MMEMory:COPY <file1>,<file2>

Copies <file1> to <file2>. Each file name must include the file extension.

Parameter	Typical Return
Any valid file name (both files)	(none)
Copy state file from the root directory to the folder "Backup" on the internal flash file system: MMEM:COPY "INT:\MyVoltMeas.sta","INT:\Backup"

The source file and folder must exist and cannot be marked as hidden or system.
The destination folder must exist and cannot be marked as hidden or system.
If the destination file exists, it will be overwritten, unless marked as hidden or system.
To copy a file to a file of the same name in a different folder, specify just the <drive> and/or <path> for <destination>.

MMEMory:DELete {<file>|<filespec>}

Deletes a file. To delete a folder, use MMEMory:RDIRectory.

Parameter	Typical Return
Any valid file name, including file extension, or a <filespec>, as described below.	(none)
Delete a file from the root directory of the internal flash file system: MMEM:DEL "INT:\MySetup.sta"

A <filespec> may include the * as a wildcard character: *.bmp, *.sta, abc*.*, and so on.
The specified folder must exist and cannot be marked as hidden or system.
SYSTem:SECurity:IMMediate deletes and sanitizes all files.

MMEMory:MOVE <file1>,<file2>

Moves and/or renames <file1> to <file2>. Each file name must include the file extension.

Parameter	Typical Return
Any valid file name (both files)	(none)
Move the specified state file from the currently selected default directory to the folder "Backup" on the internal flash file system: MMEM:MOVE "MyVoltMeas.sta","INT:\Backup"

To rename a file, specify the same folder for <file1> and <file2>.
To move a file to a file of the same name in a different folder, you can specify just the <drive>:<path> for <file2>.