Command Line Options

VM3 supports eight command line options: -control #, -delay, -map, -load, -save.

-control, -server, -port

These options allow the control of various controllers on different servers, ports and/or traces.

The -control option allows the usage of any controller that is properly mapped. The default control number is zero.

The -server option allows the usage of controllers located on different host and remote servers.

The -port option allows the usage of controllers using different port settings.

For instance:

To use VM3 with controller 1 on the host machine, type: vm3 -control 1
To use VM3 with controller 2 on a remote host named "Orion" using TCP/IP port number 5000, type: vm3 -control 2 -server Orion -port 5000

-delay
The -delay option determines how often the VM3 screen is refreshed. The default value is 10 milliseconds. Setting the delay to a smaller value will cause the screen to be updated more frequently. Setting the delay to 0 will update the screen as fast as possible, but will cause noticeable delay in other applications. Since most video monitors do not refresh more often than every 10 milliseconds, there is usually no advantage gained by lowering the delay. For example, the command:

vm3 -delay msec (8)

will cause the screen to refresh every 8 milliseconds.

-map
The -map option allows the loading of an alternative map file. For example, the command:

vm3 -map myfile.map

will cause VM3 to use the file "myfile.map" instead of using the default map file. The default map file is XmpNNN.map where NNN is the firmware version number.

-load
The -load option causes VM3 to browse the firmware memory images from a file. Only the MEIXmpData{} and MEIXmpBufferData{} structures are loaded. This feature works in conjunction with the -save option. For example, the command:

vm3 -load Xmpdump.bin

will load the previously saved "Xmpdump.bin" file for viewing.

-save
The -save option specifies the name to be used for saving memory images when F8 is pressed. The -save option does not need to be specified to save memory images when F8 is pressed. The default is "Xmpdump.bin." For example, the command:

vm3 -save dump1.bin

will save the memory images to the "dump1.bin" file. Memory images will continue to be saved to this file when F8 is pressed for the remainder of the session.