6.0;subs (subsystem), revision 6.0, 83/04/15
SUBS (SUBSYSTEM) -- Set or display subsystem attributes.
usage:  SUBS object [subs_name] [-DATA] [-MGR] [-L] [-UP | -DOWN] [-BR]


FORMAT

  SUBS object [subs_name] [options]


  SUBS  is  used  to  set  or show protected subsystem attributes.  When setting
  subsystem attributes, you must be running in that subsystem.

  See the  ENSUBS  (ENTER_SUBSYSTEM)  command  in  the  "DOMAIN  System  Command
  Reference" for details on entering a subsystem.


ARGUMENTS

  object
  (required)          Specify pathname of an object.  The function of the object
                     (either  a  protected  file  or  a  managing  program)   is
                     determined by options described below.

  subs_name
  (optional)          Specify  name  of  a subsystem.  The Shell will search the
                     directory /SYS/SUBSYS for the specified subsystem.  If this
                     argument   is   specified,  the  attributes  of  the  named
                     subsystem will be set as directed by the options  described
                     below.

                     Default if omitted:  display attributes of 'object.'


OPTIONS

  -DATA               Set  or  display  the  name of the subsystem which manages
                     'object.'

  -MGR               Set or display the name of the subsystem for which 'object'
                     is  a manager. 'Object' must be an executable file (i.e., a
                     program).

  -UP                Increase the privilege level of  a  process  running  in  a
                     subsystem  so  that  it  can directly access the objects it
                     owns.

  -DOWN              Decrease the privilege level  of  a  process;  opposite  of
                     '-UP.'

  -L                  List  subsytem  attributes and/or manager fields.  This is
                     the default action if 'subs_name' is not specified.

  -BR                Display only the name of  the  subsystem.    Not  valid  if
                     attributes are being set.


EXAMPLES

  See the SUBS command in the "DOMAIN System Command Reference" for an example.


RELATED TOPICS

  More information is available.  Type:

  - HELP PROTECTION PROTECTED_SUBS
   for a detailed description of protected subsystems.

  - HELP CRSUBS
   for details about creating a protected subsystem.

  - HELP ENSUBS
   for details about entering a protected subsystem.

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