Museum

SYSCALLS/MBX - mailbox manager module     82/03/30


Include files:

    Fortran:    /sys/ins/mbx.ins.ftn
    Pascal:     /sys/ins/mbx.ins.pas

NOTE: If you use the mailbox manager for INTER-NODE interprocess communication,
      the participating nodes must all be running the mbx helper process. The
      program that implements this process is "/SYS/MBX/MBX_HELPER" and can be
      run either in a normal process or started via the display manager CPO
      command, as:

                     CPO  /SYS/MBX/MBX_HELPER

Procedures and Functions:

    mbx_$get_rec(handle, bptr, blen, rptr, rlen, status)
         get a record from the mailbox


    mbx_$get_conditional(handle, bptr, blen, rptr, rlen, status)
         get a record from the mailbox if there is one

    mbx_$get_rec_chan(handle, chan, bptr, blen rptr, rlen, status)
         get a record from a specific channel of the mailbox (Servers only)

    mbx_$cond_get_rec_chan(handle, chan, bptr, blen rptr, rlen, status)
         get a record from a specific channel of the mailbox
         if there is one  (Servers only)

    mbx_$put_rec(handle, bptr, blen, status)
         put a record into the mailbox

    mbx_$put_chr(handle, bptr, blen, status)
         put a partial data record into the mailbox

    mbx_$put_rec_conditional(handle, bptr, blen, status)
         put a record into the mailbox if there is space

    mbx_$open(name, len, bptr, blen, handle, status)
         Open the mailbox (client's call) given a name. The mailbox
         must exist, and a server must laready have the mailbox open.

    mbx_$create_server(name, len, datsiz, maxch, handle, status)
         Create a mailbox (server's call) creates a mailbox if it
         doesn't exist and initializes an existing mailbox file.

    mbx_$close(handle, status)
         Close a mailbox (servers and clients BOTH call this)
               CLIENT: Send EOF message on channel to server
               SERVER: Close mailbox and de-allocates all channels.

    mbx_$deallocate(handle, channel, status)
         Release a channel (Usually called by server after
               receipt of channel closed control msg.)

    mbx_$get_ec (handle, key, ecp, status)
         Return a level 2 eventcount pointer for the given mailbox.