Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

LRDA

Prolog  

Control Block Contents  
   LRDA DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


LRDA Prolog

 Name       : HCPLRDA
 Description: Locate Record data area
 COPYRIGHT -
              THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
              5654-030 (C) COPYRIGHT IBM CORP. - 1990, 1998
              LICENSED MATERIALS - PROPERTY OF IBM
 DSECT      : LRDA
 Function   : Maps the contents of the Locate Record data
              area.
 Located by :
              HCCWADDR - The Locate Record CCW data address field
              contains the address of the locate
              record data area.
 Created by :
              Storage for this control block cannot be
              specifically allocated/deallocated using
              HCPGETST/HCPRELST.
              Paging I/O manager -
              The data area resides in the HCPPIOBK which
              is allocated by HCPRDA.
              Track cache manager -
              Data area is part of a larger free storage
              area used to build ECKD channel programs
              which is allocated in modules HCPFTU/HCPFTP.
 Deleted by :
              Storage for this control block cannot be
              specifically allocated/deallocated using
              HCPGETST/HCPRELST.
              Paging I/O manager -
              The data area resides in the HCPPIOBK which
              is allocated by HCPRDD.
              Track cache manager -
              Data area is part of a larger free storage
              area used to build ECKD channel programs
              which is deallocated in modules HCPFTU/HCPFTP.
 Serialized :
              Paging I/O manager -
              EXPLCKFG - The paging I/O manager uses the exposure
              block lock to serialize this data area.
              Track cache manager -
              TCMTSLK  - Track cache lock
 Comments   :
              Paging I/O manager -
              The Locate Record data area resides in the
              HCPPIOBK. Each Locate Record CCW address field
              contains the address of the Locate Record data
              area within that PIOBK.
              Track cache manager -
              None

 

LRDA Control Block Content


LRDA DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      LRDA           Locate Record data area
0000    0 Bitstring   16 LRDAREA (0)    Locate record data area
     Byte 0 (Operation byte)
     Although defined as BITs, the contents of the operation byte are,
     architecturally, multiple codes.
0000    0 Bitstring    1 LRDOP          Operation byte
          11.. ....      LRDOR          X'C0' Operation byte, bits 0 and
                                        1 ------- Codes for use with
                                        LRDOR
          .... ....      LRDORCA        X'00' Orient on count area
          .1.. ....      LRDORHA        X'40' Orient on home address
          1... ....      LRDORDA        X'80' Orient on data area
          11.. ....      LRDORIX        X'C0' Orient on index -------
          ..11 1111      LRDOOC         X'3F' Operation byte, bits 2
                                        through 7 ------- Codes for use
                                        with LRDOOC
          .... ....      LRDOCOR        X'00' Orient
          .... ...1      LRDOCWD        X'01' Write data
          .... ..11      LRDOCFW        X'03' Format write
          .... .11.      LRDOCRD        X'06' Read data
          .... 1.11      LRDOCWT        X'0B' Write track
          .... 11..      LRDOCRT        X'0C' Read tracks
          ...1 .11.      LRDOCR         X'16' Read -------
     Byte 1 (Auxiliary byte)
0001    1 Bitstring    1 LRDAUX         Auxiliary byte
          1... ....      LRDAVTLF       X'80' Validate transfer length
                                        factor
          .... ...1      LRDARCS        X'01' Read count suffix
     Byte 2 (Zeros)
0002    2 Bitstring    1 LRDZEROS       Must be zeros
     Byte 3 (Record count)
0003    3 Bitstring    1 LRDRECCT       Record count
     Bytes 4 through 7 (Seek address)
0004    4 Bitstring    4 LRDSEEK (0)    Seek address (CCHH)
0004    4 Bitstring    2 LRDSCC         CC of CCHH
0006    6 Bitstring    2 LRDSHH         HH of CCHH
     Bytes 8 through 12 (Search argument)
0008    8 Bitstring    5 LRDSRCH (0)    Search argument (CCHHR)
0008    8 Bitstring    2 LRDRCC         CC of CCHHR
000A   10 Bitstring    2 LRDRHH         HH of CCHHR
000C   12 Bitstring    1 LRDRR          R of CCHHR
     Byte 13 (Sector number)
000D   13 Bitstring    1 LRDSECT        Sector number
     Bytes 14 and 15 (Transfer length factor)
000E   14 Bitstring    2 LRDTLF         Transfer length factor
     Length equates
          00000010       LRDBSIZE       *-LRDAREA Size of LRDA in bytes
          00000002       LRDSIZE        ((*-LRDAREA)+7)/8 Size of LRDA in
                                        DWs

 

LRDA Storage Layout

          
*** LRDA - Locate Record data area
*
*     +------+------+------+------+-------------+-------------+
*   0 |LRDOP |LRDAUX|:ZEROS|:RECCT|   LRDSCC    |   LRDSHH    |
*     +------+------+------+------+------+------+-------------+
*   8 |   LRDRCC    |   LRDRHH    |LRDRR |:SECT |   LRDTLF    |
*     +-------------+-------------+------+------+-------------+
*  10
*
*** LRDA - Locate Record data area

 

LRDA Cross Reference

Symbol         Dspl Value
-------------- ---- -----
LRDARCS        0001 01
LRDAREA        0000
LRDAUX         0001
LRDAVTLF       0001 80
LRDBSIZE       000E 00000010
LRDOCFW        0000 03
LRDOCOR        0000 00
LRDOCR         0000 16
LRDOCRD        0000 06
LRDOCRT        0000 0C
LRDOCWD        0000 01
LRDOCWT        0000 0B
LRDOOC         0000 3F
LRDOP          0000
LRDOR          0000 C0
LRDORCA        0000 00
LRDORDA        0000 80
LRDORHA        0000 40
LRDORIX        0000 C0
LRDRCC         0008
LRDRECCT       0003
LRDRHH         000A
LRDRR          000C
LRDSCC         0004
LRDSECT        000D
LRDSEEK        0004
LRDSHH         0006
LRDSIZE        000E 00000002
LRDSRCH        0008
LRDTLF         000E
LRDZEROS       0002

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 16:51:56 EDT.
Copyright IBM Corporation, 1990, 2002