User guide

112 CHAPTER 4. THE COMMAND LANGUAGE
bounce CIN:n, POS:y, NAT:n
This command is part of the bounce demonstration that is only available under
Cintpos. It is normally invoked by the command: run bounce which creates a new
CLI task and then enters the bounce program whose main loop is:
qpkt(taskwait()) REPEAT
which repeatedly suspends the task until a packet is received then immediately returns
it to the sender. Packets ar e normally sent to the bounce task using the send comm and,
described below.
break TASK/A,A/S,B/S,C/S,D/S,E/S,ALL/S CIN:n, POS:y, NAT:n
This Cint pos command is used to break the normal exec uti on of a specified task.
The first argument gives the task number and the remaining arguments specify which
flags to set. If no flags are specified flag B is set. If ALL is specified all the flags from
A to E are set.
c command-file arguments CIN:y, POS:y, NAT:y
The c command allows a file of commands to be executed as though they had just
been typ ed in. The argument command-file gives the name of the file contai ni ng the
command sequence. It fir st looks in the curre nt directory then the directories specified
by the scripts environment variab l e whose name is i n the rtn
scriptsvar field of
the rootnode, and finally, if that fails, it looks in the directory specified by the root
environment variable whose name is in the rtn
rootsvar field of the rootnode.
Unless explicitly changed, the characters ’=’, ’<’, ’>’, ’$’ and ’.’ have spec i al mean-
ings within a command c ommand . A dot ’.’ at the start of a line starts a directive
which can specify the command command’s argument format, or replace one of the
special character with an alternative. There are six possible directives as follows:
.KEY or .K str Argument format string.
.DEFAULT or .DEF key value Give key a default value, optionally, = is
allowed between the key and value.
.BRA ch Use ch i n st ead of <
.KET ch Use ch i n st ead of >
.DOLLAR ch Use ch instead of $
.DOT ch Use ch i n st ead of .
All directives must occur at t he star t of the command file. The .KEY directive
specifies a format string of the form used by rdargs (see page 58) that describes
what ar gume nts can follow the command file name. The .DEFAULT directive specifies
the default value that a specified key should have if the corresponding argument was
omitted. The remaining di r e ct i ves allow the special characters to be changed.
The command sequence occ ur s after all the directives and may contain items of the
form <key$value> or <key> where key is one of the keys in the format string and value
is a default value. Such items are textually replaced by its corresponding argument or
a default value. If $valu e is present, this overrides (for this ite m only) any default th at
might have been given by a .DEFAULT directive.