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

 

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' 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 Bitstring    1 SDFTYPE        TYPE OF SYSTEM DATA FILE FLAG
          00000080       SDFNSS         X'80' SDFNSS File is a saved
                                        System or Segment.
          00000040       SDFIMG         X'40' SDFIMG IMAGE LIBRARY FILE
          00000020       SDFTRF         X'20' SDFTRF System Trace File
                                        (TRF)
          00000010       SDFDMP         X'10' SDFDMP SOFT ABEND DUMP FILE
          00000008       SDFUCR         X'08' SDFUCR Class Override file
                                        (UCR)
          00000004       SDFNLS         X'04' SDFNLS National Language
                                        file (NLS)
          00000002       SDFVMDMP       X'02' 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

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

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 V6R2.0. Last updated on 21 Nov 2011 at 11:20:01 EDT.
Copyright IBM Corporation, 1990, 2011