splat command syntax

Edit online

Review the splat command syntax, flags, and parameters.

The syntax for the splat command is as follows:

splat [-i file] [-n file] [-o file] [-d [bfta]] [-l address][-c class] [-s [acelmsS]] [-C#] [-S#] [-t start] [-T stop] [-p]

splat -h [topic]

splat -j

Flags
The flags of the splat command are:
Item Descriptor
-i inputfile Specifies the &SWsym.AIX; trace log file input.
-n namefile Specifies the file containing output of the gensyms command.
-o outputfile Specifies an output file (default is stdout).
-d detail Specifies the level of detail of the report.
-c class Specifies class of locks to be reported.
-l address Specifies the address for which activity on the lock will be reported.
-s criteria Specifies the sort order of the lock, function, and thread.
-C CPUs Specifies the number of processors on the MP system that the trace was drawn from. The default is 1. This value is overridden if more processors are observed to be reported in the trace.
-S count Specifies the number of items to report on for each section. The default is 10. This gives the number of locks to report in the Lock Summary and Lock Detail reports, as well as the number of functions to report in the Function Detail and threads to report in the Thread detail (the -s option specifies how the most significant locks, threads, and functions are selected).
-t starttime Overrides the start time from the first event recorded in the trace. This flag forces the analysis to begin an event that occurs starttime seconds after the first event in the trace.
-T stoptime Overrides the stop time from the last event recorded in the trace. This flag forces the analysis to end with an event that occurs stoptime seconds after the first event in the trace.
-j Prints the list of IDs of the trace hooks used by the splat command.
-h topic Prints a help message on usage or a specific topic.
-p Specifies the use of the PURR register to calculate CPU times.
Parameters
The parameters associated with the splat command are:
Item Descriptor
inputfile The AIX® trace log file input. This file can be a merge trace file generated using the trcrpt -r command.
namefile File containing output of the gensyms command.
outputfile File to write reports to.
detail The detail level of the report, it can be one of the following:
basic
Lock summary plus lock detail (the default)
function
Basic plus function detail
thread
Basic plus thread detail
all
Basic plus function plus thread detail
class Activity classes, which is a decimal value found in the /usr/include/sys/lockname.h file.
address The address to be reported, given in hexadecimal.
criteria Order the lock, function, and thread reports by the following criteria:
a
Acquisitions
c
Percent processor time held
e
Percent elapsed time held
l
Lock address, function address, or thread ID
m
Miss rate
s
Spin count
S
Percent processor spin hold time (the default)
CPUs The number of processors on the MP system that the trace was drawn from. The default is 1. This value is overridden if more processors are observed to be reported in the trace.
count The number of locks to report in the Lock Summary and Lock Detail reports, as well as the number of functions to report in the Function Detail and threads to report in the Thread detail. (The -s option specifies how the most significant locks, threads, and functions are selected).
starttime The number of seconds after the first event recorded in the trace that the reporting starts.
stoptime The number of seconds after the first event recorded in the trace that the reporting stops.
topic Help topics, which are: all overview input names reports sorting