newarraysess(2)                                                newarraysess(2)


NAME
     newarraysess - start a new array session

SYNOPSIS
     #include <unistd.h>

     int newarraysess(void);

DESCRIPTION
     The newarraysess function creates a new array session and moves the
     current process from its original array session to the new one.  The
     parents, children and siblings of the current process are not affected by
     this and remain in their original array sessions.

     A handle for the new array session will be generated by the system.
     Normally the new handle is guaranteed to be unique on the current system
     only, though some systems may be able to assign global array session
     handles that are unique across an entire array of systems by setting the
     asmachid system variable.  Otherwise, the range of values that the system
     may assign for array session handles is defined by the system variables
     min_local_paggid and max_local_paggid.  System variables can be examined
     and/or modified with systune(1).  If necessary, the setash(2) function
     can be used to override the default handle after the array session has
     been created.

     The project ID and service provider information for the new array session
     are taken from the original array session of the current process.  They
     can be changed after the new array session has been created using the
     setprid(2) and setspinfo(2) functions.

     For the purposes of array session accounting, it is undefined whether the
     resources used by the current process are charged to the original array
     session, the new array session, or split between both in some fashion.
     It is guaranteed that the process resources will be charged to at least
     one of the two array sessions, and that if the resources are split
     between the two array sessions, they will be split cleanly (in other
     words, no "double-billing" will take place).

     Ordinarily, a new array session should be started whenever the conceptual
     equivalent of a login is performed.  This would include programs that do
     conventional logins (for example, login(1) or telnet(1)) as well as
     programs that are essentially "logging in" to do work on behalf of
     another user, such as cron(1) or batch queueing systems.

     Using the arsop(2) function, it is possible to restrict the processes in
     an array session from starting a new array session.  If this has been
     done, then newarraysess will fail with an EPERM error.

ERRORS
     newarraysess may fail if the following condition is true:


     ENOMEM    The system is unable to allocate memory or other resources for
               the new array session.

     EPERM     The current array session has been restricted from starting new
               array sessions.

     EINVAL    The current process is a batch process (see miser(1) ). It is
               not possible to create a new array session for a batch process.

SEE ALSO
     systune(1), miser(1), arsop(2), setash(2), setprid(2), setspinfo(2),
     array_sessions(5), extacct(5).

DIAGNOSTICS
     Upon successful completion, newarraysess returns a value of 0.
     Otherwise, a value of -1 is returned and errno is set to indicate the
     error.


                                                                        Page 2