PVM/ICM(Sept. 1995)

NAME
pvm_maximatask - generats pvm task for a maxima process

SYNOPSIS
pvm_maximatask [ -L maxima ] [ -N executable ] file.o ...

DESCRIPTION
Given a set of maxima object files (as simple file names) pvm_maximatask generates a csh shell script that can be executed as a pvm task. You will be asked to enter a main function name (MAIN) which is the entery point to the pvm task. The script performs the following steps: (1) establishes a log file (/tmp/${USER}LOG.$$) for any output or error produced by the task, (2) collects and formulats command-line arguments, (3) loads the named object files into maxima+pvm or the system given by the -L option, (4) invokes the maxima top-level command
MAIN( "argv[1]", "argv[2]", ...);
Note the command-line arguments are passed as maxima strings to MAIN. (5) exits from maxima and terminates. The generated program can be named by the -N option. The maxima system used is /usr/local/bin/maxima+pvm, a version of maxima with the clpvm interface loaded, or given by the -L option. The shell script can be edited and later distributed using pvm_distrib. For example,
% pvmmc maxima-hello.lsp maxima-hello_other.lsp
% pvm_maximatask -N maxima-hello maxima-hello.o
% pvm_distrib maxima-hello maxima-hello_other
The maxima objects (file.o ...) are assumed to be located in the local_disk_bin directory.

FILES
local_disk_bin symbolic link     $HOME/pvm3/local_disk_bin
Default local-disk location      /tmp/pvm_bin.$USER
Task log file                    /tmp/${USER}LOG.$$
maxima task examples             $PVM_ROOT/UTIL/clpvm/examples/maxima
~