z/OS DFSMSdfp Advanced Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Data Extent Block (DEB) Fields

z/OS DFSMSdfp Advanced Services
SC23-6861-01

The data extent block (DEB) fields shown here should only be used with EXCP and EXCPVR (see 53z/OS DFSMSdfp Diagnosis for all fields in the DEB).
Common Name:
Data Extent Block
Macro ID:
IEZDEB
DSECT Name:
  • DEB (DSECT card precedes AVT section)
  • DEBBASIC should be used for USING basic section.
  • DEBDASD (DSECT name for direct access section)
  • DEBACSMD (DSECT name for access method sections)
  • DEBSUBNM (DSECT name for subroutine name section)
  • DEBXTN (DSECT name for DEB extension)
Owning Component:
Data Management, subcomponent OPEN/CLOSE/EOV
Eye-Catcher ID:
None
Subpool and Key:
230 and key 5
Size:
Variable (device and access method dependent sections)
Created by:
OPEN
Pointed to by:
DCBDEBAD field of the DCB data area. DEBDEBAD field of the DEB data area (next DEB on the chain)
Serialization:
LOCAL lock serializes the placing of a DEB on the TCB DEB chain and in the DEB table. OPEN/CLOSE/EOV processing is serialized by local lock and DEBCHK.
Function:
The DEB is an extension of the information in the DCB. Each DEB is associated with a DCB, and the two point to each other. It contains information about the physical characteristics of the data set, and other information used by the control program.
Table 1. Partial Listing of DEB Fields
Offset Type Length Name Description
Appendage vector table section of the DEB pointed to by DEBAPPAD
0(0)   20 DEBAVT(0) Appendage vector table
0(0) ADDRESS 4 DEBEOEA(0) Address of end-of-extent appendage routine
0(0) BITSTRING 1 DEBEOEAB Flag byte
  . . . . xxxx   DEBEOENP X'0F'– number of 2K pages to be fixed for the end–of–extent appendage
1(1) ADDRESS 3 DEBEOEAD Address of end-of-extent appendage routine
4(4) ADDRESS 4 DEBSIOA(0) Address of start I/O appendage routine
4(4) BITSTRING 1 DEBSIOAB Flag byte
  1. . . . . . .   DEBPGFX X'80' Address in DEBSIOAD can be used to determine the entry point to the page fix (PGFX) appendage routine by adding 4 to the address in DEBSIOAD
  .1. . . . . .   DEBSIOX X'40'– if zero, do not enter SIO appendage when ERP IS active. If one, enter SIO appendage even when ERP is active.
  . .1. . . . .   DEBIOVR X'20'– If one, EXCPVR request is valid. If zero, EXCPVR request is invalid and will not be executed. Currently has no effect.
  . . .1 . . . .   DEBFIX X'10' Indication that DEB has been fixed
  . . . . xxxx   DEBSIONP X'0F'– number of 2K pages to be fixed for the SIO appendage
5(5) ADDRESS 3 DEBSIOAD Address of start I/O appendage routine
8(8) ADDRESS 4 DEBPCIA(0) Address of PCI appendage routine
8(8) BITSTRING 1 DEBPCIAB Flag byte
  . . . . xxxx   DEBPCINP X'0F'–number of 2K pages to be fixed for the PCI appendage
9(9) ADDRESS 3 DEBPCIAD Address of program controlled interruption (PCI) appendage routine
12(C) ADDRESS 4 DEBCEA(0) Address of channel end appendage routine
12(C) BITSTRING 1 DEBCEAB Flag byte
  1. . . . . . .   DEBESMVR X'80',c'x' validity check for EXCPVR caller
  . . . . xxxx   DEBCENP X'0F'– number of 2K pages to be fixed for the channel–end appendage
13(D) ADDRESS 3 DEBCEAD Address of channel end appendage routine
16(10) ADDRESS 4 DEBXCEA(0) Address of abnormal end appendage routine
16(10) BITSTRING 1 DEBXCEAB Flag byte
  . . . . xxxx   DEBXCENP X'0F'– number of 2K pages to be fixed for the abnormal–end appendage
17(11) ADDRESS 3 DEBXCEAD Address of abnormal end appendage routine
  X''   DEBAVTE "*" End of appendage vector table
DEB PREFIX TABLE. Addressable as negative offset from DEB basic section. Not necessarily contiguous with DEB appendage vector table.
-16(10)   16 DEBPREFX(0) DEB prefix table
-16(10) BITSTRING 1 DEBWKARA O/C/E work area (direct access)
-15(F) BITSTRING 7 DEBDSCBA DSCB address (BBCCHHR) used by O/C/E (direct access)
-8(8) ADDRESS 4 DEBXTNP(0) Pointer to DEB extension
-4(4) BITSTRING 1 DEBLNGTH Length of DEB in double words. If it exceeds 2040 bytes (X'FF' doublewords), the excess bits are ignored.
-3(3) CHARACTER 1 DEBAMTYP Access method type
  X'0'   DEBAMNON "0" Access method type not known
  X'1'   DEBAMVSM "1" VSAM access method type
  X'2'   DEBAMXCP "2" EXCP access method type
  X'4'     Reserved
  X'8'   DEBAMGAM "8" Graphics access method type
  X'10'   DEBAMTAM "16" BTAM access method type
  X'20'   DEBAMBPM "32" BPAM access method type
  X'20'   DEBAMSAM "32" Sequential access method type
  X'40'   DEBAMBDM "64" Direct access method type
  X'81'   DEBAMSUB "129" subsystem access method type
  X'82'   DEBAMVTM "130" VTAM® access method type
  X'84'     Reserved
-2(2) UNSIGNED 2 DEBTBLOF For system use
  X'24'   DEBPREFE "*" End of DEB prefix table  
DEB basic section
0(0)     DEBBASIC "*"
0(0) ADDRESS 4 DEBTCBAD(0) Address of TCB for this DEB
0(0) BITSTRING 1 DEBNMSUB Number of subroutines loaded by OPEN executor routines and identified in the subroutine name section (DEBSUBID)
1(1) ADDRESS 3 DEBTCBB Address of TCB for this DEB
4(4) ADDRESS 4 DEBDEBAD(0) Address of the next DEB in the same task
4(4) BITSTRING 1 DEBAMLNG Number of bytes in the access method dependent section. For BDAM this field contains the length expressed in number of words.
5(5) ADDRESS 3 DEBDEBB Address of the next DEB in the same task
8(8) ADDRESS 4 DEBIRBAD(0) IRB storage address used for appendage asynchronous exits
8(8) BITSTRING 1 DEBOFLGS Data set status flags
  xx. . . . . .   DEBDISP X'C0'– data set disposition flags bit setting disposition
  01. . . . . .   DEBDSOLD X'40' old data set
  10 . . . . . .   DEBDSMOD X'80' mod data set
  11. . . . . .   DEBDSNEW X'C0' new data set
  . .1. . . . .   DEBEOF X'20'– end of file (EOF) encountered (tape input) format 1 DSCB bit 93.0 indicates that the current volume is the last volume of the data set (DASD input)
  . . .1 . . . .   DEBRLSE X'10'– release unused external storage (DASD) emulator tape with second generation format. Tape might contain blocks shorter than 12 characters. (tape)
  . . . . .1. .   DEBSPLIT X'04'–7–track emulator tape with possible mixed parity records (tape)
  . . . . . .1.   DEBLABEL X'02'– nonstandard labels
  . . . . . . .1   DEBRERR X'01'– use reduced error recovery procedure (tape) concatenated partitioned organization data sets processed using BPAM (DASD)
9(9) ADDRESS 3 DEBIRBB IRB storage address used for appendage asynchronous exits
12(C) BITSTRING 1 DEBOPATB Flags indicating both the method of I/O processing and the disposition that is to be performed when an end of volume (EOV) condition occurs
  1. . . . . . .   DEBABEND X'80'– set by abend indicating a sysabend or sysudump data set
  .1. . . . . .   DEBZERO X'40'– always zero
  . .xx . . . .   DEBPOSIT X'30'– data set positioning flags bit setting positioning
  . . 01 . . . .   DEBRERED X'10' reread
  . .11 . . . .   DEBLEAVE X'30' leave
  . . . . xxxx   DEBACCS X'0F'– type of I/O accessing being done bit setting accessing
  . . . . 0000   DEBINPUT X'0' INPUT
  . . . . 1111   DEBOUTPT X'F' OUTPUT or EXTEND
  . . . . 0011   DEBINOUT X'3' INOUT
  . . . . 0111   DEBOUTIN X'7' OUTIN or OUTINX
  . . . . 0001   DEBRDBCK X'1' RDBACK
  . . . . 0100   DEBUPDAT X'4' UPDAT
13(D) BITSTRING 1 DEBQSCNT PURGE (SVC 16) – Quiesce count. Number of devices executing user's channel programs, as shown by bits 5 and 6 of UCBFL1 fields.
14(E) BITSTRING 1 DEBFLGS1 Flag field
  1. . . . . . .   DEBPWCKD X'80'– password was supplied during OPEN. EOV will not request a password for each additional volume of a multivolume data set.
  .1. . . . . .   DEBEOFDF X'40'– set by EOV to inform close that an end of file has been encountered and, therefore, deferred user label processing is allowed.
  . . .1 . . . .   DEBEXCPA X'10'– EXCP(VR) is authorized for this DEB
  . . . . .1. .   DEBF1CEV X'04'–not valid with an EXCP DCB.
  . . . . . .1.   DEBAPFIN X'02'– if on, authorized programs can be loaded
  . . . . . . .1   DEBXTNIN X'01'– if one, DEB extension exists
15(F) BITSTRING 1 DEBFLGS2 Flag field two
        The following two flag bits are used by O/C/EOV to maintain a uniform recording mode (compaction or non-compaction) on tape data sets that span over more than one volume.
  . . . . 1. . .   DEBDSCMP X'08' tape data set compaction mode
  . . . . .1. .   DEBDSNCP X'04' tape data set non-compaction mode
  . . . . . . 1.   DEB31UCB UCB address fields are four bytes. Use DEBSUCBA, DEBUCBAD, DEBSDVMX or DEBDVMOD31 instead of DEBSUCBB, DEBUCBA, DEBSDVM or DEBDVMOD.
16(10) ADDRESS 4 DEBUSRPG(0) Address of purged I/O restore list (PIRL)
16(10) BITSTRING 1 DEBNMEXT Number of extent descriptions starting at DEBBASND. One extent per unit for extended format or PDSE data sets.
17(11) ADDRESS 3 DEBUSRPB Address of purged I/O restore list (PIRL)
20(14) ADDRESS 4 DEBRRQ(0) Pointer to related request queue
20(14) BITSTRING 1 DEBPRIOR Priority of the task owning DEB
24(18) ADDRESS 4 DEBDCBAD(0) Address of DCB or ACB associated with this DEB
24(18) BITSTRING 1 DEBPROTG(0) Task protection key in high order 4 bits
24(18) BITSTRING 1 DEBDEBID A hex F in low–order 4 bits to identify this block as a DEB
25(19) ADDRESS 3 DEBDCBB Address of DCB or ACB associated with this DEB
28(1C) ADDRESS 4 DEBAPPAD(0) Address of the I/O appendage vector table
28(1C) ADDRESS 1 DEBEXSCL This field is used to determine the size of the device dependent section. Two to this power gives the length of the device dependent section at DEBBASND. Extent scale – 4 (16 bytes) for direct access device and 3525 card punch with device–associated data set support and 2 (4 bytes) for nondirect access device and communication device.
29(1D) ADDRESS 3 DEBAPPB Address of the I/O appendage vector table
32(20)     DEBBASND End of basic section
Unit Record, Magnetic Tape, Telecommunications Devices Section
32(20)     DEBDDS1 "*"
32(20) ADDRESS 4 DEBSUCBA(0) See the DEBUCBAD field.
32(20) BITSTRING 1 DEBSDVM Device modifier. For magnetic tape, MODESET operation code. For unit record, not defined. Valid only if DEB31UCB is off.
  1101 0011   DEBMTDN4 X'D3' 9–track MODESET CCW CODE DENSITY=6250BPI
  1100 0011   DEBMTDN3 X'C3' 9–track MODESET CCW CODE DENSITY=1600BPI
  1100 1011   DEBMTDN2 X'CB' 9–track MODESET CCW CODE DENSITY= 800BPI 7–track TAPE MODESET skeleton codes (must be completed with parity, translation and/or conversion)
  0000 0011   DEBM7DN0 X'03' 7–track MODESET SKELETON DENSITY=200BPI
  0100 0011   DEBM7DN1 X'43' 7–track MODESET SKELETON DENSITY=556BPI
  1000 0011   DEBM7DN2 X'83' 7–track MODESET SKELETON DENSITY=800BPI 3480 tape operation code
  1100 0011   DEBMSTWI X'C3' 3480 set tape write immediate ccw code. Tape mode set function byte
  1. . . . . . .   DEBMTRF0 X'80' tape recording format bit 0
  .1. . . . . .   DEBMTRF1 X'40' tape recording format bit 1
  . .1. . . . .   DEBMTWI X'20' tape write immediate (non-buffered write)
  . . .1 . . . .   DEBMINHS X'10' inhibit supervisor commands
  . . . . 1. . .   DEBMCOMP X'08' compacted recording mode
  . . . . 1. . .   DEBCMPAC "DEBMCOMP" COMPACTED RECORDING MODE
  . . . . . .1.   DEBM3424 X'02' 3424 mode set flag
  . . . . . . .1   DEBMINHE X'01' inhibit control unit ERP
  X'C2'   DEBM6250 "DEBMTRF0+ DEBMTRF1+ DEBM3424"SET 3424 DENSITY=6250BPI
  X'42'   DEBM1600 "DEBMTRF1+ DEBM3424" SET 3424 DENSITY=1600BPI
33(21) ADDRESS 3 DEBSUCBB Address of a UCB associated with a given data set
36(24)   0 DEBDEVED(0) End of common tape and unit record fields if DEB31UCB is off.
Next four bytes present only if DEB31UCB is on
36(24) BITS 1 DEBSDVMX Device modifier. For magnetic tape, modeset operation code or modeset function byte. For unit record reserved. Present only if DEB31UCB is on.
37(25) CHARACTER 3   Reserved
40(28)   0 DEBDVEDX End of section if DEB31UCB is on.
The following fields are present only for the 3525 with device–associated data set support
36(24) ADDRESS 4 DEBRDCB(0)  
36(24) BITSTRING 1 DEBRSV06  
37(25) ADDRESS 3 DEBRDCBA  
40(28) ADDRESS 4 DEBPDCB(0)  
40(28) BITSTRING 1 DEBRSV07  
41(29) ADDRESS 3 DEBPDCBA  
44(2C) ADDRESS 4 DEBWDCB(0)  
44(2C) BITSTRING 1 DEBRSV08  
45(2D) ADDRESS 3 DEBWDCBA  
      DEBASDSE Address of DCB for the read associated data set
Direct–access storage device section it follows the basic section. There is one of these sections for each extent, except for a pdse or extended format data set, in which case there is one section per device.
0(0) ADDRESS 4 DEBUCBAD Address of a UCB associated with this extent. The following applies to DEBSUCBA, DEBSUCBB, DEBUCBAD and DEBUCBA: If the actual UCB is above the 16 MB line and the dynamic allocation nocapture option is not in effect, allocation normally captures the UCB to create a 24-bit address. When using EXCP and you specify the nocapture option of dynamic allocation but not the LOC=ANY option on the DCBE, then OPEN or EOV captures the UCB until a later EOV or close. In these cases the high order byte of this word contains the device modifier byte. If you specify nocapture on the dynamic allocation and the actual DASD or tape UCB address is above the line and the DCB is for BSAM, BPAM, QSAM or EXCP and the DCBE has specified LOC=ANY, then the system does not capture the UCB. In that case OPEN turns on the DEB31UCB bit to signify the 31-bit UCB address field is valid and that the device modifier byte is in DEBSDVMX or DEBDVMOD31. It may remain on for subsequent volumes even though they have actual 24-bit addresses in a four-byte field.
0(0) BITSTRING 1 DEBDVMOD Device modifier. File mask. Valid only if DEB31UCB is off.
1(1) ADDRESS 3 DEBUCBA Address of UCB for this extent. Valid only if DEB31UCB is off.
4(4) BINARY 1 DEBDVMOD31 Reserved if DEB31UCB is off. File mask (device modifier) if DEB31UCB is on.
5(5) BINARY 1 DEBNMTRKHI High order byte of number of tracks in extent. Low order two bytes are in DEBNMTRK. DEBNMTRKHI combined with DEBNMTRK gives total number of tracks in this extent. DEBNMTRKHI is 0 for a basic format data set and may be non-zero for a large format data set.
6(6) BINARY 2 DEBSTRCC Low order 16 bits of cylinder number of start of extent
8(8) BINARY 2 DEBSTRHH High order 12 bits of cylinder number and four-bit track number of start of extent
10(A) BINARY 2 DEBENDCC Low order 16 bits of cylinder number of end of extent. Not set for a PDSE
12(C) BINARY 2 DEBENDHH High order 12 bits of cylinder number and four-bit track number of end of extent. For PDSE this field is reserved. For an extended format data set this field contains the track number of the format-1 dscb address.
14(E) BINARY 2 DEBNMTRK Number of tracks allocated to a given extent. For a pdse this field is set to one(X'0001'). For an extended format sequential data set the first byte contains the record number of the format-1 dscb address, and the second byte is zero.
      DEBDASDE "*" end of DASD device section
EXCP Access Method, Bsam And Qsam Dependent Section Length Is In DEBAMLNG.
0(0) BINARY 2 DEBVOLSQ Volume sequence number for multivolume sequential data sets
0(0) BITSTRING 1 DEBVOLBT First byte of debvolsq. Reserved for system use.
1(1) SIGNED 1 DEBVLSEQ For direct access, sequence number of the volume of the data set relative to the first volume of the data set. For tape, sequence number of the volume of the data set relative to the first volume processed.
2(2) BINARY 2 DEBVOLNM Total number of volumes in a multivolume sequential data set.
4(4) BINARY 8 DEBDSNM Member name. This field appears only when an output data set has been opened for a member name and the dscb specifies a partitioned data set.
4(4) ADDRESS 4 DEBUTSAA Address of the user totaling save area
4(4) BITSTRING 1 DEBRSV13 For system use
5(5) ADDRESS 3 DEBUTSAB Address of the user totaling save area
8(8) BITSTRING 4 DEBRSV14 For system use (if user totaling was specified)
12(C) SIGNED 2 DEBBLKSI Maximum block size
14(E) SIGNED 2 DEBLRECL Logical record length
BPAM Dependent Section
0(0) BINARY 1 DEBEXTNM For a partitioned data set opened for input, each one–byte field contains the extent number of the first extent entry for each data set except the first, if two or more data sets are concatenated. The number of bytes in the field is equal to one less than the number of data sets concatenated.
0(0) CHARACTER 8 DEBDSNAM For a partitioned data set opened for output for a member name, this field is the member name.
BDAM Dependent Section For Fixed Length Records With The Option Of Relative Block Addressing
0(0) BINARY 4 DEBDBLK One four byte field for each extent described in the device dependent section
0(0) ADDRESS 1 DEBDBPT Number of blocks per track
1(1) BINARY 3 DEBDBPE Number of blocks per extent  
Subroutine Name Section Note Follows The Access Method Dependent Section, Or The Device Dependent Section If There Is No Access Method Section
0(0) CHARACTER 2 DEBSUBID Subroutine identification. Each access method subroutine, appendage subroutine, and irb routine will have a unique eight–byte name. The low–order two bytes of each routine name will be in this field if the subroutine is loaded by the OPEN routines.  
DEB Extension Pointed To By DEBXTNP In The DEB Prefix
0(0) SIGNED 2 DEBXLNGH Length of DEB extension
2(2) BITSTRING 1 DEBXFLG1 Flag byte—for system use
3(3) BITSTRING 1 DEBXFLG2 Flag byte
  .1. . . . . .   DEBBYP X'40'– when on EXCP scan routine will set iosbyp on and bypass building a prefix
  . .1. . . . .   DEBCHCMP X'20'– when on EXCP scan routine will set ioschcmp on and bypass building a prefix
4(4) ADDRESS 4 DEBXDSAB Pointer to dsab
8(8) BITSTRING 4   For system use
12(C) ADDRESS 4 DEBXDBPR Pointer to DEB
16(10) CHARACTER 24   For system use
40(28) BITSTRING 8 DEBXDEF(0) Define extent data area
40(28) BITSTRING 1 DEBDEFG1 Flag byte
  1. . . . . . .   DEBNSHED X'80' no seek head permitted
  .1. . . . . .   DEBXVDEF X'40' DEB def ext data parms valid. Must be on for dx data to be used.
41(29) BITSTRING 1 DEBGATTR Global attributes
  xx. . . . . .   DEBECKD X'C0' extent definition 2 b'00......' define extent operates as defined for fixed block arch b'11......' define extent operates as defined for ckd ext-cchh extents
  1. . . . . . .   DEBGAEX1 X'80' extent definition 1
  .1. . . . . .   DEBGAEX2 X'40' extent definition 2
  . .1. . . . .   DEBSTRTP X'20' data storage type-norm/temp b'..1.....' normal data storage b'..0.....' temporary data storage
  . . .x xx . .   DEBGA345 X'1c' attributes bits 3,4,5 b'...000..' normal cache access b'...001..' bypass cache load b'...010..' inhibit cache load b'...011..' sequential access b'...100..' reserved b'...101..' reserved b'...111..' reserved b'......xx' reserved
  . . .1 . . . .   DEBGA1 X'10' attribute 1
  . . . . 1 . . .   DEBGA2 X'08' attribute 2
  . . . . .1 . .   DEBGA3 X'04' attribute 3 b'...000..' normal cache access b'...001..' bypass cache load b'...010..' inhibit cache load b'...011..' sequential access b'...100..' sequential staging mode'...101..' record access mode b'...111..' reserved b'......xx' reserved
  . . . 0 00 . .   DEBNCACH X'00' normal cache access
  . . . 0 01 . .   DEBBCACH X'04' bypass cache load
  . . . 0 10 . .   DEBICACH X'08' inhibit cache load
  . . . 0 11 . .   DEBSCACH X'0c' sequential access
  . . . . . .1.   DEBNRD X'02' non-retentive data access
  . . . . . . .1   DEBINHFW X'01' inhibit fast write b'......10' use non-retentive data b'......11' inhibit DASD fast write
42(2A) BITSTRING 2 DEBBLKSZ Blocksize in bytes if less than or equal to 32760
44(2C) CHARACTER 4 DEBEXTOK Zero,extent locator or token
44(2C) CHARACTER 2 DEBNRDID Subsystem function id: non-retentive data id or concurrent copy / xrc session id
46(2E) CHARACTER 2    
48(30) CHARACTER 4 DEBIOPID For system use
52(34) CHARACTER 4 DEBBLKID Block id value used to calculate number of blocks in this tape volume for extended block count checking

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014