.\" $Id: pvm.1,v 1.1 1996/09/23 21:50:24 pvmsrc Exp $
.TH PVM 1PVM "30 August, 1993" "" "PVM Version 3.4"
.SH NAME
pvm \- PVM version 3 console
.SH SYNOPSIS
.ft B
pvm
[
\-options
]
[
hostfile
]
.ft R
.SH DESCRIPTION
.I 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.
.PP
When started \fIpvm\fR 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:
.br
	pvm>

The following console commands are available:
.nf
    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
.fi
.PP
.I pvm
reads $HOME/.pvmrc before reading commands from the tty,
so it can be used to customize the console environment,
for example:
.nf
    alias ? help
    alias j jobs
    setenv PVM_EXPORT DISPLAY
    # print my id
    echo new pvm shell
    id
.fi
.SH EXAMPLES
	pvm
.br
Starts up pvmd3 on the local host or connects to running pvmd3.

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

.SH SEE ALSO
pvm_intro(1PVM), pvmd3(1PVM)