HOSTGROUP(5)						   Sun Grid Engine File Formats 					      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 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 (
ewline) 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.

SGE 6.2u5							      $Date$							      HOSTGROUP(5)