HOSTGROUP(5)                  File Formats Manual                 HOSTGROUP(5)



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  host-
       group  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,  Univa  Grid Engine allows backslashes (\) be used to escape new-
       line (\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 permissions.



Univa Grid Engine File Formats     UGE 8.5.4                      HOSTGROUP(5)