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)

                                         30 August, 1993                                PVM(1PVM)