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

#### KEYSECT

Prolog

Control Block Contents
KEYSECT DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### KEYSECT Prolog

     Name       : KEYSECT
     Description: Disk Key Table DSECT for BDAM Simulation
     DSECT      : KEYSECT
     Function   : KEYSECT defines by key, the key table used for
                  I/O in OS simulation of BDAM files. KEYSECT is
                  built dynamically from CMS free storage.
                  KEYSECT is called by the KEYSECT macro.

#### KEYSECT Control Block Content

#### KEYSECT DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      KEYSECT        Disk Key Table DSECT for BDAM Simulation
    0000    0 Signed       4 KEYLNGTH       - KEY LENGTH
    0004    4 Signed       4 DATAEND        - ITEM PTR TO LAST DATA ITEM IN
                                            FILE
    0008    8 Signed       4 KEYOP (2)      - START OF PLIST FOR KEYS FILE
    0010   16 Signed       4 KEYNAME (2)    - NAME OF KEYS FILE
    0018   24 Signed       4 KEYTYPE (2)    - FILE TYPE OF KEYS FILE
    0020   32 Signed       2 KEYMODE        - FILE MODE OF KEYS FILE
    0022   34 Signed       2 *              - RESERVED.
    0024   36 Signed       4 KEYTBLAD       - ADDRESS OF KEY TABLE
    0028   40 Signed       4 TBLLNGTH       - BYTE SIZE OF KEY TABLE
    002C   44 Bitstring    1 KEYFORM        - FORMAT OF KEYS FILE
    002D   45 Bitstring    1 KEYCHNG        - RDBUF/WRBUF PLIST FLAG.
              ..1. ....      KEYEXTPL       X'20' KEYEXTPL EXTENDED PLIST
                                            FLAG.
              .... ...1      KEYCHANG       X'01' KEYCHANG INDICATES CHANGE
                                            IN KEY TABLE
    002E   46 Signed       2 *              - RESERVED.
    0030   48 Signed       4 *              - NO. OF BYTES READ
    0034   52 Signed       4 KEYTBLNO       - ITEM NO. OF KEY TABLE
    0038   56 Signed       4 KEYCOUT        - BLOCKING FACTOR OF KEY TABLE
    003C   60 Signed       4 KEYTABLE (0)   - START OF TABLE (ITEM) FULL OF
                                            KEYS
    003C   60 Bitstring    4 KEYEOF         EOF MARKER.
    0040   64 Signed       2 KEYXTNT1       XTENT AREA IF LE 65535.
    0042   66 Character    2 KEYMARK        BDAM KEY INDICATOR.
    0044   68 Signed       2 KEYPTR1        PTR TO KEYS IF LE 65535.
    0046   70 Signed       2 *              RESERVED.
    0048   72 Signed       4 KEYXTNT2       XTENT AREA IF GT 65535.
    004C   76 Signed       4 KEYPTR2        PTR TO KEYS IF GT 65535.

#### KEYSECT Storage Layout

    *** KEYSECT - Disk Key Table DSECT for BDAM Simulation
    *
    *     +---------------------------+---------------------------+
    *   0 |         KEYLNGTH          |         DATAEND           |
    *     +---------------------------+---------------------------+
    *   8 |                        KEYOP                          |
    *     +-------------------------------------------------------+
    *  10 |                       KEYNAME                         |
    *     +-------------------------------------------------------+
    *  18 |                       KEYTYPE                         |
    *     +-------------+-------------+---------------------------+
    *  20 |  KEYMODE    |/////////////|         KEYTBLAD          |
    *     +-------------+-------------+------+------+-------------+
    *  28 |         TBLLNGTH          |:FORM |:CHNG |/////////////|
    *     +---------------------------+------+------+-------------+
    *  30 |///////////////////////////|         KEYTBLNO          |
    *     +---------------------------+---------------------------+
    *  38 |         KEYCOUT           |          KEYEOF           |
    *     +-------------+-------------+-------------+-------------+
    *  40 |  KEYXTNT1   |  KEYMARK    |  KEYPTR1    |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *  48 |         KEYXTNT2          |         KEYPTR2           |
    *     +---------------------------+---------------------------+
    *  50
    *
    *** KEYSECT - Disk Key Table DSECT for BDAM Simulation

#### KEYSECT Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DATAEND        0004
    KEYCHANG       002D 01
    KEYCHNG        002D
    KEYCOUT        0038
    KEYEOF         003C
    KEYEXTPL       002D 20
    KEYFORM        002C
    KEYLNGTH       0000
    KEYMARK        0042
    KEYMODE        0020
    KEYNAME        0010
    KEYOP          0008
    KEYPTR1        0044
    KEYPTR2        004C
    KEYTABLE       003C
    KEYTBLAD       0024
    KEYTBLNO       0034
    KEYTYPE        0018
    KEYXTNT1       0040
    KEYXTNT2       0048
    TBLLNGTH       0028

This information is based on z/VM V6R1.0.
Last updated on 23 Oct 2009 at 11:01:56 EDT.
Copyright IBM Corporation, 1990, 2008