1REG_RM(3PVM)                    PVM Version 3.4                   REG_RM(3PVM)
2
3
4

NAME

6       pvm_reg_rm - Register task as PVM resource manager.
7
8

SYNOPSIS

10       C    #include <pvmsdpro.h>
11
12            int cc = pvm_reg_rm( struct pvmhostinfo **hip )
13            struct pvmhostinfo {
14                 int  hi_tid;
15                 char *hi_name;
16                 char *hi_arch;
17                 int  hi_speed;
18            };
19
20       Fortran   Not Available
21
22

PARAMETERS

24       hostp  Returns pointer to a pvmhostinfo structure which contains infor‐
25              mation about the master host.
26
27

DESCRIPTION

29       Registers the calling task as a PVM task and slave host manager.   This
30       means  it  intercepts certain libpvm calls from other tasks in order to
31       have a say in scheduling  policy.   The  resource  manager  will  asyn‐
32       chronously receive messages from tasks containing requests for service,
33       as well as messages from pvmds notifying it of system failures.
34
35       Before you start using this function, be warned that it's not a trivial
36       thing,  i.e. you can't just call it to turn off the default round-robin
37       task assignment.  Rather, it allows you to write your own resource man‐
38       ager and hook it to PVM.
39
40       To understand what the following messages mean, you should refer to the
41       PVM source code and/or user guide section  on  implementation;  There's
42       just too much to say about them.
43
44       When  one  of  the  following libpvm functions is called in a task with
45       resource manager set, the given message tag is sent to to resource man‐
46       ager.
47
48           Libpvm call           RM message        Normal message
49           pvm_addhosts()        SM_ADDHOST        TM_ADDHOST
50           pvm_config()          SM_CONFIG         TM_CONFIG
51           pvm_delhosts()        SM_DELHOST        TM_DELHOST
52           pvm_notify()          SM_NOTIFY         TM_NOTIFY
53           pvm_spawn()           SM_SPAWN          TM_SPAWN
54           pvm_tasks()           SM_TASK           TM_TASK
55           pvm_reg_rm()          SM_SCHED          TM_SCHED
56
57       The  resource  manager  must in turn compose the following messages and
58       send them to the pvmds:
59
60           RM message        Normal message
61           SM_EXEC           DM_EXEC
62           SM_EXECACK        DM_EXECACK
63           SM_ADD            DM_ADD
64           SM_ADDACK         DM_ADDACK
65           SM_HANDOFF        (none - change of resource manager)
66
67       The following messages are sent asynchronously to the resource  manager
68       by the system:
69
70           RM message        Meaning
71           SM_TASKX          notify of task exit/fail
72           SM_HOSTX          notify of host delete/fail
73
74       The  resource manager task must use pvm_setopt(PvmResvTids, 1) to allow
75       sending reserved messages.  Messages should be  packed  using  encoding
76       PvmDataDefault to ensure they can be unpacked anywhere in the system.
77
78       pvm_reg_rm() returns PvmOk when successful.
79
80

SEE ALSO

82       pvm_addhosts(3PVM),        pvm_config(3PVM),        pvm_delhosts(3PVM),
83       pvm_notify(3PVM), pvm_spawn(3PVM), pvm_tasks(3PVM)
84
85
86
87                                 4 March, 1994                    REG_RM(3PVM)
Impressum