Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### VNCBK

Prolog

Control Block Contents
VNCBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### VNCBK Prolog

     NAME       : HCPVNCBK
     DESCRIPTION: Virtual Network Command parameters
     DSECT      : VNCBK
     FUNCTION   :
                  Define a structure to represent a work area used
                  for processing a QUERY LAN or QUERY VSWITCH command
                  or a QUERY PORT command.
                  A new VNCBK is allocated for each command.
     LOCATED BY -
       Local pointer for the duration of command processing
     CREATED BY -
       CP QUERY LAN command processing (module HCPVLQ)
       CP QUERY VSWITCH command processing (module HCPSWQ)
       CP QUERY CONTROLLER command processing (module HCPSWQ)
       CP QUERY PORT command processing (module HCPSWP)
     DESTROYED BY -
       CP QUERY LAN command processing (module HCPVLQ)
       CP QUERY VSWITCH command processing (module HCPSWQ)
       CP QUERY CONTROLLER command processing (module HCPSWQ)
       CP QUERY PORT command processing (module HCPSWP)
     REFERENCED CONTROL BLOCKS -
       HCPLANBK COPY - Virtual Network (LAN) definition

#### VNCBK Control Block Content

#### VNCBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      VNCBK          Virtual Network Command parameters
    0000    0 Bitstring    1 VNCLEVEL       Level (VSWITCH/LAN/GROUP)
              .... ...1      VNCGLAN        1 VNCGLAN - Level 1 - Guest Lan &
                                            VSWITCH
              .... ..1.      VNCVSW         2 VNCVSW - Level 2 - Vswitch
              .... ..11      VNCGRP         3 VNCGRP - Level 3 - GROUP
    0001    1 Bitstring    1 VNCOPT         Command processing options
              1... ....      VNCXALL        X'80' VNCXALL - Found keyword
                                            'ALL'
              .1.. ....      VNCXLAN        X'40' VNCXLAN - Use VNCNAME
                                            <lanname>
              ..1. ....      VNCXANY        X'20' VNCXANY - Found keyword
                                            'ANYOWNER'
              ...1 ....      VNCXOWN        X'10' VNCXOWN - Use VNCUSER
                                            <ownerid>
              .... 1...      VNCXANT        X'08' VNCXANT - Found keyword
                                            'ANYTYPE'
              .... .1..      VNCXTYPE       X'04' VNCXTYPE - Use VNCTYPE
                                            <lantype>
              .... ..1.      VNCXUSR        X'02' VNCXUSR - Use VNCUSER
                                            <controller>
    0002    2 Bitstring    1 VNCOPT1        Command processing options
              1... ....      VNCXDET        X'80' VNCXDET - Found keyword
                                            'DETails'
              .1.. ....      VNCXACT        X'40' VNCXACT - Found keyword
                                            'ACTive'
              ..1. ....      VNCXACC        X'20' VNCXACC - Found keyword
                                            'ACCesslist'
              ...1 ....      VNCXCONN       X'10' VNCXCONN - Report every
                                            connection
              .... 1...      VNCXCTRS       X'08' VNCXCTRS - Report counters
                                            (VSWITCH)
              .... .1..      VNCXPRO        X'04' VNCXPRO - Found keywork
                                            'PROmiscuous'
              .... ..1.      VNCXCON        X'02' VNCXCON - Found keywork
                                            'CONtroller'
    0003    3 Bitstring    1 VNCOPT2        Command processing options
              1... ....      VNCXVLAN       X'80' VNCXVLAN - Found keyword
                                            'VLAN'
              .1.. ....      VNCXVLAN_ANY   X'40' VNCXVLAN_ANY - Found
                                            keyword 'VLAN ANY'
              ..1. ....      VNCXVLAN_NONE  X'20' VNCXVLAN_NONE - Found
                                            keyword 'VLAN NONE'
              ...1 ....      VNCXUSER       X'10' VNCXUSER - Found keyword
                                            'USERid user'
              .... 1...      VNCXRDEV       X'08' VNCXRDEV - Found keyword
                                            'RDEV nnnn'
    0004    4 Bitstring   16 VNCLANID (0)   LAN ID (ownerid||lanname)
    0004    4 Bitstring    8 VNCUSER        Owner (userid)
    000C   12 Bitstring    8 VNCNAME        Name
    0004    4 Bitstring    8 VNCPGNME       Groupname
    0014   20 Signed       2 VNCVLAN        VLAN id
    0016   22 Bitstring    1 VNCTYPE        LAN TYPE value (use LANTYPE)
    0017   23 Bitstring    1 VNCMPAQD       Options for HCPMPAQD
              1... ....      VNCQDDET       X'80' VNCQDDET - DETAILS
                                            requested
              .1.. ....      VNCQDVID       X'40' VNCQDVID - Restrict to
                                            matching VLAN ID
    0018   24 Bitstring    1 VNCNOTES       Notes (during processing)
              1... ....      VNCACTVL       X'80' VNCACTVL Indicate VLAN ID
                                            found
              .1.. ....      VNCACTRD       X'40' VNCACTRD Indicate matching
                                            RDEV found
              ..1. ....      VNCACTUS       X'20' VNCACTUS Indicate matching
                                            USER found
    0019   25 Bitstring    1 VNCPOPT        QUERY PORT command options
              1... ....      VNCPGRP        X'80' VNCPGRP - Found keyword
                                            'GROup'
              .1.. ....      VNCPGRPN       X'40' VNCPGRPN - Found
                                            <groupname> - Moved RDEV
                                            flag from - VNCPRDEV to VNCXRDEV
              ...1 ....      VNCPDET        X'10' VNCPDET - Found keyword
                                            'DETails'
              .... 1...      VNCPACT        X'08' VNCPACT - Found keyword
                                            'ACTive'
              .... .1..      VNCPIACT       X'04' VNCPIACT - Found keyword
                                            'INActive'
    001A   26 Signed       2 VNCPRDV        RDEV
    001C   28 Bitstring    1 VNCNOTEI       Notes for individual LANBK See
                                            bits defined for VNCNOTES.
    001D   29 Bitstring    1 *              Reserved for alignment
    0020   32 Address      4 VNCSWPBK       Pointer to SWPBK
    0024   36 Character    8 VNCUSERF       USERID for filtering
              0000002C       VNC$END        * End of VNCBK
              0000002C       VNCBKLN        *-VNCBK Size of VNCBK in bytes
              00000006       VNCBKSZ        (*-VNCBK+7)/8 Size of VNCBK in
                                            doublewords
         ** End of Definitions

#### VNCBK Storage Layout

    *** VNCBK - Virtual Network Command parameters
    *
    *     +------+------+------+------+---------------------------+
    *   0 |:LEVEL|VNCOPT|:OPT1 |:OPT2 |         VNCUSER-          |
    *     +------+------+------+------+---------------------------+
    *   8 |          -(004)           |         VNCNAME-          |
    *     +---------------------------+-------------+------+------+
    *  10 |          -(00C)           |  VNCVLAN    |:TYPE |:MPAQD|
    *     +------+------+-------------+------+------+------+------+
    *  18 |:NOTES|:POPT |  VNCPRDV    |:NOTEI|//////|/////////////|
    *     +------+------+-------------+------+------+-------------+
    *  20 |         VNCSWPBK          |        VNCUSERF-          |
    *     +---------------------------+---------------------------+
    *  28 |          -(024)           | 2C
    *     +---------------------------+
    *
    *** VNCBK - Virtual Network Command parameters

    *** Overlay for VNCLANID in VNCBK
    *
    *                                 +---------------------------+
    *     ...                       4 |        VNCPGNME-          |
    *     +---------------------------+---------------------------+
    *   8 |          -(004)           | C
    *     +---------------------------+
    *
    *** Overlay for VNCLANID in VNCBK

#### VNCBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    VNC$END        0024 0000002C
    VNCACTRD       0018 40
    VNCACTUS       0018 20
    VNCACTVL       0018 80
    VNCBKLN        0024 0000002C
    VNCBKSZ        0024 00000006
    VNCGLAN        0000 01
    VNCGRP         0000 03
    VNCLANID       0004
    VNCLEVEL       0000
    VNCMPAQD       0017
    VNCNAME        000C
    VNCNOTEI       001C
    VNCNOTES       0018
    VNCOPT         0001
    VNCOPT1        0002
    VNCOPT2        0003
    VNCPACT        0019 08
    VNCPDET        0019 10
    VNCPGNME       0004
    VNCPGRP        0019 80
    VNCPGRPN       0019 40
    VNCPIACT       0019 04
    VNCPOPT        0019
    VNCPRDV        001A
    VNCQDDET       0017 80
    VNCQDVID       0017 40
    VNCSWPBK       0020
    VNCTYPE        0016
    VNCUSER        0004
    VNCUSERF       0024
    VNCVLAN        0014
    VNCVSW         0000 02
    VNCXACC        0002 20
    VNCXACT        0002 40
    VNCXALL        0001 80
    VNCXANT        0001 08
    VNCXANY        0001 20
    VNCXCON        0002 02
    VNCXCONN       0002 10
    VNCXCTRS       0002 08
    VNCXDET        0002 80
    VNCXLAN        0001 40
    VNCXOWN        0001 10
    VNCXPRO        0002 04
    VNCXRDEV       0003 08
    VNCXTYPE       0001 04
    VNCXUSER       0003 10
    VNCXUSR        0001 02
    VNCXVLAN       0003 80
    VNCXVLAN_ANY   0003 40
    VNCXVLAN_NONE  0003 20

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:23:36 EDT.
Copyright IBM Corporation, 1990, 2008