Requests          (Socket - TD)

DESCRIPTION
"Request" shows the number of successful Transient Data (TD) socket requests 
to a Sun MTP System's Socket Server. An application makes a TD request to write
data to a particular TD queue, usually to work toward the firing of a trigger
condition. An application makes the request directly to the Socket Server. The 
TD socket request has the following format:

TDQ, DATA, TD

Each field must be separated by the ','. TDQ is a four character identifier of a
TD queue. The TDQ must have a valid entry in the Sun MTP system's Destination 
Control Table (TCT), usually in the Intrapartition table. A request fails when 
the TDQ is not in the DCT. The DATA field can be up to 35 characters in length. 
The character length of the DATA contributes to the TD "Characters" and "Avg 
Chars" datapoints. The TD is the string "TD" in either upper or lower case 
letters (even mixed case is accepted). This string identifies the socket request
as a TD request.


VALUES
When shown, "Requests" is a cardinal integer count. The value is left blank when
the Socket Server is not activated (see below). 


INTERPRETATION
"Requests" is a cumulative total of the number of successful TD socket requests
made to the Sun MTP Socket Server. "Requests" does not include the number of 
"Failures". Sun MTPScan uses the number of "Requests" to compute the "Avg Chars"
datapoint, a value that shows the average number of characters per TD request.


CONCLUSIONS
This datapoint tells exactly how many successful TD socket requests have been
made to the Socket Server. As long as data accompanies TD requests, the number 
of "Characters" should increase with the number of "Requests".

The Socket Screen does not display any values when the Socket Server is not 
activated. Sun MTP must be initiated with the -p parameter to activate the Socket
Server. The -p parameter takes a port number for an argument. For example, to 
run the Socket Server so that it listens on port 7000, you could start Sun MTP 
as follows:

$ kixstart -p 7000 
