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



NNAAMMEE
       hostgroup - host group entry file format

DDEESSCCRRIIPPTTIIOONN
       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 _q_c_o_n_f(1) --sshhggrrppll option. The contents of  each  listed  host  group
       entry  can be shown via the --sshhggrrpp switch. The output follows the _h_o_s_t_-
       _g_r_o_u_p format description. New host group entries  can  be  created  and
       existing  can  be  modified  via  the --aahhggrrpp, --mmhhggrrpp, --ddhhggrrpp and --??aattttrr
       options to _q_c_o_n_f(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.

FFOORRMMAATT
       A host group entry contains following parameters:

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

   hhoossttlliisstt
       The  name  of  all  hosts  and  host  groups  (see  _h_o_s_t___i_d_e_n_t_i_f_i_e_r  in
       _s_g_e___t_y_p_e_s(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 _h_o_s_t___i_d_e_n_t_i_f_i_e_r is an "@" sign  the
       name is used to reference a _h_o_s_t_g_r_o_u_p(5) which is taken as sub group of
       this group.


EEXXAAMMPPLLEE
       This is a typical host group entry:


       group_name @bigMachines

       hostlist @solaris64 @solaris32 fangorn balrog


       The entry will define a new host group  called  @@bbiiggMMaacchhiinneess.  In  this
       host  group  are  the  host ffaannggoorrnn, bbaallrroogg and all members of the host
       groups @@ssoollaarriiss6644 and @@ssoollaarriiss3322.



SSEEEE AALLSSOO
       _s_g_e_____t_y_p_e_s(1), _q_c_o_n_f(1)

CCOOPPYYRRIIGGHHTT
       See _s_g_e___i_n_t_r_o(1) for a full statement of rights and permissions.



GE 6.1                   $Date: 2007/06/26 22:21:10 $             HOSTGROUP(5)
