mbx_start_helper() — Apollo Domain/OS SR10.4

MBX_$START_HELPER                 Domain/OS                  MBX_$START_HELPER


NAME
     mbx_$start_helper - start a mailbox helper

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

     boolean mbx_$start_helper(status_$t *status)

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

     function mbx_$start_helper(
          out status: status_$t): boolean;

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

           integer*4 status
           logical started

           started = mbx_$start_helper(status)

DESCRIPTION
     Mbx_$start_helper starts a mailbox helper on the caller's node if one is
     not already running.  It returns true if the mailbox helper was not
     already running and it had to start one.  It returns false if a mailbox
     helper was already running.

     This call is useful only in servers because a mailbox helper will be
     automatically started for clients when necessary.

     status
          The completion status.  If status is status_$ok when
          mbx_$start_helper returns, there is a mailbox helper running and
          mailbox access to remote nodes.
Museum
