ICS N4865A, Instruction Manual

Page: 71 / 100

A-19
A2
C.1 interface_name
The interface_name procedure is used to read/modify the current VXI-11
logical interface name.
struct Int_Name_Parms {
unsigned int action;
unsigned int length;
opaque name<>;
};
struct Int_Name_Resp {
unsigned int error;
unsigned int length;
opaque name<>;
};
Int_Name_Resp interface_name (Int_Name_Parms) = 1;
The action value determines whether the client wishes to execute a read of
the current setting, or a modifi cation 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 re-
turned.
If the RPC message is of insuffi cient length to satisfy the required length,
an error value of 1 is returned.
The name string must be a NULL terminated string with a 32-byte maximum
length (exclusive of the NULL). An error of 5 is returned and the Interface
Name is unchanged if the name fi eld exceeds 32-bytes.
The returned Int_Name_Resp structure will always contain the current
Interface Name, irrespective of the error value.
error Meaning
0 No error
1 Syntax error
5 Parameter error