CHGTCPDMN (Change TCP/IP Domain)

CHGTCPDMN Command syntax diagram

 

Purpose

The Change TCP/IP Domain Information command is used to allow the user to change the host/domain names and server information.

Restrictions: You must have *IOSYSCFG special authority to use this command.

 

Optional Parameters

HOSTNAME

The host name of this system. This name should also be defined in the local host table or at the domain name server.

*SAME: The HOSTNAME value does not change if it was previously set.

host-name: Specify the host name to be used.

DMNNAME

The name of the TCP/IP domain this system is a member of.

*SAME: The DMNNAME value does not change if it was previously set.

domain-name: Specify the domain name to be used.

DMNSCHLIST

Specifies the TCP/IP domains to search when fully-qualified domain names (FQDN) are not given. The first name in the search list is the default domain name on all searches.

*SAME: The DMNSCHLIST value does not change if it was previously set; otherwise, *DFT is used.

*DFT: The default behavior is to search the local domain tree. The local domain tree is the DMNNAME and each parent domain with two or more parts to the domain. DMNNAME is the default domain name on all searches.

'domain-search-list': Specify the list of domain names to be searched. Up to six domain names may be specified, separated by spaces and enclosed in apostrophes. The first domain name in the search list is the default domain name on all searches. Note that if a domain search list is defined then the local domain name (DMNNAME) will not automatically be used in the search list. If you wish to include the local domain name specify it as part of the search list. Parent domains for the domains defined in the search list will not be searched. If you want parent domains to be searched then they must be explicitly defined in the search list.

HOSTSCHPTY

Specifies whether to search the domain name server or the local host table first for host name resolution.

*SAME: The HOSTSCHPTY value does not change if it was previously set; otherwise, *REMOTE is used.

*REMOTE: Specify *REMOTE to contact a domain name server first. The local host table is not searched until all attempts to reach a remote name server have failed.

*LOCAL: Specify *LOCAL to always search the local host table prior to contacting a remote name server.

INTNETADR

The internet address of the domain name server host. The dotted decimal form is used. A maximum of three domain name servers can be specified. If the domain name server is contacted and either it does not respond, or returns with a non-authoritative response then the next domain name server in the list will be contacted.

*SAME: The INTNETADR value does not change if it was previously set.

internet-address: Specify the internet address to be used.

PORT

The remote port number used to contact the domain name server listed in INTNETADR. Care should be taken in changing this value to something other than port number 53, which is the domain name server well-known port.

*SAME: The PORT value does not change if it was previously set; otherwise, 53 is used.

port-number: Specify the remote port number to be used. Valid values range from 1 to 65535.

PROTOCOL

The protocol used to contact a remote name server. Care should be taken in changing this value from *UDP, which is the protocol typically used by domain name servers.

*SAME: The PROTOCOL value does not change if it was previously set; otherwise, *UDP is used.

*UDP: The User Datagram Protocol is used to communicate with a domain name server.

*TCP: The Transmission Control Protocol is used to with communicate a domain name server.

INLDMNSVR

Specifies the initial domain name server selection method. This option determines whether the first configured domain name server should always be queried first, or if the first name server to be queried should be rotated in a round robin fashion if more than one is configured. This rotation provides a simple form of load balancing on the configured name servers.

*SAME: The INLDMNSVR value does not change if it was previously set; otherwise, *FIRST is used.

*FIRST: The first configured domain name server is queried first. Always query the name servers in order as configured.

*ROTATE: Rotate through the configured name servers in a round robin fashion to determine which to query first.

DMNSVRRTY

The number of retry attempts that are made to contact each domain name server listed in INTNETADR, and the number of seconds this iSeries 400 waits for a response from each attempt to contact a name server.

Element 1: Number of Retries

*SAME: The number of retries does not change if it was previously set; otherwise, 2 is used.

number-retries: Specify the number of retries to be attempted. Valid values range from 0 to 99.

Element 2: Time Interval

*SAME: The time interval does not change if it was previously set; otherwise, 2 is used.

time-interval: Specify the number of seconds between retries. Valid values range from 0 to 99. If a number of retries is set, the time interval should be set to something other than 0.

Examples for CHGTCPDMN

Example 1: Change host and domain names

CHGTCPDMN HOSTNAME(rs021) DMNNAME(endicott.ibm.com)

This command changes the host name and domain name.

Example 2: Change Domain Search List

CHGTCPDMN DMNSCHLIST('endicott.ibm.com                        
                     rochester.ibm.com ibm.com')              

This command changes the domain search list to be three domain names: endicott.ibm.com, rochester.ibm.com, and ibm.com.

Example 3: Change Domain Name Server Rotation

CHGTCPDMN INLDMNSVR(*ROTATE)                                  

This command changes the initial domain name server selection so it rotates between the configured name servers in a round robin fashion.

Error messages for CHGTCPDMN

*ESCAPE Messages

None.