viAssertUtilSignal
Purpose
Asserts or deasserts the specified utility bus signal.
C Syntax
viStatus viAssertUtilSignal(ViSession vi, ViUInt16 line)
Visual Basic Syntax
viAssertUtilSignal& (ByVal vi&, ByVal line%)
Resource Classes
GPIB-VXI BACKPLANE, VXI BACKPLANE, VXI SERVANT
Parameters
| Name | Direction | Description |
|---|---|---|
|
vi |
IN |
Unique logical identifier to a session. |
|
line |
IN |
Specifies the utility bus signal to assert. This can be the value VI_UTIL_ASSERT_SYSRESET, VI_UTIL_ASSERT_SYSFAIL, or VI_UTIL_DEASSERT_SYSFAIL. |
Return Values
| Completion Codes | Description |
|---|---|
|
VI_SUCCESS |
Operation completed successfully. |
| Error Codes | Description |
|---|---|
|
VI_ERROR_INV_OBJECT |
The given session reference is invalid. |
|
VI_ERROR_NSUP_OPER |
The given vi does not support this operation. |
|
VI_ERROR_RSRC_LOCKED |
Specified operation could not be performed because the resource identified by vi has been locked for this kind of access. |
|
VI_ERROR_TMO |
Timeout expired before operation completedS. |
|
VI_ERROR_INV_LINE |
The value specified by the line parameter is invalid. |
Description
This operation can be used to assert either the SYSFAIL or SYSRESET utility bus interrupts on the VXIbus backplane. This operation is valid only on BACKPLANE (mainframe) and VXI SERVANT (servant) sessions.
Asserting SYSRESET (also known as HARD RESET in the VXI specification) should be used only when it is necessary to promptly terminate operation of all devices in a VXIbus system. This is a serious action that always affects the entire VXIbus system.
Related Topics