DRBK Back to Index page
 
Prolog 
Control Block Contents 
   DRBK 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.


  DRBK Prolog Top of page
 
 NAME       : HCPDRBK
 DESCRIPTION: CP Data Request Block
 DSECT      : DRBK
 FUNCTION   : The DRBK contains information used during
              open, read and close processing
 LOCATED BY : OFBDRB chain of open Data Request Blocks
              ACSPOPEN chain of pre-openned DRBKs
 CREATED BY : DRBKs are created by any routine that
              wishes to read a CMS file.
              DRBKs are created by CPCACHE processing.
 DELETED BY : Generally, whoever creates it.
              Although DRBKs created by CPCACHE
              will be deleted by HCPZIR during release
              processing.
 RELOCATION CONSIDERATIONS : None
 
 
  DRBK Control Block Content Top of page
 

 DRBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure DRBK CP Data Request Block The user fields should remain at the front of the block 0000 0 Dbl-Word 8 DRBUSRD1 Reserved for non-IBM use 0008 8 Dbl-Word 8 DRBUSRD2 Reserved for non-IBM use 0010 16 Signed 4 DRBUSRF1 Reserved for non-IBM use 0014 20 Signed 4 DRBUSRF2 Reserved for non-IBM use 0018 24 Signed 2 DRBUSRH1 Reserved for non-IBM use 001A 26 Signed 2 DRBUSRH2 Reserved for non-IBM use 001C 28 Bitstring 1 DRBUSRX1 Reserved for non-IBM use 001D 29 Bitstring 1 DRBUSRX2 Reserved for non-IBM use 001E 30 Bitstring 1 DRBUSRX3 Reserved for non-IBM use 001F 31 Bitstring 1 DRBUSRX4 Reserved for non-IBM use 0020 32 Address 4 DRBFWD A( next DRBK on open chain ) 0024 36 Address 4 DRBOFB A( OFB ) 0028 40 Character 16 DRBFID (0) File id, filename-filetype 0028 40 Character 8 DRBFIDFN File id, filename portion 0030 48 Character 8 DRBFIDFT File id, filetype portion 0038 56 Character 8 DRBMEMBR Member name (or x'00' if none) 0040 64 Signed 4 DRBMEMS Member starting record number 0044 68 Signed 4 DRBMEME Member ending record number 0048 72 Signed 4 * Reserved for future IBM use 004C 76 Signed 4 * Reserved for future IBM use 0050 80 Address 4 DRBPOPEN A(next DRBK on pre-open chain) 0054 84 Bitstring 1 DRBFLAG1 DRBK flags. Look at HCPZIOPX for bit conflict checking. 1... .... DRBNDRCT X'80' DRBNDRCT DRBBUFAD --> indirectly to bufr ...1 .... DRBUNIQE X'10' DRBUNIQE Don't search for OFBK .... 1... DRBNDFER X'08' DRBNDFER Don't stack CPEBK .... .1.. DRBPHYSR X'04' DRBPHYSR Physical Read performed .... ..1. DRBPHYSW X'02' DRBPHYSW Physical Write performed .... ...1 DRBSEUDO X'01' DRBSEUDO Perform Pseudo-OPEN 0055 85 Bitstring 1 DRBFLAG2 DRBK flags. Look at HCPZIOPX for bit conflict checking. 1... .... DRBOUTPT X'80' DRBOUTPT File is for output .1.. .... DRBBUFFR X'40' DRBBUFFR Delay write till buffer full ..1. .... DRBSPARS X'20' DRBSPARS File is a CMS "sparse file" ...1 .... DRBNOUPD X'10' DRBNOUPD Need't read block before writing .... 1... DRBCACHE X'08' DRBCACHE File has been cached. This is sometimes referred to as a pre-opened file. Hence the chain of DRBKs anchored on ACSPOPEN. .... .1.. DRBCNTRY X'04' DRBCNTRY Century for DRBDATIM (0=19, 1=20) 0056 86 Character 1 DRBRECFM Record format (c'V' or c'F'). 0057 87 Bitstring 1 * Reserved for future IBM use 0058 88 Signed 4 DRBRECDS How many records are in the file 005C 92 Signed 4 DRBRECNO Record number desired 0060 96 Signed 4 * Reserved for future IBM use 0064 100 Signed 4 DRBBUFAL ALET of addr space of DRBBUFAD 0068 104 Address 4 DRBBUFAD Host logical address of buffer or buffer list. A buffer list is indicated by the DRBNDRCT flag being on. A buffer list is a series of pairs of fullwords, where each pair contains the ad-len (address and length) of a section of the buffer. The sections may be discontiguous. The length of a section may be zero. The storage for the buffer may be backed anywhere in storage since format 2 IDA lists will be used to read in data. 006C 108 Signed 4 DRBBUFSZ Size of buffer: for a buffer list, the sum of all sections. 0070 112 Signed 4 DRBRECSZ Size of record retrieved 0074 116 Signed 4 DRBLRECL Largest record in file 0078 120 Address 4 DRBACSBK A( ACSBK ) if DRBACSBX = 0 007C 124 Signed 2 DRBACSBX Index into ACSPK 007E 126 Signed 2 DRBRETCD Rc from service routines .... .... DRBOK X'0000' DRBOK Request completed OK Access request errors .... .1.. DRBCHBIG X'0004' CPCACHE FILES big LRECL .... 1... DRBCHOTH X'0008' CPCACHE FILES other error .... 11.. DRBOFFLN X'000C' RDEV is OFFLINE ...1 .... DRBBDDEV X'0010' Unacceptable device type ...1 .1.. DRBBDACC X'0014' Unacceptable filemode number ...1 1... DRBACC2 X'0018' Competing ACCESS request ...1 11.. DRBRELRQ X'001C' Release required first ..1. .... DRBNTEDF X'0020' Mdisk not CMS EDF format ..1. .1.. DRBBDLNK X'0024' LINK processing failed Open request errors ..11 .... DRBOPN X'0030' File was already open ..11 .1.. DRBNTACC X'0034' Filemode number not accessed ..11 1... DRBNTFND X'0038' File was not found ..11 11.. DRBBDRCF X'003C' Unacceptable RECFM .1.. .... DRBINCLP X'0040' Imbed would cause a loop .1.. .1.. DRBNOMEM X'0044' Member not found .1.. 1... DRBBXBK X'0048' BX ^= 0 & BK ^= 0 .1.. 11.. DRBBITS X'004C' Invalid combination of flags Get request errors .1.1 .... DRBSMBFS X'0050' DRBBUFSZ < DRBRECSZ Small buffer size is only a problem when trying to read a PDS directry. .1.1 .1.. DRBNTOPN X'0054' File was not open .1.1 1... DRBEOF X'0058' E-O-F (DRBRECNO > FSBRECDS) E-O-F (DRBRECNO > DRBRECDS) E-O-F (buffer contains member separator) .1.1 11.. DRBBDRCN X'005C' Unacceptable DRBRECNO .11. .... DRBBDBFA X'0060' Unacceptable DRBBUFAD .11. .1.. DRBBDBFS X'0064' Unacceptable DRBBUFSZ .11. 1... DRBBDEXT X'0068' Outside minidisk extents .11. 11.. DRBBDINT X'006C' Bad internal format in file Put request errors .111 1... DRBPUSPR X'0078' Attempt to PUT a sparse rec .111 11.. DRBNOTUP X'007C' Not opened for output/update 1... .... DRBBDRCS X'0080' DRBRECSZ not eq record size Close request errors 1... .1.. DRBPSOPN X'0084' Pseudo-open still in effect Release request errors 1... 11.. DRBREL2 X'008C' Competing RELEASE request 1..1 .... DRBBDDET X'0090' Error detaching VDEV CPCACHE request errors 1..1 .1.. DRBCACHD X'0094' File was already cached State (or State Next) request errors 1..1 1... DRBNMORE X'0098' No more files on disk 1..1 11.. DRBBDSTA X'009C' Invalid STATE resume point PDS processing errors 1.1. .... DRBNTLIB X'00A0' Filetype not *LIB 1.1. .1.. DRBNTPDS X'00A4' Invalid PDS internal id 1.1. 1... DRBBDPDS X'00A8' Invalid PDS internal format General errors 1.11 .... DRBIOERR X'00B0' I/O error 1.11 .1.. DRBPGERR X'00B4' Paging error 1.11 1... DRBRETMX X'00B8' Maximum value supported for DRBRETCD 0080 128 Address 4 DRBSTACK Push down stack ptr for IMBEDs 0084 132 Address 4 * Reserved for future IBM use 0088 136 Character 6 DRBDATIM Date & time (yy mm dd hh mm ss) 008E 142 Signed 2 * Reserved for future IBM use 0090 144 Dbl-Word 8 * (0) D-word alignment for DRBSTWRK 0090 144 Bitstring 6 DRBSTWRK (0) Work area for STATE 0090 144 Address 4 DRBSTFSH STATE FSHBK pointer 0094 148 Signed 1 * STATE reserved field 0095 149 Signed 1 DRBSTFSI STATE FSBK index in page 0096 150 Signed 2 * Reserved for future IBM use 0098 152 Signed 4 DRBOPENS Count of times opened 009C 156 Signed 4 DRBCLOSD Count of times closed 00A0 160 Signed 4 * Reserved for future IBM use 00A4 164 Signed 4 * Reserved for future IBM use 00A8 168 Dbl-Word 8 * (0) End of DRBK 000000A8 DRBSIZEB (*-DRBK) Size in bytes 00000015 DRBSIZED (*-DRBK+7)/8 Size in d-words 0058 88 Signed 4 DRBSUOPC Count of pseudo-open requests that are not yet closed. 0010 16 Signed 4 DRBUSER0 Reserved for non-IBM use 0014 20 Signed 4 DRBUSER1 Reserved for non-IBM use
 
 
  DRBK Storage Layout Top of page
 
          
*** DRBK - CP Data Request Block
*
*     +-------------------------------------------------------+
*   0 |                       DRBUSRD1                        |
*     +-------------------------------------------------------+
*   8 |                       DRBUSRD2                        |
*     +---------------------------+---------------------------+
*  10 |         DRBUSRF1          |         DRBUSRF2          |
*     +-------------+-------------+------+------+------+------+
*  18 |  DRBUSRH1   |  DRBUSRH2   |:USRX1|:USRX2|:USRX3|:USRX4|
*     +-------------+-------------+------+------+------+------+
*  20 |          DRBFWD           |          DRBOFB           |
*     +---------------------------+---------------------------+
*  28 |                       DRBFIDFN                        |
*     +-------------------------------------------------------+
*  30 |                       DRBFIDFT                        |
*     +-------------------------------------------------------+
*  38 |                       DRBMEMBR                        |
*     +---------------------------+---------------------------+
*  40 |         DRBMEMS           |         DRBMEME           |
*     +---------------------------+---------------------------+
*  48 |///////////////////////////|///////////////////////////|
*     +---------------------------+------+------+------+------+
*  50 |         DRBPOPEN          |:FLAG1|:FLAG2|:RECFM|//////|
*     +---------------------------+------+------+------+------+
*  58 |         DRBRECDS          |         DRBRECNO          |
*     +---------------------------+---------------------------+
*  60 |///////////////////////////|         DRBBUFAL          |
*     +---------------------------+---------------------------+
*  68 |         DRBBUFAD          |         DRBBUFSZ          |
*     +---------------------------+---------------------------+
*  70 |         DRBRECSZ          |         DRBLRECL          |
*     +---------------------------+-------------+-------------+
*  78 |         DRBACSBK          |  DRBACSBX   |  DRBRETCD   |
*     +---------------------------+-------------+-------------+
*  80 |         DRBSTACK          |///////////////////////////|
*     +---------------------------+-------------+-------------+
*  88 |                DRBDATIM                 |/////////////|
*     +---------------------------+------+------+-------------+
*  90 |         DRBSTFSH          |//////|:STFSI|/////////////|
*     +---------------------------+------+------+-------------+
*  98 |         DRBOPENS          |         DRBCLOSD          |
*     +---------------------------+---------------------------+
*  A0 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  A8
*
*** DRBK - CP Data Request Block
          
*** Overlay for DRBRECDS in DRBK
*
*     +---------------------------+
*  58 |         DRBSUOPC          | 5C
*     +---------------------------+
*
*** Overlay for DRBRECDS in DRBK
          
*** Overlay for DRBUSRF1 in DRBK
*
*     +---------------------------+---------------------------+
*  10 |         DRBUSER0          |         DRBUSER1          |
*     +---------------------------+---------------------------+
*  18
*
*** Overlay for DRBUSRF1 in DRBK
 
 
  DRBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
DRBACC2        007E 18
DRBACSBK       0078
DRBACSBX       007C
DRBBDACC       007E 14
DRBBDBFA       007E 60
DRBBDBFS       007E 64
DRBBDDET       007E 90
DRBBDDEV       007E 10
DRBBDEXT       007E 68
DRBBDINT       007E 6C
DRBBDLNK       007E 24
DRBBDPDS       007E A8
DRBBDRCF       007E 3C
DRBBDRCN       007E 5C
DRBBDRCS       007E 80
DRBBDSTA       007E 9C
DRBBITS        007E 4C
DRBBUFAD       0068
DRBBUFAL       0064
DRBBUFFR       0055 40
DRBBUFSZ       006C
DRBBXBK        007E 48
DRBCACHD       007E 94
DRBCACHE       0055 08
DRBCHBIG       007E 04
DRBCHOTH       007E 08
DRBCLOSD       009C
DRBCNTRY       0055 04
DRBDATIM       0088
DRBEOF         007E 58
DRBFID         0028
DRBFIDFN       0028
DRBFIDFT       0030
DRBFLAG1       0054
DRBFLAG2       0055
DRBFWD         0020
DRBINCLP       007E 40
DRBIOERR       007E B0
DRBLRECL       0074
DRBMEMBR       0038
DRBMEME        0044
DRBMEMS        0040
DRBNDFER       0054 08
DRBNDRCT       0054 80
DRBNMORE       007E 98
DRBNOMEM       007E 44
DRBNOTUP       007E 7C
DRBNOUPD       0055 10
DRBNTACC       007E 34
DRBNTEDF       007E 20
DRBNTFND       007E 38
DRBNTLIB       007E A0
DRBNTOPN       007E 54
DRBNTPDS       007E A4
DRBOFB         0024
DRBOFFLN       007E 0C
DRBOK          007E 00
DRBOPENS       0098
DRBOPN         007E 30
DRBOUTPT       0055 80
DRBPGERR       007E B4
DRBPHYSR       0054 04
DRBPHYSW       0054 02
DRBPOPEN       0050
DRBPSOPN       007E 84
DRBPUSPR       007E 78
DRBRECDS       0058
DRBRECFM       0056
DRBRECNO       005C
DRBRECSZ       0070
DRBRELRQ       007E 1C
DRBREL2        007E 8C
DRBRETCD       007E
DRBRETMX       007E B8
DRBSEUDO       0054 01
DRBSIZEB       00A8 000000A8
DRBSIZED       00A8 00000015
DRBSMBFS       007E 50
DRBSPARS       0055 20
DRBSTACK       0080
DRBSTFSH       0090
DRBSTFSI       0095
DRBSTWRK       0090
DRBSUOPC       0058
DRBUNIQE       0054 10
DRBUSER0       0010
DRBUSER1       0014
DRBUSRD1       0000
DRBUSRD2       0008
DRBUSRF1       0010
DRBUSRF2       0014
DRBUSRH1       0018
DRBUSRH2       001A
DRBUSRX1       001C
DRBUSRX2       001D
DRBUSRX3       001E
DRBUSRX4       001F
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:49:45 EDT.
Copyright IBM Corporation, 1990, 2022