NAME

       pvm_reg_rm - Register task as PVM resource manager.

SYNOPSIS

       C    #include <pvmsdpro.h>

            int cc = pvm_reg_rm( struct pvmhostinfo **hip )
            struct pvmhostinfo {
                 int  hi_tid;
                 char *hi_name;
                 char *hi_arch;
                 int  hi_speed;
            };

       Fortran   Not Available

PARAMETERS

       hostp  Returns pointer to a pvmhostinfo structure which contains information about the master host.

DESCRIPTION

       Registers the calling task as a PVM task and slave host manager.  This means it intercepts certain libpvm
       calls  from  other  tasks  in  order  to  have  a  say  in  scheduling policy.  The resource manager will
       asynchronously receive messages from tasks containing requests for service,  as  well  as  messages  from
       pvmds notifying it of system failures.

       Before  you  start using this function, be warned that it's not a trivial thing, i.e. you can't just call
       it to turn off the default round-robin task assignment.  Rather, it allows you to write your own resource
       manager and hook it to PVM.

       To understand what the following messages mean, you should refer to the PVM source code and/or user guide
       section on implementation; There's just too much to say about them.

       When one of the following libpvm functions is called in a task  with  resource  manager  set,  the  given
       message tag is sent to to resource manager.

           Libpvm call           RM message        Normal message
           pvm_addhosts()        SM_ADDHOST        TM_ADDHOST
           pvm_config()          SM_CONFIG         TM_CONFIG
           pvm_delhosts()        SM_DELHOST        TM_DELHOST
           pvm_notify()          SM_NOTIFY         TM_NOTIFY
           pvm_spawn()           SM_SPAWN          TM_SPAWN
           pvm_tasks()           SM_TASK           TM_TASK
           pvm_reg_rm()          SM_SCHED          TM_SCHED

       The resource manager must in turn compose the following messages and send them to the pvmds:

           RM message        Normal message
           SM_EXEC           DM_EXEC
           SM_EXECACK        DM_EXECACK
           SM_ADD            DM_ADD
           SM_ADDACK         DM_ADDACK
           SM_HANDOFF        (none - change of resource manager)

       The following messages are sent asynchronously to the resource manager by the system:

           RM message        Meaning
           SM_TASKX          notify of task exit/fail
           SM_HOSTX          notify of host delete/fail

       The  resource  manager  task  must  use  pvm_setopt(PvmResvTids,  1)  to allow sending reserved messages.
       Messages should be packed using encoding PvmDataDefault to ensure they can be unpacked  anywhere  in  the
       system.

       pvm_reg_rm() returns PvmOk when successful.

SEE ALSO

       pvm_addhosts(3PVM),     pvm_config(3PVM),    pvm_delhosts(3PVM),    pvm_notify(3PVM),    pvm_spawn(3PVM),
       pvm_tasks(3PVM)

                                                  4 March, 1994                                     REG_RM(3PVM)