* IBM MPL * * IBM MPL * * IBM MPL * * IBM MPL * * IBM MPL * * IBM MPL * 
--------------------------------------------------------------------------
|  Instructions for POE debugging:
|  To be used AFTER first running the interactive example as is (w/o debugging).
--------------------------------------------------------------------------

1) Make sure you are in the IBM POE(MPL) environment, type: 

   prompt> startmpl

2) In your copy of the sample directory, type:

   prompt> make -f make.mpl

   The makefile will direct the compilation and linking of the 
   programs.  

3) Set the environment variable describing the parallel programming
   model (spmd or mpmd).  For this tutorial, the proper setting is mpmd:

   prompt> setenv MP_PGMMODEL mpmd

3) In the sample directory, start the pdbx debugger (which, in turn, starts
   the Parallel Operating Environment (POE).  For this tutorial, we take
   advantage of the command preprocessing option of the pdbx command
   to read (and then execute) some debugging commands from a file.

   prompt> pdbx -c debug.commands

   The commands in the file debug.commands load the mplmanager executable
   on node 0, and create a group of "workers", loading the mplworker
   executable on each of the "worker" nodes.
   (These commands could also be entered by hand after pdbx is started.)

   The response should resemble the following:


>  grand17>  pdbx -c debug.commands
>  Version 2.0                   Dec 16 1994 13:51:24
>  
>  WARNING: 0031-402  Using css0 as euidevice for User Space job
>  WARNING: 0031-403  Forcing dedicated adapter for User Space job
>  WARNING: 0031-403  Forcing dedicated adapter for User Space job
>  WARNING: 0031-403  Forcing dedicated adapter for User Space job
>  WARNING: 0031-403  Forcing dedicated adapter for User Space job
>  
>  pdbx(all) 0029-2040 3 tasks added to group workers
>  
>  pdbx(all) 
>  pdbx(all) reading symbolic information ...
>  reading symbolic information ...
>  reading symbolic information ...
>  reading symbolic information ...
>  [1] stopped in mplmanager at line 27 in file "mplmanager.f"
>     27         call MP_ENVIRON(nprocs,nodeid)
>  [1] stopped in mplworker at line 21 in file "mplworker.f"
>     21         call MP_ENVIRON(nprocs,nodeid)
>  [1] stopped in mplworker at line 21 in file "mplworker.f"
>     21         call MP_ENVIRON(nprocs,nodeid)
>  [1] stopped in mplworker at line 21 in file "mplworker.f"
>     21         call MP_ENVIRON(nprocs,nodeid)
>  0031-504  Partition loaded ...
>  
>  pdbx(all)



4) Breakpoints for each node (or group of nodes) can be set using
   various pdbx commands.  See the Parallel Environment Operation
   and Use reference manual (in /doc/pedocs/peopsuse.ps) or the pdbx 
   manpage for details.

   The command "cont" ("continue") can be use to start the loaded programs
   running, or continue execution after breakpoints have been reached.

5)  Enter the command "quit" to quit the pdbx debugger.


--------------------------------------------------------------------------
|  Please direct any questions, comments or suggestions            
|  to karin@cam.nist.gov.                                          
--------------------------------------------------------------------------