Specifies the IP address at the local TCP/IP stack. If the local TCP/IP stack has multiple static IPv4 VIPA addresses, use IPADDR to specify which of those static VIPA addresses you want other Enterprise Extender nodes to use in order to communicate with this host. Alternatively, the HOSTNAME start option can be coded to provide a host name to be resolved into the static VIPA address. If neither IPADDR nor HOSTNAME are specified, the default is to use the first static IPv4 VIPA address in the TCP/IP stack's (the referenced TCPNAME start option stack) HOME list.
- When your Enterprise Extender configuration requires the use of multiple static VIPAs
- When HOSTNAME was coded as a start option and the value of hostname resolves to an IP address different from the IP address that is to be used for this EE XCA major node GROUP definition statement.
The address must be specified in dotted decimal format for an IPv4 address (for example, IPADDR=4.6.41.7) or in colon-hexadecimal format for an IPv6 address (for example, IPADDR=2000::67:1:2).
- The IPADDR start option is used only when the IPADDR and HOSTNAME operands are not specified on the XCA major node (MEDIUM=HPRIP) GROUP definition statements, and the HOSTNAME start option was not coded.
- The IPADDR start option can be dynamically modified using MODIFY
VTAMOPTS under certain conditions. An attempt to modify IPADDR to
be a nonzero IP address will be failed with message IST448I if a static
VIPA address has been obtained from the TCP/IP stack named in the
TCPNAME start option and is being used for active Enterprise Extender
connections. All active Enterprise Extender lines must be deactivated
before the MODIFY VTAMOPTS,IPADDR=IP address will
be accepted.
If the MODIFY command is successful, displays of VTAM® start options will show the new value immediately; however, the new value will not be used until all Enterprise Extender lines whose GROUP definition statements do not have HOSTNAME or IPADDR explicitly coded are inactive. Any subsequent activation for an Enterprise Extender line whose GROUP definition statement does not have HOSTNAME or IPADDR explicitly coded will make use of the new IPADDR start option value. If the HOSTNAME start option is currently in use when the MODIFY VTAMOPTS is performed to activate IPADDR, the HOSTNAME start option is reset (for example, treated as if MODIFY VTAMOPTS,HOSTNAME=NONE was also coded) as part of processing the MODIFY VTAMOPTS.
A value of 0.0.0.0, or an IPv6 IP address of all zeros, usually written as ::, can be specified for the IPADDR value on the MODIFY VTAMOPTS command as a mechanism for clearing the value of the current IPADDR start option. This option will be failed, however, with message IST448I, if the Enterprise Extender XCA major node is active.
- HOSTNAME and IPADDR cannot be modified using one MODIFY VTAMOPTS command. If both start options are specified on the same MODIFY command, they will both be ignored and message IST1917I will be generated.
- If the IPADDR and the HOSTNAME operands are not specified on any of the GROUP definition statements within the Enterprise Extender XCA major node, then either the HOSTNAME, TCPNAME or IPADDR start option must be specified in order to initiate an Enterprise Extender link. If VTAM has been activated without the specification of one of these options then the MODIFY VTAMOPTS command can be used to set one of these options. If an Enterprise Extender link activation is attempted without HOSTNAME, TCPNAME or IPADDR specified then the link activation will fail with the IST1890I message.
- If either the IPADDR or the HOSTNAME operand is specified on any GROUP definition statement within the Enterprise Extender (XCA) definition, it must be specified on all Enterprise Extender GROUP definition statements (or defaulted from the VTAM start options).
- The TCPNAME start option is required in a CINET environment if
any of the following conditions exist:
- The IPADDR parameter is specified on any of the Enterprise Extender XCA major node GROUP definition statements.
- The HOSTNAME parameter is specified on any of the Enterprise Extender XCA major node GROUP definition statements.
- The HOSTNAME keyword is specified as a VTAM start option.
If OMVS is not initialized at Enterprise Extender line activation, a Common INET environment is assumed.
In this case, if an Enterprise Extender link activation is attempted without TCPNAME specified, then the link activation will fail with message IST1897I.
- If both the IPADDR and the HOSTNAME start options are specified on the VTAM START command, the value of the IPADDR start option is ignored.
- IPADDR is meaningful only if the NODETYPE start option is also used.