z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


TCP/IP profile record dynamic VIPA (DVIPA) address section

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

This section provides information about dynamic VIPA (DVIPA) address and interfaces, from the following VIPADYNAMIC profile substatements:
  • VIPABACKUP
  • VIPADEFINE
  • VIPARANGE
There can be multiple sections in the record, one per each of the above profile substatements. If requested configuration changes for this section were cancelled, then:
  • Only one section is provided in the record.
  • Flag NMTP_DVCFChgCancelled is set. If this flag is set, no other information is provided in the section.
Table 1 shows the dynamic VIPA address section.
Table 1. TCP/IP profile record dynamic VIPA (DVIPA) address section
Offset Name Length Format Description
0(X'0') NMTP_DVCFEye 4 EBCDIC DVCF eyecatcher
4(X'4') NMTP_DVCFFlags 2 Binary DVIPA flags:
X'8000', NMTP_DVCFChgCancelled:
If set, pending configuration changes for this section were cancelled because the stack is not currently joined to the sysplex group. If this flag is set, no other information is provided in this section.
X'4000', NMTP_DVCFIPv6:
If set, IP addresses are IPv6; otherwise, IP addresses are IPv4.
X'2000', NMTP_DVCFMoveImmed:
This flag is valid only when the value of NMTP_DVCFType is Backup or Define. If set, the DVIPA can be immediately moved to another stack when the other stack requests ownership of it, but existing connections are preserved. If this flag is not set, the DVIPA cannot move to another stack until all current connections have ended.
X'1000', NMTP_DVCFMoveNonDisrupt:
This flag is valid only if the value of NMTP_DVCFType is Range. If set, the DVIPA can be immediately moved to another stack when the other stack requests ownership of it, but existing connections are preserved. If this flag is not set:
  • A subsequent BIND on another stack for the same DVIPA address fails. A subsequent SIOCSVIPA ioctl on another stack succeeds and the DVIPA is deleted from this stack. Any connections to the DVIPA on this offset are terminated.
  • A subsequent SIOCSVIPA ioctl on another stack succeeds and the DVIPA is deleted from this stack. Any connections to the DVIPA on this stack are terminated.
4(X'4') (Cont)      
X'0800', NMTP_DVCFCpcScope
If set, the DVIPA cannot be moved to or taken over by another TCP/IP stack that is in a different central processor complex (CPC). This flag is valid only if field NMTP_DVCFType is set to Backup or Define.
X'0400', NMTP_DVCFTier1
If set, the DVIPA is used to distribute incoming requests to non-z/OS targets. This flag is valid only if field NMTP_DVCFType is set to Backup or Define.
X'0200', NMTP_DVCFTier2
If set, the DVIPA is used to distribute incoming requests from Tier1 targets to server applications and the DVIPA cannot be moved to or taken over by another TCP/IP stack that is in a different CPC. This flag is valid only if field NMTP_DVCFType is set to Backup or Define.
X'0100', NMTP_DVCFServMgr
If set, and this DVIPA is distributed, MultiNode Load Balancing (MNLB) is performed as part of the distribution. This flag is not supported.
X'0080', NMTP_DVCFDeactivated
If set, the associated DVIPA address is currently deactivated. DVIPA addresses and interfaces can be deactivated by way of the VARY TCPIP,,SYSPLEX,DEACTIVATE command. This flag is valid only if NMTP_DVCFType is Backup or Define.
X'0040', NMTP_DVCFSAFNameSet
If set, the SAF parameter is specified on the VIPARANGE statement. Field NMTP_DVCFSAFName contains the SAF parameter value.
6(X'6') NMTP_DVCFType 1 Binary DVIPA entry type:
NMTP_DVCFBackup(1)
Backup
NMTP_DVCFDefine(2)
Define
NMTP_DVCFRange(3)
Range
7(X'7') NMTP_DVCFBackupRank 1 Binary If the NMTP_DVCFType value is Backup, this field contains the rank value.
8(X'8') NMTP_DVCFPfxLen 8 EBCDIC One of the following values:
  • If the NMTP_DVCFType value is Define or Backup, and the NMTP_DVCFIPv6 flag is not set, this field contains the IPv4 subnet prefix length.
  • If the NMTP_DVCFType value is Define or Backup, and the NMTP_DVCFIPv6 flag is set, this field contains the IPv6 subnet prefix length.
  • If the NMTP_DVCFType value is Range, and the NMTP_DVCFIPv6 flag is not set, this field contains the prefix length used to create the IPv4 VIPARANGE prefix.
  • If the NMTP_DVCFType value is Range, and the NMTP_DVCFIPv6 flag is set, this field contains the prefix length used to create the IPv6 VIPARANGE prefix.
  • 0 if a prefix length was not specified.
9(X'9')   7 Binary Reserved
16(X'10') NMTP_DVCFAddr4 4 Binary One of the following values:
  • If the NMTP_DVCFIPv6 flag is not set, this field contains the IPv4 DVIPA IP address.
  • If the NMTP_DVCFIPv6 flag is set, this field contains the IPv6 DVIPA IP address.
16(X'10) NMTP_DVCFAddr6 16 Binary One of the following values:
  • If the NMTP_DVCFIPv6 flag is not set, this field contains the IPv4 DVIPA IP address.
  • If the NMTP_DVCFIPv6 flag is set, this field contains the IPv6 DVIPA IP address.
32(X'20') NMTP_DVCFIntfName 16 EBCDIC If the NMTP_DVCFIPv6 flag is set, this field contains the IPv6 DVIPA interface name, padded with trailing blanks.
48(X'30') NMTP_DVCFSAFName 8 EBCDIC If the NMTP_DVCFSAFNameSet flag is set, this field contains the name specified on the SAF parameter of the VIPARANGE statement, padded with trailing blanks.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014