ShellCLI

Contents

• Introduction and Overview
• SWI calls
  • Shell_Create
  • Shell_Destroy
• *Commands
  • ShellCLI

Introduction and Overview

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 &45290)

This SWI call is for internal use 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 SWIs

Shell_Create, Shell_Destroy

Document information

Maintainer(s):	RISCOS Ltd <developer@riscos.com>
History:	Revision Date Author Changes 1 ROL Initial version
Disclaimer:	Copyright © Pace Micro Technolgy plc, 2002. Portions copyright © RISCOS Ltd, 2002. Published by RISCOS Limited. No part of this publication may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, or stored in any retrieval system of any nature, without the written permission of the copyright holder and the publisher, application for which shall be made to the publisher.