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

#### DVLHEAD

Prolog

Control Block Contents
DVLHEAD DSECT
DVLRANGE DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DVLHEAD Prolog

     NAME       : HCPDVLBK
     DESCRIPTION: Device List Structures
     DSECT      : DVLHEAD
     FUNCTION   :
                  This file defines structures that are used to
                  represent a set of device addresses (or similar
                  collections of numeric values).  Typical
                  applications for this structure are:
         Device List
         VLAN List
     LOCATED BY :
                  Various links depending on the application.
     CREATED BY :
                  HCPDVLAL - Add a range to the device list.
     DELETED BY :
                  HCPDVLDL - Delete a device list.

#### DVLHEAD Control Block Content

#### DVLHEAD DSECT

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DVLHEAD        Device List Structures
    0000    0 Address      4 DVLHFRST       First DVLRANGE
    0004    4 Address      4 DVLHSOFR       DVLRANGE where GD left off
    0008    8 Address      4 DVLHLAST       Last DVLRANGE
    000C   12 Signed       4 DVLHMXNM       Maximum OK number
    0010   16 Address      4 DVLHADBM       Address of Already Done Bit Map
              00000003       DVLHSIZE       (*-DVLHEAD+7)/8 Head of list size
                                            in DWORDS
          OBJECT - DVLRANGE
            Map a single range (see HCPDVL ASSEMBLE).

    DVLRANGE DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DVLRANGE       Device List Structures
    0000    0 Address      4 DVLRNEXT       Next DVLRANGE in list
    0004    4 Signed       4 DVLRFRST       First number in range
    0008    8 Signed       4 DVLRSOFR       Number where GD left off
    000C   12 Signed       4 DVLRLST        Last number in range
    0010   16 Signed       4 DVLRCNT        Count of numbers in range
    0014   20 Signed       4 DVLRESET       0 ==> not processed yet
              00000003       DVLRSIZE       (*-DVLRANGE+7)/8 Device range
                                            block DWORD size

    DVLHEAD Storage Layout

    *** DVLHEAD - Device List Structures
    *
    *     +---------------------------+---------------------------+
    *   0 |         DVLHFRST          |         DVLHSOFR          |
    *     +---------------------------+---------------------------+
    *   8 |         DVLHLAST          |         DVLHMXNM          |
    *     +---------------------------+---------------------------+
    *  10 |         DVLHADBM          | 14
    *     +---------------------------+
    *
    *** DVLHEAD - Device List Structures

    *** DVLRANGE - Device List Structures
    *
    *     +---------------------------+---------------------------+
    *   0 |         DVLRNEXT          |         DVLRFRST          |
    *     +---------------------------+---------------------------+
    *   8 |         DVLRSOFR          |         DVLRLST           |
    *     +---------------------------+---------------------------+
    *  10 |         DVLRCNT           |         DVLRESET          |
    *     +---------------------------+---------------------------+
    *  18
    *
    *** DVLRANGE - Device List Structures

    DVLHEAD Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DVLHADBM       0010
    DVLHFRST       0000
    DVLHLAST       0008
    DVLHMXNM       000C
    DVLHSIZE       0010 00000003
    DVLHSOFR       0004
    DVLRCNT        0010
    DVLRESET       0014
    DVLRFRST       0004
    DVLRLST        000C
    DVLRNEXT       0000
    DVLRSIZE       0014 00000003
    DVLRSOFR       0008

    This information is
    based on z/VM V5R2.0.
    Last updated on 12 Apr 2006 at 16:52:12 EDT.

    Copyright IBM Corporation, 1990, 2005