SICL Error Codes
When you install a default SICL error handler such as I_ERROR_EXIT or I_ERROR_NOEXIT with an ionerror call, a SICL internal error message is logged.
SICL logs internal messages as events that you can view via Event Viewer. To launch Event viewer, first open the Keysight IO Control application fromEvent Viewer. Both system and application messages can be logged to the Event Viewer from SICL. SICL messages are identified by SICL LOG or by the driver name (such as hp341i32 for the GPIB driver).
For C programs, you can use ionerror to install a custom error handler. The error handler can call igeterrstr with the given error code and the corresponding error message string will be returned. See Programming with SICL for more information on error handlers. This table summarizes SICL error codes and messages .
|
Error Number |
Error Code |
Error String |
Description |
|
23 |
I_ERR_ABORTED |
|
A SICL call was aborted by external means. |
|
3 |
I_ERR_BADADDR |
|
The device/interface address passed to iopen does not exist. Verify that the interface name is the one assigned with Connection Expert. |
|
24 |
I_ERR_BADCONFIG |
|
An invalid configuration was identified when calling |
|
13 |
I_ERR_BADFMT |
|
Invalid format string specified for iprintf or iscanf. |
|
4 |
I_ERR_BADID |
|
The specified INST id does not have a corresponding iopen. |
|
19 |
I_ERR_BADMAP |
|
The imap call has an invalid map request. |
|
28 |
I_ERR_BUSY |
|
The specified interface is busy. |
|
14 |
I_ERR_DATA |
|
The use of CRC, Checksum, and so forth imply invalid data. |
|
128 |
I_ERR_INTERNAL |
|
SICL internal error. |
|
129 |
I_ERR_INTERRUPT |
|
A process interrupt (signal) has occurred in your application. |
|
21 |
I_ERR_INVLADDR |
|
The address specified in iopen is not a valid address (for example, “hpib,57”). |
|
17 |
I_ERR_IO |
|
An I/O error has occurred for this communication session. |
|
11 |
I_ERR_LOCKED |
|
Resource is locked by another session (see isetlockwait). |
|
27 |
I_ERR_NESTEDIO |
|
Attempt to call another SICL function when current SICL function has not completed (WIN16). More than one I/O operation is prohibited. |
|
25 |
I_ERR_NOCMDR |
|
Tried to specify a commander session when it is not active, available, or does not exist. |
|
6 |
I_ERR_NOCONN |
|
Communication session has never been established, or connection to remote has been dropped. |
|
20 |
I_ERR_NODEV |
|
Tried to specify a device session when it is not active, available, or does not exist. |
|
0 |
I_ERR_NOERROR |
|
No SICL error returned; function return value is zero (0). |
|
10 |
I_ERR_NOINTF |
|
Tried to specify an interface session when it is not active, available, or does not exist. |
|
12 |
I_ERR_NOLOCK |
|
An iunlock was specified when device was not locked. |
|
7 |
I_ERR_NOPERM |
|
Access rights violated. |
|
9 |
I_ERR_NORSRC |
|
No more system resources available. |
|
22 |
I_ERR_NOTIMPL |
|
Call not supported on this implementation. The request is valid, but not supported on this implementation. |
|
8 |
I_ERR_NOTSUPP |
|
Operation not supported on this implementation. |
|
18 |
I_ERR_OS |
|
SICL encountered an operating system error. |
|
16 |
I_ERR_OVERFLOW |
|
Arithmetic overflow. The space allocated for data may be smaller than the data read. |
|
5 |
I_ERR_PARAM |
|
The constant or parameter passed is not valid for this call. |
|
2 |
I_ERR_SYMNAME |
|
Symbolic name passed to |
|
1 |
I_ERR_SYNTAX |
|
Syntax error occurred parsing address passed to |
|
15 |
I_ERR_TIMEOUT |
|
A timeout occurred on the read/write operation. The device may be busy, in a bad state, or you may need a longer timeout value for that device. Check also that you passed the correct address to |
|
26 |
I_ERR_VERSION |
|
The |