DP_CREATE(2-N)             SYSTEM CALLS            DP_CREATE(2-N)


NAME
     dp_create -- create an MPPG (Message Passing Process Group)


SYNOPSIS
     #include <sys/mppg.h>

     unsigned long long dp_create(int tally, int flag);


DESCRIPTION
     dp_create  generates an MPPG and returns an ID for the MPPG,
     dpid.  This system call should be executed only  once  in  a
     distributed parallel program.

     tally  is  an  integer value that will be reflected into the
     process account of the MPPG  processes  as  the  distributed
     parallel  program  id.  Because this code is used to specify
     the process that composed a distributed parallel program, it
     should set a value with the least possibility of conflict.

     flag  specifies  the  type  of  MPPG  to be generated.  When
     DP_MULTI is specified, it generates a multi-node  MPPG,  and
     when  DP_SINGLE  is  specified,  it  generates a single-node
     MPPG.

     The effective user ID of the calling process must  be  super-
     user to use this call.

     dp_create fails if one or more of the following are true:

     [ENOPKG]   Neither SUPER-MNS nor SX-GM are installed.

     [ENOPKG]   Software lock is not unlocked.

     [ENOPKG]   flag  is DP_MULTI but SUPER-MNS is not installed.

     [EIO]      flag is DP_MULTI but the IXS is unavailable.

     [EINVAL]   flag is not a valid value.

     [EPERM]    The effective user ID of the calling  process  is
                not superuser.

     [EAGAIN]   The MPPG table is full.

     [EAGAIN]   There is no free GCR.

SEE ALSO
     acctcom(1),     dp_join(2),    dp_exit(2),    dp_xmalloc(2),
     dp_xmfree(2), dp_xmshare(2), dp_xmatt(2),
     dp_cntl(2), dp_kill(2), dp_resume(2)
     Global Memory in the SUPER-UX Programmer's Guide




SUPER-UX            Last change: Oct 13, 1999                   1





DP_CREATE(2-N)             SYSTEM CALLS            DP_CREATE(2-N)


DIAGNOSTICS
     Upon  successful  completion,  dp_create  returns a dpid, an
     MPPG ID.  Otherwise, a value of -1 is returned and errno  is
     set to indicate the error.





















































SUPER-UX            Last change: Oct 13, 1999                   2