User guide

122 CHAPTER 4. THE COMMAND LANGUAGE
The COUNT argument allows the user to specify how many Cintcode instr uct i ons to
obey for each raster line. The default is 1000. The SCALE argument gives t he raster
line granularity in bytes per pixel. The default being 12. The TO argument specifies
the name of the raster data file t o be written. The default file name is RASTER.
If raster is called without any arguments, it closes the raster data fil e . The raster
data file can be processed and converted to Postscript using the rast2ps command
described below. Typical use of the raster command is following script:
raster count 1000 scale 12 to RASTER
bcpl com/bcpl.b to junk
raster
rast2ps fh 18000000 mh 301000
This will create the Postscript file RASTER.ps for the BCPL compiler compiling itself,
similar to that shown in Figure 4.2.
record TO,OFF/S CIN:n, POS:y, NAT:n
This Cintpos command st ar t sending a recording including timing information of
the current console sessions to the specified file. The recording is stopped by the
command record off. See commands playback, playfast, and playtime.
rename FROM/A,TO=AS/A/K CIN:y, POS:y, NAT:y
This will rename the file given by FROM to that specified by the AS argument.
repeat CIN:y, POS:y, NAT:y
This attempt to reposition CLI input to the start of the current command line
thereby causing it to be executed again. For example:
wait 3; echo hello; repeat
will output hello to t he screen every 3 seconds until interrupted by the D flag (set by
@d).
run command-line CIN:y, POS:y, NAT:y
This command creates a new CLI task giving it command-line to execute. On
complete this new CLI task commits suicide.
send TASK/N,COUNT/N CIN:n, POS:y, NAT:n
This is part of the Cintpos bounce demonstration. It repe at edl y s en ds a packet
to the specified task the specified number of times. The default task number is 7 and
the default count is 1000000. It can be used to measure th e efficiency of inter-task
communication.
setflags TASK,A/S,B/S,C/S,D/S,E/S,QUIET/S CIN:n, POS:y, NAT:n
This Cintpos command sets th e specified flags in the task control block of the given
task. Unless QUIET is given it outputs the previous setting of the flags.
setlogname NAME,VALUE CIN:y, POS:y, NAT:y
This command sets or possible displays Cintsys or Cintpos l ogi c al variable s. These
must not be confused with s hell environments variables described in Section 3.6.