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 SDFSPTAP       Flags for SPTAPE usage.
          .1.. ....      SDFSPTD        X'40' SPTAPE currently dumping
                                        file.
          ..1. ....      SDFSPTL        X'20' SPTAPE currently loading
                                        file.
0031   49 Bitstring    1 *              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 |:SPTAP|//////|  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
SDFSPTAP       0030
SDFSPTD        0030 40
SDFSPTL        0030 20
SDFSTAT        002D
SDFTRF         002E 00000020
SDFTYPE        002E
SDFUCR         002E 00000008
SDFVMDMP       002E 00000002
SDFWORK        0068
SDFWRBUF       003C

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 16:20:31 EDT.
Copyright IBM Corporation, 1990, 2001