Ixia EE11ABG 802.11 a/b/g Emulation Engine User Manual EmulationEngine 11a b g User s Guide

Ixia 802.11 a/b/g Emulation Engine EmulationEngine 11a b g User s Guide

Contents

User Manual 2 of 3

Download: Ixia EE11ABG 802.11 a/b/g Emulation Engine User Manual EmulationEngine 11a b g User s Guide
Mirror Download [FCC.gov]Ixia EE11ABG 802.11 a/b/g Emulation Engine User Manual EmulationEngine 11a b g User s Guide
Document ID352252
Application IDG2qN3XPLiNvQvbxJL/Y3XQ==
Document DescriptionUser Manual 2 of 3
Short Term ConfidentialNo
Permanent ConfidentialNo
SupercedeNo
Document TypeUser Manual
Display FormatAdobe Acrobat PDF - pdf
Filesize327.38kB (4092253 bits)
Date Submitted2003-08-29 00:00:00
Date Available2003-08-29 00:00:00
Creation Date2003-07-17 22:47:53
Producing SoftwareAcrobat Distiller 5.0 (Windows)
Document Lastmod2003-08-22 14:53:05
Document TitleEmulationEngine 11a/b/g User's Guide
Document CreatorAcrobat PDFMaker 5.0 for Word
Document Author: CMC

EmulationEngine 11a/b/g User's Guide
CHAPTER 6:
The Command Line Interface (CLI)
The CLI can be used to display and modify the configuration of the
EmulationEngine from a PC that is connected via Telnet or the
serial port. The CLI also includes commands to configure and run
virtual stations, display statistics, and to access the System Under
Test. The EmulationEngine maintains statistics and event log files
that you can configure and display using CLI commands.
CLI Usage Notes
1) CLI commands are not case sensitive (e.g., "set Date" is the
same as "set date").
2) You do not need to enter the entire command string to execute
a command. Only the number of unique characters required to
identify the command are needed (e.g., "se da" will execute the "set
date" command because there are no other CLI commands that
begin with “se” and no other set objects that begin with "da").
3) Some parameters can be assigned very large values in the
range: 0...2,147,483,647. Do not enter commas (,) for values larger
than 999 (e.g., use 1000 rather than 1,000).
4) It is very important to keep a printed record of configuration
parameters. See "Configuration Records" in Chapter 9.
User Log-In
The EE login prompt is displayed after you successfully establish
a connection to the EmulationEngine. See “Initial Setup” in
Chapter 4. When you have successfully established this
connection, the CLI prompts you to enter a log in name and
password.
EE login: Admin
Password: **
The default log in user name is "Admin". The default password is
"EE". Both entries are case sensitive (i.e., the default user name is
"Admin", not "admin"). After you enter a valid user name and
password, the CLI displays a version banner, the current system
time and status, and a CLI prompt.
Communication Machinery Corporation
EmulationEngine(tm) 11a/b/g Rev 2.0.0
System date & time is THU JAN 01 00:00:44 1970
Use the "set date" or "set time" command to adjust
EmulationEngine 11a/b/g software version 2.0.0
WLAN mode .................... 802.11b
WLAN MAC address ............. 00:0b:cd:59:23:57
WLAN address mask ............ ff:ff:ff:ff:00:00
LAN MAC address .............. 00:0b:16:00:00:07
BSSID of System Under Test.... 00:60:1d:f0:de:97
Rev #/Date: 2.0.0 Beta/07.17.03
6-1
Communication Machinery Corporation (CMC)
The EmulationEngine is not joined with the SUT.
0 vSTAs currently in the system.
CMC_EE ->
The CLI is now ready to accept your commands.
NOTE: If the CLI displays the message “This EmulationEngine has
not been Node Locked” after you enter the EE login name and
password, see “Missing Key File” in Chapter 9. Troubleshooting.
User Log-Off
Use the quit command to log off from the CLI:
CMC_EE -> quit
After log-off, you must reopen the telnet connection to log in to the
CLI.
CLI Commands
The “help” command will display a list of all CLI commands.
Example:
CMC_EE -> help
List of EmulationEngine CLI commands:
assoc -- Associate a vSTA with the SUT
auth -- Authenticate a vSTA with the SUT
autoconf -- Autoconfig-init-auth-assoc N vSTAs
autorun -- Run N configured/associated vSTAs
clear bssid -- Clear BSSID for System Under Test
clear evlog -- Clear event log file or buffer
clear group -- Clear vSTA group data
clear sntpserver -- Clear SNTP/NTP server IP address
clear systemname -- Clear the EmulationEngine system name
clear vsta -- Clear vSTA data
conf -- Configure a vSTA
deauth -- Deauthenticate a vSTA
del group -- Delete a vSTA group
del key -- Delete Encryption key
del statfile -- Delete a vSTA statistics file
del summfile -- Delete a vSTA statistics summary file
del vsta -- Delete a vSTA
disassoc -- Disassociate a vSTA
exec -- Execute a command file
ftp -- Software update via FTP
get association -- Display Association Table
get basic11b -- Display Basic 11b Rates
get bssid -- Display BSSID of System Under Test
get bsslist -- Display list of discovered BSSIDs
get channel -- Display Radio Channel
get config -- Display current EmulationEngine configuration
get countrycode -- Display Country Code
get ctsmode -- Display CTS mode (11g)
get ctsrate -- Display CTS rate (11g)
get ctstype -- Display CTS type (11g)
get eemac -- Display Wireless LAN MAC Address
get eemask -- Display Wireless LAN Address Mask
6-2
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
get eestatus -- Display EmulationEngine status
get evlog -- Display event log data
get features -- Display authorized features
get fragmentthreshold -- Display Fragment Threshold
get frequency -- Display Radio Frequency (MHz)
get gateway -- Display Gateway IP Address
get group -- Display information for a vSTA group
get hardware -- Display Hardware Revisions
get ipaddr -- Display IP Address
get ipmask -- Display IP Subnet Mask
get key -- Display Encryption Key
get keyentrymethod -- Display Encryption Key Entry Method
get login -- Display Login User Name
get power -- Display Transmit Power Setting
get rate -- Display Data Rate
get rtsthreshold -- Display RTS/CTS Threshold
get shortpreamble -- Display Short Preamble (11b/11g) Usage
get shortslottime -- Display Short Slot Time (11g) Usage
get sntpserver -- Display SNTP/NTP Server IP Address
get statfile -- Display vSTA statistics from file
get station -- Display Station Status
get summfile -- Display vSTA statistics summary from file
get systemname -- Display the EmulationEngine system name
get telnet -- Display Telnet Mode
get tzone -- Display Time Zone Setting
get uptime -- Display UpTime
get version -- Display Firmware Version
get vsta -- Display vSTA information
get wirelessmode -- Display Wireless LAN Mode
halt -- Halt a running vSTA
help -- Display CLI Command List
history -- Display the command line history
init -- Initialize a configured vSTA
join -- Join the EE with the System Under Test
ping -- Ping
quit -- Logoff
reboot -- Reboot the EmulationEngine
reset eemac -- Reset the WLAN MAC address to default value
reset group -- Reset a vSTA group to the initialized state
reset vsta -- Reset a vSTA to the initialized state
run -- Run an associated vSTA
save evlog -- Save the event log buffer to file
save group -- Save vSTA group data
save vsta -- Save vSTA data
scan -- Acquire SUT (scan/join)
set basic11b -- Set Use of Basic 11b Rates
set bssid -- Set the BSSID for the System Under Test
set countrycode -- Set Country Code
set ctsmode -- Set CTS Mode (11g)
set ctsrate -- Set CTS Rate (11g)
set ctstype -- Set CTS Type (11g)
set date -- Set the system date
set eemac -- Set WLAN MAC Address
set eemask -- Set WLAN Address Mask
set evlog -- Set event log controls
set factorydefault -- Restore to Default Factory Settings
Rev #/Date: 2.0.0 Beta/07.17.03
6-3
Communication Machinery Corporation (CMC)
set features -- Upgrade current feature set
set fragmentthreshold -- Set Fragment Threshold
set gdraft5 -- Set 11g Draft 5.0 compatibility (11g)
set gateway -- Set Gateway IP Address
set group -- Set vSTA group configuration parameters
set ipaddr -- Set IP Address
set ipmask -- Set IP Subnet Mask
set key -- Set Encryption Key
set keyentrymethod -- Select Encryption Key Entry Method
set login -- Modify Login User Name
set password -- Modify Password
set power -- Set Transmit Power
set rate -- Set Data Rate
set rtsthreshold -- Set RTS/CTS Threshold
set shortpreamble -- Set Short Preamble (11b/11g) Usage
set shortslottime -- Set Short Slot Time (11g) Usage
set sntpserver -- Set SNTP/NTP Server IP Address
set systemname -- Set the EmulationEngine system name
set telnet -- Set Telnet Mode
set time -- Set the system time
set tzone -- Set Time Zone Setting
set vsta -- Set vSTA configuration parameters
set wirelessmode -- Set Wireless LAN Mode
timeofday -- Display Current Time of Day
version -- Software version
CMC_EE->
This list does not include the commands that are available in
administrative mode. See “Administrative Mode Commands” for a
list of additional commands that are available in administrative
mode.
System Under Test Commands
These commands are used to scan for and join with a device that
can be tested by the EmulationEngine. These commands must be
used to select and join with a System Under Test before you can
use the Virtual Station Set-Up and Control Commands described
below.
clear bssid -- Clear BSSID for System under test
get bssid -- Display BSSID of System under test
get bsslist -- Display list of discovered BSSIDs
get wirelessmode -- Display Wireless LAN Mode
join -- Join the EE with the System Under Test
scan -- Acquire SUT (scan/join)
set bssid -- Set the BSSID for the System Under Test
set wirelessmode -- Set Wireless LAN Mode
These commands can also be used to change the System Under
Test while virtual stations are defined and active. Use the following
command sequence:
1) Use the reset command to return all virtual stations to an
initialized state:
reset vsta all
6-4
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
2) If the new System Under Test is not in the EmulationEngine's
BSS list, a scan is required:
scan
3) Use the set bssid command to set the EmulationEngine to
another System Under Test:
set bssid 
4) Use the join command to join with the System Under Test:
join
5) Issue the authenticate command for all virtual stations:
auth vsta all
6) Issue the associate command for all virtual stations:
assoc vsta all
7) Run the test for all virtual stations:
run vsta all
bssid (get/set/clear)
get bssid
This command shows the current BSSID/MAC address of the
system that is being tested.
get bssid
Example:
CMC_EE -> get bssid
BSSID of System Under Test: 00:04:e2:34:e0:a8
CMC_EE ->
set bssid
This command specifies the BSSID/MAC address of the system to
be tested. This is the System Under Test that the
EmulationEngine will scan for and join with. The default value is
all zeros.
NOTE: The EmulationEngine must be configured with a non-zero
BSSID in order to perform a Join operation and to create and run
virtual stations.
set bssid 
: MAC address of the System Under Test.
Example:
CMC_EE -> set bssid 00:04:e2:34:e0:a8
BSSID of System Under Test: 00:04:e2:34:e0:a8
CMC_EE ->
CMC_EE -> get bssid
BSSID of System Under Test: 00:04:e2:34:e0:a8
CMC_EE ->
Rev #/Date: 2.0.0 Beta/07.17.03
6-5
Communication Machinery Corporation (CMC)
clear bssid
This command clears the current BSSID.
clear bssid
Example:
CMC_EE -> clear bssid
BSSID 00:04:e2:34:e0:a8 cleared
use the set bssid CLI command to set the BSSID of the
System Under Test
CMC_EE ->
bsslist (get)
This command shows the Basic Service Sets discovered in the
most recent scan. See the scan command.
get bsslist
Example:
CMC_EE -> get bsslist
BSS Type Channel
RSSI BSSID
-------- ---------- ----SUT BSS 5.180 ( 36) 38
00:04:e2:37:e6:a1
SUT BSS 5.200 ( 40) 36
00:05:5d:89:c5:f9
SUT BSS 5.220 ( 44) 35
00:04:e2:38:a7:87
SUT BSS 5.260 ( 52) 68
00:04:e2:38:a8:d2
SUT: 4, Ad-Hoc: 0. Total BSS: 4
CMC_EE ->
SSID
---CMC/KDB SMC-1
Noah - DLink
jeff
SMC_03
join
This command joins with the System Under Test. It must be
present in the current Basic Service Set list. See the bsslist
command.
join
Example:
CMC_EE -> join
The join should take about 1 sec
CMC_EE -> EE Join: Checking BSS ... OK
EE Join: Checking channel ... OK
EE Join: Initiating JOIN ...
Infrastructure
5.260
55
00:04:e2:38:a8:d2 SMC_03
EE Join: channel 5260, SMC_03
OK
CMC_EE ->
vSTA ID:0 NOTIFY Operation JOIN succeeded. - WED JUL 09
10:12:24 2003
CMC_EE ->
scan
This command scans for Basic Service Set IDs and, optionally,
joins with the System Under Test. The EmulationEngine’s wireless
mode affects the type of devices that can be discovered in a scan.
6-6
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
See “set wirelessmode” to change the EmulationEngine’s wireless
mode.
NOTE: If a test is in process (see the run command), a scan
operation will be disruptive to the normal testing operations of the
EmulationEngine.
CMC_EE -> scan
Active (probe request) or passive (listen for beacons)
[a/p: p]?
Enter "a" and press the  key to select an active scan. Just
press the  key to select the default passive mode. If
passive mode is selected, the CLI will prompt for the following
scanning options:
Channel (0 = all) [0]?
Channel timeout in msec [300]?
Attempt a join with SUT 00:04:e2:34:e0:a8 [y/n: n]?
If active mode is selected, the CLI will prompt for the following
scanning options:
Broadcast or directed probe request [b/d: d]?
Channel (0 = all) [0]?
Channel timeout in msec [300]?
Attempt a join with SUT 00:04:e2:38:56:78 [y/n: n]? n
Example:
CMC_EE -> scan
Active (probe request) or passive (listen for beacons)
[a/p: p]?
Channel (0 = all) [0]?
Channel timeout in msec [300]?
Attempt a join with SUT 00:04:e2:38:a8:d2 [y/n: n]?
The scan should take about 4 sec
CMC_EE -> OK
CMC_EE ->
CMC_EE ->
Passive scanning 5 GHz 54Mbps (802.11a) channels for 4
seconds...
BSS No. 0 BSSID 00:04:E2:38:A8:D2
BSS No. 1 BSSID 00:04:E2:38:56:68
BSS No. 2 BSSID 00:04:E2:37:E6:A1
BSS No. 3 BSSID 00:04:E2:38:A7:87
Select BSS: Looking for .. 00:04:E2:38:A8:D2
Select BSS: Found ........ 00:04:E2:38:A8:D2
=> BSS'es from the selected wireless mode <=
BSS Type Channel
RSSI BSSID
-------- ---------- ----SUT BSS
5.220 ( 44)
31
00:04:e2:38:a7:87
SUT BSS
5.260 ( 52)
55
00:04:e2:38:a8:d2
SUT BSS
5.280 ( 56)
46
00:04:e2:38:56:68
SUT BSS
5.300 ( 60)
44
00:04:e2:37:e6:a1
SMC-1
SUT: 4, Ad-Hoc: 0. Total BSS: 4
Rev #/Date: 2.0.0 Beta/07.17.03
SSID
---jeff
SMC_03
DSM APDUT
CMC/KDB
6-7
Communication Machinery Corporation (CMC)
vSTA ID:0 NOTIFY Operation SCAN succeeded. - WED JUL 09
10:12:19 2003
wirelessmode (get/set)
get wirelessmode
This command displays the current Wireless LAN Mode (11a, 11b,
or 11g):
get wirelessmode
Example:
CMC_EE -> get wirelessmode
Wireless LAN Mode: 11g
CMC_EE ->
set wirelessmode
This command sets the EmulationEngine’s Wireless LAN Mode:
set wirelessmode 
: 11a = 802.11a, 11b = 802.11b, or 11g = 802.11g. The
default value is 11g.
NOTE: The feature set you ordered from CMC may limit the
number of available wireless mode selections. The CLI will display
an error message if the wireless mode selection is not in your
feature set.
Virtual Station Set-Up & Control Commands
The following commands configure and activate virtual stations.
Most of these commands require that you select and join with a
System Under Test before the command is issued (see the “System
Under Test Commands”).
assoc -- Associate a vSTA with the SUT
auth -- Authenticate a vSTA with the SUT
autoconf -- Autoconfig-init-auth-assoc N vSTAs
autorun -- Run N configured/associated vSTAs
clear group -- Clear vSTA group data
clear vsta -- Clear vSTA data
conf -- Configure a vSTA
deauth -- Deauthenticate a vSTA
del group -- Delete a vSTA group
del vsta -- Delete a vSTA
disassoc -- Disassociate a vSTA
get group -- Display information for a vSTA group
get vsta -- Display vSTA information
halt -- Halt a running vSTA
init -- Initialize a configured vSTA
reset group -- Reset a vSTA group to the initialized state
reset vsta -- Reset a vSTA to the initialized state
run -- Run an associated vSTA
save group -- Save vSTA group data
save vsta -- Save vSTA data
set group -- Set vSTA group configuration parameters
set vsta -- Set vSTA configuration parameters
6-8
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
Most of the commands in this group require that you join with a
System Under Test. If a join or scan has not been done, the CLI
will display the following message:
**
**You must do a "join" or a "scan" with the join option
first.
**
Use the System Under Test commands described above to join
with a System Under Test before using the commands in this
group.
The following diagram illustrates the life cycle of a virtual station
from its null (unconfigured) state to its running state in the active
execution of a test. This illustration will help you determine the
sequence of commands to use to achieve the desired results with
virtual station setup and control commands.
conf
Null
Configured
del
init
del
Initialized
auth
del
deauth,
reset
deauth,
reset
reset
Authenticated
disassoc
del
Associated
halt
assoc
del
run
Running
NOTES: The state names used in the diagram are defined as
follows:
Rev #/Date: 2.0.0 Beta/07.17.03
6-9
Communication Machinery Corporation (CMC)
Null: The virtual station does not yet exist, it hasn't been created
(i.e., configured).
Configured: The initial configuration parameters for the virtual
station have been defined.
Initialized: The virtual station has been added to the system's
internal tables (addressing, etc.).
Authenticated: The virtual station has been authenticated with the
System Under Test.
Associated: The virtual station has been associated with the
System Under Test.
Running: The virtual station is running, either its internal load
application or externally supplied network traffic.
assoc
This command initiates the association sequence for one or more
virtual stations. The virtual station(s) must be configured,
initialized, and authenticated before this command can be used.
The following command will initiate the association sequence for
one or all virtual stations.
assoc vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
assoc vsta all), the association sequence is initiated for all virtual
stations.
The following command will initiate the association sequence for
all virtual stations in a specified group.
assoc group 
: Group ID (1...64)
Example:
CMC_EE -> assoc vsta 1
CMC_EE -> OK
CMC_EE ->
vSTA ID:1 NOTIFY Operation ASSOC succeeded - TUE JUL 15
03:08:38 2003
CMC_EE ->
auth
This command initiates the authentication sequence for one or
more virtual stations. The virtual station(s) must be configured
and initialized before this command can be used.
NOTE: The EmulationEngine supports both open system and
shared key authentication.
The following command will initiate the authentication sequence
for one or all virtual stations.
auth vsta 
6-10
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
auth vsta all), the authentication sequence is initiated for all
virtual stations.
The following command will initiate the authentication sequence
for all virtual stations in a specified group.
auth group 
: Group ID (1...64)
Example:
CMC_EE -> auth vsta 1
CMC_EE -> OK
CMC_EE ->
vSTA ID:1 NOTIFY Operation AUTH succeeded - TUE JUL 15
03:08:15 2003
CMC_EE ->
autoconf
This command can be used to configure, initialize, authenticate
and associate a number of virtual stations using a single
command. It can be issued multiple times. The first time the
command is issued the base MAC and IP virtual station addresses
must be specified. For subsequent commands, the IP and MAC
address parameters are not required. The specified number of
virtual stations will be configured using either default values or
the values specified in the command line. Except for the number
of virtual stations to be configured, values are specified using a
"name/value" pair syntax and may be given in any order.
autoconf  mac  ip  [group ]
[csmode persistent|non-persistent] [retry ]
[timeout ] [authentication open-system|shared-key]
[encryption on|off] [keyindex ] [cipher wep] [mode
internal|external] [target ] [count ]
[size ]
: The number of virtual stations to be configured (1...64). If
this is not the first autoconf command, new virtual stations will be
configured starting at the last virtual station and incrementing for
. Default: None.
mac : Base/starting value to be used for virtual
station MAC addresses. This parameter is required for the first
autoconf command and should not be specified for subsequent
commands. Default: Last MAC address + 1. The starting MAC
address must be within the range of MAC addresses defined by
the WLAN Base MAC Address and WLAN MAC Mask in
EmulationEngine configuration (see “set eemac” & “set eemask”).
ip : Base/starting value to be used for virtual station
IP addresses. This parameter is required for the first autoconf
command and should not be specified for subsequent commands.
Default: Last IP address + 1.
Rev #/Date: 2.0.0 Beta/07.17.03
6-11
Communication Machinery Corporation (CMC)
[group ]: Optional group ID number (1...64).
[csmode persistent|non-persistent]: Connection mode (persistent
or non-persistent).
[retry ]: If csmode is presistent, this parameter specifies
the Authentication/Association retry limit (1...2,147,483,647 or
zero (=no retries)).
[timeout ]: If csmode is presistent, this parameter
specifies the Authentication/Association timeout in milliseconds
(1...2,147,483,647 or zero (=immediate timeout)).
[authentication open-system|shared-key]: Authentication mode
(open-system or shared-key).
[encryption on|off]: Encryption mode (on or off).
[keyindex ]: If encryption is on, a shared key index
number (1...4).
[cipher wep]: Enables WEP cipher mode.
[mode internal|external]: If mode is internal, virtual station(s) will
generate data using Ping (ICMP Echo Request) packets. Each
virtual station will run a ping transmitter process. The packets
will contain virtual station IP and MAC source address. If Internal
is specified the "target" parameter must also be specified. If mode
is external, data for virtual station(s) will be generated by an
external host connected to the same LAN as the EmulationEngine.
IP and ARP packets generated from this host that contain the
virtual station's IP address as a source will be translated at the
MAC layer to appear as if sourced from the virtual station's MAC
address. Default: Internal.
[target ]: Target host's IP address. If mode is Internal
this parameter is required. Default: None.
[count ]: Number of ping packets to send:
0...2,147,483,647. Default: 1000.
[size ]: Size of ping data buffer (64...1024). Default: 1024.
Examples:
CMC_EE -> autoconf 2 mac 00:0b:cd:59:00:01 ip 10.1.35.150
mode external
vSTA ID:1 IP:10.1.35.150 MAC:00:0b:cd:59:00:01 CONF OK
vSTA ID:2 IP:10.1.35.151 MAC:00:0b:cd:59:00:02 CONF OK
vSTA ID:1 INIT OK
vSTA ID:2 INIT OK
vSTA ID:1 AUTH CMD OK
vSTA ID:1 AUTH NOTIFY OK
vSTA ID:2 AUTH CMD OK
vSTA ID:2 AUTH NOTIFY OK
vSTA ID:1 ASSOC CMD OK
vSTA ID:1 ASSOC NOTIFY OK
vSTA ID:2 ASSOC CMD OK
6-12
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
vSTA ID:2 ASSOC NOTIFY OK
CMC_EE ->
CMC_EE -> autoconf ?
vSTA Auto-Configuration Information
Configured vSTAs ...... 2
Base IP Address ....... 10.1.35.150
Next IP Address ....... 10.1.35.152
Base MAC Address ...... 00:0b:cd:59:00:01
Next MAC Address ...... 00:0b:cd:59:00:03
CMC_EE ->
NOTE: By default, all virtual stations that are created in the CLI
are assigned to group 1. This can be changed using the “set vsta
 group ” command.
autorun
This command automatically runs one or more configured virtual
stations that are in the associated state. It is intended for use in
conjunction with the autoconf command. Any other use may
produce unexpected results. It will issue the run command for the
specified number of virtual stations.
autorun [nVstas]
[nVstas]: Optional number of virtual stations (1...64). If this
parameter is omitted, the total number of auto-configured
(autoconf) virtual stations is used.
conf
This command configures a virtual station. It specifies a virtual
station's IP address, WLAN MAC address and load application
mode. It also specifies the load application protocol, target host
and application specific parameters. After a virtual station is
configured, it must be initialized with the "init" command.
conf        
: Virtual Station ID (1...64)
: Virtual station’s WLAN IP address (nnn.nnn.nnn.nnn)
: Virtual station’s WLAN MAC address (xx:xx:xx:xx:xx:xx).
The starting MAC address must be within the range of MAC
addresses defined by the WLAN Base MAC Address and WLAN
MAC Mask in EmulationEngine configuration (see “set eemac” &
“set eemask”).
: external or internal. If external mode is used, the
remaining parameters (   ) are optional.
: Specifies the Load Application Protocol (ping).
: Target IP address (nnn.nnn.nnn.nnn)
: Number of ICMP Echo Requests to transmit:
0...2,147,483,647.
Rev #/Date: 2.0.0 Beta/07.17.03
6-13
Communication Machinery Corporation (CMC)
: Number of data bytes to be included in ICMP Echo
Requests: 64...1024.
Example:
CMC_EE -> conf 3 10.1.40.20 00:0b:cd:59:00:01 internal ping
10.1.40.16 64000 1024
CMC_EE -> OK
NOTE: By default, all virtual stations that are created in the CLI
are assigned to group 1. This can be changed using the “set vsta
 group ” command.
deauth
This command initiates the de-authentication sequence for one or
more virtual stations. The virtual station(s) must be configured,
initialized and authenticated before this command can be used.
The following command will initiate the de-authentication
sequence for one or all virtual stations.
deauth vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
deauth vsta all), the de-authentication sequence is initiated for all
virtual stations.
The following command will initiate the de-authentication
sequence for all virtual stations in a specified group.
deauth group 
: Group ID (1...64)
Example:
CMC_EE -> deauth vsta 1
CMC_EE -> OK
CMC_EE ->
vSTA ID:1 NOTIFY Operation DEAUTH succeeded - TUE JUL 15
03:09:56 2003
CMC_EE ->
disassoc
This command initiates the disassociation sequence for one or
more virtual stations. The virtual station(s) must be configured,
initialized, authenticated, and associated before this command
can be used. The following command will initiate the
disassociation sequence for one or all virtual stations.
disassoc vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
disassoc vsta all), the disassociation sequence is initiated for all
virtual stations.
The following command will initiate the disassociation sequence
for all virtual stations in a specified group.
disassoc group 
: Group ID (1...64)
6-14
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
Example:
CMC_EE -> disassoc vsta 1
CMC_EE -> OK
CMC_EE ->
vSTA ID:1 NOTIFY Operation DISASSOC succeeded - TUE JUL 15
03:09:50 2003
CMC_EE ->
group (clear/del/get/reset/save/set)
These commands display and modify group configuration. Group
commands are a convenient way to reference multiple virtual
stations using a single command. For example, the "set group"
command will assign the specified parameters to all virtual
stations in the group.
clear group stats
This command clears all statistics for all virtual stations in a
specified group.
clear group  stats
: Group ID (1...64)
del group
This command clears all configuration parameters for a specified
group and removes the group from the system.
del group 
: Group Number (1...64)
Example:
CMC_EE -> del group 2
5 vSTAs deleted
CMC_EE -> OK
CMC_EE ->
vSTA ID:6 NOTIFY DELETED - reason: delete command - WED JUL
16 07:35:27 2003
CMC_EE -> OK
CMC_EE ->
vSTA ID:7 NOTIFY DELETED - reason: delete command - WED JUL
16 07:35:27 2003
CMC_EE -> OK
CMC_EE ->
vSTA ID:8 NOTIFY DELETED - reason: delete command - WED JUL
16 07:35:27 2003
CMC_EE -> OK
CMC_EE ->
vSTA ID:9 NOTIFY DELETED - reason: delete command - WED JUL
16 07:35:28 2003
CMC_EE -> OK
CMC_EE ->
vSTA ID:10 NOTIFY DELETED - reason: delete command - WED
JUL 16 07:35:28 2003
CMC_EE ->
Rev #/Date: 2.0.0 Beta/07.17.03
6-15
Communication Machinery Corporation (CMC)
get group
This command retrieves and displays a configuration parameter or
statistics for all virtual stations in a group.
get group  
: Group Number (1...64). If  is “summary”, you may
specify “all” as the group number (i.e., get group all summary) to
display summary statistics for all groups.
: The attribute of the information to get/display:
authentication: Display the group’s authentication mode (opensystem or shared-key).
cipher: Display the group’s cipher mode (wep)
count: If the group’s test mode is internal, display the configured
ping count (0...2,147,483,647)
csmode: Display the group’s connection mode (persistent or nonpersistent)
encryption: Display the group’s encryption mode: on or off
keyindex: Display the group’s shared-key index (1, 2, 3, or 4)
lp: Load Protocol: ping
mode: Display the group’s test mode (external or internal)
retry: If the group’s csmode is persistent, display the configured
Authentication/Association retry limit (1...2,147,483,647 or zero
(=no retries)).
size: If the group’s test mode is internal, display the configured
ping packet size (64...1024).
stats: Displays statistics counters for all virtual stations in a
group.
summary: Displays cumulative summary statistics for all virtual
stations in one or all groups.
target: If the group’s test mode is internal, display the configured
ping target IP address (e.g., 10.1.35.100).
timeout: If the group’s csmode is persistent, display the configured
Authentication/Association timeout in milliseconds
(1...2,147,483,647 or zero (=immediate timeout).
Example:
CMC_EE
vSTA 1
vSTA 2
vSTA 3
vSTA 4
vSTA 5
-> get group 1 csmode
connection mode: persistent
connection mode: persistent
connection mode: persistent
connection mode: persistent
connection mode: persistent
5 vSTAs found
6-16
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
CMC_EE ->
reset group
This command resets all virtual stations in a group to the
Initialized state and clears all group statistics counters.
reset group 
: Group Number (1...64)
Example:
CMC_EE -> reset group 1
5 vSTAs reset
CMC_EE ->
save group stats
This command saves statistics information in a file for all virtual
stations in a specified group. Each virtual station in the group is
saved to its own file. The file will be stored in the /Statistics
subdirectory and named "Vsta#Stats.dat" (where "#" is the virtual
station ID).
save group  stats
: Group ID (1...64)
save group summary
This command saves cumulative summary statistics in a file for all
virtual stations in one or all groups. Each group is saved to its
own file. The file will be stored in the /Statistics subdirectory and
named "Grp#Summ.dat" (where "#" is the group ID).
save group  summary
: Group ID (1...64) or "all". If  is set to "all" (i.e., save
group all summary), summary statistics are saved for all virtual
stations in all groups.
set group
This command modifies configuration parameters for all virtual
stations in a specified group.
set group   
: Group Number (1...64)
: authentication, cipher, count, csmode, encryption,
keyindex, lp, mode, retry, size, target, timeout.
: Depending on the , set  to one of the
following.


authentication
Authentication mode: open-system or shared-key
cipher
Cipher mode: wep
count
Ping Count: 0...2,147,483,647
Rev #/Date: 2.0.0 Beta/07.17.03
6-17
Communication Machinery Corporation (CMC)


csmode
Connection mode: persistent or non-persistent
encryption
Encryption mode: on or off
keyindex
Shared-key index: 1, 2, 3, or 4
lp
Load Protocol: ping
mode
external or internal
retry
Authentication/Association retry limit: 1...2,147,483,647 or zero
(=no retries)
size
Ping Packet Size: 64...1024
target
Ping Target IP address in ASCII Dotted Decimal Notation:
nnn.nnn.nnn.nnn (e.g., 10.1.35.100).
timeout
Authentication/Association timeout in milliseconds:
1...2,147,483,647 or zero (=immediate timeout)
Example:
CMC_EE -> set group 1 size 64
5 vSTAs updated
OK
CMC_EE ->
halt
This command initiates an immediate halt of the load application
currently being run by one or more virtual stations. The virtual
station(s) must be configured, initialized, authenticated,
associated and running a load application. As long as the specified
virtual station remains in the associated state, the load
application may be re-started by issuing a run command. The
following command will execute the halt for one or all virtual
stations.
halt vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
halt vsta all), the halt command will be sent to all virtual stations.
The following command will execute the halt for all virtual stations
in a specified group.
halt group 
: Group ID (1...64)
Example:
CMC_EE -> halt vsta 1
CMC_EE ->
vSTA ID:1 halted OK
CMC_EE ->
init
This command initializes one or more virtual stations. A virtual
station must be configured before it can be initialized. See the
6-18
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
"conf" command. The following command initializes one or all
virtual stations.
init vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
init vsta all), all virtual stations are initialized.
The following command initializes all virtual stations in a specified
group.
init group 
: Group ID (1...64)
Example:
CMC_EE -> init vsta 1
CMC_EE -> OK
run
This command starts running the load application for one or more
virtual stations. The virtual station(s) must be configured,
initialized, authenticated and associated before issuing this
command. After a run command has completed, it may be
reissued/re-started as long as the virtual station remains in the
associated state. The following command starts running the load
application for one or all virtual stations.
run vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
run vsta all), the run command is sent to all virtual stations.
The following command starts running the load application for all
virtual stations in a specified group.
run group 
 = Group ID (1...64)
Example:
CMC_EE ->run vsta 1
CMC_EE ->
vSTA ID:1 running OK
CMC_EE ->
vSTA ID:1 NOTIFY Operation RUN completed.
CMC_EE ->
vsta (clear/del/get/reset/save/set)
These commands can be used to clear virtual station statistics,
delete virtual stations from the system, display virtual station
configuration and statistics, reset virtual stations, save virtual
station statistics in a file, and to set virtual station parameters.
clear vsta stats
This command clears all statistics for one or more virtual stations.
clear vsta  stats
Rev #/Date: 2.0.0 Beta/07.17.03
6-19
Communication Machinery Corporation (CMC)
: Virtual Station ID (1...64), "all", or "master". If  is set to
"all" (i.e., clear vsta all stats), this command will clear all statistics
for all virtual stations. If  is set to "master" (i.e., clear vsta
master stats), this command will clear all statistics for the
EmulationEngine.
Example:
CMC_EE -> clear vsta 1 stats
CMC_EE ->
del vsta
This command clears all configuration parameters for one or more
virtual stations and removes the virtual station(s) from the system.
del vsta 
: Virtual Station ID (1...64) or "all". If  is set to "all" (i.e.,
del vsta all), all virtual stations are deleted.
Example:
CMC_EE -> del vsta 1
CMC_EE -> OK
CMC_EE ->
vSTA ID:1 NOTIFY DELETED - reason: delete command - WED JUL
16 07:44:09 2003
CMC_EE ->
get vsta
This command gets (retrieves and displays) a configuration
parameter or statistics for one or all virtual stations.
get vsta  
: Virtual Station ID (1...64). Use "all" to display  for
all virtual stations. If the  is set to “stats” to display
statistics, the  can be set to “master” to show statistics for the
EmulationEngine (i.e., get vsta master stats). If  is
“summary”,  must be set to “all”
: The attribute of the information to get. Omit this
parameter (e.g., get vsta 1) to show a virtual station's complete
configuration. Or, use one of the following attributes to show a
specific configuration parameter:
authentication: Display the virtual station’s authentication mode
(open-system or shared-key).
cipher: Display the virtual station’s cipher mode (wep).
count: If the virtual station’s test mode is internal, display the
configured ping count (0...2,147,483,647).
csmode: Display the virtual station’s connection mode (persistent
or non-persistent).
encryption: Display the virtual station’s encryption mode (on or
off).
6-20
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
keyindex: Display the virtual station’s shared-key index (1, 2, 3, or
4).
lp: Display the virtual station’s Load Protocol (ping).
mode: Display the virtual station’s test mode (external or internal).
retry: If csmode is persistent, display the virtual station’s
Authentication/Association retry limit (1...2,147,483,647 or zero
(=no retries)).
size: If the virtual station’s test mode is internal, display the
configured ping packet size (64...1024).
stats: Depending on the value of , display statistics counters
for one virtual station, all virtual stations, or the
EmulationEngine.
summary: Display cumulative summary statistics for all virtual
stations
target: If the virtual station’s test mode is internal, display the
configured ping target IP address (e.g., 10.1.35.100).
timeout: If the virtual station’s test csmode is persistent, display
the Authentication/Association timeout in milliseconds
(1...2,147,483,647 or zero (=immediate timeout)).
Examples:
CMC_EE -> get vsta 1 count
vSTA 1 Ping count: 1000
CMC_EE -> get vsta 1
vSTA configuration:
ID ......................
Group ID ................
IP Address ..............
MAC Address .............
Connection Mode .........
Auth/Assoc Retry ........
Auth/Assoc Timeout ......
Authentication ..........
Cipher ..................
Data encryption .........
Shared-key Index ........
Mode ....................
Load Application ........
Target IP Address .......
Ping transmit count .....
Ping data size ..........
CMC_EE ->
10.1.40.18
00:0b:cd:59:00:01
persistent
300 mSec
Shared-key
WEP(RC4)
Off
internal
ping
10.1.40.16
1000
1024
CMC_EE -> get vsta 1 state
vSTA: 1
State: Running
Mode: internal
vStaPingRcv:Active
Rev #/Date: 2.0.0 Beta/07.17.03
6-21
Communication Machinery Corporation (CMC)
vStaPingXmt:Active
CMC_EE ->
CMC_EE -> get vsta 1 stats
vSTA 1: MAC 00:0b:cd:59:00:01, IP 10.1.35.150, State:
Running
Authentications:
1,
Deauthentications:
Associations:
1,
Disassociations:
Rcv Sig Strength:
72,
Ack Sig Strength:
83
Rcv Rate: 24,
Tx SF Rate: 54,
Tx LF Rate: 54
Frame counts: MSDUs
Data
Mcast
Mgmt
Ctrl
Rcv
240
238
Tx
95
97
vSTA 1 Ping statistics:
Transmit count:
1000
Transmit data size:
1024
Packets transmitted:
96
Round-trip (uSec):
Bytes transmitted:
99072
Min:
50000
Transmit ENOBUFS:
Max:
100000
Packets received:
96
Avg:
74725
Bytes received:
99072
Stddev:
25137
Packet loss:
0%
Rcv Errors: 64, Tx Errors: 4
Rcv PHY Errors:
0,
Excess Retries:
Rcv CRC Errors:
64,
Total Retries:
Rcv Duplicates:
146,
Tx Filtered:
Rcv Discarded:
146,
Tx Discarded:
Ack Rcv Fails:
0,
RTS Fails:
Authentication Type: Open System
Encryption:
Off,
FCS Fails:
Rcv Decrypt Errs:
0,
WEP Excluded:
CMC_EE ->
CMC_EE -> get vsta
Summary statistics
Authentications:
Associations:
Signal Quality:
Rcv Strength
Ack Strength
Rcv Rate
Tx SF Rate
Tx LF Rate
Rcv Frames:
MSDUs
Data
Multicast
Management
Control
Error
Tx Frames:
MSDUs
Data
Multicast
Management
Control
Error
6-22
all summary
for 5 vSTAs:
Deauthentications:
Disassociations:
Min
Max
Avg
61
36
60
35
54
54
54
54
54
54
54
54
54
Min
Max
Avg
10
Min
Max
Avg
Total
30
18
12
Total
12
12
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
Tx Retries
Rcv Errors:
Rcv PHY Errors:
Rcv CRC Errors:
Rcv Duplicates:
Rcv Discarded:
Ack Rcv Fails:
Rcv Decrypt Errs:
0,
0,
0,
3,
0,
0,
0,
Tx Errors:
Excess Retries:
Total Retries:
Tx Filtered:
Tx Discarded:
RTS Fails:
WEP Excluded:
FCS Fails:
reset vsta
This command resets virtual stations to the Initialized state and
clears the virtual station's statistics counters.
reset vsta 
: Virtual Station ID (1...64) or "all". If  is set to all (i.e.,
reset vsta all), this command will reset all virtual stations.
Example:
CMC_EE -> reset vsta 1
CMC_EE ->
save vsta stats
This command writes all statistics for virtual stations to a file in
the flash file system. The file will be stored in the /Statistics
subdirectory and named "Vsta#Stats.dat" (where "#" is the virtual
station ID).
save vsta  stats
: Virtual Station ID (1...64), "all", or "master". If  is set to
all (i.e., save vsta all stats), statistics for all virtual stations are
written to individual files. If  is set to "master" (i.e., save vsta
master stats), EmulationEngine statistics information are written
in the file /Statistics/VstaMasterStats.dat.
Example:
CMC_EE -> save vsta 1 stats
Wrote vSTA 1 statistics to file
CMC_EE ->
save vsta all summary
This command saves cumulative summary statistics for all virtual
stations to the file /Statistics/VstaAllSumm.dat.
save vsta all summary
Example:
CMC_EE -> save vsta all summary
Wrote vSTA all summary to file
CMC_EE ->
set vsta
This command modifies virtual station parameters.
Rev #/Date: 2.0.0 Beta/07.17.03
6-23
Communication Machinery Corporation (CMC)
set vsta   
: Virtual Station ID (1...64). If  is anything other
than "ip" or "mac", the  can be given as "all" to apply the
configuration parameter to all virtual stations.
: authentication, cipher, count, csmode, encryption,
group, ip, keyindex, lp, mac, mode, retry, size, target, timeout.
: Depending on the , set  to one of the
following.


authentication
Authentication mode: open-system or shared-key
cipher
Cipher mode: wep
count
Ping Count: 0...2,147,483,647
csmode
Connection mode: persistent or non-persistent (see NOTE
below)
encryption
Encryption mode: on or off
group
Assign virtual station(s) to group ID (1...64)
ip
IP address in ASCII Dotted Decimal Notation: nnn.nnn.nnn.nnn
(e.g., 10.1.35.100).
keyindex
Shared-key index: 1, 2, 3, or 4
lp
Load Protocol: ping
mac
MAC address in ASCII Colon Separated Hexadecimal Notation:
xx:xx:xx:xx:xx:xx (e.g., 02:cf:1f:00:00:01)
mode
external or internal
retry
Authentication/Association retry limit: 1...2,147,483,647 or zero
(=no retries)
size
Ping Packet Size: 64...1024
target
Ping Target IP address in ASCII Dotted Decimal Notation:
nnn.nnn.nnn.nnn (e.g., 10.1.35.100).
timeout
Authentication/Association timeout in milliseconds:
1...2,147,483,647 or zero (=immediate timeout)
NOTE: The purpose of the csmode parameter is for the virtual
station to remain persistent (connected) to a system during a test
if the system deauthenticates or disassociates. If the
EmulationEngine loses connection to a System Under Test, it
must be able to recover and continue where it left off. For
example, if the virtual station is in a run or associated state and
an 802.11 management frame (deauth or disassoc) is sent from
the system and received by the EmulationEngine virtual station,
the virtual station will go back to the state it was in prior to
receiving the management frame. If it was in an internal run state,
ping will continue. If it was in an associated state, the virtual
station will go back to associated. Examples:
CMC_EE -> set vsta 1 count 100
6-24
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
CMC_EE
CMC_EE
CMC_EE
CMC_EE
CMC_EE
->
->
->
->
->
OK
set vsta 1 csmode persistent
OK
set vsta 1 csmode non-persistent
OK
Statistics File Commands
The following commands can be used to display and delete
statistics files:
del
del
get
get
statfile
summfile
statfile
summfile
-----
Delete a vSTA statistics file
Delete a vSTA statistics summary file
Display vSTA statistics from file
Display vSTA statistics summary from file
See "Chapter 8, Statistics Counters" for a description of the fields
that may be displayed by any of the commands in this group that
display statistics counters. Also see the “group” and “vsta”
commands under “Virtual Station Setup & Control Commands”
above for commands that display, clear, and save statistics
counters for a group or one or more virtual stations.
Delete Statistics File
del statfile group
This command deletes the statistic file for all virtual stations in a
specified group.
del statfile group 
: Group ID (1...64)
del statfile vsta
This command deletes the statistic file for one or more virtual
stations.
del statfile vsta 
: Virtual Station ID (1...64), "all", or "master". If  is set to
"all" (i.e., del statfile vsta all), this command will delete the
statistics file for all virtual stations. If  is set to "master" (i.e.,
del statfile vsta master), this command will delete the statistics file
for the EmulationEngine.
Example:
CMC_EE -> del statfile vsta 1
Deleted vSta 1 statistics file
CMC_EE ->
del summfile group
This command deletes the group summary statistics file for one or
all groups.
del summfile group 
: Group ID (1...64) or "all". If  is set to "all" (i.e., gel group
all summfile), group summary statistics are deleted for all groups.
Rev #/Date: 2.0.0 Beta/07.17.03
6-25
Communication Machinery Corporation (CMC)
del summfile vsta all
This command deletes the overall summary statistics file for all
virtual stations.
del vsta all summfile
Get/Display Statistics File
get statfile group
This command retrieves and displays a statistics file for all virtual
stations in a specified group.
get statfile group 
: Group ID (1...64)
get statfile vsta
This command retrieves and displays a statistics file for one or
more virtual stations.
get statfile vsta 
: Virtual Station ID (1...64), "all", or "master". If  is set to
"all" (i.e., get statfile vsta all), this command will display the
statistics file for all virtual stations. If  is set to "master" (i.e.,
get statfile vsta master), this command will display the statistics
file for the EmulationEngine.
get summfile group
This command displays cumulative statistics from a summary
statistics file for all virtual stations in one or all groups.
get summfile group id
: Group ID (1...64) or "all". If  is set to "all" (i.e., get
summfile group all), group summary statistics are displayed for all
groups.
get summfile vsta all
This command displays cumulative statistics from a summary
statistics file for all virtual stations.
get summfile vsta all
Event Log Commands
These commands can be used to clear the event log, display the
event log, set event log controls, and save the event log in a file.
clear evlog -- Clear event log file or buffer
get evlog -- Display event log data
save evlog -- Save the event log buffer to file
set evlog -- Set event log controls
Also see "Chapter 7, Event Logging" for more information about
how the EmulationEngine creates and maintains the event log.
6-26
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
Clear Event Log
clear evlog buffer
This command clears the EmulationEngine's event log buffer.
clear evlog buffer
Example:
CMC_EE -> clear evlog buffer
clear evlog file
This command clears a log file.
clear evlog file 
: A or B
Example:
CMC_EE -> clear evlog file A
Get/Display Event Log
get evlog buffer
This command displays event log data from the event log buffer.
get evlog buffer 
: the number of records to display. The CLI will display the last
 number of records in the buffer. Omit this parameter to show
all records in the buffer.
Example:
CMC_EE -> get evlog buffer
1/17/2003,10:25:14,5527.040462,0, Joined, BSSID
00:04:e2:38:52:18, chan 5280
1/17/2003,10:27:19,5651.922666,1, vSta conf ID 1, IP
10.1.35.231, mac 02:22:33:44:55:61, mode external
1/17/2003,10:27:19,5652.172465,2, vSta conf ID 2, IP
10.1.35.232, mac 02:22:33:44:55:62, mode external
1/17/2003,10:27:20,5652.672575,3, vSta init ID 1
1/17/2003,10:27:20,5652.922582,4, vSta init ID 2
1/17/2003,10:27:21,5653.839116,5, vSta auth ID 1
1/17/2003,10:27:22,5654.339023,6, vSta auth ID 2
1/17/2003,10:27:23,5655.339004,7, vSta assoc ID 1
1/17/2003,10:27:23,5655.839090,8, vSta assoc ID 2
get evlog file
This command displays event log data from an event log file.
get evlog file  [ []]
get evlog file  ?
: A or B
: The first record to be displayed. Omit this parameter
to start with the first record in the file.
Rev #/Date: 2.0.0 Beta/07.17.03
6-27
Communication Machinery Corporation (CMC)
: The number of records to display. Omit this parameter to
show all remaining records in the file. This parameter can only be
used if  is specified.
Use "?" to display the number of records in the file.
Example:
CMC_EE -> get evlog file A ?
Log file A has 15 records
CMC_EE -> get evlog file A
1/1/1970,0:00:37,30.963149,0, CLI: set date 5/5/2003 15:21
5/5/2003,15:21:03,34.229892,1, CLI: (null)
5/5/2003,15:21:21,52.663185,2, CLI: autoconf 5 ip
10.1.35.150 mac 00:0b:cd:59:00:01
1 mode external
5/5/2003,15:21:23,54.646520,3, CLI: join
5/5/2003,15:21:23,61.952464,4, Joined, BSSID
00:04:e2:3a:3c:32, chan 5180
5/5/2003,15:21:45,83.939091,5, CLI: autoconf 2 ip
10.1.35.150 mac 00:0b:cd:59:00:02 mode external
5/5/2003,15:21:45,83.939443,6, vSTA 1: configured, IP
10.1.35.150, mac 00:0b:cd:59:00:03, mode external
5/5/2003,15:21:45,84.189298,7, vSTA 2: configured, IP
10.1.35.151, mac 04:cf:1f:00:00:02, mode external
5/5/2003,15:21:46,84.439303,8, vSTA 1: initialized
5/5/2003,15:21:46,84.689242,9, vSTA 2: initialized
5/5/2003,15:21:46,85.022468,10, vSTA 1: authenticated
5/5/2003,15:21:47,85.272568,11, vSTA 2: authenticated
5/5/2003,15:21:47,85.522474,12, vSTA 1: associated
5/5/2003,15:21:47,85.772538,13, vSTA 2: associated
5/5/2003,15:21:53,91.422499,22, CLI: save evlog
get evlog settings
This command displays the current event log control settings.
get evlog settings
Example:
CMC_EE -> get evlog settings
Event logging is enabled
Event log verbosity : critical events only
WLANTX module: disabled
WLANRX module: disabled
EE module: enabled
VSTA module: enabled
UI module: disabled
Event data to console: disabled
Event data to file
: disabled
CMC_EE ->
Save Event Log (save evlog)
This command flushes all records from the log buffer to the
current log file, even if log to file is not enabled.
save evlog
6-28
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
NOTE: When logging to file is enabled (i.e., set evlog file enable),
event records are automatically written to the log file as they
occur. The "save evlog" command is intended for use when log to
file is not enabled but there are significant events in the event log
buffer that you want to save to file.
Set Event Log Controls
set evlog
This command enables/disables event logging.
set evlog 
: enable/disable
Example:
CMC_EE -> set evlog enable
set evlog console
This command enables/disables event logging to the console.
set evlog console 
: enable/disable
Example:
CMC_EE -> set evlog console enable
set evlog file
This command enables/disables event logging to event log files.
set evlog file 
: enable/disable
Example:
CMC_EE -> set evlog file enable
set evlog level
This command sets the level at which events are logged. The
verbosity level sets an “importance” threshold for events: at lower
verbosity, only more “important” events are logged; at higher
verbosity, less important events may also be logged.
set evlog level 
: 0 or critical = Log critical events only, 1 or low = Set log
level to low verbosity, 2 or medium = Set log level to medium
verbosity, 3 or high = Set log level to high verbosity.
Example:
CMC_EE -> set evlog level 1
set evlog module
This command enables/disables event logging for specific
modules.
Rev #/Date: 2.0.0 Beta/07.17.03
6-29
Communication Machinery Corporation (CMC)
set evlog module  
: WLANTX = 802.11 WLAN frame transmissions,
WLANRX = 802.11 WLAN frame receptions, EE = EmulationEngine
control, VSTA = Virtual station control, UI = User interface actions
: enable/disable
Example:
CMC_EE -> set evlog module EE enable
EmulationEngine Commands
The commands in this group can be used to display and modify
the EmulationEngine configuration.
clear sntpserver -- Clear SNTP/NTP server IP address
clear systemname -- Clear the EmulationEngine system name
del key -- Delete Encryption key
exec -- Execute a command file
ftp -- Software update via FTP
get association -- Display Association Table
get channel -- Display Radio Channel
get config -- Display current EmulationEngine configuration
get countrycode -- Display Country Code
get eemac -- Display Wireless LAN MAC Address
get eemask -- Display Wireless LAN Address Mask
get eestatus -- Display EmulationEngine status
get features -– Display authorized features
get fragmentthreshold -- Display Fragment Threshold
get frequency -- Display Radio Frequency (MHz)
get gateway -- Display Gateway IP Address
get hardware -- Display Hardware Revisions
get hwtxretries – Display HW Transmit Retry Limit
get ipaddr -- Display IP Address
get ipmask -- Display IP Subnet Mask
get key -- Display Encryption Key
get keyentrymethod -- Display Encyrption Key Entry Method
get login -- Display Login User Name
get power -- Display Transmit Power Setting
get rate -- Display Data Rate
get sntpserver -- Display SNTP/NTP Server IP Address
get station -- Display Station Status
get systemname -- Display the EmulationEngine system name
get telnet -- Display Telnet Mode
get tzone -- Display Time Zone Setting
get uptime -- Display UpTime
help -- Display CLI Command List
history -- Display the command line history
ping -- Ping
quit -- Logoff
reboot -- Reboot the EmulationEngine
reset eemac -- Reset the WLAN MAC address to default value
set countrycode -- Set Country Code
set date -- Set the system date
set eemac -- Set WLAN MAC Address
set eemask -- Set WLAN Address Mask
set factorydefault -- Restore to Default Factory Settings
6-30
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
set features -- Upgrade current feature set
set fragmentthreshold -- Set Fragment Threshold
set gateway -- Set Gateway IP Address
set hwtxretries – Set HW Transmit Retry Limit
set ipaddr -- Set IP Address
set ipmask -- Set IP Subnet Mask
set key -- Set Encryption Key
set keyentrymethod -- Select Encryption Key Entry Method
set login -- Modify Login User Name
set password -- Modify Password
set power -- Set Transmit Power
set rate -- Set Data Rate
set sntpserver -- Set SNTP/NTP Server IP Address
set systemname -- Set the EmulationEngine system name
set telnet -- Set Telnet Mode
set time -- Set the system time
set tzone -- Set Time Zone Setting
timeofday -- Display Current Time of Day
version -- Software version
!WARNING!: When EmulationEngine configuration settings are
changed using many of these commands, the device will write all
settings to a new configuration file in Flash. This process is
delayed to allow multiple parameters to be changed. The new file
will be written within one minute from the time the first parameter
is changed. The EmulationEngine will display the following
warning and confirmation:
**
** DO NOT REMOVE POWER FROM THE EmulationEngine!
** Wait for the EE to update the configuration file in
** Flash or use the "reboot" command for immediate
** update & reboot.
** Automatic update will be done within one minute.
**
...Configuration file update completed.
association (get)
This command shows a list of known stations and their
association status. This list will include the master station, the
System Under Test, and all virtual stations.
get association
Example:
get association
CMC_EE -> get assoc
STA
MAC Address
00:04:E2:38:56:78
SUT
00:04:E2:38:A8:D2
02:CF:1F:00:00:01
02:CF:1F:00:00:02
02:CF:1F:00:00:03
02:CF:1F:00:00:04
02:CF:1F:00:00:05
Rev #/Date: 2.0.0 Beta/07.17.03
State
up
up
joined
joined
joined
joined
joined
6-31
Communication Machinery Corporation (CMC)
channel (get)
This command displays the radio channel/frequency used by the
EmulationEngine. The channel is set automatically when it joins
with the System Under Test.
get channel
Example:
CMC_EE -> get channel
Radio Frequency: 5260 MHz (IEEE 52)
CMC_EE ->
config (get)
This command displays the EmulationEngine configuration.
get config
Example: This example shows the default configuration.
CMC_EE -> get config
EmulationEngine Cfg Rev: 2
Country Code: NA
Wireless Mode: 802.11a
Data Rate: best
Login Username: Admin
BSSID of System Under Test: 00:00:00:00:00:00
WLAN MAC Address: 00:00:00:00:00:00
WLAN MAC Address Mask: ff:ff:ff:ff:00:00
System Name:
DTIM: 1
Fragmentation Threshold: 2346
RTS/CTS Threshold: 2346
IP Address: 192.168.0.50
IP Mask: 255.255.255.0
Host IP Address: 192.168.0.2
Gateway IP Address: 10.10.5.1
SNTP/NTP Server IP Address:
Time Zone:
HW Transmit Retry Limit: 4
TransmitPower: full
Current Transmit Output Power 15.0 dBm
Default transmit key: 1
Shared Key 1, size 40, 1234567890
Key Entry Method: hexadecimal
Telnet: Enabled
CMC_EE ->
countrycode (get/set)
get countrycode
This command displays the country code that is currently
configured in the EmulationEngine.
get countrycode
Example:
CMC_EE -> get country code
Country Code: US - UNITED_STATES
6-32
Rev #/Date: 2.0.0 Beta/07.17.03
EmulationEngine 11a/b/g User's Guide
set countrycode
This command sets the country code configuration parameter for
the EmulationEngine.
set 
: An ISO standard country code (e.g., DB DEBUG, NA - NO_COUNTRY_SET, PR - PUERTO_RICO, US UNITED_STATES, etc.)
Example:
CMC_EE -> set countrycode us
Country Code: US
**
**DO NOT REMOVE POWER FROM THE EmulationEngine!
**Wait for the EE to update the configuration file in Flash
**or use the "reboot" command for immediate update &
reboot.
**Automatic update will be done within one minute.
**
CMC_EE -> ...Configuration file update completed.
get countrycode
Country Code: US
CMC_EE ->
date (set)
This command sets the current system date and (optionally) time
in the EmulationEngine.
set date  [
Source Exif Data: 
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.3
Linearized                      : No
Modify Date                     : 2003:08:22 14:53:05-07:00
Keywords                        : Rev, #/Date:, 2.0.0, Beta/07.17.03
Create Date                     : 2003:07:17 22:47:53Z
Page Count                      : 66
Creation Date                   : 2003:07:17 22:47:53Z
Mod Date                        : 2003:07:17 16:29:45-06:00
Producer                        : Acrobat Distiller 5.0 (Windows)
Author                          : CMC
Metadata Date                   : 2003:07:17 16:29:45-06:00
Creator                         : CMC
Title                           : EmulationEngine 11a/b/g User's Guide
Page Mode                       : UseOutlines
EXIF Metadata provided by EXIF.tools
FCC ID Filing: RCX-EE11ABG

Navigation menu