6.0;ensubs (enter_subsystem), revision 6.0, 83/04/15
ENSUBS (ENTER_SUBSYSTEM) -- Enter a protected subsystem at Shell command level.
usage:  ENSUBS subsystem_name


FORMAT

  ENSUBS subsystem_name


  ENSUBS  is used to enter a protected subsystem at Shell command level.  ENSUBS
  creates a new process in which to run the subsystem Shell.

  Once in the subsystem, the SUBS command can be used to create new managers for
  the subsystem or to seal data objects so that only managers of  the  subsystem
  can operate on them.  Also, subsystem managers can be debugged conveniently in
  this  mode  using  DEBUG,  and  protected data objects can be examined.  Note,
  however, that access to protected objects requires prior use of the  SUBS  -UP
  command.


ARGUMENTS

  subsystem_name
  (required)          Specify  name  of subsystem to be entered.  The Shell will
                     search the directory /SYS/SUBSYS for the file specified.

  NOTES

     o ENSUBS XXX just invokes the command /SYS/SUBSYS/XXX in a new process
       (unless the current process is already running  in  Subsystem  XXX).
       The  new  process  shares the window of the creating process, and is
       therefore subject to the same restrictions found when logging into a
       window.  To avoid the limitations, a new window, containing a  Shell
       running  in  the  subsystem,  can be created using the DM. Press the
       <CMD> key; next to the prompt, type:

            Command: cp /sys/subsys/XXX

     o The access  control  list  on  the  file  /SYS/SUBSYS/subsystem_name
       determines who can enter the subsystem 'subsystem_name': whoever has
       read  and  execute  rights  to it can enter the subsystem.  Usually,
       this  capability  should  be  restricted  to  the  creators  of  the
       subsystem or to the system administrator.


RELATED TOPICS

  More information is available.  Type:

  - HELP PROTECTION
    for general information about DOMAIN protection mechanisms.

  - HELP PROTECTION PROTECTED_SUBSYSTEMS
    for detailed information on protected subsystems.

  - HELP SUBS
    for information on displaying or selecting subsystem attributes.

  - HELP CRSUBS
    for information on creating a protected subsystem.

  - HELP XSUBS
    for details about executing a Shell script as a subsystem manager.

  - HELP LOGIN WINDOW
    for information on the attributes of a login window.

  - HELP PROTECTION ACLS
    for information on ACLS.