43.5 Commands at a Glance

The following commands on the PackMimeHTTP class can be accessed from OTcl:

[new PackMimeHTTP]
Creates a new PackMimeHTTP object.

$packmime start
Start generating connections

$packmime stop
Stop generating new connections

$packmime set-client <node>
Associates the node with the PackMimeHTTP client cloud

$packmime set-server <node>
Associates the node with the PackMimeHTTP server cloud

$packmime set-rate <float>
Set the average number of new connections started per second

$packmime set-req_size <RandomVariable>
Set the HTTP request size distribution

$packmime set-rsp_size <RandomVariable>
Set the HTTP response size distribution

$packmime set-flow_arrive <RandomVariable>
Set the time between two consecutive connections starting

$packmime set-server_delay <RandomVariable>
Set the web server delay for fetching pages

$packmime set-run <int>
Set the run number so that the RNGs used for the random variables will use the same substream (see Chapter 25 on RNG for more details).

$packmime get-pairs
Return the number of completed HTTP request-response pairs. See tcl/ex/packmime/pm-end-pairs.tcl for an example of using get-pairs to end the simulation after a certain number of pairs have completed.

$packmime set-TCP <protocol>
Sets the TCP type (Reno, Newreno, or Sack) for all connections in the client and server clouds - Reno is the default

HTTP/1.1-Specific Commands

$packmime set-http-1.1
Use HTTP/1.1 distributions for persistent connections instead of HTTP/1.0.

$packmime no-pm-persistent-reqsz
By default, PackMime-HTTP sets all request sizes in a persistent connection to be the same. This option turns that behavior off and samples a new request size from the request size distribution for each request in a persistent connection.

$packmime no-pm-persistent-rspsz
By default, PackMime-HTTP uses an algorithm (see PackMimeHTTPPersistRspSizeRandomVariable::value() in packmime_ranvar.h for details) for setting the response sizes in a persistent connection. This option turns that behavior off and samples a new response size from the response size distribution for each response in a persistent connection.

$packmime set-prob_persistent <RandomVariable>
Set the probability that the connection is persistent

$packmime set-num_pages <RandomVariable>
Set the number of pages per connection

$packmime set-prob_single_obj <RandomVariable>
Set the probability that the page contains a single object

$packmime set-objs_per_page <RandomVariable>
Set the number of objects per page

$packmime set-time_btwn_pages <RandomVariable>
Set the time between page requests (i.e., think time)

$packmime set-time_btwn_objs <RandomVariable>
Set the time between object requests

Output-Specific Commands

$packmime active-connections
Output the current number of active HTTP connections to standard error

$packmime total-connections
Output the total number of completed HTTP connections to standard error

$packmime set-warmup <int>
Sets what time output should start. Only used with set outfile.

$packmime set-outfile <filename>
Output the following fields (one line per HTTP request-reponse pair) to filename:

• time HTTP response completed
• HTTP request size (bytes)
• HTTP response size (bytes)
• HTTP response time (ms) - time between client sending HTTP request and client receiving complete HTTP response
• source node and port identifier
• number of active connections at the time this HTTP request-response pair completed

$packmime set-filesz-outfile <filename>
Right after sending a response, output the following fields (one line per HTTP request-reponse pair) to filename:

• time HTTP response sent
• HTTP request size (bytes)
• HTTP response size (bytes)
• server node and port address

$packmime set-samples-outfile <filename>
Right before sending a request, output the following fields (one line per HTTP request-reponse pair) to filename:

• time HTTP request sent
• HTTP request size (bytes)
• HTTP response size (bytes)
• server node and port address

$packmime set-debug <int>
Set the debugging level:

• 1: Output the total number of connections created at the end of the simulation
• 2: Level 1 +
  output creation/management of TCP agents and applications
  output on start of new connection
  number of bytes sent by the client and expected response size
  number of bytes sent by server
• 3: Level 2 +
  output when TCP agents and applications are moved to the pool
• 4: Level 3 +
  output number of bytes received each time client or server receive a packet