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 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  listed  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,  Grid  Engine  allows  backslashes  (\) be used to escape newline characters. The backslash and the
       newline are replaced with a space character before any interpretation.

FORMAT

       A host group entry contains the 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  names  of  all  hosts and host groups (see host_identifier in sge_types(5)) which are members of the
       group.  Only whitespace is allowed as list separators. The 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 a subgroup 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 permissions.

SGE 8.1.3pre                              $Date: 2011-05-22 12:20:04 $                              HOSTGROUP(5)