INshell command line (inshell.rta)

INshell is a command line interpreter for INtime, especially used with INtime Distributed RTOS. It has a basic command line interface and also the ability to execute scripts of commands. (INtime Distributed RTOS only)

INshell should be started on NodeA, then use the -node option to execute commands on other nodes.

Command line

inshell.rta [options] [filename]

Available options

-addon "rsl[;rsl_list]": Takes a string argument which is a list of rsls with additional commands.
-c scriptfile/command: Load and execute a scriptfile or a command and exit the INshell application.
-d or -debug: enable debug messages (internal).
-h or -help: Gives a short help screen on the command line arguments.
-k: Start interactive session (default).
-nologon: Skip user name and password check at startup of INshell.
-p or -priority numeric-value: Set Priority of this application (default is 250), valid range 3 - 253

Usage

The utility is started without arguments. A short version info is displayed and interactive command line interface is provided. The interface has some built in commands and can execute external rta or script files.

The utility can also be used to start script files as a kind of batch file processor. There is support for string variables, conditions and environment variables.

Commands

To get a list of supported commands, use the help command. To get details on specific command, use help and the command in interest, e.g. help accounting

To target a node other than NodeA (where inshell.exe is running) use the -node option:

process -node NodeB list: Executes the process list command on NodeB and returns the output to the console.
launch -node NodeC -wait myapp.rta: Executes myapp.rta on NodeC and waits for its completion, showing any output on the local console.

Command	Description
accounting	set/examine thread accounting
alias	manage aliases
attrib	display, set, or remove attributes assigned to files
cd	change directory
chdir	change directory
cls	clear display
copy	copy source to destination file or directory
del	delete a file or files
delete	delete a file or files
device	list or set PCI device node
dir	list files and subdirectories in a directory
echo	echo to screen
exit	quit the shell
help	display list of commands, or help for each command
history	display console history buffer
info	read resource info from rta/rsl
keyb	keyboard information and control
last_error	get result of last rt command executed
launch	launch a command with system parameters
license	list system license
md	create a new directory
mkdir	create a new directory
net	list or set network parameters
node	node information and control
pause	wait for any key to be pressed
process	process information and control
pwd	print program working directory
rd	remove an existing directory
reboot	reboot system
ren	renames a file or a directory
remdir	remove an existing directory
set	display list of environment variables, or examine or set an environment variable
setreboot	set/examine reboot pending flag
shutdown	shutdown system
sleep	sleep for <delay> seconds
syslog	display/clear system log on screen
system	list or set system parameters
systeminfo	display system information about RTOS
time	get or set system time and date
type	print a text file to screen
uptime	display time since boot
ver	show version
which	display full path name for command

Script files

Scriptfiles support all internal commands, can launch programs and have same basic flow control. Every line is parsed separately, so a command cannot spawn more lines.

A special script file for each node named startup.rsc is in the directory: /config/<node name>. This script file supports a subset

Comment lines start with # or ' and cannot be part of other lines.
Labels start with :
Variables are treated as strings and are defined with keyword var, one per line
Assignments are done with single =
Comparisons support equal == or not equal != and are used within conditions if .. then .. else
External processes are started and the interpreter waits until the command has finished. To start a process without waiting for the end of process the command launch can be used. External processes use the launch command with option -wait specified.
Every line which contains a command or external process gets printed on screen. A line can be suppressed by a leading @. This behavior can be changed by the echo off command and restored by echo on. To suppress the output of the echo off command itself, the command can be written as @echo off
exit has a slightly different usage in script files as it does not exit INshell, but only exits the script.
Environment variables can be accessed by the name enclosed in %, e.g. %PATH%
A special environment variable is available, the ?, which gives the result of last launched command.

Script file utilities

These utilities can be useful within a script file:

waitfor.rta - Wait for a handle to be cataloged in a process' object directory.

waitnode.rta - Wait for a node to be ready to load new applications.

waitproc.rta - Wait for a process to be loaded on the local node.

Sample script

var s
 
# comment
' comment
 
s = test
 
if s == h then goto label1
if s == test then goto label4 else goto label2
 
# never executed
 
:label4
ifconfig
if %?% != 0 then goto error
 
:label1
goto label2
:label3
s = %TEMP%
echo s
cd s
if %TEMP% != s then goto label2 else exit
 
:label2
echo s
goto label3
 
:error
echo an error occurred on external command