Programming Interface Information: This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM.

#### LABSECT

Prolog

Control Block Contents
LABSECT DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### LABSECT Prolog

     Name       : LABSECT
     Description: Tape Label Information
     DSECT      : LABSECT
     Function   : LABSECT contains user-supplied tape label
                  information used by CMS tape label processing.
                  LABSECT is called by the LABSECT macro.

#### LABSECT Control Block Content

#### LABSECT DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      LABSECT        Tape Label Information
    0000    0 Address      4 LABNEXT        FORWARD CHAIN POINTER
    0004    4 Address      4 LABFCBPT       POINTER TO FCBSECT OR ZERO
    0008    8 Character    8 LABFILE        NAME OF FILE (DDNAME) FOR BLOCK
    0010   16 Character   17 LABFID         FILE ID (RIGHTMOST 17 CHARACTERS)
    0021   33 Character    1 LABSEC         SECURITY
    0022   34 Character    6 LABVOLID       VOLUME SERIAL NUMBER (VOLID)
    0028   40 Character    4 LABVSEQ        VOLUME SEQUENCE NUMBER
    002C   44 Character    4 LABFSEQ        FILE SEQUENCE NUMBER
    0030   48 Character    4 LABGENN        GENERATION NUMBER
    0034   52 Character    2 LABGENV        GENERATION VERSION
    0036   54 Character    6 LABCRD         CREATION DATE
    003C   60 Character    6 LABEXD         EXPIRATION DATE
    0042   66 Bitstring    1 LABFLAG1       THIS BYTE HAS DEFAULT FLAGS:
              1... ....      LABDFID        X'80' LABDFID DEFAULT FILE ID
              .1.. ....      LABDSEC        X'40' LABDSEC DEFAULT SECURITY
              ..1. ....      LABDVID        X'20' LABDVID DEFAULT VOLUME
                                            SERIAL NUMBER
              ...1 ....      LABDVSEQ       X'10' LABDVSEQ DEFAULT VOLUME
                                            SEQUENCE NUMBER
              .... 1...      LABDFSEQ       X'08' LABDFSEQ DEFAULT FILE
                                            SEQUENCE NUMBER
              .... .1..      LABDGENN       X'04' LABDGENN DEFAULT GENERATION
                                            NUMBER
              .... ..1.      LABDGENV       X'02' LABDGENV DEFAULT GENERATION
                                            VERSION
              .... ...1      LABDCRD        X'01' LABDCRD DEFAULT CREATION
                                            DATE
    0043   67 Bitstring    1 LABFLAG2       MISCELLANEOUS FLAGS BYTE:
              1... ....      LABDEXD        X'80' LABDEXD DEFAULT EXPIRATION
                                            DATE
              .1.. ....      LABSCRAT       X'40' LABSCRAT DO 'SCRATCH' VOLID
                                            PROCESSING
              ..1. ....      LABSCRSP       X'20' LABSCRSP SCRATCH SPECIFIED;
                                            NOT DEFAULT
              ...1 ....      LABLBDSC       X'10' LABLBDSC LABSCRAT set by
                                            LABELDEF
              .... .1..      LABFDEF        X'04' LABFDEF LABSECT GOTTEN BY
                                            FILEDEF
              .... ..1.      LABPERM        X'02' LABPERM PERMANENT SPECIFIED
              .... ...1      LABNOCHG       X'01' LABNOCHG NOCHANGE SPECIFIED
    0044   68 Address      4 LABCUVOL       POINTER TO CURRENT VOLID MOUNTED
    0048   72 Address      4 LABNXVOL       POINTER TO NEXT VOLID TO MOUNT
    004C   76 Address      4 LABVSECT       FORWARD CHAIN POINTER TO VOLSECT
    0050   80 Address      4 LABCSECT       VOLSECT ADDR OF CURRENT VOLID
    0054   84 Character  120 LABVOLS        SPACE FOR 15 ADDITIONAL VOLIDS
    00CC  204 Bitstring    4 LABEND         FENCE FOR END OF VOLIDS
    00D0  208 Character   44 LABFILID       FILE IDENTIFIER
    00FC  252 Character   17 LABSTRP        LAST 17 CHAR OF LABFILID
              00000022       LABSIZE        (*-LABSECT+7)/8 SIZE OF LABSECT
                                            IN DOUBLE WORDS

#### LABSECT Storage Layout

    *** LABSECT - Tape Label Information
    *
    *     +---------------------------+---------------------------+
    *   0 |         LABNEXT           |         LABFCBPT          |
    *     +---------------------------+---------------------------+
    *   8 |                       LABFILE                         |
    *     +-------------------------------------------------------+
    *  10 |                                                       |
    *     =                        LABFID                         =
    *     |      +------+-----------------------------------------+
    *  20 |      |LABSEC|                LABVOLID                 |
    *     +------+------+-------------+---------------------------+
    *  28 |         LABVSEQ           |         LABFSEQ           |
    *     +---------------------------+-------------+-------------+
    *  30 |         LABGENN           |  LABGENV    |   (036)-    |
    *     +---------------------------+-------------+-------------+
    *  38 |         -LABCRD           |         LABEXD-           |
    *     +-------------+------+------+---------------------------+
    *  40 |   -(03C)    |:FLAG1|:FLAG2|         LABCUVOL          |
    *     +-------------+------+------+---------------------------+
    *  48 |         LABNXVOL          |         LABVSECT          |
    *     +---------------------------+---------------------------+
    *  50 |         LABCSECT          |                           |
    *     +---------------------------+                           |
    *  58 |                                                       |
    *     =                       LABVOLS                         =
    *     |                           +---------------------------+
    *  C8 |                           |          LABEND           |
    *     +---------------------------+---------------------------+
    *  D0 |                                                       |
    *     =                       LABFILID                        =
    *     |                           +---------------------------+
    *  F8 |                           |                           |
    *     +---------------------------+                           |
    *     |                       LABSTRP                         |
    *     |                                  +--------------------+
    *     |                                  | 10D
    *     +----------------------------------+
    *
    *** LABSECT - Tape Label Information

#### LABSECT Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    LABCRD         0036
    LABCSECT       0050
    LABCUVOL       0044
    LABDCRD        0042 01
    LABDEXD        0043 80
    LABDFID        0042 80
    LABDFSEQ       0042 08
    LABDGENN       0042 04
    LABDGENV       0042 02
    LABDSEC        0042 40
    LABDVID        0042 20
    LABDVSEQ       0042 10
    LABEND         00CC
    LABEXD         003C
    LABFCBPT       0004
    LABFDEF        0043 04
    LABFID         0010
    LABFILE        0008
    LABFILID       00D0
    LABFLAG1       0042
    LABFLAG2       0043
    LABFSEQ        002C
    LABGENN        0030
    LABGENV        0034
    LABLBDSC       0043 10
    LABNEXT        0000
    LABNOCHG       0043 01
    LABNXVOL       0048
    LABPERM        0043 02
    LABSCRAT       0043 40
    LABSCRSP       0043 20
    LABSEC         0021
    LABSIZE        00FC 00000022
    LABSTRP        00FC
    LABVOLID       0022
    LABVOLS        0054
    LABVSECT       004C
    LABVSEQ        0028

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