acmsdi_read_msg
3.6 acmsdi_read_msg
TP Desktop Connector client services call this presentation procedure when
a TDMS Read exchange is received from the TP Desktop Connector gateway
on the host OpenVMS system. Its function is to display the prompt (if any)
sent from the ACMS task and then to acquire the text from the form’s Message
Field to be returned to ACMS.
Format
acmsdi_read_msg (submitter_id,
msg_text,
prompt_text,
call_id,
call_context)
Parameters
submitter_id
Type: ACMSDI_SUBMITTER_ID
Access: read
Mechanism: by reference
The value returned by the acmsdi_sign_in service.
msg_text
Type: char
Access: write
Mechanism: by reference
A buffer into which the presentation procedure will write the text from the
form’s Message Field to be returned to the ACMS task. This is a C-style
null-terminated string with a maximum length of 132 plus one for the null
terminator.
prompt_text
Type: char
Access: read
Mechanism: by reference
Text to be displayed as a prompt to the terminal operator. This is a C-style
null-terminated string with a maximum length of 132 plus one for the null
terminator. There may be no prompt text to display in which case the length
will be 0; that is, the null terminator will be in the first position.
Portable API Presentation Procedures 3–9