|
|
|
|
|
The soft_disc command sends a disconnect to a script on a channel or channels.
Synopsis
soft_disc channelStart[-channelEnd]
Description
The soft_disc command sends a message or messages to the Transaction State Machine (TSM) process requesting that the script running on channelStart or the range of channels channelStart-channelEnd be sent interrupt messages. If no script is running on the channel, or if TSM does not own the channel, no action is taken for the channel.
The soft_disc command waits for a response from TSM. When it exits, TSM has acted on all the requests for all the channels by sending disconnects to the scripts or rejecting the requests. Scripts running on the channel receive the ESOFTDISC event.
Return values
If the soft_disc is successful, a 0 value is returned. If any value other than 0 is returned, the soft_disc command completely or partially failed. If soft_disc returns a value of 2, the dip_int command failed due to temporary condition. In this case, the user should attempt the dip_int command again.
Example
The following example requests that TSM send interrupt messages to channel 2.
soft_disc 2
The following example requests that TSM send interrupt messages to channels 1 through 32.
soft_disc 1-32
See also
