GLOBALIPNODES statement

Use the GLOBALIPNODES statement to specify the name of either a z/OS® UNIX file or MVS™ data set that contains the hard-coded IP addresses and host names to be used.

Restriction: The specified file or data set can include IPv4 and IPv6 addresses, but cannot include IPv4–mapped addresses.

Syntax


>>-+----------------------------------------------------------+-><
   '-GLOBALIPNODES --+-('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 IP addresses and host names. The data set name is not case sensitive.

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

/file system absolute pathname

The complete name of the file system containing the IP addresses and host names. The z/OS UNIX path name is case sensitive.

Requirement: The beginning slash (/) is required.

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

Examples

To specify the data set named TCPIP.ETC.IPNODES, use the following code:

GLOBALIPNODES('TCPIP.ETC.IPNODES')

To specify z/OS UNIX file ipnodes in directory etc as containing IP addresses and host names, use the following code:

GLOBALIPNODES(/etc/ipnodes)

Note: Because it is an z/OS UNIX file, the name is case sensitive.

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.
For an MVS data set, the following conditions are required:
- Sequential (PS) organization or PDS
- RECFM=F or RECFM=FB
- Recommended logic record length (LRECL) in the range 80 - 256
This specified file or data set can contain IPv4 and IPv6 addresses, but cannot contain IPv4–mapped addresses. Each host name can be up to 128 characters in length, and each host name can have up to 35 IPv4 addresses and 35 IPv6 addresses. Each node in the host name (without dots) can be up to 63 characters in length. For example, if host name is testname.testdomain, testname and testdomain can be to 63 characters in length.