Use the host_group statement to identify the set of IP addresses to update for a group of hosts. The automated domain name registration application updates the name server with the intersection between the IP addresses configured to the automated domain name registration application and the IP addresses active on the hosts in the sysplex.
The DNS names dynamically added to the name server take the form host_group_name.domain_suffix, where the host_group_name value is the name of the group of hosts being registered to the GWM and the domain_suffix value is the domain suffix name specified in a zone parameter on a dns statement.
The automated domain name registration application can also update individual host instances with the DNS server using the member keyword. The automated domain name registration application updates the name server with the intersection between the IP addresses configured for the member and the set of IP addresses active on the hosts in the sysplex. The DNS names dynamically added to the name server take the form host_name.domain_suffix, where host_name is the name of the member being registered to the GWM and domain_suffix is the domain suffix name specified in a zone parameter on a dns statement.
See the description of domain_suffix in dns statement for total length restrictions.
Syntax
>>-host_group --host_group_label--| Put Braces and Parameters on Separate Lines |->< Put Braces and Parameters on Separate Lines |--+-{--------------------------------------------------------------------------------------+--| | .----------------. | | V | | +-----| member |---+--host_group_name--host_group_name--dns--dns_label--zone--zone_label-+ '-}--------------------------------------------------------------------------------------' member |--member--{--+-----------------------+-------------------------> '-host_name --host_name-' .-------------------------------. V | >----ipaddrlist --ipaddrlist_label-+--}-------------------------|
Parameters
- host_group
- The keyword that defines the beginning of the host_group statement.
- host_group_label
- A string 1 - 32 characters in length for the label of this host group. This value is referenced from automated domain name registration commands.
- host_group_name host_group_name
- The name of the group of hosts to be updated in the name server.
This is the default host name for a member defined without a host_name parameter.
Restrictions:
- The name must be less than or equal to 63 characters in length.
- The name cannot contain any periods.
- Within the entire configuration file, a group name must be unique. The host_group_name value cannot be used on any other host_group statements or be used on any other server_group statements as a server_group_name value.
- dns dns_label
- A label referencing the dns statement that defines the DNS server with which to register the domain name and IP addresses. The value specified matches the dns_label on a dns statement.
- zone zone_label
- A label referencing a zone on the DNS server that is identified by the dns keyword. The value specified matches the zone_label value on a dns statement.
- member
- The members for a given group. The member might refer to a
single TCP/IP host instance or might apply to the host group itself.
- host_name host_name
- The name of the individual host to be updated in the name server.
If the host_name value is not specified, the member statement
applies to the host group itself and not an individual host.
Rules:
- Only one member can be defined for a host group without a host_name definition.
- The name must be less than or equal to 63 characters in length.
- The name cannot contain any periods.
- ipaddrlist ipaddrlist_label
- A label referencing an ipaddrlist statement. This list contains
one or more IP addresses to register. These IP addresses can be IPv4
or IPv6 addresses.
Guideline: For increased availability, specify VIPAs to identify the host.