9.5;cp (create_process) *DM*, revision 9.5, 86/07/24
CP (CREATE_PROCESS) -- Create process, pads, and windows.
usage:  [region]cp [-i] [-c 'char'] [-n name] pathname [args ...]


FORMAT

  [region]CP [options] pathname [args ...]


  CP  creates  a  process,  input  and transcript pads, and input and transcript
  windows, then executes a program (indicated by the 'pathname' argument) within
  that process.

  To  create  a  process  running the Shell, either press the <SHELL> key (which
  causes everything to happen automatically) or specify /COM/SH for 'pathname'.

  To stop a Shell and delete all windows and pads  associated  with  its  parent
  process,  type  CTRL/Z  in the Shell's process input pad, then CTRL/N to close
  the window.


ARGUMENTS

  region
  (optional)         Specify area of the screen where the  new  window  will  be
                     displayed.    For  details  on  window regions,   type HELP
                     WINDOWS.

                     Default if omitted:  use next DM default window.

  pathname
  (required)         Specify file to be executed by the new process:  usually  a
                     Shell (command interpreter).

  args ...
  (optional)           Specify  any  arguments  to  be  passed  to  the  program
                     'pathname'.  If any of  these  arguments  contain  explicit
                     blanks, enclose those arguments in quotation marks.


OPTIONS

  Note that options, if present, must precede the 'pathname' argument.

  -I                 Specify that the window created for this process will be in
                     icon format.

  -C 'char'          Specify the icon character to be used in the  icon  window.
                     'char'  must  reside  in  the  current  icon font.  If this
                     option is not specified and  -I  is  present,  the  Display
                     Manager  will  use  the default icon character for this pad
                     type.

  -N name            Assign process name 'name.' If omitted, the DM assigns  the
                     name  "Process_n,"  where  n is an integer beginning with 1
                     and incremented by 1 for each active process.


EXAMPLES

     1. Create a process named 'spare' running the Shell.    The  '-nstart'
        option on SH suppresses startup file execution for the new Shell.

            Command: (0,0)dr;(500,300)cp -nstart -n spare /com/sh

     2. Create  a  process  running  the Shell, and place it in a window in
        icon format using the default icon character for this pad type.

            Command: cp -i /com/sh


RELATED TOPICS

  More information is available.  Type:

  - HELP CPO
   for details about creating processes without windows and pads

  - HELP CPS
   for details about creating server processes

  - HELP DQ
   for details about stopping processes