GLOBALTCPIPDATA statement

Use the GLOBALTCPIPDATA statement to specify the name of either a z/OS® UNIX file or MVS data set that contains the TCPIP.DATA statements that are used to set global MVS image-wide values for TCPIP.DATA.

Restriction: Start of changeThis statement is ignored for applications running in IBM® z/OS Container Platform environments. The resolver configuration is always obtained from the z/OS UNIX files '/etc/resolv.conf' and '/etc/nsswitch.conf' in the container’s filesystem namespace. For more information, see Search orders used in the z/OS UNIX environment in z/OS Communications Server: IP Configuration Guide. End of change

If GLOBALTCPIPDATA is not specified, the appropriate environment's (Native MVS or z/OS UNIX) search order is used to locate TCPIP.DATA.

If GLOBALTCPIPDATA is specified, any TCPIP.DATA statements contained in the specified file or data set take precedence over any TCPIP.DATA statements found using the appropriate environment's (native MVS or z/OS UNIX) search order.

The following resolver TCPIP.DATA statements can be specified only in the file or data set specified by GLOBALTCPIPDATA. If these resolver statements are found in any of the other search locations for TCPIP.DATA, they are ignored. If these resolver statements are not found in the file or data set specified by GLOBALTCPIPDATA, their default value is used.

  • DomainOrigin/Domain
  • NSInterAddr/NameServer
  • NSPortAddr
  • ResolverTimeOut
  • ResolverUDPRetries
  • ResolveVia
  • Search
  • SortList

Syntax

Read syntax diagramSkip visual syntax diagramGLOBALTCPIPDATA ('fully qualified MVS dataset name')(/file system absolute pathname)

Parameters

'fully qualified MVS dataset name'
The complete name of the MVS data set containing the TCPIP.DATA statements.

Requirement: The beginning and ending quotes (' ') are required.

/file system absolute pathname
The complete name of the z/OS UNIX file containing the TCPIP.DATA statements.

Requirement: The beginning slash (/) is required.

Restriction: The /file system absolute path name can be a maximum of 255 characters.

Examples

The following example specifies member GLOBAL in partitioned data set TCPIP.TCPPARMS as containing TCPIP.DATA statements. 
GLOBALTCPIPDATA('TCPIP.TCPPARMS(GLOBAL)')
The following example specifies z/OS UNIX file Global.Tcpip.data in directory etc as containing TCPIP.DATA statements.
Note: Because it is a z/OS UNIX file the name is case sensitive.
GLOBALTCPIPDATA(/etc/Global.Tcpip.data)

Usage notes

  • For a z/OS UNIX file, the file can reside in any directory. The maximum line length supported is 256 characters. If the line is greater than 256 characters, it is truncated to 256 characters and processed, and a trace resolver warning message is issued.
  • The z/OS UNIX path name is case sensitive.
  • For an MVS data set, the following conditions are required:
    • Sequential (PS) or Partitioned (PO) organization
    • RECFM=F or RECFM=FB
    • Recommended logic record length (LRECL) in the range 80 - 256
  • The MVS data set name is not case sensitive.
  • You must code the GLOBALTCPIPDATA statement if you specify the AUTOQUIESCE operand on the UNRESPONSIVETHRESHOLD statement. If you cannot ensure that all DNS IP addresses are accessible from all of your TCPIP stacks, you should not use a global TCPIP.DATA file and you should not code AUTOQUIESCE on the UNRESPONSIVETHRESHOLD setup statement in your resolver setup file. See UNRESPONSIVETHRESHOLD statement for more information.