SDFBK | Back to Index page

| Prolog Control Block Contents SDFBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

SDFBK Prolog | Top of page

     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
     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
     RELOCATION CONSIDERATIONS : None

SDFBK Control Block Content | Top of page

     SDFBK DSECT
    Top of page

    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' SDFOPENR FILE IS OPEN FOR
                                            READING
              .1.. ....      SDFOPENW       X'40' SDFOPENW FILE IS OPEN FOR
                                            WRITING
              ..1. ....      SDFNORTN       X'20' SDFNORTN File is marked
                                            NORETURN
              .... 1...      SDFPURGE       X'08' SDFPURGE FILE IS MARKED FOR
                                            PENDING PURGE
              .... .1..      SDFEOF         X'04' SDFEOF FILE IS POSITIONED
                                            AT END
    002E   46 Signed       1 SDFTYPE        Type of System Data File flag
              00000080       SDFNSS         128 SDFNSS File is a saved System
                                            or Segment.
              00000040       SDFIMG         64 SDFIMG Image library file
              00000020       SDFTRF         32 SDFTRF System Trace File (TRF)
              00000010       SDFDMP         16 SDFDMP Soft ABEND dump file
              00000008       SDFUCR         8 SDFUCR Class Override file
                                            (UCR) - UCR no longer supported
                                            but - Customers may still have
                                            files - of this type on the
                                            system
              00000004       SDFNLS         4 SDFNLS National Language file
                                            (NLS)
              00000002       SDFVMDMP       2 SDFVMDMP VM DUMP file
    002F   47 Bitstring    1 SDFFLAG        User data flags
              1... ....      SDFSECUR       X'80' SDFSECUR 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
          Mapping for SDFSPOOL field
    0050   80 Signed       4 SDFSPABK       Address of SPABK
    0054   84 Signed       4 SDFSPFBK       Address of SPFBK. This field is
                                            filled in while the SDF is open
    0058   88 Bitstring    1 SDFSPLFL       Spooling data file flag
              1... ....      SDFRDLST       X'80' SDFRDLST For a file being
                                            written, the last record was read
    0059   89 Bitstring   15 *              Reserved for IBM use

SDFBK Storage Layout | Top of page

    *** 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

    *** Overlay for SDFSPOOL in SDFBK
    *
    *     +---------------------------+---------------------------+
    *  50 |         SDFSPABK          |         SDFSPFBK          |
    *     +------+--------------------+---------------------------+
    *  58 |:SPLFL|////////////////////////////////////////////////|
    *     +------+////////////////////////////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  68
    *
    *** Overlay for SDFSPOOL in SDFBK

SDFBK Cross Reference | Top of page

    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
    SDFRDLST       0058 80
    SDFRECNT       0020
    SDFRECSZ       0028
    SDFSCLAB       0048
    SDFSECUR       002F 80
    SDFSIZE        0068 00000012
    SDFSPABK       0050
    SDFSPFBK       0054
    SDFSPLFL       0058
    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 7.2.0 Last updated on 24 Jun 2020 at 09:30:19 EDT.
Copyright IBM Corporation, 1990, 2020