Requests          (Socket - IC)

DESCRIPTION
"Request" shows the number of successful Interval Control (IC) socket requests 
to a Sun MTP system's Socket Server. An application makes an IC request when a
delay is required before processing a given transaction. An application makes 
the request directly to the Socket Server. The Socket Server places the request 
on the Sun MTP Startq with an EXEC CICS START. The IC socket request has the 
following format:

TRANSID, DATA, IC, [INTERVAL]

Each field must be separated by the ','. The TRANSID field 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 IC "Characters" and 
"Avg Chars" datapoints. The IC field is the string "IC" in either upper or lower
case letters (even mixed case is accepted). The optional INTERVAL field tells
Sun MTP how long to wait before executing the TRANSID. The INTERVAL must be 
specified in hhmmss format. If the INTERVAL is not specified, the transaction
executes immediately. 


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 IC socket requests
made to the Sun MTP system's 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 
IC request.


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