Envoy Application Programming Manual

ADM-2 Multipoint Supervisor Protocol
Envoy Application Programming Manual—427159-001
7-23
Send Function
(message length = 5 + number of terminals * 3 + text length)
Send Function
The send function is used to instruct a terminal to send some specified data to the
network control center (that is, the application process). The address of the terminal and
the send function code is specified in the message format. The send function message is
sent to the designated terminal by means of a call to the WRITEREAD procedure. Upon
completion of the WRITEREAD, the buffer of the application process contains the data
requested from the terminal.
A send function is performed by writing a message having the following form:
MCW.<6> = 1 (special-format message)
MCW.<8:15> = 0
text block = EOT a1a1sf ENQ
v means "send line foreground"
w means "send page foreground"
x means "send line all"
y means "send page all"
z means "send message foreground"
{ means "send message all"
If the application process inserts the terminal address, the message is passed to Envoy
(with the WRITEREAD procedure) as shown above. In that case:
MCW.<5> = 1 (message formatted by the application process)
(message length = 7)
t is a one-byte broadcast-select function code
entry no
1
is the one-byte address-list entry number of the first terminal to receive
the message
entry no
2
is the one-byte address-list entry number of the second terminal to
receive the message
entry no
n
is the one-byte address-list entry number of the last terminal to receive
the message
0
is a one-byte place holder
s is a one-byte fast-select function code
a1
is the one-byte terminal address of the terminal to perform the send
function
sf is a send function defined as follows: