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 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)
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    2 *              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 - 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) |/////////////|
*     +---------------------------+------+------+-------------+
*  30
*
*** $NETWK - Relocation mapping for virtual NIC

 
Symbol         Dspl Value
-------------- ---- -----
$NET_BITL      0002
$NET_BITS      0008
$NET_BLEN      000A 00000008
$NET_DATA      0010
$NET_DLEN      002E 00000020
$NET_HDLN      0004 00000008
$NET_HDRL      0000
$NET_VER       0000 00000001
$NETBYSZ       002E 00000030
$NETDDCFG      0009 40
$NETDDCFM      0009 20
$NETDDLAN      0009 80
$NETDWSZ       002E 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
$NETPROMISC    0008 02
$NETTRANSPORT  0025
$NETUSERBASED  0008 40
$NETUSERPORT   0008 01
$NETVLANPORT   002D
$NETVLFILTER   0008 10
$NETVSWITCH    0008 80
$NET0          0008
$NET1          0009