DOMAINORIGIN statement

Use the DOMAINORIGIN statement to specify the domain origin that is appended to the host name to form the fully qualified domain name of a host.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-+--------------+--DOMAINORIGIN--origin----------------------><
   '-system_name:-'                         

Parameters

system_name:
The name of the system to which this statement applies. See system_name considerations for a complete description of this parameter.

Requirement: The colon is required.

origin
The domain origin is appended to the host name. This name usually has imbedded dots.

Guidelines: The values for the domain name must conform to the following rules:

  • Maximum of 249 characters.
  • Must contain one or more tokens separated by a period.
  • Each token must be at least one character.
  • Each token must start with a letter or number.
  • Remaining characters in each token must be a letter, number, or hyphen.
  • The length of the host name plus the length of the domain name must be less than or equal to 254.

Steps for modifying

You can refresh this statement using the MODIFY command. For more information about parameters used with the MODIFY command, see z/OS Communications Server: IP System Administrator's Commands.

Examples

This example appends the domain origin of BOBS.YOUR.UNCLE to the host name:
DOMAINORIGIN  BOBS.YOUR.UNCLE

Usage notes

  • No case translation is performed on the domain origin.
  • If the resolver is passed a host name that does not contain any dots (in dotted decimal notation), the domain origin is appended to the host name. If the host name passed to the resolver contains dots, the value of the OPTIONS NDOTS:n statement influences how the DOMAINORIGIN value is used. See OPTIONS statement.
  • The DOMAINORIGIN configuration statement must be customized at each site.
  • Additionally, the domain origin can be set from the z/OS® shell environment by exporting the LOCALDOMAIN environment variable.
    Read syntax diagramSkip visual syntax diagram
    >>-export--LOCALDOMAIN=origin----------------------------------><
    
    

    The setting of the LOCALDOMAIN as an environment variable overrides any setting for DOMAIN, DOMAINORIGIN, or SEARCH found in TCPIP.DATA.