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 Manual 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 Manual for an
  example.


RELATED TOPICS

  More information is available.  Type:

  - HELP PROTECTION PROTECTED_SUBSYSTEMS
    - HELP PROTECTION 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.