Learn more about Platform products at http://www.platform.com

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]



pam Command Reference


Contents

pam


Parallel Application Manager - job starter for MPI applications

SYNOPSIS

HP-UX vendor MPI syntax

bsub pam -mpi mpirun [mpirun_options ] mpi_app [argument ...]

SGI vendor MPI syntax

bsub pam [-n num_tasks ] -mpi -auto_place mpi_app [argument ...]

Generic PJL framework syntax

bsub pam [-t] [-v] [-n num_tasks ] -g [num_args] pjl_wrapper [pjl_options] mpi_app [argument ...]

pam [-h] [-V]

DESCRIPTION

The Parallel Application Manager (PAM) is the point of control for Platform LSF HPC. PAM is fully integrated with Platform LSF HPC to interface the user application with LSF. PAM acts as the supervisor of a parallel LSF job.

MPI jobs started by pam can only be submitted through the LSF Batch system. PAM cannot be used interactively to start parallel jobs. sbatchd starts PAM on the first execution host.

For all parallel application processes (tasks), PAM:

TASK STARTUP FOR VENDOR MPI JOBS

The pam command starts a vendor MPI job on a specified set of hosts in an LSF cluster. Using pam to start an MPI job requires the underlying MPI system to be LSF aware, using a vendor MPI implementation that supports LSF (SGI IRIX vendor MPI or HP-UX vendor MPI).

PAM uses the vendor MPI library to spawn the child processes needed for the parallel tasks that make up your MPI application. It starts these tasks on the systems allocated by LSF. The allocation includes the number of execution hosts needed, and the number of child processes needed on each host.

TASK STARTUP FOR LSF HPC GENERIC PJL JOBS

For parallel jobs submitted with bsub:

OPTIONS

OPTIONS FOR VENDOR MPI JOBS

-auto_place

The -auto_place option on the pam command line tells the SGI IRIX mpirun library to launch the MPI application according to the resources allocated by LSF.

-mpi

In the SGI environment, the -mpi option on the bsub and pam command line is equivalent to the mpirun command.

On HP-UX, you can have LSF manage the allocation of hosts to achieve better resource utilization by coordinating the start-up phase with mpirun. This is done by preceding the regular HP MPI mpirun command with:

bsub pam -mpi

For HP-UX vendor MPI jobs, the -mpi option must be the first option of the pam command.

For example, to run a single-host job and have LSF select the host, the command:

mpirun -np 14 a.out

is entered as:

bsub pam -mpi mpirun -np 14 a.out

-n num_tasks

The number of processors required to run the MPI application, typically the number of parallel tasks in the job. If the host is a multiprocessor, one host can start several tasks.

You can use both bsub -n and pam -n in the same job submission. The number specified in the pam -n option should be less than or equal to the number specified by bsub -n. If the number of tasks specified with pam -n is greater than the number specified by bsub -n, the pam -n is ignored.

For example, on SGI IRIX or SGI Altix, you can specify:

bsub -n 5 pam -n 2 -mpi -auto_place a.out

Here, the job requests 5 processors, but PAM only starts 2 parallel tasks.

mpi_app [argument ...]

The name of the MPI application to be run on the listed hosts. This must be the last argument on the command line.

-h

Prints command usage to stderr and exit.

-V

Prints LSF release version to stderr and exit.

OPTIONS FOR LSF HPC GENERIC PJL JOBS

-t

This option tells pam not to print out the MPI job tasks summary report to the standard output. By default, the summary report prints out the task ID, the host on which it was executed, the command that was executed, the exit status, and the termination time.

-v

Verbose mode. Displays the name of the execution host or hosts.

-g [num_args] pjl_wrapper [pjl_options]

The -g option is required to use the LSF HPC generic PJL framework. You must specify all the other pam options before -g.

num_args

Specifies how many space-separated arguments in the command line are related to the PJL (after that, the remaining section of the command line is assumed to be related to the binary application that launches the parallel tasks).

pjl_wrapper

The name of the PJL

pjl_options

Optional arguments to the PJL

For example:

-n num_tasks

The number of processors required to run the MPI application, typically the number of parallel tasks in the job. If the host is a multiprocessor, one host can start several tasks.

You can use both bsub -n and pam -n in the same job submission. The number specified in the pam -n option should be less than or equal to the number specified by bsub -n. If the number of tasks specified with pam -n is greater than the number specified by bsub -n, the pam -n is ignored.

mpi_app [argument ...]

The name of the MPI application to be run on the listed hosts. This must be the last argument on the command line.

-h

Prints command usage to stderr and exit.

-V

Prints LSF release version to stderr and exit.

EXIT STATUS

pam exits with the exit status of mpirun or the PJL wrapper.

SEE ALSO

bsub(1)

[ Top ]


[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]


      Date Modified: March 13, 2009
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2009 Platform Computing Corporation. All rights reserved.