mbx_deallocate()

MBX_$DEALLOCATE                   Domain/OS                    MBX_$DEALLOCATE


NAME
     mbx_$deallocate - deallocate a channel

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

     void mbx_$deallocate(
          void *&mbx_handle,
          short &mbx_channel,
          status_$t *status)

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

     procedure mbx_$deallocate(
          in mbx_handle: univ_ptr;
          in mbx_channel: integer;
          out status: status_$t);

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

           integer*4 mbx_handle, status
           integer*2 mbx_channel

           call mbx_$deallocate(mbx_handle, mbx_channel, status)

DESCRIPTION
     Mbx_$deallocate releases channel number mbx_channel of the mailbox speci-
     fied by mbx_handle from the client it is allocated to, so the channel can
     be allocated to another client.  It should usually be called by the mail-
     box server when it receives a mbx_$eof_mt message generated by a client's
     call to mbx_$close.  If the client attempts to use the channel after it
     is deallocated, it will get the mbx_$channel_not_open completion status.

     mbx_handle
          A mailbox handle.

     mbx_channel
          The channel to deallocate.

     status
          The completion status.
Museum
