dnsIoActive

dnsIoActive — sets the dnscan I/O mode to active and starts a heartbeat timer.

Synopsis

(dnsIoActive card_id Timeout)
	

Parameters

card_id
The target card ID (0..3).
Timeout
Timeout delay in ms, or infinite if 0.

Returns

If successful, then:

(dnsCmd card_id CMD_IO_ACTIVE)

Otherwise, one of the following error messages:

(error "dnsIoActive DR_ERR_CARD_INVALID (time) invalid card: card_id")
(error "dnsIoActive DR_ERR_NO_CARD (time) card not available")
(error "dnsIoActive DVN_ERR_CMD_TIMEOUT (time) Cmd failed (timeout)")

Description

Sets the I/O mode to active and starts a heartbeat timer. If the command is not re-issued within the timeout period, the I/O mode is set to idle, forcing all client and server I/O messages to zero-length (transmit_idle). The response of each device to zero-length messages is dependent on the device vendor.