im_serial_protocol_control
• If IM_PROTOCOL_OFF is specified, the incoming data is terminated
• If IM_PROTOCOL_OFF is used, you must specify a termination
• If IM_NEW_TERM_CHAR is specified, IM_PROTOCOL_OFF is
The term_char parameter is the end of message character needed to
terminate input from the communications port. The character is normally a
carriage return, but you can set it to any character. This parameter is
required for IM_PROTOCOL_OFF and IM_NEW_TERM_CHAR.
None.
OUT Parameter:
This function returns one of the standard status codes listed in Appendix A,
Return Value:
"Status Codes."
Notes:
Requires im_link_comm.
The receive buffers are cleared whenever the protocol is turned on or off. To
change the termination character (or to not change the setting at all), use
IM_NEW_TERM_CHAR or IM_NO_CHANGE instead of toggling the
protocol.
im_link_comm
See Also:
Example
With System, Text_IO, Intrmecd_IO, Intrmecp_IO;
Use System, Text_IO, Intrmecd_IO, Intrmecp_IO;
procedure protctrl Is
package IM_ORIGIN_IO is new INTEGER_IO (IM_ORIGIN);
comm_buff
: Im_Buffer;
comm_buff_ptr
: System.Address := comm_buff(comm_buff'First)'Address;
comm_buff_size : System.Word := comm_buff'Length;
ans
: Character := ' ';
status
: System.Word;
receive_status : System.Word;
eom
: Character := Ascii.CR;
label
: String(1..16) := (others => Ascii.NUL);
3-106
with the specified end of message character. If the end of message
character is null, the function terminates upon receiving the first
character.
character, otherwise the data is returned in individual bytes.
assumed and the new end of message character specified in the
parameter list is used.