Command Syntax for LSLOG 5.0

LSLOG is the LoadSim log analysis program. It calculates the npercentile (pctile) average response time value from the .log file that LoadSim creates during a run. LSLOG can perform a variety of other useful functions, including truncating unwanted data, merging multiple .log files, and displaying the time spanned by the data in the .log file. The syntax for each of these functions is explained below.

To run LSLOG, from the Windows NT command prompt, type

LSLOG <op> <args>

The parameters <op> and <args> are the operation to perform and its arguments, respectively. All operations write to stdout. You can abbreviate the values for <op>, which include truncate, merge, answer, and times. The <args> parameter describes the arguments that go with specific operations, and are usually a file name or another optional parameter.

Truncate
The truncate parameter removes times before begin and after end and truncates files at end-of-year boundaries. The command syntax for truncate is

LSLOG truncate logfile \[begin end\]

where logfile is the name of the LoadSim .log file to truncate. The optional variables begin and end are times in hours:minutes. The default values are 1:00 and 4:00, respectively, which retains data beginning at 1:00 hours and ending at 4:00 hours, essentially the second through the fourth hours of a run (values are 0-based). In the command

LSLOG truncate loadsim.log > loadsim.1t4

LSLOG truncates data in the run before 1:00 hours and after 4:00 hours (the default) in the file loadsim.log and writes the output to a file loadsim.1t4. This usage is the \common.

Merge
The merge parameter merges given log files so that the resulting file is still in sequential order. The command syntax for merge is

LSLOG merge \[/r\] logfile logfile \[logfile ...\]

If you specify the rebase (/r) flag, all files start at Jan 01 00:00:00, and LSLOG merges them accordingly. Merge supports wildcard file specifications. In the command

LSLOG merge /r client?.log > mclients.log

LSLOG merges data from all files client0.log, client1.log, and so on into the file mclients.log. The dates are all rebased starting at Jan 01, 00:00:00.

Answer
The answer parameter computes and outputs the n pctile single and weighted average response times for the given LoadSim perf log file. If not specified, the default pctile is 95 (i.e., the 95th percentile). The command syntax for answer is

LSLOG answer \[/i\] \[/a\] logfile \[pctile\] \[flags...\]

If you specify the ignore (/i) flag, LoadSim will ignore weight values for specific actions of a given type and weight equally all actions of the same type. If you specify the average (/a) flag, LSLOG will use average time values instead of 95th percentile values.

You can specify any of the valid flags at the end of the command. One such flag is ­w, which overrides the default weight for a given action. The usage looks like -wACTION:N, where ACTION is the name of the action (e.g., READ) and N is the new weight. Action names are matched case-insensitive, without spaces, and only up to the number of characters you specify. For example, replya will match REPLY ALL.

You can specify as many flags as you want (e.g., you can override the weight values of several different actions). In the command

LSLOG answer loadsim.log

LSLOG parses the logfile called loadsim.log and lists on the screen the 95th percentile weighted response times for all the LoadSim user actions. This usage is the most common.

Times
The times parameter outputs the first and last times logged in the given log file. The command syntax for times is

LSLOG times logfile

Times supports wildcard file specifications. In the command

LSLOG times *.log

On the screen, LSLOG prints the first and last times logged in all .log files in the current directory.