newsess(1)                                                          newsess(1)


NAME
     newsess - start a new array session

SYNOPSIS
     newsess [-l] [-g] [-h ASH] [-p project] [[-s] shell-args]

DESCRIPTION
     The newsess command starts a new array session.  The user remains logged
     in and the current directory is unchanged.  If the change is successful,
     the user will be given a new shell.  The original shell, and any
     processes it may have had running, will remain alive and associated with
     the original array session.  Thus, exiting the new shell will return the
     user to the original shell and original array session.

     By default, the new array session will be a global array session (see
     array_sessions(5) for more information on this subject).  Some systems
     are capable of generating their own global array session handles
     internally, while others must request a global handle from an array
     services daemon.  If the -l option is specified, the system will not try
     to contact an array services daemon; this will result in a purely local
     array session handle on systems that do not internally generate global
     handles.  On the other hand, the -g option will force the system to
     obtain a global array session handle from an array services daemon, even
     if the system could have generated a global handle internally.  In this
     case, newsess will fail if an array services daemon is not available.
     The -g and -l options are mutually exclusive.

     The -p option can be used to set the new array session's project to
     project.  By default, the new array session will belong to the same
     project as the current array session.  If the user is not the superuser,
     then the user must be authorized for project in the /etc/project file.

     The superuser may force a specific array session handle to be used by
     specifying the -h ASH option.  An error will occur if ASH is already in
     use by another array session.  The -g and -h options are mutually
     exclusive.

     The first unrecognized command line argument, and all remaining arguments
     that follow it, will be passed to the new shell as arguments.  The
     newsess option -s can be used to force the rest of the command line to be
     treated as shell arguments.  This is useful if it is necessary to pass an
     option to the shell that also happens to be a valid newsess option.  When
     using shells like sh(1), an argument of the form -c string executes
     string via the shell and an argument of -r will give the user a
     restricted shell.

NOTES
     The array services daemon (arrayd(1M)) must be running on the local
     machine in order to start a new global array session.  It is not required
     for a new local array session.


SEE ALSO
     newproj(1), newarraysess(2), array_services(5), array_sessions(5).


                                                                        Page 2