SYSTem:LOG

Last Updated: August 29, 2007

These commands are used for remote UI logging.

For more information on the conventions used in the programming examples click here.

SYSTem:LOG:UI:REMote[:STATe][?]

Sets/queries the remote UI logging state. Turning the remote UI logging state ON or OFF does not change the contents of the remote UI log. When the state is ON, all remote SCPI messages are added to an internal queue. If the queue is full, the oldest item is removed from the queue. The queue size is 1000 entries. Each entry can be an arbitrary number of characters.

Setting Range: 0 | OFF | 1 | ON

Query Range: 0 | 1

*RST Setting: no effect

Test Set Requirements: E6601A WCTS Program Version A.03 and above

Example:

' Set the remote UI logging state on.

TestSet.WriteString("SYSTem:LOG:UI:REMote 1")

SYSTem:LOG:UI:REMote:CLEar

Clears the current remote UI log contents and the displayed log. This command itself is not logged, therefore after processing this command the log is left empty.

Test Set Requirements: E6601A WCTS Program Version A.03 and above

Example:

' Clear the remote UI log.

TestSet.WriteString("SYSTem:LOG:UI:REMote:CLEar")

SYSTem:LOG:UI:REMote:COUNt?

Queries the number of entries in the current remote UI log.

Query Range: <nr1>

*RST Setting: 0

Test Set Requirements: E6601A WCTS Program Version A.03 and above

Example:

' Query the number of entries in the remote UI log.

TestSet.WriteString("SYSTem:LOG:UI:REMote:COUNt?")

SYSTem:LOG:UI:REMote:DIRectory[:CURRent]?

Queries the details of the current save and load file path. The default directory is D:\E6601A_WCTS\<program version>\Remote UI Logs. This default directory is set when the test set is turned on.

Query Range: <string> representing the file path

*RST Setting: no effect

Test Set Requirements: E6601A WCTS Program Version A.03 and above

Example:

' Query the file path of the current save/load.

TestSet.WriteString("SYSTem:LOG:UI:REMote:DIRectory?")

SYSTem:LOG:UI:REMote:DISPlay:REFResh

Sets the current remote UI log contents to be displayed on the test set's screen.

Test Set Requirements: E6601A WCTS Program Version A.03 and above

Example:

' Refresh the remote UI log displayed on the screen.

TestSet.WriteString("SYSTem:LOG:UI:REMote:DISPlay:REFResh")

SYSTem:LOG:UI:REMote:DISPlay:RTIMe[?]

Sets/queries the state of the real time display.

Turning the real time display:

Setting Range: 0 | OFF | 1 | ON

Query Range: 0 | 1

*RST Setting: no effect

Test Set Requirements: E6601A WCTS Program Version A.03 and above

Example:

' Set the real time display to the remote UI log.

TestSet.WriteString("SYSTem:LOG:UI:REMote:DISPlay:RTIMe ON")

SYSTem:LOG:UI:REMote:LOAD

Loads the contents of a previously saved log into the remote UI log queue, replacing any current content. The default directory is D:\E6601A_WCTS\<program version>\Remote UI Logs. This default directory is set when the test set is turned on.

Setting Range: An absolute path (a path starting with a '\' or a drive designator) or a file name. The file name must contain the .csv suffix.  

*RST Setting: no effect

Test Set Requirements: E6601A WCTS Program Version A.03 and above; A.04 changed default directory from drive C to drive D

Example:

' Load the specified file into the log queue.

TestSet.WriteString("SYSTem:LOG:UI:REMote:LOAD "D:\E6601A_WCTS\A.02.10\Remote UI Logs\test.csv"")

SYSTem:LOG:UI:REMote:SAVE

Saves the current remote UI log contents to a file you specify.

Each log entry is saved as five strings and formatted as a standard Comma Separated File (.csv file extension), which can be imported into Microsoft Excel® if required.

The default directory is D:\E6601A_WCTS\<program version>\Remote UI Logs. This default directory is set when the test set is turned on.

Setting Range: An absolute path (a path starting with a '\' or a drive designator) or a file name. The file name must contain the .csv suffix.

*RST Setting: no effect

Test Set Requirements: E6601A WCTS Program Version A.03 and above; A.04 changed default directory from drive C to drive D

Example:

' Save the current remote UI log.

TestSet.WriteString("SYSTem:LOG:UI:REMote:SAVE "D:\E6601A_WCTS\A.02.10\Remote UI Logs\test.csv"")