Compaq TP DESKTOP CONNECTOR AAPVNFGTE - Manual (Page 88)

acmsdi_bind_msg
4.4 acmsdi_bind_msg
The client application can call this service when acmsdi_poll returns ACMSDI_
TDMS_READ_EXCH (a TDMS Read exchange) or ACMSDI_TDMS_WRITE_
EXCH (a TDMS Write exchange) from the TP Desktop Connector gateway on
the host OpenVMS system. It performs one of the following functions:
• acquires the prompt text, if any, associated with a TDMS Read exchange
• sends the message text associated with a TDMS Read exchange.
• acquires the message text associated with a TDMS Write exchange.
If the prompt or message text is being acquired, the text is truncated when
the buffer supplied is not large enough to hold the entire text. If the buffer is
larger than the text being acquired, the text is left-justified in the buffer and
right-filled with blank characters.
This is an optional call, that is, you are not required to issue this call.
However, if you do not issue this call you will not be able to process arguments
received from the server or to send arguments back to the server.
Format
acmsdi_bind_msg (submitter_id,
direction,
length,
text,
call_id)
Parameters
submitter_id
Type: ACMSDI_SUBMITTER_ID
Access: read
Mechanism: by reference
The value returned by the acmsdi_sign_in service.
direction
Type: short int
Access: read
Mechanism: by value
The value indicates which direction the text is being sent. A value of 1
indicates that the prompt text from a TDMS Read exchange or the message
text from a TDMS Write exchange is being copied into the application’s memory
4–10 Forced Nonblocking Client Services