NAME

pvm - PVM version 3 console

SYNOPSIS

pvm [ -options ] [ hostfile ]

DESCRIPTION

Pvm is a stand alone PVM task which allows the user to interactively query and modify the virtual machine. The console can be started and stopped multiple times on any of the hosts in the virtual machine without affecting PVM or any applications that may be running.

When started pvm determines if PVM is already running and if not automatically executes pvmd3 on this host, passing pvmd3 the command line options and host file. Thus PVM need not be running to start the console. Once started the console prints the prompt:
pvm>

The following console commands are available:

    add  hostname(s)    - Add hosts to virtual machine


    alias               - Define/list command aliases


    conf                - List virtual machine configuration


    delete  hostname(s) - Delete hosts from virtual machine


    echo                - Echo arguments


    export              - Add environment variables to spawn export list


    halt                - Stop pvmds


    help [command]      - Print helpful information about a command


    id                  - Print console task id


    jobs                - List running jobs


    kill  task-tid      - Terminate tasks


    mstat host-tid      - Show status of hosts


    ps -a               - List all PVM tasks


    pstat task-tid      - Show status of tasks


    quit                - Exit console


    reset               - Kill all tasks


    setenv              - Display/set environment variables


    sig  signum task    - Send signal to task


    spawn [opt] a.out   - Spawn task


         opts are: -(count)  number of tasks, default is 1
		   -(host)   spawn on host, default is any
		   -(ARCH)   spawn on hosts of ARCH
		   -?        enable debugging


                   ->        redirect task output to console


                   -> file   redirect task output to file


                   ->>file   redirect task output append to file


    trace               - Set/display trace event mask


    unexport - Remove environment variables from spawn export list


    unalias - Undefine command alias


    version - Show libpvm version

pvm reads $HOME/.pvmrc before reading commands from the tty, so it can be used to customize the console environment, for example:

    alias ? help


    alias j jobs


    setenv PVM_EXPORT DISPLAY


    # print my id


    echo new pvm shell


    id

EXAMPLES

pvm
Starts up pvmd3 on the local host or connects to running pvmd3.

pvm hostfile
Starts up console and pvmd3, which in turn reads the host file and adds the listed computers to the virtual machine.

SEE ALSO

pvm_intro(1PVM), pvmd3(1PVM)