A-43
A4
C.18 eos_active_mode
The eos_active_mode procedure is used to read/modify the EOS active mode.
If the EOS mode is TRUE, then an EOS character will terminate reads.
struct Eos_Active_Parms {
unsigned
int
action;
unsigned
int
eosActive;
};
struct Eos_Active_Resp {
unsigned
int
error;
unsigned
int
eosActive;
};
EosActive_Resp eos_active_mode (Eos_Active_Parms) = 18;
The action value determines whether the client wishes to execute a read of the
current setting, or a modification of the current value.
action = 0 = read of current value
action = 1 = modify current value
If the action value is other than 0 or 1, then an error value of 5 is returned.
If the RPC message is of insufficient length to satisfy the required length, an
error value of 1 is returned.
The eosActive mode must be either 0 or 1. An error of 5 is returned and the
current automatic EOS mode is unchanged if eosActive is determined to be
invalid.
The returned Eos_Active_Resp structure will always contain the current EOS
mode, irrespective of the error value.
error Meaning
0
No error
1
Syntax error
5
Parameter error