cps — Apollo

9.5;cps (create_process_server) *DM*, revision 9.5, 86/07/24
CPS (CREATE_PROCESS_SERVER) -- Create process independent of login.
usage:  cps [-n name] [-w] pathname [args ...]


FORMAT

  CPS [options] pathname [args...]


  CPS  creates  a  process  (without  associated  pads  or  windows)  that  runs
  regardless of whether or not any one is logged in.    This  is  desirable  for
  utilities  like the PRSVR (PRINT_SERVER) and NETMAN.  CPS may appear in any of
  the DM startup scripts.  You may prefer to issue  the  CPS  command  from  the
  keyboard  on selected occasions, however, rather than include this function in
  a startup script.

  The   created   process   is   assigned   the   subject    identifier    (SID)
  USER.SERVER.NONE.local_node regardless of the context in which the CPS command
  appears.  Be sure that any files to be used by  this  process  (including  the
  program  specified  by  the  'pathname' argument) give adequate access to this
  SID.  If the ACLs on the files do  not  allow  proper  access  to  the  SERVER
  project  name, the process will terminate.  And since background processes are
  essentially invisible, no error messages are returned to the  display,  making
  fault diagnosis difficult.


ARGUMENTS

  pathname
  (required)         Specify file to be executed by the new process.

  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.

                     Default if omitted:  no arguments passed.


OPTIONS

  -N name            Assign process name 'name'.  If this option is omitted, the
                     process is not named.

  -W                 Invoke "wait" mode. If this option  is  specified,  the  DM
                     suspends  its  activities  until  the newly created process
                     terminates. As long as the process runs, the  DM  will  not
                     respond  to  keyboard  or other input. USE THIS OPTION WITH
                     CAUTION. If the newly created process does  not  terminate,
                     the  DM  will  appear  to  be hung.  In addition, processes
                     created using -W CANNOT make any  DM  requests  (via  pad_$
                     requests  or  DM  commands) because the DM is suspended and
                     will not respond.


EXAMPLES

  1. Run the server MBX_HELPER.

      Command: cps /sys/mbx/mbx_helper -n mbx_helper


RELATED TOPICS

  More information is available.  Type:

  - HELP CP
   for details about creating processes with windows and pads

  - HELP CPO
   for details about creating non-server processes without windows or pads

  - HELP SIGP
   for details about stopping background processes

  - HELP SERVERS
   for details about available server programs
Museum

Related Articles
