|
|
|
|
|
The soft_szr command starts a script on a channel.
Synopsis
soft_szr channelStart[-channelEnd] script
Description
The soft_szr command can be used to start a script on a channel. The soft_szr command sends a message to the Transaction State Machine (TSM) process requesting that a script be started on a channel. If the channel is in use, the script is not started. Soft_szr waits for a response from TSM. When soft_szr exits, TSM has either accepted the request and started the script or rejected the request.
There are two arguments to the soft_szr command: channel and script . The channel argument specifies the channel (channelStart) or range of channels (channelStart-channelEnd) on which you want to start the script. The script argument specifies the script to be started. The script does not have to be in the table of assigned scripts.
The channel numbers must be valid and the channels must not be busy, and the channels must be in the inserv state. If you specify a channel that is busy, the command fails. If you specify a range of channels and one or more of the channels is busy, the command seizes the idle channels but fails for the busy channels.
Return values
If the soft_szr command is successful, a 0 value is returned. If any value other than 0 is returned, the soft_szr command completely or partially failed. If the soft_szr command returns a value of 2, the soft_szr command failed due to temporary condition. In this case, the user should attempt executing the dip_int command again.
Example
The following example starts the script sodapop on channels 0 through 4.
soft_szr 0-4 sodapop
The following example starts the script test1 on channel 10.
soft_szr 10 test1
