IBM: AVRADR

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

AVRADR

Prolog

Control Block Contents

AVRADR DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

AVRADR Prolog
 Name       : AVRLIST
 Description: Volume and Device Characteristics
 DSECT      : AVRADR
 Function   : AVRADR describes the characteristics of volumes
              and devices in response to a VSE SVC 99 request
              (GETVCE). AVRADR is called by AVRADR macro
              which calls AVRLIST macro that in turn calls
              DCTENTRY macro.

AVRADR Control Block Content


AVRADR DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      AVRADR         Volume and Device Characteristics
          00000000       AVRVOLC        * VOLUME CHARACTERISTICS
0000    0 Address      4 AVRPUB         ADDRESS OF PHYSICAL UNIT BLOCK
0004    4 Character    6 AVRVOLID       VOLUME IDENTIFIER
000A   10 Bitstring    1 AVRFLAG        FLAG BYTE
          1... ....      AVREXTFL       X'80' EXTENTION AVAILABLE
          .1.. ....      AVRSHR         X'40' DEVICE IS SHARED
          ..1. ....      AVRRSV         X'20' DEVICE IS RESERVED
          ...1 ....      AVRCOPY        X'10' DEVICE A COPY
          .... 1...      AVRREMV        X'08' DEVICE HAS REMOVABLE MEDIA
          .... .1..      AVRCMSV        X'04' DEVICE IS A CMS DISK
          .... ..1.      AVRNLNO        X'02' AVRLNO IS NOT VALID
          .... ...1      AVRNVOL        X'01' VOLID INFORMATION IS NOT
                                        VALID E.G NO VOL1 LABEL
000B   11 Bitstring    1 AVRTYPE        FORMAT OF DEVICE CHARACTERISTICS
          .... ...1      AVRFBA         X'01' FBA DEVICE
          .... ..1.      AVRCKD         X'02' CKD DEVICE
          .... ..11      AVRRPS         X'03' CKD DEVICE WITH RPS
          .... .1..      AVRECKD        X'04' ECKD DEVICE
          ..1. ....      AVRTAPE        X'20' TAPE DEVICE
000C   12 Bitstring    5 AVRVTOC (0)    DASD ADDRESS OF VTOC
000C   12 Bitstring    2 AVRVCC         CKD CYLINDER NO.
000E   14 Bitstring    2 AVRVHH         CKD TRACK NO.
0010   16 Bitstring    1 AVRVR          CKD RECORD NO.
0011   17 Bitstring    1 AVRCDCST       CKD DEVICE STATUS
          1... ....      AVRNOWRT       X'80' VM DEVICE WITH READ ONLY
000C   12 Bitstring    1 AVRVCI         BLOCKS PER CONTROL INTERVAL
000D   13 Bitstring    4 AVRVNUM        FBA BLOCK NO. OF VTOC
0011   17 Bitstring    1 AVRFDCST       FBA DUAL COPY STATUS
000C   12 Bitstring    6 AVRTINFO       RESERVED FOR FUTURE EXTENTION
0012   18 Bitstring    2 AVRLNO         LOGICAL UNIT NO. (AS IN CCB)
          00000014       AVRLEN         *-AVRADR LENGTH OF OUTPUT LIST
          0000000C       AVRILNG        12 LENGTH OF INPUT PARAMETER LIST
     RETURN CODES
          00000000       AVRGOOD        0 ALL DATA RETURNED
          00000004       AVRNOLNO       4 WAS UNABLE TO READ VOL1 LABEL
                                        CHECK FIELD AVRFLAG
          00000008       AVRNOVOL       8 VOLUME NOT MOUNTED
          00000008       AVRNOASG       8 LOGICAL UNIT NOT ASSIGNED
          00000008       AVRNDASD       8 DEVICE NOT DASD
          0000000C       AVRIGN         12 LOGICAL UNIT IS ASSIGNED
                                        'IGNORE'
          00000010       AVRNOTUP       16 DEVICE IS NOT OPERATIONAL
          00000014       AVRBPL         20 BAD INPUT PARAMETER LIST
          00000018       AVRNOTDF       24 ASSIGNED UNIT IS DIFFERENT
                                        CLASS
          0000001C       AVRNRDY        28 DEVICE IS NOT READY

AVRADR Storage Layout

*** AVRADR - Volume and Device Characteristics
*
*     +---------------------------+---------------------------+
*   0 |          AVRPUB           |        AVRVOLID-          |
*     +-------------+------+------+-------------+-------------+
*   8 |   -(004)    |:FLAG |:TYPE |   AVRVCC    |   AVRVHH    |
*     +------+------+------+------+-------------+-------------+
*  10 |AVRVR |:CDCST| 12
*     +------+------+
*
*** AVRADR - Volume and Device Characteristics
*** Overlay for AVRVTOC in AVRADR
*
*                                 +------+--------------------+
*   8 ...                       C |AVRVCI|     AVRVNUM-       |
*     +------+------+-------------+------+--------------------+
*  10 |-(00D)|:FDCST| 12
*     +------+------+
*
*** Overlay for AVRVTOC in AVRADR
*** Overlay for AVRVTOC in AVRADR
*
*                                 +---------------------------+
*     ...                       C |        AVRTINFO-          |
*     +-------------+-------------+---------------------------+
*  10 |   -(00C)    |   AVRLNO    | 14
*     +-------------+-------------+
*
*** Overlay for AVRVTOC in AVRADR