CCP4 web logo CCP4i: Graphical User Interface
Run Tests

next button previous button top button

Program Testing

File Location

Using Local directories.def

Program Testing

The Run Tests option in the System Administration menu is intended for use by program developers to rerun test jobs. It will repeat all the tasks in the current project (or a selected range of them) in the order they appear in the database. A new project is created as a sub-directory of the current project and the output files are written to that new project. The user can follow progress by watching the Job List window where initially all jobs are reported as 'ON_HOLD'. As each job is run it is updated as 'RUNNING' and 'FINISHED'.

The Run Tests option can be used to set up test runs interactively or with the following command line:

ccp4i -autotest [-project project_name] [-target target_directory] [-first first_job] [-last last_job] [-remote machine_name] [-exit]

-project project_name

Rerun tasks from the project_name project. project_name must be a project alias defined in the current directories.def.

-target target_directory

Create a new project and project directory called target_directory. If no name is provided, a name will be constructed from the date (e.g. 10_oct_2000).

-first first_job

Rerun jobs starting at job number first_job.

-last last_job

Rerun jobs finishing at job number last_job.

-remote machine_name

Rerun the jobs on the remote machine machine_name but note that the controlling CCP4i process will run on the local machine.


Exit the controlling CCP4i process when the tasks are completed.

File Location

When rerunning a test job, CCP4i will:

  • put all output files in the target directory;
  • look first for an input file in the target directory (it will find files output by preceding job). If no suitable files are there, it will look in the master project directory.

So beware: the order of tasks in the test project may affect the results.

Using Local directories.def

By default a directories.def file (defining the project names and directories) in the directory in which the CCP4i process is started, takes precedence over any other directories.def. This means that a tester should work in a master directory which contains a directories.def defining the test projects, and the test projects themselves preferably as sub-directories of that master directory. It is possible to run through several project directories with a controlling script.

next button previous button top button