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.


ARGUMENT

  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.