HOSTGROUP(5)               Grid Engine File Formats               HOSTGROUP(5)



[1mNAME[0m
       hostgroup - host group entry file format

[1mDESCRIPTION[0m
       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 [4mqconf[24m(1) [1m-shgrpl [22moption. The contents of each enlisted  host  group
       entry  can be shown via the [1m-shgrp [22mswitch. The output follows the [4mhost-[0m
       [4mgroup[24m format description. New host group entries  can  be  created  and
       existing  can  be  modified  via  the [1m-ahgrp[22m, [1m-mhgrp[22m, [1m-dhgrp [22mand [1m-?attr[0m
       options to [4mqconf[24m(1).

       Note, 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.

[1mFORMAT[0m
       A host group entry contains following parameters:

   [1mgroup_name[0m
       The group_name defines the host group name. Host group  names  have  to
       begin  with  an  '@'  character  as  explained  for  [4mhostgroup_name[24m  in
       [4msge_types[24m(5).

   [1mhostlist[0m
       The  name  of  all  hosts  and  host  groups  (see  [4mhost_identifier[24m  in
       [4msge_types[24m(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 [4mhost_identifier[24m is an "@" sign  the
       name is used to reference a [4mhostgroup[24m(5) which is taken as sub group of
       this group.


[1mEXAMPLE[0m
       This is a typical host group entry:


       group_name @bigMachines

       hostlist @solaris64 @solaris32 fangorn balrog


       The entry will define a new host group  called  [1m@bigMachines[22m.  In  this
       host  group  are  the  host [1mfangorn[22m, [1mbalrog [22mand all members of the host
       groups [1m@solaris64 [22mand [1m@solaris32[22m.



[1mSEE ALSO[0m
       [4mge__types[24m(1), [4mqconf[24m(1)

[1mCOPYRIGHT[0m
       See [4mge_intro[24m(1) for a full statement of rights and permissions.



GE 6.2u2                 $Date: 2007/02/14 12:58:39 $             HOSTGROUP(5)
