5SCRIPTS: cyana - CYANA shell script

Synopsis: cyana [option] [macro] [parameters]

The 'cyana' shell script starts the CYANA program, or runs CYANA as a
background or batch job, if one of the options -a, -n, or -q is present.
If present, the given <macro> is executed by CYANA, otherwise the program
will prompt for interactive input. The <macro> name can be given with or
without the '.cya' extension.

The 'cyana' command can only be invoked from the Unix shell. The command
syntax follows Unix (not INCLAN) conventions.

Options:

  -h            help
  -a file       start job only after <file> exists
  -c <command>  command to start program
  -n <nproc>    number of processors
  -q <queue>    batch queue, or - to run in background
  -S            run in safe mode, i.e. within one directory
  -t <system>   use executable for explicit system type
  -x            display name of executable without executing it

Executables for several different system types can be installed
simultaneously. The 'cyana' script chooses automatically an executable
that is suitable for the present computer and operating system.
Alternatively, the system type can be chosen explicitly with the '-t'
option.

The '-c' option can be used, for example, to start a parallel MPI
version of the program with 'mpirun', or to run CYANA under the control
of a debugger. For example,

  cyana -t intel-debug -c gdb

starts a CYANA version for the system type 'intel-debug' (compiled with
the Intel Fortran compiler using switches to include debugging
information) under the control of the GNU debugger, 'gdb'.

The given macro file can be executed in parallel as a batch or background
job. For instance, the command

  cyana -n 20 CALC

will exceute the macro file 'CALC.cya' as a batch job using 20 processors
in parallel.

The batch job submission is machine-dependent and must be adapted to the
particular application environment.
