AmigaOS 3.1 Command Reference

ICONX


Format:
ICONX

Template:
(none)

Purpose:
To allow execution of a script file from an icon.

Path:
C:ICONX

Specification:


ICONX allows you to execute a script file of AmigaDOS commands via an icon.

To use ICONX, create or copy a project icon for the script. Open the icon's
Information window and change the Default Tool of the icon to C:ICONX and
select Save to store the changed .info file. The script can then be executed
by double-clicking on the icon.

When the icon is opened, ICONX changes the current directory to the
directory containing the project icon before executing the script. An
input/output window for the script file will be opened on the Workbench
screen.

Several Tool Types can be specified in the icons for the script files. The
WINDOW Tool Type lets you provide an alternate window specification for the
input/output window. By default, the window's specification is:

WINDOW=CON:0/50//80/IconX/AUTO/WAIT/CLOSE

This has the effect of opening a window only if there actually is some
output performed by the script. If a window does open, it will remain
opened after the script terminates, until the user clicks on its close
gadget.

The WAIT Tool Type lets you specify the number of seconds the input/output
window should remain open after the script terminates. Using this option
will cause the default input/output window to not have a close gadget. There
is also a DELAY Tool Type which works in a very similar way, except that its
parameter is in 1/50th of a second, instead of in seconds.

The STACK Tool Type lets you specify the number of bytes to use for stack for
the script execution. If this Tool Type is not provided, the default 4096
bytes is used.

Finally, the USERSHELL Tool Type lets you cause the script file to be run
using the current User Shell instead of the normal ROM Shell. You must
specify USERSHELL=YES for this to happen. User Shells are third party shells
that you can purchase and install in your system to replace the standard
shell environment that comes with the operating system.

Extended selection can be used to pass files that have icons to the script.
Their filenames appear to the script as keywords. To use this facility, the
.KEY keyword must appear at the start of the script. In this case, the
AmigaDOS EXECUTE command is used to execute the script file.

See also:

EXECUTE


Converted from AmigaGuide to HTML by Jaruzel