CP6100 I/O Process Programming Manual

CPTEST
CPTEST Input Line Format
Requests to the Protocol
The most important CPTEST input consists of requests to the
protocol module. Each protocol has its own set of requests,
as defined in the manual describing the protocol. In a CPTEST
SEND or SENDNW command, you supply all the data CPTEST needs
to format a request.
There is only one difference between the SEND and SENDNW
commands. If you issue a SEND command, CPTEST waits for the
protocol to respond and then displays the response before
prompting you for another command. If you issue a SENDNW
command, CPTEST displays the next prompt without waiting for the
response to the SEND. Thus you can have more than one command
outstanding. SENDNW is especially useful with protocols that
allow queued requests (that is, those that allow more than one
outstanding request at the same time).
Responses from the Protocol
Responses from the protocol are the most important CPTEST output.
The three kinds of responses are:
• Asynchronous responses (that is, unsolicited messages
from the protocol)
• Waited responses (that is, responses to requests issued
with the SEND command)
• Nowaited responses (that is, responses to requests issued
with the SENDNW command)
CPTEST captures asynchronous responses and displays them on
the terminal. The display of an asynchronous response begins
with the word "Async:". Some protocols--in fact, most of
them--never send asynchronous responses; to find out about
a specific protocol, consult the manual describing it.
The processing and display of an asynchronous response does not
terminate the wait for waited responses. CPTEST continues to
wait for the response to an outstanding SEND command. CPTEST
does not display an asynchronous response that cannot be
completely processed due to an error condition. Instead, it
discards the response and issues another read. (As described
in Section 2, a READ call is used to capture an asynchronous
response, while WRITEREAD calls are used for other requests
and responses.
B-3