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

#### SDFBK

Prolog

Control Block Contents
SDFBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SDFBK Prolog

     NAME       : HCPSDFBK
     DESCRIPTION: SYSTEM DATA FILE BLOCK
     DSECT      : SDFBK
     FUNCTION   : THIS IS THE CONTROL BLOCK THROUGH WHICH USERS OF
                  SYSTEM DATA FILES COMMUNICATE WITH THE SPOOLING
                  SUBSYSTEM.
     LOCATED BY : THE ADDRESS OF THE BLOCK IS MAINTAINED BY THE ROUTINES
                  WHICH UTILIZE SYSTEM DATA FILES, AND IS PASSED TO ALL
                  SYSTEM DATA FILE ROUTINES.
     CREATED BY : HCPNSD - WHEN DEFINING A SYSTEM OR SEGMENT
                  HCPNSG - WHEN SAVING ANY SYSTEM DATA FILE
                  HCPNSI - WHEN LOADING ANY SYSTEM DATA FILE
                  HCPNSL - WHEN LOADING A SYSTEM OR SEGMENT
                  HCPNSN - TO PURGE SYSTEM DATA FILES
                  HCPNSQ - TO QUERY NSS/DCSS FILES
                  HCPNSR - WHEN OPENING AN IMAGE LIBRARY
                  HCPNSS - WHEN SAVING A SYSTEM OR SEGMENT
                  HCPTRD - AFTER OPENING A SYSTEM TRACE FILE
                  HCPUCR - WHEN OPENING A UCR FILE
     DELETED BY : HCPNSD - AFTER DEFINING A SYSTEM OR SEGMENT
                  HCPNSG - AFTER SAVING ANY SYSTEM DATA FILE
                  HCPNSI - AFTER LOADING ANY SYSTEM DATA FILE
                  HCPNSN - AFTER PURGE SYSTEM DATA FILES
                  HCPNSP - WHEN PURGING A NSS OR DCSS
                  HCPNSQ - AFTER QUERYING NSS/DCSS FILES
                  HCPNSR - AFTER CLOSING AN IMAGE LIBRARY
                  HCPNSS - AFTER SAVING A SYSTEM OR SEGMENT
                  HCPTRD - AFTER CLOSING A SYSTEM TRACE FILE
                  HCPTSG - AFTER CLOSING A SYSTEM TRACE FILE
                  HCPUCR - AFTER CLOSING A UCR FILE

#### SDFBK Control Block Content

#### SDFBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SDFBK          SYSTEM DATA FILE BLOCK
    0000    0 Character    8 SDFFN          FILE NAME
    0008    8 Character    8 SDFFT          FILE TYPE
    0010   16 Character    8 SDFOWNER       USERID OF FILE OWNER
    0018   24 Character    8 SDFORIG        USERID OF FILE ORIGINATOR
    0020   32 Signed       4 SDFRECNT       NUMBER OF RECORDS
    0024   36 Signed       4 SDFPOS         CURRENT RECORD POSITION IN THE
                                            FILE
    0028   40 Signed       2 SDFRECSZ       RECORD SIZE
    002A   42 Signed       2 *              RESERVED FOR FUTURE IBM USE
    002C   44 Character    1 SDFCLASS       FILE CLASS
    002D   45 Bitstring    1 SDFSTAT        FILE STATUS FLAG
              1... ....      SDFOPENR       X'80' FILE IS OPEN FOR READING
              .1.. ....      SDFOPENW       X'40' FILE IS OPEN FOR WRITING
              ..1. ....      SDFNORTN       X'20' File is marked NORETURN
              .... 1...      SDFPURGE       X'08' FILE IS MARKED FOR PENDING
                                            PURGE
              .... .1..      SDFEOF         X'04' FILE IS POSITIONED AT END
    002E   46 Bitstring    1 SDFTYPE        TYPE OF SYSTEM DATA FILE FLAG
              00000080       SDFNSS         X'80' File is a saved System or
                                            Segment.
              00000040       SDFIMG         X'40' IMAGE LIBRARY FILE
              00000020       SDFTRF         X'20' System Trace File (TRF)
              00000010       SDFDMP         X'10' SOFT ABEND DUMP FILE
              00000008       SDFUCR         X'08' Class Override file (UCR)
              00000004       SDFNLS         X'04' National Language file
                                            (NLS)
              00000002       SDFVMDMP       X'02' VM DUMP file
    002F   47 Bitstring    1 SDFFLAG        User data flags
              1... ....      SDFSECUR       X'80' This bit is used to provide
                                            security when SPTAPE DUMPing
                                            NSS/DCSS files.
    0030   48 Bitstring    1 * (2)          RESERVED FOR FUTURE IBM USE
    0032   50 Signed       2 SDFIDNUM       FILE IDENTIFICATION NUMBER
    0034   52 Signed       4 *              RESERVED FOR FUTURE IBM USE
    0038   56 Signed       4 SDFRDBUF       READ BUFFER ADDRESS
    003C   60 Signed       4 SDFWRBUF       WRITE BUFFER ADDRESS
    0040   64 Signed       4 SDFCLTIM       FIRST HALF OF TOD CLOCK WHEN THE
                                            FILE WAS CLOSED
    0044   68 Signed       4 *              RESERVED FOR FUTURE IBM USE
    0048   72 Dbl-Word     8 SDFSCLAB       SPOOL FILE SECLABEL
    0050   80 Signed       4 SDFSPOOL (6)   RESERVED AREA FOR SPOOL SUBSYSTEM
    0068  104 Signed       4 SDFWORK (10)   USER WORK AREA
              00000012       SDFSIZE        (*-SDFBK+7)/8 SIZE OF SDFBK IN
                                            DOUBLE WORDS
              00000090       SDFBSIZE       *-SDFBK SIZE OF SDFBK IN BYTES

#### SDFBK Storage Layout

    *** SDFBK - SYSTEM DATA FILE BLOCK
    *
    *     +-------------------------------------------------------+
    *   0 |                        SDFFN                          |
    *     +-------------------------------------------------------+
    *   8 |                        SDFFT                          |
    *     +-------------------------------------------------------+
    *  10 |                       SDFOWNER                        |
    *     +-------------------------------------------------------+
    *  18 |                       SDFORIG                         |
    *     +---------------------------+---------------------------+
    *  20 |         SDFRECNT          |          SDFPOS           |
    *     +-------------+-------------+------+------+------+------+
    *  28 |  SDFRECSZ   |/////////////|:CLASS|:STAT |:TYPE |:FLAG |
    *     +-------------+-------------+------+------+------+------+
    *  30 |/////////////|  SDFIDNUM   |///////////////////////////|
    *     +-------------+-------------+---------------------------+
    *  38 |         SDFRDBUF          |         SDFWRBUF          |
    *     +---------------------------+---------------------------+
    *  40 |         SDFCLTIM          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  48 |                       SDFSCLAB                        |
    *     +-------------------------------------------------------+
    *  50 |                                                       |
    *     =                       SDFSPOOL                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  68 |                                                       |
    *     =                       SDFWORK                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  90
    *
    *** SDFBK - SYSTEM DATA FILE BLOCK

#### SDFBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SDFBSIZE       0068 00000090
    SDFCLASS       002C
    SDFCLTIM       0040
    SDFDMP         002E 00000010
    SDFEOF         002D 04
    SDFFLAG        002F
    SDFFN          0000
    SDFFT          0008
    SDFIDNUM       0032
    SDFIMG         002E 00000040
    SDFNLS         002E 00000004
    SDFNORTN       002D 20
    SDFNSS         002E 00000080
    SDFOPENR       002D 80
    SDFOPENW       002D 40
    SDFORIG        0018
    SDFOWNER       0010
    SDFPOS         0024
    SDFPURGE       002D 08
    SDFRDBUF       0038
    SDFRECNT       0020
    SDFRECSZ       0028
    SDFSCLAB       0048
    SDFSECUR       002F 80
    SDFSIZE        0068 00000012
    SDFSPOOL       0050
    SDFSTAT        002D
    SDFTRF         002E 00000020
    SDFTYPE        002E
    SDFUCR         002E 00000008
    SDFVMDMP       002E 00000002
    SDFWORK        0068
    SDFWRBUF       003C

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:22:27 EDT.
Copyright IBM Corporation, 1990, 2005