mbx_close(A) — Apollo Domain/OS SR10.4.1

MBX_$CLOSE                        Domain/OS                         MBX_$CLOSE


NAME
     mbx_$close - close a channel or mailbox

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/mbx.h>

     void mbx_$close(
          void *&mbx_handle,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/mbx.ins.pas';

     procedure mbx_$close(
          in mbx_handle: univ_ptr;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/mbx.ins.ftn'

           integer*4 mbx_handle, status

           call mbx_$close(mbx_handle, status)

DESCRIPTION
     When a client calls mbx_$close, the server for the mailbox on mbx_handle
     receives an mbx_$eof_mt message on that client's channel.  Mbx_$eof_mt is
     usually a signal that the server should call mbx_$deallocate to deallo-
     cate the client's channel so it can be allocated to another client.

     When a server calls mbx_$close, it closes the server's mailbox.

     mbx_handle
          The mailbox handle.

     status
          The completion status.
Museum
