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

#### SFBLOK

Prolog

Control Block Contents
SFBLOK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SFBLOK Prolog

     NAME       : SFBLOK
     DESCRIPTION: VM/SP 370 SPOOL FILE CONTROL BLOCK
     DSECT      : SFBLOK
     FUNCTION   : THIS DSECT IS USED TO WHEN SPOOL FILES ARE TO BE
                  TRANSLATED TO VM/SP FORMAT.  (IT IS ANALOGOUS TO
                  THE VM/XA SPFBK.)
     CREATED BY : HCPSXSFB FOR SPFBK TO SFBLOK TRANSLATIONS.  THIS IS
                  DONE FOR DIAGNOSE X'14' and *SPL OUTPUT.
     DELETED BY : NOT APPLICABLE

#### SFBLOK Control Block Content

#### SFBLOK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SFBLOK         VM/SP 370 SPOOL FILE CONTROL BLOCK
    0000    0 Signed       4 SFBPNT         POINTER TO NEXT SFBLOK
    0004    4 Signed       4 SFBSTART       DASD LOC. OF FIRST PAGE BUFFER
    0008    8 Character    8 SFBUSER        VMUSER IDENTIFICATION OF FILE
                                            OWNER
    0010   16 Character    8 SFBORIG        VMUSER IDENTIFICATION OF FILE
                                            ORIGIN
    0018   24 Signed       4 SFBRECNO       NUMBER OF DATA RECORDS IN FILE
    001C   28 Signed       2 SFBRECSZ       LOGICAL RECORD SIZE - EXCLD. CCWS
    001E   30 Signed       2 SFBFILID       BINARY SYSTEM FILE NUMBER
    0020   32 Bitstring    1 SFBFLAG        S*1 SFBLOK CONTROL FLAGS
              1... ....      SFBINUSE       X'80' SFBINUSE FILE BEING
                                            PROCESSED
              .1.. ....      SFBRECOK       X'40' SFBRECOK ALLOCATION RECORDS
                                            COMPLETE
              ..1. ....      SFBUHOLD       X'20' SFBUHOLD FILE IN USER HOLD
                                            STATUS
              ...1 ....      SFBDUMP        X'10' SFBDUMP FILE IS A CP SYSTEM
                                            DUMP
              .... 1...      SFBOPEN        X'08' SFBOPEN INPUT FILE HAS BEEN
                                            OPENED
              .... .1..      SFBSHOLD       X'04' SFBSHOLD FILE IN SYSTEM
                                            HOLD STATUS
              .... ..1.      SFBEOF         X'02' SFBEOF INPUT FILE HAS
                                            REACHED EOF
              .... ...1      SFBRECER       X'01' SFBRECER SFBREC CHAIN
                                            INCOMPLETE
    0021   33 Bitstring    1 SFBTYPE        DEVICE TYPE FOR SPOOL OUTPUT
    0022   34 Signed       2 SFBMISC1       USE VARIES ACCORDING TO CALLER
    0024   36 Signed       4 SFBRECS        POINTER TO RECBLOKS FOR ACTIVE
                                            FILE
    0028   40 Character   12 SFBFNAME       FILE NAME
    0034   52 Character   12 SFBFTYPE       FILE TYPE
    0040   64 Character    8 SFBDATE        CREATION DATE OF SPOOL FILE
    0048   72 Character    8 SFBTIME        CREATION TIME OF SPOOL FILE
    0050   80 Signed       4 SFBLAST        DASD LOC. (DCHR) OF LAST PAGE
                                            BUFFER
    0054   84 Signed       2 SFBCOPY        NUMBER OF COPIES REQUESTED
    0056   86 Bitstring    1 SFBCLAS        SPOOL FILE CLASS CHARACTER
    0057   87 Bitstring    1 SFBFLAG2       SFBLOK CONTROL FLAGS - BYTE 2
              1... ....      SFBHOLD        X'80' SFBHOLD SAVE INPUT FILE;
                                            HOLD OUTPUT FILE
              .1.. ....      SFBNOHLD       X'40' SFBNOHLD DELETE INPUT FILE;
                                            NOHOLD OUTPUT
              ..1. ....      SFBFLNMT       X'20' SFBFLNMT FILE NOT EMPTY IF
                                            ON
              ...1 ....      SFBRSTRT       X'10' SFBRSTRT RESTART IN
                                            PROGRESS
              .... 1...      SFBTICER       X'08' SFBTICER BUFFER TIC ERROR
              .... .1..      SFBPURGE       X'04' SFBPURGE PURGE OPEN SPOOL
                                            FILE
              .... ..1.      SFBFIRST       X'02' SFBFIRST INDICATE FIRST
                                            PAGE WRITTEN
              .... ...1      SFBMON         X'01' SFBMON MONITOR CLASS FILE
    0058   88 Character    8 SFBDIST        DISTRIBUTION CODE
    0060   96 Character    4 SFBFLASH       OVERLAY NAME FOR 3800 FLASHING
    0064  100 Bitstring    1 SFBSTCPY       CURRENT STARTING COPY NUMBER
    0065  101 Bitstring    1 SFBFLAG3       SFBLOK CONTROL FLAGS - BYTE 3
              1... ....      SFBLDBEG       X'80' SFBLDBEG 3800 LOAD CCWS AT
                                            BEGINNING
              .1.. ....      SFBLDMID       X'40' SFBLDMID 3800 LOAD CCWS ALL
                                            THRU FILE
              ..1. ....      SFBFCB         X'20' SFBFCB INDICATE FCB CCWS
                                            NOW IN FILE
              .... .1..      SFBACNT        X'04' SFBACNT ACCOUNTING TYPE
                                            FILE
              .... ..1.      SFBSEEN        X'02' SFBSEEN 'FILE PREVIOUSLY
                                            SEEN' FLAG
              .... ...1      SFBXFER        X'01' SFBXFER 'FILE TRANSFERRED'
                                            FLAG
    0066  102 Bitstring    1 SFBCKPMP       CHECKPOINT MAP NUMBER FOR SLOT
    0067  103 Bitstring    1 SFBFLAG4       MORE STATUS FLAGS - BYTE 4
              1... ....      SFBINVS        X'80' SFBINVS SFBLOK IS IN
                                            SYSSPOOL's VIRTUAL STORAGE
              .1.. ....      SFBTUSE        X'40' SFBTUSE FILE IN TEMPORARY
                                            USE BY SYSTEM
              ..1. ....      SFBNORET       X'20' SFBNORET NORETURN FLAG
              ...1 ....      SFBVLEN        X'10' SFBVLEN Original record
                                            length available
              .... 1...      SFBPURGD       X'08' SFBPURGD File is 'to be
                                            purged'
              .... .1..      SFBCONV        X'04' SFBCONV File has been
                                            converted
              .... ..1.      SFBBCONV       X'02' SFBBCONV File being
                                            converted
              .... ...1      SFBXABER       X'01' SFBXABER AN XAB DISK RECORD
                                            IS INCORRECT SFBFLASH CONTAINS
                                            THE DISK ADDRESS OF THE INCORRECT
                                            RECORD.
              0000000D       SFBDSIZE       (*-SFBLOK)/8 DEFAULT SIZE, NON
                                            EXTENDED
    0068  104 Dbl-Word     8 SFBUFORM       USER SPECIFIED FORM NUMBER
    0070  112 Dbl-Word     8 SFBOFORM       OPERATOR SPECIFIED FORM NUMBER
              0000000F       SFBR2SIZ       (*-SFBLOK)/8 VM/SP RELEASE 2 SIZE
                                            IN DBL WDS
    0078  120 Signed       2 SFBFCBNL       LONGEST IMBEDDED FCB (3211-TYPE)
    007A  122 Signed       2 SFBFCBXL       LONGEST IMBEDDED FCB (EXTENDED)
          The following 4 bytes are reserved for compatibility when
          Diagnose x'14' and *SPL return an SFLOBK to the user.
          In particular, the bits that are
          useful to Diag x'14' and *SPL are the ones which indicate
          the KEEP/NOKEEP status (SFBXKEEP) and the MSG/NOMSG
          status (SFBXMSG) of the file.
    007C  124 Bitstring    1 SFBXSPT (4)    RESERVED FOR Diag x'14' and *SPL
                                            use
    0080  128 Dbl-Word     8 SFBDEST        USER SPECIFIED DESTINATION
    0088  136 Signed       4 SFBXAB         DASD ADDRESS OF XAB (CCPD/PPPD)
                                            EXTENDED ATTRIBUTE BUFFER
    008C  140 Signed       2 SFBXABL        LENGTH OF XAB EXTENDED ATTRIBUTE
                                            BUFFER
    008E  142 Bitstring    1 SFBFLG4A       SFBLOK FLAG
              1... ....      SFBREAD        X'80' SFBREAD INPUT SPOOL FILE
                                            HAS BEEN READ
              .1.. ....      SFBPCHEK       X'40' SFBPCHEK ALREADY CHECKED
                                            FOR PURGE
              ..1. ....      SFBORIGN       X'20' SFBORIGN DIAGNOSE X'F8'
                                            ORIGINATING NODE AND USERID ARE
                                            STORED IN THE FIRST SPLINK
              ...1 ....      SFBVAFP        X'10' SFBVAFP File created on
                                            VAFP type printer
    008F  143 Bitstring    1 SFBCENT        Hexadecimal representation of the
                                            century portion of the year in
                                            SFBDATE
    0090  144 Signed       4 SFBSYSID       SYSTEM UNIQUE FILE-ID
    0094  148 Bitstring    1 SFBFLAG5       FLAG
              1... ....      SFBCDMP        X'80' SFBCDMP INDICATE CURRENT
                                            DUMP SFBLOK
              .1.. ....      SFBCONTO       X'40' SFBCONTO CONSOLE SPOOLED TO
                                            ANOTHER VM
              ..1. ....      SFBRSVBT       X'20' SFBRSVBT RESERVED FOR IBM
                                            USE
              ...1 ....      SFBOPFRE       X'10' SFBOPFRE COPY OF AN OPEN
                                            READER FILE
    0095  149 Address      3 SFBOPCPY       ADDRESS OF SFBLOK IN FREE STORAGE
                                            FOR OPEN READER FILES
    0098  152 Character    1 SFBSHSPS (0)   START OF ISF CHANGES
              00000018       SFBSZ5         (*-SFBDEST) SIZE IN BYTES OF HPO5
                                            UNIQUE DATA
    0098  152 Bitstring    1 SFBSYQIX       SYSTEM INDEX OWNING THE LOCK
    0099  153 Bitstring    1 SFBORGIX       SYSTEM INDEX OWNING TEMP SPACE
    009A  154 Signed       2 SFBORGID       SPOOL FILE ID ON THE OWNING
                                            SYSTEM
    009C  156 Bitstring    1 SFBSHPST       SHARED SPOOL FILE STATUS
    009D  157 Bitstring    1 SFBSHPFL       SHARED SPOOL FILE FLAGS
    009E  158 Bitstring    1 SFBSHPCK       COPY SFBLOK CHECKPOINT STATUS
    009F  159 Bitstring    1 SFBBITS        BROADCAST BITS - BIT MAP OF
                                            SYSTEMS WITH COPIES OF THIS
                                            ORIGINAL SFBLOK
    00A0  160 Character    1 SFBSHSPN (0)   END OF ISF ENTRIES
    00A0  160 Character    8 SFBXFEE        VM userid of file's previous
                                            owner
    00A8  168 Dbl-Word     8 * (2)          RESERVED FOR FUTURE USE
    00B8  184 Character    8 SFBSCLAB       SPOOL FILE SECLABEL
              00000018       SFBSIZE        (*-SFBLOK)/8 SIZE IN DOUBLE WORDS
              00000018       SFBFNFT        L'SFBFNAME+L'SFBFTYPE
    007C  124 Bitstring    1 SFBXQUE        SPFQUEUE saved here for Diag
                                            x'14'
    007D  125 Bitstring    1 SFBXSYTY       SPFSYSTY saved here for Diag
                                            x'14'
    007E  126 Bitstring    1 SFBXSTAT       SPFSTAT saved here for Diag x'14'
              1... ....      SFBXINUS       X'80' SFBXINUS SPFINUSE (always
                                            turned off because SPTAPE LOAD
                                            restored the entire byte and
                                            should never load a file with the
                                            in use flag on. SPTAPE is no
                                            longer supported but this flag is
                                            saved for compatibility in Diag
                                            x'14' and *SPL output.) The real
                                            in-use status of the file is
                                            recorded in SFBFLAG.SFBINUSE
                                            flag.
              .... 1...      SFBXKEEP       X'08' SFBXKEEP SPFKEEP
              .... .1..      SFBXMSG        X'04' SFBXMSG SPFMSG
    007F  127 Bitstring    1 SFBXTYPE       SPFTYPE saved here for Diag x'14'
                                            and *SPL output compatibility

#### SFBLOK Storage Layout

    *** SFBLOK - VM/SP 370 SPOOL FILE CONTROL BLOCK
    *
    *     +---------------------------+---------------------------+
    *   0 |          SFBPNT           |         SFBSTART          |
    *     +---------------------------+---------------------------+
    *   8 |                       SFBUSER                         |
    *     +-------------------------------------------------------+
    *  10 |                       SFBORIG                         |
    *     +---------------------------+-------------+-------------+
    *  18 |         SFBRECNO          |  SFBRECSZ   |  SFBFILID   |
    *     +------+------+-------------+-------------+-------------+
    *  20 |:FLAG |:TYPE |  SFBMISC1   |         SFBRECS           |
    *     +------+------+-------------+---------------------------+
    *  28 |                       SFBFNAME                        |
    *     |                           +---------------------------+
    *  30 |                           |         SFBFTYPE          |
    *     +---------------------------+                           |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40 |                       SFBDATE                         |
    *     +-------------------------------------------------------+
    *  48 |                       SFBTIME                         |
    *     +---------------------------+-------------+------+------+
    *  50 |         SFBLAST           |  SFBCOPY    |:CLAS |:FLAG2|
    *     +---------------------------+-------------+------+------+
    *  58 |                       SFBDIST                         |
    *     +---------------------------+------+------+------+------+
    *  60 |         SFBFLASH          |:STCPY|:FLAG3|:CKPMP|:FLAG4|
    *     +---------------------------+------+------+------+------+
    *  68 |                       SFBUFORM                        |
    *     +-------------------------------------------------------+
    *  70 |                       SFBOFORM                        |
    *     +-------------+-------------+---------------------------+
    *  78 |  SFBFCBNL   |  SFBFCBXL   |         SFBXSPT           |
    *     +-------------+-------------+---------------------------+
    *  80 |                       SFBDEST                         |
    *     +---------------------------+-------------+------+------+
    *  88 |          SFBXAB           |  SFBXABL    |:FLG4A|:CENT |
    *     +---------------------------+------+------+------+------+
    *  90 |         SFBSYSID          |:FLAG5|     SFBOPCPY       |
    *     +------+------+-------------+------+------+------+------+
    *  98 |:SYQIX|:ORGIX|  SFBORGID   |:SHPST|:SHPFL|:SHPCK|:BITS |
    *     +------+------+-------------+------+------+------+------+
    *  A0 |                       SFBXFEE                         |
    *     +-------------------------------------------------------+
    *  A8 |///////////////////////////////////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  B8 |                       SFBSCLAB                        |
    *     +-------------------------------------------------------+
    *  C0
    *
    *** SFBLOK - VM/SP 370 SPOOL FILE CONTROL BLOCK

    *** Overlay for SFBXSPT in SFBLOK
    *
    *                                 +------+------+------+------+
    *  78 ...                      7C |:XQUE |:XSYTY|:XSTAT|:XTYPE|
    *                                 +------+------+------+------+
    *  80
    *
    *** Overlay for SFBXSPT in SFBLOK

#### SFBLOK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SFBACNT        0065 04
    SFBBCONV       0067 02
    SFBBITS        009F
    SFBCDMP        0094 80
    SFBCENT        008F
    SFBCKPMP       0066
    SFBCLAS        0056
    SFBCONTO       0094 40
    SFBCONV        0067 04
    SFBCOPY        0054
    SFBDATE        0040
    SFBDEST        0080
    SFBDIST        0058
    SFBDSIZE       0067 0000000D
    SFBDUMP        0020 10
    SFBEOF         0020 02
    SFBFCB         0065 20
    SFBFCBNL       0078
    SFBFCBXL       007A
    SFBFILID       001E
    SFBFIRST       0057 02
    SFBFLAG        0020
    SFBFLAG2       0057
    SFBFLAG3       0065
    SFBFLAG4       0067
    SFBFLAG5       0094
    SFBFLASH       0060
    SFBFLG4A       008E
    SFBFLNMT       0057 20
    SFBFNAME       0028
    SFBFNFT        00B8 00000018
    SFBFTYPE       0034
    SFBHOLD        0057 80
    SFBINUSE       0020 80
    SFBINVS        0067 80
    SFBLAST        0050
    SFBLDBEG       0065 80
    SFBLDMID       0065 40
    SFBMISC1       0022
    SFBMON         0057 01
    SFBNOHLD       0057 40
    SFBNORET       0067 20
    SFBOFORM       0070
    SFBOPCPY       0095
    SFBOPEN        0020 08
    SFBOPFRE       0094 10
    SFBORGID       009A
    SFBORGIX       0099
    SFBORIG        0010
    SFBORIGN       008E 20
    SFBPCHEK       008E 40
    SFBPNT         0000
    SFBPURGD       0067 08
    SFBPURGE       0057 04
    SFBREAD        008E 80
    SFBRECER       0020 01
    SFBRECNO       0018
    SFBRECOK       0020 40
    SFBRECS        0024
    SFBRECSZ       001C
    SFBRSTRT       0057 10
    SFBRSVBT       0094 20
    SFBR2SIZ       0070 0000000F
    SFBSCLAB       00B8
    SFBSEEN        0065 02
    SFBSHOLD       0020 04
    SFBSHPCK       009E
    SFBSHPFL       009D
    SFBSHPST       009C
    SFBSHSPN       00A0
    SFBSHSPS       0098
    SFBSIZE        00B8 00000018
    SFBSTART       0004
    SFBSTCPY       0064
    SFBSYQIX       0098
    SFBSYSID       0090
    SFBSZ5         0098 00000018
    SFBTICER       0057 08
    SFBTIME        0048
    SFBTUSE        0067 40
    SFBTYPE        0021
    SFBUFORM       0068
    SFBUHOLD       0020 20
    SFBUSER        0008
    SFBVAFP        008E 10
    SFBVLEN        0067 10
    SFBXAB         0088
    SFBXABER       0067 01
    SFBXABL        008C
    SFBXFEE        00A0
    SFBXFER        0065 01
    SFBXINUS       007E 80
    SFBXKEEP       007E 08
    SFBXMSG        007E 04
    SFBXQUE        007C
    SFBXSPT        007C
    SFBXSTAT       007E
    SFBXSYTY       007D
    SFBXTYPE       007F

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:27:53 EDT.
Copyright IBM Corporation, 1990, 2008