    NAME
         hostgroup - host group entry file format

    DESCRIPTION
         A host group entry is used to merge host  names  to  groups.
         Each   host   group  entry  file defines one group. Inside a
         group definition file you  can  also  reference  to  groups.
         These  groups are called subgroups. A subgroup is referenced
         by the sign "@" as first character of the name.

         A list of currently configured host  group  entries  can  be
         displayed  via  the qconf(1) -shgrpl option. The contents of
         each enlisted host group entry can be shown via  the  -shgrp
         switch. The output follows the hostgroup format description.
         New host group entries can be created and  existing  can  be
         modified  via  the -ahgrp, -mhgrp, -dhgrp and -?attr options
         to qconf(1).

         Note, Sun Grid Engine allows  backslashes  (\)  be  used  to
         escape  newline (\newline) characters. The backslash and the
         newline are replaced with a space (" ") character before any
         interpretation.

    FORMAT
         A host group entry contains following parameters:

      group_name
         The group_name defines the host group name. Host group names
         have  to  begin  with  an  '@'  character  as  explained for
         hostgroup_name in sge_types(5).

      hostlist
         The name of all hosts and host groups  (see  host_identifier
         in  sge_types(1))  which  are  member  of the group. As list
         separators white-spaces are supported  only.  Default  value
         for this parameter is NONE.

         Note, if the first character of the  host_identifier  is  an
         "@"  sign the name is used to reference a hostgroup(5) which
         is taken as sub group of this group.

    EXAMPLE
         This is a typical host group entry:

         group_name @bigMachines

         hostlist @solaris64 @solaris32 fangorn balrog

         The entry will define a new host group called  @bigMachines.
         In  this  host  group  are  the host fangorn, balrog and all
         members of the host groups @solaris64 and @solaris32.

    SEE ALSO
         sge__types(1), qconf(1)

    COPYRIGHT
         See sge_intro(1) for a full statement of rights and  permis-
         sions.