1.3.1 The cogsys program

This is a simplified syntax of the Cogsys program:

run [ testlist [outfile]]

Cogsys needs to know two important things whenever it starts up:

1. Where to read its testlist (testlist name)
2. Where to write its outfile (outfile name)

At the top of the outfile, before any data is written, Cogsys will write the testlist name and outfile name.

Without any arguments at all, Cogsys will use `cogsys.in' for the input file and `cogsys.out' for the output file. Normally, these same names will be used for the testlist label and outfile label, respectively. See Invoking Cogsys, for exceptions.

A single argument specifies a testlist other than `cogsys.in' In this case, the outfile is written to `cogsys.out'. It is written to the current directory, that is, the directory from which Cogsys was run, not the directory where the testlist is located. This was how the sample testlist was run above.

cogsh# run sample/hello.in

Two arguments specify both a testlist and an outfile. Here, the outfile is written to wherever the user specifies. If Cogsys cannot open the file, it will give a runtime error.

cogsh# run sample/hello.in hello.out

In all of these cases, the labels used in the outfile are simply the actual names of the testlist and outfile used.

For more details on how to specify labels and an explanation of other command line options, see Invoking Cogsys.