Requests          (Socket - IM)

DESCRIPTION
"Request" shows the number of successful Immediate (IM) socket requests to
a Sun MTP System's Socket Server. An application makes an IM request to execute
a transaction with no delay. In fact, Sun MTP bypasses placing the request on the
Startq and directs a free Transaction Server to initiate a link between itself
and the calling application. The Transaction Server and the application use the
socket to communicate directly. The application, however, must make the request 
directly to the Socket Server. The IM socket request has the following format:

TRANSID, DATA

Each field must be separated by the ','. TRANSID is a four character identifier 
of a transaction to run on the Sun MTP system. The TRANSID must have a valid
entry in the Sun MTP system's Program Control Table (PCT). A request fails when
the TRANSID is not in the PCT. The DATA field can be up to 35 characters in 
length. The character length of the DATA contributes to the IM "Characters" and 
"Avg Chars" datapoints. The type of request is an implicit "KC". The Socket 
Server does not require the action identifier of an IM request as with the IC 
and TD socket requests. 


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 IM 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 IM request.


CONCLUSIONS
This datapoint tells exactly how many successful IM socket requests have been
made to the Socket Server. As long as data accompanies IM 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 
