www.riscos.com Technical Support: Programmer's Reference Manual

ShellCLI

Introduction

This module provides a single * Command that allows you to invoke a command shell from a Wimp program.

It also has two SWIs for its own internal use. You must not use them in your own code.

SWI Calls

---

Shell_Create
(SWI &405C0)

This SWI call is for use by the ShellCLI module only. You must not use it in your own code.

---

Shell_Destroy
(SWI &405C1

This SWI call is for use by the ShellCLI module only. You must not use it in your own code

* Commands

---

*ShellCLI

Invokes a command shell from a Wimp program

Syntax

*ShellCLI

Parameters

None

Use

*ShellCLI invokes a command shell from a Wimp program, starting it as a Wimp task. It prompts the user with *, and passes each line that the user types to the command line interpreter, OS_CLI. This is repeated until the user enters a blank line, whereupon control is returned to the Wimp program. The Task Manager uses this command to implement its *Command (F12) menu item.

You must call *ShellCLI using *WimpTask or the SWI Wimp_StartTask, rather than using the command line or the SWI OS_CLI. You can only call Wimp_StartTask or *WimpTask from within an active task.

The command uses the two SWIs Shell_Create and Shell_Destroy; it is the only user of these SWIs.

Example

*WimpTask ShellCLI

Related commands

None

Related SWIs

Shell_Create, Shell_Destroy

Related vectors

None