[ ECLiPSe message passing built-in.|Group Index| Full Index]

mps_init(+Host)

Inititialise the message passing subsystem, using name server on Host.

+Host
Atom or string.

Description

This predicate does initialisation of the message passing subsystem and associates the ECLiPSe process with a name server. This is the first step to be taken by every process for becoming part of a distributed ECLiPSe application. The name server is identified by the name of the host on which the name server resides. The name of the host is a simple string, e.g. "tricky", "tricky.ecrc.de", or "141.1.3.150".

Fail Conditions

None.

Resatisfiable

No.

Exceptions

(4) Instantiation fault
Host is not instantiated.
(5) Type error
Host is not a string or atom.
(176)
Message passing system error

Examples

   
    [eclipse 1]: mps_init(breeze).
    yes.
    [eclipse 2]: mps_port_allocate(true/0, Port).
    Port = 2050162692
    yes.
    [eclipse 3]: mps_send(2050162692,"Hello World !").
    yes.
    [eclipse 4]: mps_receive(2050162692, Message).
    Message = "Hello World !"
    yes.
    [eclipse 5]: mps_port_deallocate(2050162692).
    yes.
    [eclipse 6]: mps_exit. 
    yes.

    [eclipse 7]: mps_init(notahost).    
    message passing error in mps_init(notahost, _81)



See Also

mps_ping / 1, mps_exit / 0, mps_port_register / 4, mps_port_lookup / 3, mps_port_deregister / 3, mps_port_allocate / 2, mps_port_deallocate / 1, mps_send / 2, mps_receive / 2