$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.3.0 Last updated on 22 Jun 2022 at 15:58:54 EDT.
Copyright IBM Corporation, 1990, 2022