$NETWK | Back to Index page

| Prolog Control Block Contents $NETWK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

$NETWK Prolog | Top of page

     NAME       : LGRNETWK
     DESCRIPTION: Relocation mapping for virtual NIC
     DSECT      : $NETWK
     FUNCTION   : LGRNETWK defines those fields required to perform
                  extended eligibility checks for a virtual NIC
                  on the destination system during a live guest
                  relocation.
     LOCATED BY : This is a mapping of the RDODATA area within the
                  RDOBK during guest relocation.
     CREATED BY : HCPNETEC - Allocates storage for this extension
                  HCPNETNF - Formats the NETWK extension
     DELETED BY : HCPRLDRL - Release storage associated with an RDP
     RELOCATION CONSIDERATIONS : This control block is an aggregation of data from
                  various control blocks and is only used to perform
                  eligibility checks on the destination system during
                  a live guest relocation.

$NETWK Control Block Content | Top of page

     $NETWK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      $NETWK         Relocation mapping for virtual NIC
              00000001       $NET_VER       1 Mapping version number for this
                                            DSECT. Version is independent of
                                            the CP level and need only be
                                            changed when this DSECT is
                                            changed. The convention is to
                                            increment by 1.
    0000    0 Signed       2 $NET_HDRL      Header length (in bytes)
    0002    2 Signed       2 $NET_BITL      Length of mapped bits (in bytes)
    0004    4 Signed       4 *              Reserved for future use
              00000008       $NET_HDLN      *-$NETWK Length of header (bytes)
          Bit map: Contains the NETWK flags that are subject to
                   relocation. These bits are defined sequentially,
                   regardless of how they are defined in HCPNETWK.
                   This yields a consistent mapping that ensures
                   compatibility when a guest is relocated between
                   systems at differing service levels.
                   Names in the comments column indicate the control
                   block byte which contains the flag. This name is
                   subject to change if the flag definition changes.
             ====> NEVER change bits which already exist here.
             ====> NEVER change the order of bits in this section.
             ====> ALWAYS add new bits at the end of this section,
                   together with new flag bytes as required.
    0008    8 Signed       2 $NET_BITS (0)  Bit map area
    0008    8 Bitstring    1 $NET0
              1... ....      $NETVSWITCH    X'80' $NETVSWITCH Coupled to
                                            VSWITCH
              .1.. ....      $NETUSERBASED  X'40' $NETUSERBASED USERBASED
                                            VSWITCH
              ..1. ....      $NETPORTBASED  X'20' $NETPORTBASED PORTBASED
                                            VSWITCH
              ...1 ....      $NETVLFILTER   X'10' $NETVLFILTER VSWITCH is
                                            VLAN AWARE
              .... 1...      $NETESMCTL     X'08' $NETESMCTL Using ESM
                                            control
              .... .1..      $NETOSDSIM     X'04' $NETOSDSIM Authorized for
                                            OSDSIM
              .... ..1.      $NETPROMISC    X'02' $NETPROMISC Authorized for
                                            Promiscuous
              .... ...1      $NETUSERPORT   X'01' $NETUSERPORT Portnumber is
                                            user-defined (used when
                                            NETXBASE==ON)
    0009    9 Bitstring    1 $NET1
              1... ....      $NETDDLAN      X'80' $NETDDLAN NICDEF LAN is
                                            identified (used when
                                            NETXBASE==ON)
              .1.. ....      $NETDDCFG      X'40' $NETDDCFG NICDEF LAN
                                            connection authorized (used when
                                            NETXBASE==ON)
              ..1. ....      $NETDDCFM      X'20' $NETDDCFM NICDEF LAN config
                                            is mandatory (used when
                                            NETXBASE==ON)
              .... 1...      $NETUPLOW      X'08' $NETUPLOW Uplink Priority -
                                            Low
              .... .1..      $NETUPNOR      X'04' $NETUPNOR Uplink Priority -
                                            Normal
              .... ..1.      $NETUPHIG      X'02' $NETUPHIG Uplink Priority -
                                            High
    000A   10 Bitstring    6 *              Reserved for IBM use
              00000008       $NET_BLEN      *-$NET_BITS Length of bit map
                                            area
          Data:    Contains all HCPNETWK data that is subject to
                   relocation, except for flag bits, which are
                   handled separately.
                   All fields are defined as XLnn to avoid alignment
                   warnings and to pack the data efficiently.
             ====> NEVER change fields which already exist here.
             ====> NEVER change the order of fields in this section.
             ====> ALWAYS add new fields at the end of this section.
                   together with new flag bytes as required.
    0010   16 Bitstring    1 $NET_DATA (0)  Start of data map
          NET Data definitions
    0010   16 Character    8 $NETLANNAME    LANNAME VSWITCH name
    0018   24 Character    8 $NETNICOWNER   NICOWNER (userid)
    0020   32 Bitstring    2 $NETNICBASE    NICBASE (first vdevid)
    0022   34 Bitstring    2 $NETNICLAST    NICLAST (last vdevid)
    0024   36 Bitstring    1 $NETLANTYPE    LANTYPE (QDIO/INMN/IEDN/etc)
    0025   37 Bitstring    1 $NETTRANSPORT  LANTRANP (IP/ETHERNET)
    0026   38 Bitstring    2 $NETNATVID     LANNVID (NATIVE VLAN)
    0028   40 Bitstring    4 $NETPORTNUM    NICMGPOR (VSWITCH port number)
    002C   44 Bitstring    1 $NETFORWARDING LANFORW (Port Forwarding flags)
    002D   45 Bitstring    1 $NETVLANPORT   NICVPORT (ACCESS/TRUNK)
    002E   46 Bitstring    1 $NETPRIQ       LANPRIQ (PRIQUEUING setting)
    002F   47 Bitstring    1 *              Reserved for IBM Use
              00000020       $NET_DLEN      *-$NET_DATA Length of data area
              00000030       $NETBYSZ       *-$NETWK Byte length of $NETWK
              00000006       $NETDWSZ       ((*-$NETWK)+7)/8 DWord length of
                                            $NETWK

$NETWK Storage Layout | Top of page

    *** $NETWK - Relocation mapping for virtual NIC
    *
    *     +-------------+-------------+---------------------------+
    *   0 | $NET_HDRL   | $NET_BITL   |///////////////////////////|
    *     +------+------+-------------+---------------------------+
    *   8 |$NET0 |$NET1 |/////////////////////////////////////////|
    *     +------+------+-----------------------------------------+
    *  10 |                     $NETLANNAME                       |
    *     +-------------------------------------------------------+
    *  18 |                     $NETNICOWNER                      |
    *     +-------------+-------------+------+------+-------------+
    *  20 |$NETNICBASE  |$NETNICLAST  |(024) |(025) | $NETNATVID  |
    *     +-------------+-------------+------+------+------+------+
    *  28 |       $NETPORTNUM         |(02C) |(02D) |:TPRIQ|//////|
    *     +---------------------------+------+------+------+------+
    *  30
    *
    *** $NETWK - Relocation mapping for virtual NIC

$NETWK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    $NET_BITL      0002
    $NET_BITS      0008
    $NET_BLEN      000A 00000008
    $NET_DATA      0010
    $NET_DLEN      002F 00000020
    $NET_HDLN      0004 00000008
    $NET_HDRL      0000
    $NET_VER       0000 00000001
    $NETBYSZ       002F 00000030
    $NETDDCFG      0009 40
    $NETDDCFM      0009 20
    $NETDDLAN      0009 80
    $NETDWSZ       002F 00000006
    $NETESMCTL     0008 08
    $NETFORWARDING
                   002C
    $NETLANNAME    0010
    $NETLANTYPE    0024
    $NETNATVID     0026
    $NETNICBASE    0020
    $NETNICLAST    0022
    $NETNICOWNER   0018
    $NETOSDSIM     0008 04
    $NETPORTBASED  0008 20
    $NETPORTNUM    0028
    $NETPRIQ       002E
    $NETPROMISC    0008 02
    $NETTRANSPORT  0025
    $NETUPHIG      0009 02
    $NETUPLOW      0009 08
    $NETUPNOR      0009 04
    $NETUSERBASED  0008 40
    $NETUSERPORT   0008 01
    $NETVLANPORT   002D
    $NETVLFILTER   0008 10
    $NETVSWITCH    0008 80
    $NET0          0008
    $NET1          0009

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:32:09 EDT.
Copyright IBM Corporation, 1990, 2020