:DISK:FILE:SIZE?

Instrument:
N1000A
DCA-M
Meas. mode:
Scope
Eye
Jitter
TDR
Flex Apps:
FlexDCA
FlexRT

Query Syntax

:DISK:FILE:SIZE? "filename"

Description

Returns the size of a file in bytes. To determine if a file exists, use the :DISK:FILE:EXISTs? query. If file does not exists, 0 is returned. To return a time stamp for the file, use the :DISK:FILE:TIMestamp? query.

Path Substitution Strings

Use FlexDCA's Path Substitution Stings in you file names to eliminate the need to enter long path strings. For security reasons, this command only allows the %USER_DATA_DIR% and %TEMP_DIR% path substitution strings to be used. All other path substitution strings will result in a failed query with a –258, Media protected. error code.

Security Restrictions

Starting with FlexDCA revision A.07.90, file I/O security was increased when reading or writing files using the :DISK:FILE commands. FlexDCA no longer permits arbitrary file types, arbitrary folder access, or reading and writing to network share drives. The following "Valid File Types" and "Standard FlexDCA Directories" tables identify the type of files and location that you can read or write using the :DISK:FILE commands.

Sending a :DISK:FILE:SIZE command that specifies a network share drive, a restricted directory, or with a restricted file name results in –258, Media protected. error code.

You can use the :DISK:FILE:SIZE? query to determine the size of a file of the type and format marked in the following table exists.

Valid File Types
Description File Name
Extension
Adapter definitions xml
Color-Grade Gray Scale (CGGS) waveform database for channel or CGGS Memory. csv
cgsx
Documentation Wizard file. zip
Eye Mode mask file. The preferred file name extension is .mskx. mskx
Graphics files. For example, images of screen. bmp, gif, jpeg, jpg, png, tiff
Instrument Report is an XPS (XML Paper Specification) file. XPS files can be viewed using Microsoft's XPS Viewer application. xps
Jitter database jdx
Jitter Spectrum Analysis (JSA) data jsax
License file to enable features for FlexDCA. lic
Limit line file lltx
Limit test summary file sum
Log files log
SCPI command file to run when FlexDCA's Multipurpose button is clicked. scpi
Presets files save settings for various FlexDCA features that can be re-imported to setup the feature. For example, for the TDECQ Reference Equalizer function's Reference Rx preset. xml
S-parameters Touchstone or Citifile (.cti, .cit) formatted files. For single-ended devices with one port, the preferred Touchstone file name extension is .s1p, but .txt can also be used. s1p, s2p, s4p, s8p, s12p, s16p, cti, cit, ts, txt
Instrument Setup file for saving and recalling the current overall state of FlexDCA. setx
TDR/TDT calibration file tdrx
TDR De-embedding networks tf2, tf4
Waveform file (channels, Diff channels, waveform memories, etc.)
Waveform file (internal) wfmx
Waveform file (Y-values) txt
Waveform file (XY-values) txt
Pattern file csv
Pattern file (internal) wfmx
Waveform file (VSA format). VSA Waveform Recording files are ASCII files that you can import into Keysight's 89600 VSA and WLA software. Two file types include comma separated values (.csv) Tab separated values. VSA files are available to save when Pattern Lock and Acquire Entire Pattern are on. csv
txt
Pattern file from a BERT instrument which can be imported into FlexDCA. ptrn
Waveform file (Mask Limit Waveform). Reporting action for limit test.
Pattern waveform .csv
Pattern waveform (Internal) .wfmx

When using the :DISK:FILE commands, files can only be read from or written to the directories that are listed in the following two tables. This includes any sub-directories that are in the listed directories. The first table lists FlexDCA's standard directories. The second table lists folders that are not typically used but are available for you to read and write to.

Standard FlexDCA Directories
Drive/Directory FlexDCA Installed On
N1000A Windows PC
Without OneDrive With OneDrive
C:\Users\user-name\Documents\Keysight\FlexDCA  
C:\Users\user-name\Documents\Keysight    
C:\Users\user-name\OneDrive - Keysight Technologies\Documents\Keysight\FlexDCA    
D:\User Files    
Additional Non-Standard FlexDCA Directories
Drive/Directory FlexDCA Installed On
N1000A Windows PC
C:\Temp
C:\Keysight  
C:\ProgramData\Keysight\FlexDCA
C:\Users\user-name\AppData\Local\Keysight\FlexDCA
C:\Users\user-name\AppData\Local\Temp
C:\Users\user-name\AppData\Local\Temp\Keysight\FlexDCA

Requires FlexDCA revision A.05.30 and above. FlexDCA revision A.07.90 increases file I/O security.

Example

This Python script (with PyVISA) tests if a specific screen image file exists and returns its size in bytes.

# -*- coding: utf-8 -*-
"""
Checks is file exists and returns its size in bytes.
"""
import visa

rm = visa.ResourceManager('C:\\Program Files (x86)\\IVI Foundation\\VISA\\WinNT\\agvisa\\agbin\\visa32.dll')
FlexDCA = rm.open_resource("TCPIP0::localhost::hislip0::INSTR")

#Set Timeout - 10 seconds
FlexDCA.timeout =  10000
FlexDCA.read_termination = '\n'

filePath = '"%USER_DATA_DIR%\\Screen Images\\screenimage.png"'
if FlexDCA.query(':DISK:FILE:EXISts? ' + filePath) == '1':
    print('File exists!')
    size = FlexDCA.query(':DISK:FILE:SIZE? ' + filePath)
    print('File is ' + size + ' bytes')
else:
    print('File not found.')
FlexDCA.write(':SYSTem:GTLocal')
FlexDCA.close()